From b753e9cbc644430c326c90c6e5e121ddedaef26b Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Mon, 17 Nov 2025 16:24:18 +0000 Subject: [PATCH 001/105] Configurations: 'specification/ai/ContentUnderstanding/tspconfig.yaml', API Version: 2025-11-01, SDK Release Type: beta, and CommitSHA: '57cfe1e680b2521e03e1d8a0955bba0257439dca' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs' Pipeline run: https://dev.azure.com/azure-sdk/internal/_build/results?buildId=5580124 Refer to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release/sdk-release-prerequisites to prepare for SDK release. --- .../CHANGELOG.md | 7 + .../azure-ai-contentunderstanding/LICENSE | 21 + .../azure-ai-contentunderstanding/MANIFEST.in | 7 + .../azure-ai-contentunderstanding/README.md | 43 + .../_metadata.json | 7 + .../apiview-properties.json | 101 + .../azure/__init__.py | 1 + .../azure/ai/__init__.py | 1 + .../azure/ai/contentunderstanding/__init__.py | 32 + .../azure/ai/contentunderstanding/_client.py | 103 + .../ai/contentunderstanding/_configuration.py | 71 + .../_operations/__init__.py | 23 + .../_operations/_operations.py | 2427 +++++++++++++ .../_operations/_patch.py | 21 + .../azure/ai/contentunderstanding/_patch.py | 21 + .../contentunderstanding/_utils/__init__.py | 6 + .../contentunderstanding/_utils/model_base.py | 1237 +++++++ .../_utils/serialization.py | 2030 +++++++++++ .../ai/contentunderstanding/_utils/utils.py | 25 + .../ai/contentunderstanding/_validation.py | 66 + .../azure/ai/contentunderstanding/_version.py | 9 + .../ai/contentunderstanding/aio/__init__.py | 29 + .../ai/contentunderstanding/aio/_client.py | 107 + .../aio/_configuration.py | 73 + .../aio/_operations/__init__.py | 23 + .../aio/_operations/_operations.py | 2051 +++++++++++ .../aio/_operations/_patch.py | 21 + .../ai/contentunderstanding/aio/_patch.py | 21 + .../contentunderstanding/models/__init__.py | 164 + .../ai/contentunderstanding/models/_enums.py | 248 ++ .../ai/contentunderstanding/models/_models.py | 2993 +++++++++++++++++ .../ai/contentunderstanding/models/_patch.py | 21 + .../azure/ai/contentunderstanding/py.typed | 1 + .../dev_requirements.txt | 3 + .../generated_tests/conftest.py | 45 + .../test_content_understanding.py | 313 ++ .../test_content_understanding_async.py | 322 ++ .../generated_tests/testpreparer.py | 28 + .../generated_tests/testpreparer_async.py | 20 + .../pyproject.toml | 61 + .../tsp-location.yaml | 4 + sdk/contentunderstanding/ci.yml | 34 + 42 files changed, 12841 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/LICENSE create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/MANIFEST.in create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/README.md create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_client.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_configuration.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/model_base.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/serialization.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/utils.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_validation.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_version.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_client.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_configuration.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_enums.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/py.typed create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/dev_requirements.txt create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/conftest.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml create mode 100644 sdk/contentunderstanding/ci.yml diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md new file mode 100644 index 000000000000..b957b2575b48 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md @@ -0,0 +1,7 @@ +# Release History + +## 1.0.0b1 (1970-01-01) + +### Other Changes + + - Initial version \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/LICENSE b/sdk/contentunderstanding/azure-ai-contentunderstanding/LICENSE new file mode 100644 index 000000000000..63447fd8bbbf --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/LICENSE @@ -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. \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/MANIFEST.in b/sdk/contentunderstanding/azure-ai-contentunderstanding/MANIFEST.in new file mode 100644 index 000000000000..54679614d27b --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/MANIFEST.in @@ -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 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md new file mode 100644 index 000000000000..ff2efa1c51b6 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -0,0 +1,43 @@ +# Azure AI Content Understanding client library for Python + + +## Getting started + +### Install the package + +```bash +python -m pip install azure-ai-contentunderstanding +``` + +#### Prequisites + +- Python 3.9 or later is required to use this package. +- You need an [Azure subscription][azure_sub] to use this package. +- An existing Azure AI Content Understanding instance. + + +## Contributing + +This project welcomes contributions and suggestions. Most contributions require +you to agree to a Contributor License Agreement (CLA) declaring that you have +the right to, and actually do, grant us the rights to use your contribution. +For details, visit https://cla.microsoft.com. + +When you submit a pull request, a CLA-bot will automatically determine whether +you need to provide a CLA and decorate the PR appropriately (e.g., label, +comment). Simply follow the instructions provided by the bot. You will only +need to do this once across all repos using our CLA. + +This project has adopted the +[Microsoft Open Source Code of Conduct][code_of_conduct]. For more information, +see the Code of Conduct FAQ or contact opencode@microsoft.com with any +additional questions or comments. + + +[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ +[authenticate_with_token]: https://docs.microsoft.com/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-an-authentication-token +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#credentials +[azure_identity_pip]: https://pypi.org/project/azure-identity/ +[default_azure_credential]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#defaultazurecredential +[pip]: https://pypi.org/project/pip/ +[azure_sub]: https://azure.microsoft.com/free/ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json new file mode 100644 index 000000000000..5874c0664350 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json @@ -0,0 +1,7 @@ +{ + "apiVersion": "2025-11-01", + "commit": "57cfe1e680b2521e03e1d8a0955bba0257439dca", + "repository_url": "https://github.com/Azure/azure-rest-api-specs", + "typespec_src": "specification/ai/ContentUnderstanding", + "emitterVersion": "0.53.2" +} \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json new file mode 100644 index 000000000000..203ba5dda0c1 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json @@ -0,0 +1,101 @@ +{ + "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.DetectedPerson": "ContentUnderstanding.DetectedPerson", + "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.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": "ClientCustomizations.ContentUnderstandingClient.copy", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.begin_copy": "ClientCustomizations.ContentUnderstandingClient.copy", + "azure.ai.contentunderstanding.ContentUnderstandingClient.begin_create_or_replace": "ClientCustomizations.ContentUnderstandingClient.createOrReplace", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.begin_create_or_replace": "ClientCustomizations.ContentUnderstandingClient.createOrReplace", + "azure.ai.contentunderstanding.ContentUnderstandingClient.delete": "ClientCustomizations.ContentUnderstandingClient.delete", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.delete": "ClientCustomizations.ContentUnderstandingClient.delete", + "azure.ai.contentunderstanding.ContentUnderstandingClient.delete_result": "ClientCustomizations.ContentUnderstandingClient.deleteResult", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.delete_result": "ClientCustomizations.ContentUnderstandingClient.deleteResult", + "azure.ai.contentunderstanding.ContentUnderstandingClient.get": "ClientCustomizations.ContentUnderstandingClient.get", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.get": "ClientCustomizations.ContentUnderstandingClient.get", + "azure.ai.contentunderstanding.ContentUnderstandingClient.get_defaults": "ClientCustomizations.ContentUnderstandingClient.getDefaults", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.get_defaults": "ClientCustomizations.ContentUnderstandingClient.getDefaults", + "azure.ai.contentunderstanding.ContentUnderstandingClient.get_operation_status": "ClientCustomizations.ContentUnderstandingClient.getOperationStatus", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.get_operation_status": "ClientCustomizations.ContentUnderstandingClient.getOperationStatus", + "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": "ClientCustomizations.ContentUnderstandingClient.list", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.list": "ClientCustomizations.ContentUnderstandingClient.list", + "azure.ai.contentunderstanding.ContentUnderstandingClient.update": "ClientCustomizations.ContentUnderstandingClient.update", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.update": "ClientCustomizations.ContentUnderstandingClient.update", + "azure.ai.contentunderstanding.ContentUnderstandingClient.update_defaults": "ClientCustomizations.ContentUnderstandingClient.updateDefaults", + "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.update_defaults": "ClientCustomizations.ContentUnderstandingClient.updateDefaults" + } +} \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/__init__.py new file mode 100644 index 000000000000..d55ccad1f573 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/__init__.py @@ -0,0 +1 @@ +__path__ = __import__("pkgutil").extend_path(__path__, __name__) # type: ignore diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/__init__.py new file mode 100644 index 000000000000..d55ccad1f573 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/__init__.py @@ -0,0 +1 @@ +__path__ = __import__("pkgutil").extend_path(__path__, __name__) # type: ignore diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/__init__.py new file mode 100644 index 000000000000..9540dad36ca7 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/__init__.py @@ -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() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_client.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_client.py new file mode 100644 index 000000000000..155b5e5bc248 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_client.py @@ -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/") + + >>> response = client.send_request(request) + + + 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) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_configuration.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_configuration.py new file mode 100644 index 000000000000..8e5d5ba15d1b --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_configuration.py @@ -0,0 +1,71 @@ +# 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 typing import Any, TYPE_CHECKING, Union + +from azure.core.credentials import AzureKeyCredential +from azure.core.pipeline import policies + +from ._version import VERSION + +if TYPE_CHECKING: + from azure.core.credentials import TokenCredential + + +class ContentUnderstandingClientConfiguration: # pylint: disable=too-many-instance-attributes + """Configuration for ContentUnderstandingClient. + + Note that all parameters used to create this instance are saved as instance + attributes. + + :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 + """ + + def __init__(self, endpoint: str, credential: Union[AzureKeyCredential, "TokenCredential"], **kwargs: Any) -> None: + api_version: str = kwargs.pop("api_version", "2025-11-01") + + if endpoint is None: + raise ValueError("Parameter 'endpoint' must not be None.") + if credential is None: + raise ValueError("Parameter 'credential' must not be None.") + + self.endpoint = endpoint + self.credential = credential + self.api_version = api_version + self.credential_scopes = kwargs.pop("credential_scopes", ["https://cognitiveservices.azure.com/.default"]) + kwargs.setdefault("sdk_moniker", "ai-contentunderstanding/{}".format(VERSION)) + self.polling_interval = kwargs.get("polling_interval", 30) + self._configure(**kwargs) + + def _infer_policy(self, **kwargs): + if isinstance(self.credential, AzureKeyCredential): + return policies.AzureKeyCredentialPolicy(self.credential, "Ocp-Apim-Subscription-Key", **kwargs) + if hasattr(self.credential, "get_token"): + return policies.BearerTokenCredentialPolicy(self.credential, *self.credential_scopes, **kwargs) + raise TypeError(f"Unsupported credential: {self.credential}") + + def _configure(self, **kwargs: Any) -> None: + self.user_agent_policy = kwargs.get("user_agent_policy") or policies.UserAgentPolicy(**kwargs) + self.headers_policy = kwargs.get("headers_policy") or policies.HeadersPolicy(**kwargs) + self.proxy_policy = kwargs.get("proxy_policy") or policies.ProxyPolicy(**kwargs) + self.logging_policy = kwargs.get("logging_policy") or policies.NetworkTraceLoggingPolicy(**kwargs) + self.http_logging_policy = kwargs.get("http_logging_policy") or policies.HttpLoggingPolicy(**kwargs) + self.custom_hook_policy = kwargs.get("custom_hook_policy") or policies.CustomHookPolicy(**kwargs) + self.redirect_policy = kwargs.get("redirect_policy") or policies.RedirectPolicy(**kwargs) + self.retry_policy = kwargs.get("retry_policy") or policies.RetryPolicy(**kwargs) + self.authentication_policy = kwargs.get("authentication_policy") + if self.credential and not self.authentication_policy: + self.authentication_policy = self._infer_policy(**kwargs) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/__init__.py new file mode 100644 index 000000000000..36e7d1668ee5 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/__init__.py @@ -0,0 +1,23 @@ +# 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 ._operations import _ContentUnderstandingClientOperationsMixin # type: ignore # pylint: disable=unused-import + +from ._patch import __all__ as _patch_all +from ._patch import * +from ._patch import patch_sdk as _patch_sdk + +__all__ = [] +__all__.extend([p for p in _patch_all if p not in __all__]) # pyright: ignore +_patch_sdk() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py new file mode 100644 index 000000000000..b830c2679c36 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py @@ -0,0 +1,2427 @@ +# pylint: disable=too-many-lines +# 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 collections.abc import MutableMapping +from io import IOBase +import json +from typing import Any, Callable, IO, Iterator, Optional, TypeVar, Union, cast, overload +import urllib.parse + +from azure.core import PipelineClient +from azure.core.exceptions import ( + ClientAuthenticationError, + HttpResponseError, + ResourceExistsError, + ResourceNotFoundError, + ResourceNotModifiedError, + StreamClosedError, + StreamConsumedError, + map_error, +) +from azure.core.paging import ItemPaged +from azure.core.pipeline import PipelineResponse +from azure.core.polling import LROPoller, NoPolling, PollingMethod +from azure.core.polling.base_polling import LROBasePolling +from azure.core.rest import HttpRequest, HttpResponse +from azure.core.tracing.decorator import distributed_trace +from azure.core.utils import case_insensitive_dict + +from .. import models as _models +from .._configuration import ContentUnderstandingClientConfiguration +from .._utils.model_base import SdkJSONEncoder, _deserialize +from .._utils.serialization import Serializer +from .._utils.utils import ClientMixinABC +from .._validation import api_version_validation + +JSON = MutableMapping[str, Any] +_Unset: Any = object() +T = TypeVar("T") +ClsType = Optional[Callable[[PipelineResponse[HttpRequest, HttpResponse], T, dict[str, Any]], Any]] +List = list + +_SERIALIZER = Serializer() +_SERIALIZER.client_side_validation = False + + +def build_content_understanding_analyze_request( # pylint: disable=name-too-long + analyzer_id: str, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers/{analyzerId}:analyze" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + if string_encoding is not None: + _params["stringEncoding"] = _SERIALIZER.query("string_encoding", string_encoding, "str") + if processing_location is not None: + _params["processingLocation"] = _SERIALIZER.query("processing_location", processing_location, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_analyze_binary_request( # pylint: disable=name-too-long + analyzer_id: str, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + input_range: Optional[str] = None, + **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + content_type: str = kwargs.pop("content_type") + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers/{analyzerId}:analyzeBinary" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + if string_encoding is not None: + _params["stringEncoding"] = _SERIALIZER.query("string_encoding", string_encoding, "str") + if processing_location is not None: + _params["processingLocation"] = _SERIALIZER.query("processing_location", processing_location, "str") + if input_range is not None: + _params["range"] = _SERIALIZER.query("input_range", input_range, "str") + + # Construct headers + _headers["content-type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_copy_request( + analyzer_id: str, *, allow_replace: Optional[bool] = None, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers/{analyzerId}:copy" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + if allow_replace is not None: + _params["allowReplace"] = _SERIALIZER.query("allow_replace", allow_replace, "bool") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_create_or_replace_request( # pylint: disable=name-too-long + analyzer_id: str, *, allow_replace: Optional[bool] = None, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers/{analyzerId}" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + if allow_replace is not None: + _params["allowReplace"] = _SERIALIZER.query("allow_replace", allow_replace, "bool") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="PUT", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_delete_request( # pylint: disable=name-too-long + analyzer_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + # Construct URL + _url = "/analyzers/{analyzerId}" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + + return HttpRequest(method="DELETE", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_delete_result_request( # pylint: disable=name-too-long + operation_id: str, **kwargs: Any +) -> HttpRequest: + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + # Construct URL + _url = "/analyzerResults/{operationId}" + path_format_arguments = { + "operationId": _SERIALIZER.url("operation_id", operation_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + return HttpRequest(method="DELETE", url=_url, params=_params, **kwargs) + + +def build_content_understanding_get_request(analyzer_id: str, **kwargs: Any) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers/{analyzerId}" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_get_defaults_request(**kwargs: Any) -> HttpRequest: # pylint: disable=name-too-long + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/defaults" + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_get_operation_status_request( # pylint: disable=name-too-long + analyzer_id: str, operation_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers/{analyzerId}/operations/{operationId}" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + "operationId": _SERIALIZER.url("operation_id", operation_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_get_result_request( # pylint: disable=name-too-long + operation_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzerResults/{operationId}" + path_format_arguments = { + "operationId": _SERIALIZER.url("operation_id", operation_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_get_result_file_request( # pylint: disable=name-too-long + operation_id: str, path: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "*/*") + + # Construct URL + _url = "/analyzerResults/{operationId}/files/{path}" + path_format_arguments = { + "operationId": _SERIALIZER.url("operation_id", operation_id, "str"), + "path": _SERIALIZER.url("path", path, "str", skip_quote=True), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_grant_copy_authorization_request( # pylint: disable=name-too-long + analyzer_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers/{analyzerId}:grantCopyAuthorization" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_list_request(**kwargs: Any) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers" + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_update_request( # pylint: disable=name-too-long + analyzer_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/analyzers/{analyzerId}" + path_format_arguments = { + "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="PATCH", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_content_understanding_update_defaults_request(**kwargs: Any) -> HttpRequest: # pylint: disable=name-too-long + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/defaults" + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="PATCH", url=_url, params=_params, headers=_headers, **kwargs) + + +class _ContentUnderstandingClientOperationsMixin( + ClientMixinABC[PipelineClient[HttpRequest, HttpResponse], ContentUnderstandingClientConfiguration] +): + + def _analyze_initial( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + inputs: Optional[List[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any + ) -> Iterator[bytes]: + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[Iterator[bytes]] = kwargs.pop("cls", None) + + if body is _Unset: + body = {"inputs": inputs, "modelDeployments": model_deployments} + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_analyze_request( + analyzer_id=analyzer_id, + string_encoding=string_encoding, + processing_location=processing_location, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [202]: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + def begin_analyze( + self, + analyzer_id: str, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + inputs: Optional[List[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any + ) -> LROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. Default + value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of LROPoller that returns AnalyzeResult. The AnalyzeResult is compatible + with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def begin_analyze( + self, + analyzer_id: str, + body: JSON, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> LROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: JSON + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of LROPoller that returns AnalyzeResult. The AnalyzeResult is compatible + with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def begin_analyze( + self, + analyzer_id: str, + body: IO[bytes], + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> LROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: IO[bytes] + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of LROPoller that returns AnalyzeResult. The AnalyzeResult is compatible + with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + def begin_analyze( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + inputs: Optional[List[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any + ) -> LROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Is either a JSON type or a IO[bytes] type. Required. + :type body: JSON or IO[bytes] + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. Default + value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of LROPoller that returns AnalyzeResult. The AnalyzeResult is compatible + with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.AnalyzeResult] = kwargs.pop("cls", None) + polling: Union[bool, PollingMethod] = kwargs.pop("polling", True) + lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) + cont_token: Optional[str] = kwargs.pop("continuation_token", None) + if cont_token is None: + raw_result = self._analyze_initial( + analyzer_id=analyzer_id, + body=body, + string_encoding=string_encoding, + processing_location=processing_location, + inputs=inputs, + model_deployments=model_deployments, + content_type=content_type, + cls=lambda x, y, z: x, + headers=_headers, + params=_params, + **kwargs + ) + raw_result.http_response.read() # type: ignore + kwargs.pop("error_map", None) + + def get_long_running_output(pipeline_response): + response_headers = {} + response = pipeline_response.http_response + response_headers["Operation-Location"] = self._deserialize( + "str", response.headers.get("Operation-Location") + ) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = _deserialize(_models.AnalyzeResult, response.json().get("result", {})) + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + return deserialized + + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + + if polling is True: + polling_method: PollingMethod = cast( + PollingMethod, LROBasePolling(lro_delay, path_format_arguments=path_format_arguments, **kwargs) + ) + elif polling is False: + polling_method = cast(PollingMethod, NoPolling()) + else: + polling_method = polling + if cont_token: + return LROPoller[_models.AnalyzeResult].from_continuation_token( + polling_method=polling_method, + continuation_token=cont_token, + client=self._client, + deserialization_callback=get_long_running_output, + ) + return LROPoller[_models.AnalyzeResult]( + self._client, raw_result, get_long_running_output, polling_method # type: ignore + ) + + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={ + "2025-11-01": [ + "api_version", + "analyzer_id", + "string_encoding", + "processing_location", + "content_type", + "input_range", + "client_request_id", + "accept", + ] + }, + api_versions_list=["2025-11-01"], + ) + def _analyze_binary_initial( + self, + analyzer_id: str, + binary_input: bytes, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + input_range: Optional[str] = None, + **kwargs: Any + ) -> Iterator[bytes]: + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + content_type: str = kwargs.pop("content_type") + cls: ClsType[Iterator[bytes]] = kwargs.pop("cls", None) + + _content = binary_input + + _request = build_content_understanding_analyze_binary_request( + analyzer_id=analyzer_id, + string_encoding=string_encoding, + processing_location=processing_location, + input_range=input_range, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [202]: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @distributed_trace + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={ + "2025-11-01": [ + "api_version", + "analyzer_id", + "string_encoding", + "processing_location", + "content_type", + "input_range", + "client_request_id", + "accept", + ] + }, + api_versions_list=["2025-11-01"], + ) + def begin_analyze_binary( + self, + analyzer_id: str, + binary_input: bytes, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + input_range: Optional[str] = None, + **kwargs: Any + ) -> LROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param binary_input: The binary content of the document to analyze. Required. + :type binary_input: bytes + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses + 1-based page numbers, while audio visual content uses integer milliseconds. Default value is + None. + :paramtype input_range: str + :return: An instance of LROPoller that returns AnalyzeResult. The AnalyzeResult is compatible + with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + content_type: str = kwargs.pop("content_type") + cls: ClsType[_models.AnalyzeResult] = kwargs.pop("cls", None) + polling: Union[bool, PollingMethod] = kwargs.pop("polling", True) + lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) + cont_token: Optional[str] = kwargs.pop("continuation_token", None) + if cont_token is None: + raw_result = self._analyze_binary_initial( + analyzer_id=analyzer_id, + binary_input=binary_input, + string_encoding=string_encoding, + processing_location=processing_location, + input_range=input_range, + content_type=content_type, + cls=lambda x, y, z: x, + headers=_headers, + params=_params, + **kwargs + ) + raw_result.http_response.read() # type: ignore + kwargs.pop("error_map", None) + + def get_long_running_output(pipeline_response): + response_headers = {} + response = pipeline_response.http_response + response_headers["Operation-Location"] = self._deserialize( + "str", response.headers.get("Operation-Location") + ) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = _deserialize(_models.AnalyzeResult, response.json().get("result", {})) + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + return deserialized + + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + + if polling is True: + polling_method: PollingMethod = cast( + PollingMethod, LROBasePolling(lro_delay, path_format_arguments=path_format_arguments, **kwargs) + ) + elif polling is False: + polling_method = cast(PollingMethod, NoPolling()) + else: + polling_method = polling + if cont_token: + return LROPoller[_models.AnalyzeResult].from_continuation_token( + polling_method=polling_method, + continuation_token=cont_token, + client=self._client, + deserialization_callback=get_long_running_output, + ) + return LROPoller[_models.AnalyzeResult]( + self._client, raw_result, get_long_running_output, polling_method # type: ignore + ) + + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={ + "2025-11-01": ["api_version", "analyzer_id", "allow_replace", "client_request_id", "content_type", "accept"] + }, + api_versions_list=["2025-11-01"], + ) + def _copy_initial( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + source_analyzer_id: str = _Unset, + allow_replace: Optional[bool] = None, + source_azure_resource_id: Optional[str] = None, + source_region: Optional[str] = None, + **kwargs: Any + ) -> Iterator[bytes]: + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[Iterator[bytes]] = kwargs.pop("cls", None) + + if body is _Unset: + if source_analyzer_id is _Unset: + raise TypeError("missing required argument: source_analyzer_id") + body = { + "sourceAnalyzerId": source_analyzer_id, + "sourceAzureResourceId": source_azure_resource_id, + "sourceRegion": source_region, + } + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_copy_request( + analyzer_id=analyzer_id, + allow_replace=allow_replace, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [202]: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + def begin_copy( + self, + analyzer_id: str, + *, + source_analyzer_id: str, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + source_azure_resource_id: Optional[str] = None, + source_region: Optional[str] = None, + **kwargs: Any + ) -> LROPoller[_models.ContentAnalyzer]: + """Create a copy of the source analyzer to the current location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword source_analyzer_id: Source analyzer ID. Required. + :paramtype source_analyzer_id: str + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword source_azure_resource_id: Azure resource ID of the source analyzer location. Defaults + to the current resource. Default value is None. + :paramtype source_azure_resource_id: str + :keyword source_region: Azure region of the source analyzer location. Defaults to current + region. Default value is None. + :paramtype source_region: str + :return: An instance of LROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def begin_copy( + self, + analyzer_id: str, + body: JSON, + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> LROPoller[_models.ContentAnalyzer]: + """Create a copy of the source analyzer to the current location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: JSON + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of LROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def begin_copy( + self, + analyzer_id: str, + body: IO[bytes], + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> LROPoller[_models.ContentAnalyzer]: + """Create a copy of the source analyzer to the current location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: IO[bytes] + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of LROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={ + "2025-11-01": ["api_version", "analyzer_id", "allow_replace", "client_request_id", "content_type", "accept"] + }, + api_versions_list=["2025-11-01"], + ) + def begin_copy( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + source_analyzer_id: str = _Unset, + allow_replace: Optional[bool] = None, + source_azure_resource_id: Optional[str] = None, + source_region: Optional[str] = None, + **kwargs: Any + ) -> LROPoller[_models.ContentAnalyzer]: + """Create a copy of the source analyzer to the current location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Is either a JSON type or a IO[bytes] type. Required. + :type body: JSON or IO[bytes] + :keyword source_analyzer_id: Source analyzer ID. Required. + :paramtype source_analyzer_id: str + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword source_azure_resource_id: Azure resource ID of the source analyzer location. Defaults + to the current resource. Default value is None. + :paramtype source_azure_resource_id: str + :keyword source_region: Azure region of the source analyzer location. Defaults to current + region. Default value is None. + :paramtype source_region: str + :return: An instance of LROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) + polling: Union[bool, PollingMethod] = kwargs.pop("polling", True) + lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) + cont_token: Optional[str] = kwargs.pop("continuation_token", None) + if cont_token is None: + raw_result = self._copy_initial( + analyzer_id=analyzer_id, + body=body, + source_analyzer_id=source_analyzer_id, + allow_replace=allow_replace, + source_azure_resource_id=source_azure_resource_id, + source_region=source_region, + content_type=content_type, + cls=lambda x, y, z: x, + headers=_headers, + params=_params, + **kwargs + ) + raw_result.http_response.read() # type: ignore + kwargs.pop("error_map", None) + + def get_long_running_output(pipeline_response): + response_headers = {} + response = pipeline_response.http_response + response_headers["Operation-Location"] = self._deserialize( + "str", response.headers.get("Operation-Location") + ) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = _deserialize(_models.ContentAnalyzer, response.json().get("result", {})) + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + return deserialized + + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + + if polling is True: + polling_method: PollingMethod = cast( + PollingMethod, LROBasePolling(lro_delay, path_format_arguments=path_format_arguments, **kwargs) + ) + elif polling is False: + polling_method = cast(PollingMethod, NoPolling()) + else: + polling_method = polling + if cont_token: + return LROPoller[_models.ContentAnalyzer].from_continuation_token( + polling_method=polling_method, + continuation_token=cont_token, + client=self._client, + deserialization_callback=get_long_running_output, + ) + return LROPoller[_models.ContentAnalyzer]( + self._client, raw_result, get_long_running_output, polling_method # type: ignore + ) + + @api_version_validation( + params_added_on={"2025-11-01": ["allow_replace"]}, + api_versions_list=["2025-05-01-preview", "2025-11-01"], + ) + def _create_or_replace_initial( + self, + analyzer_id: str, + resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], + *, + allow_replace: Optional[bool] = None, + **kwargs: Any + ) -> Iterator[bytes]: + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[Iterator[bytes]] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(resource, (IOBase, bytes)): + _content = resource + else: + _content = json.dumps(resource, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_create_or_replace_request( + analyzer_id=analyzer_id, + allow_replace=allow_replace, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200, 201]: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + def begin_create_or_replace( + self, + analyzer_id: str, + resource: _models.ContentAnalyzer, + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> LROPoller[_models.ContentAnalyzer]: + """Create a new analyzer asynchronously. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of LROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def begin_create_or_replace( + self, + analyzer_id: str, + resource: JSON, + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> LROPoller[_models.ContentAnalyzer]: + """Create a new analyzer asynchronously. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: JSON + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of LROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def begin_create_or_replace( + self, + analyzer_id: str, + resource: IO[bytes], + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> LROPoller[_models.ContentAnalyzer]: + """Create a new analyzer asynchronously. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: IO[bytes] + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of LROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + @api_version_validation( + params_added_on={"2025-11-01": ["allow_replace"]}, + api_versions_list=["2025-05-01-preview", "2025-11-01"], + ) + def begin_create_or_replace( + self, + analyzer_id: str, + resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], + *, + allow_replace: Optional[bool] = None, + **kwargs: Any + ) -> LROPoller[_models.ContentAnalyzer]: + """Create a new analyzer asynchronously. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Is one of the following types: ContentAnalyzer, JSON, + IO[bytes] Required. + :type resource: ~azure.ai.contentunderstanding.models.ContentAnalyzer or JSON or IO[bytes] + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :return: An instance of LROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) + polling: Union[bool, PollingMethod] = kwargs.pop("polling", True) + lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) + cont_token: Optional[str] = kwargs.pop("continuation_token", None) + if cont_token is None: + raw_result = self._create_or_replace_initial( + analyzer_id=analyzer_id, + resource=resource, + allow_replace=allow_replace, + content_type=content_type, + cls=lambda x, y, z: x, + headers=_headers, + params=_params, + **kwargs + ) + raw_result.http_response.read() # type: ignore + kwargs.pop("error_map", None) + + def get_long_running_output(pipeline_response): + response_headers = {} + response = pipeline_response.http_response + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + response_headers["Operation-Location"] = self._deserialize( + "str", response.headers.get("Operation-Location") + ) + + deserialized = _deserialize(_models.ContentAnalyzer, response.json().get("result", {})) + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + return deserialized + + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + + if polling is True: + polling_method: PollingMethod = cast( + PollingMethod, LROBasePolling(lro_delay, path_format_arguments=path_format_arguments, **kwargs) + ) + elif polling is False: + polling_method = cast(PollingMethod, NoPolling()) + else: + polling_method = polling + if cont_token: + return LROPoller[_models.ContentAnalyzer].from_continuation_token( + polling_method=polling_method, + continuation_token=cont_token, + client=self._client, + deserialization_callback=get_long_running_output, + ) + return LROPoller[_models.ContentAnalyzer]( + self._client, raw_result, get_long_running_output, polling_method # type: ignore + ) + + @distributed_trace + def delete(self, analyzer_id: str, **kwargs: Any) -> None: # pylint: disable=inconsistent-return-statements + """Delete analyzer. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :return: None + :rtype: None + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[None] = kwargs.pop("cls", None) + + _request = build_content_understanding_delete_request( + analyzer_id=analyzer_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = False + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [204]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + if cls: + return cls(pipeline_response, None, response_headers) # type: ignore + + @distributed_trace + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={"2025-11-01": ["api_version", "operation_id"]}, + api_versions_list=["2025-11-01"], + ) + def delete_result(self, operation_id: str, **kwargs: Any) -> None: # pylint: disable=inconsistent-return-statements + """Mark the result of an analysis operation for deletion. + + :param operation_id: Operation identifier. Required. + :type operation_id: str + :return: None + :rtype: None + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[None] = kwargs.pop("cls", None) + + _request = build_content_understanding_delete_result_request( + operation_id=operation_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = False + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [204]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if cls: + return cls(pipeline_response, None, {}) # type: ignore + + @distributed_trace + def get(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyzer: + """Get analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_request( + analyzer_id=analyzer_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentAnalyzer, response.json()) + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @distributed_trace + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={"2025-11-01": ["api_version", "accept"]}, + api_versions_list=["2025-11-01"], + ) + def get_defaults(self, **kwargs: Any) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[_models.ContentUnderstandingDefaults] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_defaults_request( + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentUnderstandingDefaults, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @distributed_trace + def get_operation_status( + self, analyzer_id: str, operation_id: str, **kwargs: Any + ) -> _models.ContentAnalyzerOperationStatus: + """Get the status of an analyzer creation operation. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param operation_id: The unique ID of the operation. Required. + :type operation_id: str + :return: ContentAnalyzerOperationStatus. The ContentAnalyzerOperationStatus is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzerOperationStatus + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[_models.ContentAnalyzerOperationStatus] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_operation_status_request( + analyzer_id=analyzer_id, + operation_id=operation_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentAnalyzerOperationStatus, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @distributed_trace + def _get_result(self, operation_id: str, **kwargs: Any) -> _models.ContentAnalyzerAnalyzeOperationStatus: + """Get the result of an analysis operation. + + :param operation_id: The unique ID of the operation. Required. + :type operation_id: str + :return: ContentAnalyzerAnalyzeOperationStatus. The ContentAnalyzerAnalyzeOperationStatus is + compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzerAnalyzeOperationStatus + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[_models.ContentAnalyzerAnalyzeOperationStatus] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_result_request( + operation_id=operation_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentAnalyzerAnalyzeOperationStatus, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @distributed_trace + def get_result_file(self, operation_id: str, path: str, **kwargs: Any) -> Iterator[bytes]: + """Get a file associated with the result of an analysis operation. + + :param operation_id: Operation identifier. Required. + :type operation_id: str + :param path: File path. Required. + :type path: str + :return: Iterator[bytes] + :rtype: Iterator[bytes] + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[Iterator[bytes]] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_result_file_request( + operation_id=operation_id, + path=path, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", True) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["content-type"] = self._deserialize("str", response.headers.get("content-type")) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + def grant_copy_authorization( + self, + analyzer_id: str, + *, + target_azure_resource_id: str, + content_type: str = "application/json", + target_region: Optional[str] = None, + **kwargs: Any + ) -> _models.CopyAuthorization: + """Get authorization for copying this analyzer to another location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword target_azure_resource_id: Azure resource ID of the target analyzer location. Required. + :paramtype target_azure_resource_id: str + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword target_region: Azure region of the target analyzer location. Defaults to current + region. Default value is None. + :paramtype target_region: str + :return: CopyAuthorization. The CopyAuthorization is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.CopyAuthorization + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def grant_copy_authorization( + self, analyzer_id: str, body: JSON, *, content_type: str = "application/json", **kwargs: Any + ) -> _models.CopyAuthorization: + """Get authorization for copying this analyzer to another location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: CopyAuthorization. The CopyAuthorization is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.CopyAuthorization + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def grant_copy_authorization( + self, analyzer_id: str, body: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> _models.CopyAuthorization: + """Get authorization for copying this analyzer to another location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: CopyAuthorization. The CopyAuthorization is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.CopyAuthorization + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={"2025-11-01": ["api_version", "analyzer_id", "client_request_id", "content_type", "accept"]}, + api_versions_list=["2025-11-01"], + ) + def grant_copy_authorization( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + target_azure_resource_id: str = _Unset, + target_region: Optional[str] = None, + **kwargs: Any + ) -> _models.CopyAuthorization: + """Get authorization for copying this analyzer to another location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Is either a JSON type or a IO[bytes] type. Required. + :type body: JSON or IO[bytes] + :keyword target_azure_resource_id: Azure resource ID of the target analyzer location. Required. + :paramtype target_azure_resource_id: str + :keyword target_region: Azure region of the target analyzer location. Defaults to current + region. Default value is None. + :paramtype target_region: str + :return: CopyAuthorization. The CopyAuthorization is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.CopyAuthorization + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.CopyAuthorization] = kwargs.pop("cls", None) + + if body is _Unset: + if target_azure_resource_id is _Unset: + raise TypeError("missing required argument: target_azure_resource_id") + body = {"targetAzureResourceId": target_azure_resource_id, "targetRegion": target_region} + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_grant_copy_authorization_request( + analyzer_id=analyzer_id, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.CopyAuthorization, response.json()) + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @distributed_trace + def list(self, **kwargs: Any) -> ItemPaged["_models.ContentAnalyzer"]: + """List analyzers. + + :return: An iterator like instance of ContentAnalyzer + :rtype: ~azure.core.paging.ItemPaged[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[List[_models.ContentAnalyzer]] = kwargs.pop("cls", None) + + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + def prepare_request(next_link=None): + if not next_link: + + _request = build_content_understanding_list_request( + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.endpoint", self._config.endpoint, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + else: + # make call to next link with the client's api-version + _parsed_next_link = urllib.parse.urlparse(next_link) + _next_request_params = case_insensitive_dict( + { + key: [urllib.parse.quote(v) for v in value] + for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items() + } + ) + _next_request_params["api-version"] = self._config.api_version + _request = HttpRequest( + "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params + ) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.endpoint", self._config.endpoint, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + return _request + + def extract_data(pipeline_response): + deserialized = pipeline_response.http_response.json() + list_of_elem = _deserialize(List[_models.ContentAnalyzer], deserialized.get("value", [])) + if cls: + list_of_elem = cls(list_of_elem) # type: ignore + return deserialized.get("nextLink") or None, iter(list_of_elem) + + def get_next(next_link=None): + _request = prepare_request(next_link) + + _stream = False + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + response = pipeline_response.http_response + + if response.status_code not in [200]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + return pipeline_response + + return ItemPaged(get_next, extract_data) + + @overload + def update( + self, + analyzer_id: str, + resource: _models.ContentAnalyzer, + *, + content_type: str = "application/merge-patch+json", + **kwargs: Any + ) -> _models.ContentAnalyzer: + """Update analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def update( + self, analyzer_id: str, resource: JSON, *, content_type: str = "application/merge-patch+json", **kwargs: Any + ) -> _models.ContentAnalyzer: + """Update analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def update( + self, + analyzer_id: str, + resource: IO[bytes], + *, + content_type: str = "application/merge-patch+json", + **kwargs: Any + ) -> _models.ContentAnalyzer: + """Update analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + def update( + self, analyzer_id: str, resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], **kwargs: Any + ) -> _models.ContentAnalyzer: + """Update analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Is one of the following types: ContentAnalyzer, JSON, + IO[bytes] Required. + :type resource: ~azure.ai.contentunderstanding.models.ContentAnalyzer or JSON or IO[bytes] + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) + + content_type = content_type or "application/merge-patch+json" + _content = None + if isinstance(resource, (IOBase, bytes)): + _content = resource + else: + _content = json.dumps(resource, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_update_request( + analyzer_id=analyzer_id, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentAnalyzer, response.json()) + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + def update_defaults( + self, + *, + content_type: str = "application/merge-patch+json", + model_deployments: Optional[_models.RecordMergePatchUpdate] = None, + **kwargs: Any + ) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :keyword model_deployments: Mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: ~azure.ai.contentunderstanding.models.RecordMergePatchUpdate + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def update_defaults( + self, body: JSON, *, content_type: str = "application/merge-patch+json", **kwargs: Any + ) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :param body: Required. + :type body: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def update_defaults( + self, body: IO[bytes], *, content_type: str = "application/merge-patch+json", **kwargs: Any + ) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :param body: Required. + :type body: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={"2025-11-01": ["api_version", "content_type", "accept"]}, + api_versions_list=["2025-11-01"], + ) + def update_defaults( + self, + body: Union[JSON, IO[bytes]] = _Unset, + *, + model_deployments: Optional[_models.RecordMergePatchUpdate] = None, + **kwargs: Any + ) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :param body: Is either a JSON type or a IO[bytes] type. Required. + :type body: JSON or IO[bytes] + :keyword model_deployments: Mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: ~azure.ai.contentunderstanding.models.RecordMergePatchUpdate + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ContentUnderstandingDefaults] = kwargs.pop("cls", None) + + if body is _Unset: + body = {"modelDeployments": model_deployments} + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/merge-patch+json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_update_defaults_request( + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentUnderstandingDefaults, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py new file mode 100644 index 000000000000..87676c65a8f0 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -0,0 +1,21 @@ +# 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. +# -------------------------------------------------------------------------- +"""Customize generated code here. + +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +""" + + +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level + + +def patch_sdk(): + """Do not remove from this file. + + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize + """ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py new file mode 100644 index 000000000000..87676c65a8f0 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py @@ -0,0 +1,21 @@ +# 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. +# -------------------------------------------------------------------------- +"""Customize generated code here. + +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +""" + + +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level + + +def patch_sdk(): + """Do not remove from this file. + + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize + """ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/__init__.py new file mode 100644 index 000000000000..8026245c2abc --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/__init__.py @@ -0,0 +1,6 @@ +# -------------------------------------------------------------------------- +# 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. +# -------------------------------------------------------------------------- diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/model_base.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/model_base.py new file mode 100644 index 000000000000..12926fa98dcf --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/model_base.py @@ -0,0 +1,1237 @@ +# pylint: disable=line-too-long,useless-suppression,too-many-lines +# 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=protected-access, broad-except + +import copy +import calendar +import decimal +import functools +import sys +import logging +import base64 +import re +import typing +import enum +import email.utils +from datetime import datetime, date, time, timedelta, timezone +from json import JSONEncoder +import xml.etree.ElementTree as ET +from collections.abc import MutableMapping +from typing_extensions import Self +import isodate +from azure.core.exceptions import DeserializationError +from azure.core import CaseInsensitiveEnumMeta +from azure.core.pipeline import PipelineResponse +from azure.core.serialization import _Null +from azure.core.rest import HttpResponse + +_LOGGER = logging.getLogger(__name__) + +__all__ = ["SdkJSONEncoder", "Model", "rest_field", "rest_discriminator"] + +TZ_UTC = timezone.utc +_T = typing.TypeVar("_T") + + +def _timedelta_as_isostr(td: timedelta) -> str: + """Converts a datetime.timedelta object into an ISO 8601 formatted string, e.g. 'P4DT12H30M05S' + + Function adapted from the Tin Can Python project: https://github.com/RusticiSoftware/TinCanPython + + :param timedelta td: The timedelta to convert + :rtype: str + :return: ISO8601 version of this timedelta + """ + + # Split seconds to larger units + seconds = td.total_seconds() + minutes, seconds = divmod(seconds, 60) + hours, minutes = divmod(minutes, 60) + days, hours = divmod(hours, 24) + + days, hours, minutes = list(map(int, (days, hours, minutes))) + seconds = round(seconds, 6) + + # Build date + date_str = "" + if days: + date_str = "%sD" % days + + if hours or minutes or seconds: + # Build time + time_str = "T" + + # Hours + bigger_exists = date_str or hours + if bigger_exists: + time_str += "{:02}H".format(hours) + + # Minutes + bigger_exists = bigger_exists or minutes + if bigger_exists: + time_str += "{:02}M".format(minutes) + + # Seconds + try: + if seconds.is_integer(): + seconds_string = "{:02}".format(int(seconds)) + else: + # 9 chars long w/ leading 0, 6 digits after decimal + seconds_string = "%09.6f" % seconds + # Remove trailing zeros + seconds_string = seconds_string.rstrip("0") + except AttributeError: # int.is_integer() raises + seconds_string = "{:02}".format(seconds) + + time_str += "{}S".format(seconds_string) + else: + time_str = "" + + return "P" + date_str + time_str + + +def _serialize_bytes(o, format: typing.Optional[str] = None) -> str: + encoded = base64.b64encode(o).decode() + if format == "base64url": + return encoded.strip("=").replace("+", "-").replace("/", "_") + return encoded + + +def _serialize_datetime(o, format: typing.Optional[str] = None): + if hasattr(o, "year") and hasattr(o, "hour"): + if format == "rfc7231": + return email.utils.format_datetime(o, usegmt=True) + if format == "unix-timestamp": + return int(calendar.timegm(o.utctimetuple())) + + # astimezone() fails for naive times in Python 2.7, so make make sure o is aware (tzinfo is set) + if not o.tzinfo: + iso_formatted = o.replace(tzinfo=TZ_UTC).isoformat() + else: + iso_formatted = o.astimezone(TZ_UTC).isoformat() + # Replace the trailing "+00:00" UTC offset with "Z" (RFC 3339: https://www.ietf.org/rfc/rfc3339.txt) + return iso_formatted.replace("+00:00", "Z") + # Next try datetime.date or datetime.time + return o.isoformat() + + +def _is_readonly(p): + try: + return p._visibility == ["read"] + except AttributeError: + return False + + +class SdkJSONEncoder(JSONEncoder): + """A JSON encoder that's capable of serializing datetime objects and bytes.""" + + def __init__(self, *args, exclude_readonly: bool = False, format: typing.Optional[str] = None, **kwargs): + super().__init__(*args, **kwargs) + self.exclude_readonly = exclude_readonly + self.format = format + + def default(self, o): # pylint: disable=too-many-return-statements + if _is_model(o): + if self.exclude_readonly: + readonly_props = [p._rest_name for p in o._attr_to_rest_field.values() if _is_readonly(p)] + return {k: v for k, v in o.items() if k not in readonly_props} + return dict(o.items()) + try: + return super(SdkJSONEncoder, self).default(o) + except TypeError: + if isinstance(o, _Null): + return None + if isinstance(o, decimal.Decimal): + return float(o) + if isinstance(o, (bytes, bytearray)): + return _serialize_bytes(o, self.format) + try: + # First try datetime.datetime + return _serialize_datetime(o, self.format) + except AttributeError: + pass + # Last, try datetime.timedelta + try: + return _timedelta_as_isostr(o) + except AttributeError: + # This will be raised when it hits value.total_seconds in the method above + pass + return super(SdkJSONEncoder, self).default(o) + + +_VALID_DATE = re.compile(r"\d{4}[-]\d{2}[-]\d{2}T\d{2}:\d{2}:\d{2}" + r"\.?\d*Z?[-+]?[\d{2}]?:?[\d{2}]?") +_VALID_RFC7231 = re.compile( + r"(Mon|Tue|Wed|Thu|Fri|Sat|Sun),\s\d{2}\s" + r"(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s\d{4}\s\d{2}:\d{2}:\d{2}\sGMT" +) + + +def _deserialize_datetime(attr: typing.Union[str, datetime]) -> datetime: + """Deserialize ISO-8601 formatted string into Datetime object. + + :param str attr: response string to be deserialized. + :rtype: ~datetime.datetime + :returns: The datetime object from that input + """ + if isinstance(attr, datetime): + # i'm already deserialized + return attr + attr = attr.upper() + match = _VALID_DATE.match(attr) + if not match: + raise ValueError("Invalid datetime string: " + attr) + + check_decimal = attr.split(".") + if len(check_decimal) > 1: + decimal_str = "" + for digit in check_decimal[1]: + if digit.isdigit(): + decimal_str += digit + else: + break + if len(decimal_str) > 6: + attr = attr.replace(decimal_str, decimal_str[0:6]) + + date_obj = isodate.parse_datetime(attr) + test_utc = date_obj.utctimetuple() + if test_utc.tm_year > 9999 or test_utc.tm_year < 1: + raise OverflowError("Hit max or min date") + return date_obj + + +def _deserialize_datetime_rfc7231(attr: typing.Union[str, datetime]) -> datetime: + """Deserialize RFC7231 formatted string into Datetime object. + + :param str attr: response string to be deserialized. + :rtype: ~datetime.datetime + :returns: The datetime object from that input + """ + if isinstance(attr, datetime): + # i'm already deserialized + return attr + match = _VALID_RFC7231.match(attr) + if not match: + raise ValueError("Invalid datetime string: " + attr) + + return email.utils.parsedate_to_datetime(attr) + + +def _deserialize_datetime_unix_timestamp(attr: typing.Union[float, datetime]) -> datetime: + """Deserialize unix timestamp into Datetime object. + + :param str attr: response string to be deserialized. + :rtype: ~datetime.datetime + :returns: The datetime object from that input + """ + if isinstance(attr, datetime): + # i'm already deserialized + return attr + return datetime.fromtimestamp(attr, TZ_UTC) + + +def _deserialize_date(attr: typing.Union[str, date]) -> date: + """Deserialize ISO-8601 formatted string into Date object. + :param str attr: response string to be deserialized. + :rtype: date + :returns: The date object from that input + """ + # This must NOT use defaultmonth/defaultday. Using None ensure this raises an exception. + if isinstance(attr, date): + return attr + return isodate.parse_date(attr, defaultmonth=None, defaultday=None) # type: ignore + + +def _deserialize_time(attr: typing.Union[str, time]) -> time: + """Deserialize ISO-8601 formatted string into time object. + + :param str attr: response string to be deserialized. + :rtype: datetime.time + :returns: The time object from that input + """ + if isinstance(attr, time): + return attr + return isodate.parse_time(attr) + + +def _deserialize_bytes(attr): + if isinstance(attr, (bytes, bytearray)): + return attr + return bytes(base64.b64decode(attr)) + + +def _deserialize_bytes_base64(attr): + if isinstance(attr, (bytes, bytearray)): + return attr + padding = "=" * (3 - (len(attr) + 3) % 4) # type: ignore + attr = attr + padding # type: ignore + encoded = attr.replace("-", "+").replace("_", "/") + return bytes(base64.b64decode(encoded)) + + +def _deserialize_duration(attr): + if isinstance(attr, timedelta): + return attr + return isodate.parse_duration(attr) + + +def _deserialize_decimal(attr): + if isinstance(attr, decimal.Decimal): + return attr + return decimal.Decimal(str(attr)) + + +def _deserialize_int_as_str(attr): + if isinstance(attr, int): + return attr + return int(attr) + + +_DESERIALIZE_MAPPING = { + datetime: _deserialize_datetime, + date: _deserialize_date, + time: _deserialize_time, + bytes: _deserialize_bytes, + bytearray: _deserialize_bytes, + timedelta: _deserialize_duration, + typing.Any: lambda x: x, + decimal.Decimal: _deserialize_decimal, +} + +_DESERIALIZE_MAPPING_WITHFORMAT = { + "rfc3339": _deserialize_datetime, + "rfc7231": _deserialize_datetime_rfc7231, + "unix-timestamp": _deserialize_datetime_unix_timestamp, + "base64": _deserialize_bytes, + "base64url": _deserialize_bytes_base64, +} + + +def get_deserializer(annotation: typing.Any, rf: typing.Optional["_RestField"] = None): + if annotation is int and rf and rf._format == "str": + return _deserialize_int_as_str + if rf and rf._format: + return _DESERIALIZE_MAPPING_WITHFORMAT.get(rf._format) + return _DESERIALIZE_MAPPING.get(annotation) # pyright: ignore + + +def _get_type_alias_type(module_name: str, alias_name: str): + types = { + k: v + for k, v in sys.modules[module_name].__dict__.items() + if isinstance(v, typing._GenericAlias) # type: ignore + } + if alias_name not in types: + return alias_name + return types[alias_name] + + +def _get_model(module_name: str, model_name: str): + models = {k: v for k, v in sys.modules[module_name].__dict__.items() if isinstance(v, type)} + module_end = module_name.rsplit(".", 1)[0] + models.update({k: v for k, v in sys.modules[module_end].__dict__.items() if isinstance(v, type)}) + if isinstance(model_name, str): + model_name = model_name.split(".")[-1] + if model_name not in models: + return model_name + return models[model_name] + + +_UNSET = object() + + +class _MyMutableMapping(MutableMapping[str, typing.Any]): + def __init__(self, data: dict[str, typing.Any]) -> None: + self._data = data + + def __contains__(self, key: typing.Any) -> bool: + return key in self._data + + def __getitem__(self, key: str) -> typing.Any: + return self._data.__getitem__(key) + + def __setitem__(self, key: str, value: typing.Any) -> None: + self._data.__setitem__(key, value) + + def __delitem__(self, key: str) -> None: + self._data.__delitem__(key) + + def __iter__(self) -> typing.Iterator[typing.Any]: + return self._data.__iter__() + + def __len__(self) -> int: + return self._data.__len__() + + def __ne__(self, other: typing.Any) -> bool: + return not self.__eq__(other) + + def keys(self) -> typing.KeysView[str]: + """ + :returns: a set-like object providing a view on D's keys + :rtype: ~typing.KeysView + """ + return self._data.keys() + + def values(self) -> typing.ValuesView[typing.Any]: + """ + :returns: an object providing a view on D's values + :rtype: ~typing.ValuesView + """ + return self._data.values() + + def items(self) -> typing.ItemsView[str, typing.Any]: + """ + :returns: set-like object providing a view on D's items + :rtype: ~typing.ItemsView + """ + return self._data.items() + + def get(self, key: str, default: typing.Any = None) -> typing.Any: + """ + Get the value for key if key is in the dictionary, else default. + :param str key: The key to look up. + :param any default: The value to return if key is not in the dictionary. Defaults to None + :returns: D[k] if k in D, else d. + :rtype: any + """ + try: + return self[key] + except KeyError: + return default + + @typing.overload + def pop(self, key: str) -> typing.Any: ... # pylint: disable=arguments-differ + + @typing.overload + def pop(self, key: str, default: _T) -> _T: ... # pylint: disable=signature-differs + + @typing.overload + def pop(self, key: str, default: typing.Any) -> typing.Any: ... # pylint: disable=signature-differs + + def pop(self, key: str, default: typing.Any = _UNSET) -> typing.Any: + """ + Removes specified key and return the corresponding value. + :param str key: The key to pop. + :param any default: The value to return if key is not in the dictionary + :returns: The value corresponding to the key. + :rtype: any + :raises KeyError: If key is not found and default is not given. + """ + if default is _UNSET: + return self._data.pop(key) + return self._data.pop(key, default) + + def popitem(self) -> tuple[str, typing.Any]: + """ + Removes and returns some (key, value) pair + :returns: The (key, value) pair. + :rtype: tuple + :raises KeyError: if D is empty. + """ + return self._data.popitem() + + def clear(self) -> None: + """ + Remove all items from D. + """ + self._data.clear() + + def update(self, *args: typing.Any, **kwargs: typing.Any) -> None: # pylint: disable=arguments-differ + """ + Updates D from mapping/iterable E and F. + :param any args: Either a mapping object or an iterable of key-value pairs. + """ + self._data.update(*args, **kwargs) + + @typing.overload + def setdefault(self, key: str, default: None = None) -> None: ... + + @typing.overload + def setdefault(self, key: str, default: typing.Any) -> typing.Any: ... # pylint: disable=signature-differs + + def setdefault(self, key: str, default: typing.Any = _UNSET) -> typing.Any: + """ + Same as calling D.get(k, d), and setting D[k]=d if k not found + :param str key: The key to look up. + :param any default: The value to set if key is not in the dictionary + :returns: D[k] if k in D, else d. + :rtype: any + """ + if default is _UNSET: + return self._data.setdefault(key) + return self._data.setdefault(key, default) + + def __eq__(self, other: typing.Any) -> bool: + try: + other_model = self.__class__(other) + except Exception: + return False + return self._data == other_model._data + + def __repr__(self) -> str: + return str(self._data) + + +def _is_model(obj: typing.Any) -> bool: + return getattr(obj, "_is_model", False) + + +def _serialize(o, format: typing.Optional[str] = None): # pylint: disable=too-many-return-statements + if isinstance(o, list): + return [_serialize(x, format) for x in o] + if isinstance(o, dict): + return {k: _serialize(v, format) for k, v in o.items()} + if isinstance(o, set): + return {_serialize(x, format) for x in o} + if isinstance(o, tuple): + return tuple(_serialize(x, format) for x in o) + if isinstance(o, (bytes, bytearray)): + return _serialize_bytes(o, format) + if isinstance(o, decimal.Decimal): + return float(o) + if isinstance(o, enum.Enum): + return o.value + if isinstance(o, int): + if format == "str": + return str(o) + return o + try: + # First try datetime.datetime + return _serialize_datetime(o, format) + except AttributeError: + pass + # Last, try datetime.timedelta + try: + return _timedelta_as_isostr(o) + except AttributeError: + # This will be raised when it hits value.total_seconds in the method above + pass + return o + + +def _get_rest_field(attr_to_rest_field: dict[str, "_RestField"], rest_name: str) -> typing.Optional["_RestField"]: + try: + return next(rf for rf in attr_to_rest_field.values() if rf._rest_name == rest_name) + except StopIteration: + return None + + +def _create_value(rf: typing.Optional["_RestField"], value: typing.Any) -> typing.Any: + if not rf: + return _serialize(value, None) + if rf._is_multipart_file_input: + return value + if rf._is_model: + return _deserialize(rf._type, value) + if isinstance(value, ET.Element): + value = _deserialize(rf._type, value) + return _serialize(value, rf._format) + + +class Model(_MyMutableMapping): + _is_model = True + # label whether current class's _attr_to_rest_field has been calculated + # could not see _attr_to_rest_field directly because subclass inherits it from parent class + _calculated: set[str] = set() + + def __init__(self, *args: typing.Any, **kwargs: typing.Any) -> None: + class_name = self.__class__.__name__ + if len(args) > 1: + raise TypeError(f"{class_name}.__init__() takes 2 positional arguments but {len(args) + 1} were given") + dict_to_pass = { + rest_field._rest_name: rest_field._default + for rest_field in self._attr_to_rest_field.values() + if rest_field._default is not _UNSET + } + if args: # pylint: disable=too-many-nested-blocks + if isinstance(args[0], ET.Element): + existed_attr_keys = [] + model_meta = getattr(self, "_xml", {}) + + for rf in self._attr_to_rest_field.values(): + prop_meta = getattr(rf, "_xml", {}) + xml_name = prop_meta.get("name", rf._rest_name) + xml_ns = prop_meta.get("ns", model_meta.get("ns", None)) + if xml_ns: + xml_name = "{" + xml_ns + "}" + xml_name + + # attribute + if prop_meta.get("attribute", False) and args[0].get(xml_name) is not None: + existed_attr_keys.append(xml_name) + dict_to_pass[rf._rest_name] = _deserialize(rf._type, args[0].get(xml_name)) + continue + + # unwrapped element is array + if prop_meta.get("unwrapped", False): + # unwrapped array could either use prop items meta/prop meta + if prop_meta.get("itemsName"): + xml_name = prop_meta.get("itemsName") + xml_ns = prop_meta.get("itemNs") + if xml_ns: + xml_name = "{" + xml_ns + "}" + xml_name + items = args[0].findall(xml_name) # pyright: ignore + if len(items) > 0: + existed_attr_keys.append(xml_name) + dict_to_pass[rf._rest_name] = _deserialize(rf._type, items) + continue + + # text element is primitive type + if prop_meta.get("text", False): + if args[0].text is not None: + dict_to_pass[rf._rest_name] = _deserialize(rf._type, args[0].text) + continue + + # wrapped element could be normal property or array, it should only have one element + item = args[0].find(xml_name) + if item is not None: + existed_attr_keys.append(xml_name) + dict_to_pass[rf._rest_name] = _deserialize(rf._type, item) + + # rest thing is additional properties + for e in args[0]: + if e.tag not in existed_attr_keys: + dict_to_pass[e.tag] = _convert_element(e) + else: + dict_to_pass.update( + {k: _create_value(_get_rest_field(self._attr_to_rest_field, k), v) for k, v in args[0].items()} + ) + else: + non_attr_kwargs = [k for k in kwargs if k not in self._attr_to_rest_field] + if non_attr_kwargs: + # actual type errors only throw the first wrong keyword arg they see, so following that. + raise TypeError(f"{class_name}.__init__() got an unexpected keyword argument '{non_attr_kwargs[0]}'") + dict_to_pass.update( + { + self._attr_to_rest_field[k]._rest_name: _create_value(self._attr_to_rest_field[k], v) + for k, v in kwargs.items() + if v is not None + } + ) + super().__init__(dict_to_pass) + + def copy(self) -> "Model": + return Model(self.__dict__) + + def __new__(cls, *args: typing.Any, **kwargs: typing.Any) -> Self: + if f"{cls.__module__}.{cls.__qualname__}" not in cls._calculated: + # we know the last nine classes in mro are going to be 'Model', '_MyMutableMapping', 'MutableMapping', + # 'Mapping', 'Collection', 'Sized', 'Iterable', 'Container' and 'object' + mros = cls.__mro__[:-9][::-1] # ignore parents, and reverse the mro order + attr_to_rest_field: dict[str, _RestField] = { # map attribute name to rest_field property + k: v for mro_class in mros for k, v in mro_class.__dict__.items() if k[0] != "_" and hasattr(v, "_type") + } + annotations = { + k: v + for mro_class in mros + if hasattr(mro_class, "__annotations__") + for k, v in mro_class.__annotations__.items() + } + for attr, rf in attr_to_rest_field.items(): + rf._module = cls.__module__ + if not rf._type: + rf._type = rf._get_deserialize_callable_from_annotation(annotations.get(attr, None)) + if not rf._rest_name_input: + rf._rest_name_input = attr + cls._attr_to_rest_field: dict[str, _RestField] = dict(attr_to_rest_field.items()) + cls._calculated.add(f"{cls.__module__}.{cls.__qualname__}") + + return super().__new__(cls) + + def __init_subclass__(cls, discriminator: typing.Optional[str] = None) -> None: + for base in cls.__bases__: + if hasattr(base, "__mapping__"): + base.__mapping__[discriminator or cls.__name__] = cls # type: ignore + + @classmethod + def _get_discriminator(cls, exist_discriminators) -> typing.Optional["_RestField"]: + for v in cls.__dict__.values(): + if isinstance(v, _RestField) and v._is_discriminator and v._rest_name not in exist_discriminators: + return v + return None + + @classmethod + def _deserialize(cls, data, exist_discriminators): + if not hasattr(cls, "__mapping__"): + return cls(data) + discriminator = cls._get_discriminator(exist_discriminators) + if discriminator is None: + return cls(data) + exist_discriminators.append(discriminator._rest_name) + if isinstance(data, ET.Element): + model_meta = getattr(cls, "_xml", {}) + prop_meta = getattr(discriminator, "_xml", {}) + xml_name = prop_meta.get("name", discriminator._rest_name) + xml_ns = prop_meta.get("ns", model_meta.get("ns", None)) + if xml_ns: + xml_name = "{" + xml_ns + "}" + xml_name + + if data.get(xml_name) is not None: + discriminator_value = data.get(xml_name) + else: + discriminator_value = data.find(xml_name).text # pyright: ignore + else: + discriminator_value = data.get(discriminator._rest_name) + mapped_cls = cls.__mapping__.get(discriminator_value, cls) # pyright: ignore # pylint: disable=no-member + return mapped_cls._deserialize(data, exist_discriminators) + + def as_dict(self, *, exclude_readonly: bool = False) -> dict[str, typing.Any]: + """Return a dict that can be turned into json using json.dump. + + :keyword bool exclude_readonly: Whether to remove the readonly properties. + :returns: A dict JSON compatible object + :rtype: dict + """ + + result = {} + readonly_props = [] + if exclude_readonly: + readonly_props = [p._rest_name for p in self._attr_to_rest_field.values() if _is_readonly(p)] + for k, v in self.items(): + if exclude_readonly and k in readonly_props: # pyright: ignore + continue + is_multipart_file_input = False + try: + is_multipart_file_input = next( + rf for rf in self._attr_to_rest_field.values() if rf._rest_name == k + )._is_multipart_file_input + except StopIteration: + pass + result[k] = v if is_multipart_file_input else Model._as_dict_value(v, exclude_readonly=exclude_readonly) + return result + + @staticmethod + def _as_dict_value(v: typing.Any, exclude_readonly: bool = False) -> typing.Any: + if v is None or isinstance(v, _Null): + return None + if isinstance(v, (list, tuple, set)): + return type(v)(Model._as_dict_value(x, exclude_readonly=exclude_readonly) for x in v) + if isinstance(v, dict): + return {dk: Model._as_dict_value(dv, exclude_readonly=exclude_readonly) for dk, dv in v.items()} + return v.as_dict(exclude_readonly=exclude_readonly) if hasattr(v, "as_dict") else v + + +def _deserialize_model(model_deserializer: typing.Optional[typing.Callable], obj): + if _is_model(obj): + return obj + return _deserialize(model_deserializer, obj) + + +def _deserialize_with_optional(if_obj_deserializer: typing.Optional[typing.Callable], obj): + if obj is None: + return obj + return _deserialize_with_callable(if_obj_deserializer, obj) + + +def _deserialize_with_union(deserializers, obj): + for deserializer in deserializers: + try: + return _deserialize(deserializer, obj) + except DeserializationError: + pass + raise DeserializationError() + + +def _deserialize_dict( + value_deserializer: typing.Optional[typing.Callable], + module: typing.Optional[str], + obj: dict[typing.Any, typing.Any], +): + if obj is None: + return obj + if isinstance(obj, ET.Element): + obj = {child.tag: child for child in obj} + return {k: _deserialize(value_deserializer, v, module) for k, v in obj.items()} + + +def _deserialize_multiple_sequence( + entry_deserializers: list[typing.Optional[typing.Callable]], + module: typing.Optional[str], + obj, +): + if obj is None: + return obj + return type(obj)(_deserialize(deserializer, entry, module) for entry, deserializer in zip(obj, entry_deserializers)) + + +def _deserialize_sequence( + deserializer: typing.Optional[typing.Callable], + module: typing.Optional[str], + obj, +): + if obj is None: + return obj + if isinstance(obj, ET.Element): + obj = list(obj) + return type(obj)(_deserialize(deserializer, entry, module) for entry in obj) + + +def _sorted_annotations(types: list[typing.Any]) -> list[typing.Any]: + return sorted( + types, + key=lambda x: hasattr(x, "__name__") and x.__name__.lower() in ("str", "float", "int", "bool"), + ) + + +def _get_deserialize_callable_from_annotation( # pylint: disable=too-many-return-statements, too-many-statements, too-many-branches + annotation: typing.Any, + module: typing.Optional[str], + rf: typing.Optional["_RestField"] = None, +) -> typing.Optional[typing.Callable[[typing.Any], typing.Any]]: + if not annotation: + return None + + # is it a type alias? + if isinstance(annotation, str): + if module is not None: + annotation = _get_type_alias_type(module, annotation) + + # is it a forward ref / in quotes? + if isinstance(annotation, (str, typing.ForwardRef)): + try: + model_name = annotation.__forward_arg__ # type: ignore + except AttributeError: + model_name = annotation + if module is not None: + annotation = _get_model(module, model_name) # type: ignore + + try: + if module and _is_model(annotation): + if rf: + rf._is_model = True + + return functools.partial(_deserialize_model, annotation) # pyright: ignore + except Exception: + pass + + # is it a literal? + try: + if annotation.__origin__ is typing.Literal: # pyright: ignore + return None + except AttributeError: + pass + + # is it optional? + try: + if any(a for a in annotation.__args__ if a == type(None)): # pyright: ignore + if len(annotation.__args__) <= 2: # pyright: ignore + if_obj_deserializer = _get_deserialize_callable_from_annotation( + next(a for a in annotation.__args__ if a != type(None)), module, rf # pyright: ignore + ) + + return functools.partial(_deserialize_with_optional, if_obj_deserializer) + # the type is Optional[Union[...]], we need to remove the None type from the Union + annotation_copy = copy.copy(annotation) + annotation_copy.__args__ = [a for a in annotation_copy.__args__ if a != type(None)] # pyright: ignore + return _get_deserialize_callable_from_annotation(annotation_copy, module, rf) + except AttributeError: + pass + + # is it union? + if getattr(annotation, "__origin__", None) is typing.Union: + # initial ordering is we make `string` the last deserialization option, because it is often them most generic + deserializers = [ + _get_deserialize_callable_from_annotation(arg, module, rf) + for arg in _sorted_annotations(annotation.__args__) # pyright: ignore + ] + + return functools.partial(_deserialize_with_union, deserializers) + + try: + annotation_name = ( + annotation.__name__ if hasattr(annotation, "__name__") else annotation._name # pyright: ignore + ) + if annotation_name.lower() == "dict": + value_deserializer = _get_deserialize_callable_from_annotation( + annotation.__args__[1], module, rf # pyright: ignore + ) + + return functools.partial( + _deserialize_dict, + value_deserializer, + module, + ) + except (AttributeError, IndexError): + pass + try: + annotation_name = ( + annotation.__name__ if hasattr(annotation, "__name__") else annotation._name # pyright: ignore + ) + if annotation_name.lower() in ["list", "set", "tuple", "sequence"]: + if len(annotation.__args__) > 1: # pyright: ignore + entry_deserializers = [ + _get_deserialize_callable_from_annotation(dt, module, rf) + for dt in annotation.__args__ # pyright: ignore + ] + return functools.partial(_deserialize_multiple_sequence, entry_deserializers, module) + deserializer = _get_deserialize_callable_from_annotation( + annotation.__args__[0], module, rf # pyright: ignore + ) + + return functools.partial(_deserialize_sequence, deserializer, module) + except (TypeError, IndexError, AttributeError, SyntaxError): + pass + + def _deserialize_default( + deserializer, + obj, + ): + if obj is None: + return obj + try: + return _deserialize_with_callable(deserializer, obj) + except Exception: + pass + return obj + + if get_deserializer(annotation, rf): + return functools.partial(_deserialize_default, get_deserializer(annotation, rf)) + + return functools.partial(_deserialize_default, annotation) + + +def _deserialize_with_callable( + deserializer: typing.Optional[typing.Callable[[typing.Any], typing.Any]], + value: typing.Any, +): # pylint: disable=too-many-return-statements + try: + if value is None or isinstance(value, _Null): + return None + if isinstance(value, ET.Element): + if deserializer is str: + return value.text or "" + if deserializer is int: + return int(value.text) if value.text else None + if deserializer is float: + return float(value.text) if value.text else None + if deserializer is bool: + return value.text == "true" if value.text else None + if deserializer is None: + return value + if deserializer in [int, float, bool]: + return deserializer(value) + if isinstance(deserializer, CaseInsensitiveEnumMeta): + try: + return deserializer(value) + except ValueError: + # for unknown value, return raw value + return value + if isinstance(deserializer, type) and issubclass(deserializer, Model): + return deserializer._deserialize(value, []) + return typing.cast(typing.Callable[[typing.Any], typing.Any], deserializer)(value) + except Exception as e: + raise DeserializationError() from e + + +def _deserialize( + deserializer: typing.Any, + value: typing.Any, + module: typing.Optional[str] = None, + rf: typing.Optional["_RestField"] = None, + format: typing.Optional[str] = None, +) -> typing.Any: + if isinstance(value, PipelineResponse): + value = value.http_response.json() + if rf is None and format: + rf = _RestField(format=format) + if not isinstance(deserializer, functools.partial): + deserializer = _get_deserialize_callable_from_annotation(deserializer, module, rf) + return _deserialize_with_callable(deserializer, value) + + +def _failsafe_deserialize( + deserializer: typing.Any, + response: HttpResponse, + module: typing.Optional[str] = None, + rf: typing.Optional["_RestField"] = None, + format: typing.Optional[str] = None, +) -> typing.Any: + try: + return _deserialize(deserializer, response.json(), module, rf, format) + except DeserializationError: + _LOGGER.warning( + "Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True + ) + return None + + +def _failsafe_deserialize_xml( + deserializer: typing.Any, + response: HttpResponse, +) -> typing.Any: + try: + return _deserialize_xml(deserializer, response.text()) + except DeserializationError: + _LOGGER.warning( + "Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True + ) + return None + + +class _RestField: + def __init__( + self, + *, + name: typing.Optional[str] = None, + type: typing.Optional[typing.Callable] = None, # pylint: disable=redefined-builtin + is_discriminator: bool = False, + visibility: typing.Optional[list[str]] = None, + default: typing.Any = _UNSET, + format: typing.Optional[str] = None, + is_multipart_file_input: bool = False, + xml: typing.Optional[dict[str, typing.Any]] = None, + ): + self._type = type + self._rest_name_input = name + self._module: typing.Optional[str] = None + self._is_discriminator = is_discriminator + self._visibility = visibility + self._is_model = False + self._default = default + self._format = format + self._is_multipart_file_input = is_multipart_file_input + self._xml = xml if xml is not None else {} + + @property + def _class_type(self) -> typing.Any: + return getattr(self._type, "args", [None])[0] + + @property + def _rest_name(self) -> str: + if self._rest_name_input is None: + raise ValueError("Rest name was never set") + return self._rest_name_input + + def __get__(self, obj: Model, type=None): # pylint: disable=redefined-builtin + # by this point, type and rest_name will have a value bc we default + # them in __new__ of the Model class + item = obj.get(self._rest_name) + if item is None: + return item + if self._is_model: + return item + return _deserialize(self._type, _serialize(item, self._format), rf=self) + + def __set__(self, obj: Model, value) -> None: + if value is None: + # we want to wipe out entries if users set attr to None + try: + obj.__delitem__(self._rest_name) + except KeyError: + pass + return + if self._is_model: + if not _is_model(value): + value = _deserialize(self._type, value) + obj.__setitem__(self._rest_name, value) + return + obj.__setitem__(self._rest_name, _serialize(value, self._format)) + + def _get_deserialize_callable_from_annotation( + self, annotation: typing.Any + ) -> typing.Optional[typing.Callable[[typing.Any], typing.Any]]: + return _get_deserialize_callable_from_annotation(annotation, self._module, self) + + +def rest_field( + *, + name: typing.Optional[str] = None, + type: typing.Optional[typing.Callable] = None, # pylint: disable=redefined-builtin + visibility: typing.Optional[list[str]] = None, + default: typing.Any = _UNSET, + format: typing.Optional[str] = None, + is_multipart_file_input: bool = False, + xml: typing.Optional[dict[str, typing.Any]] = None, +) -> typing.Any: + return _RestField( + name=name, + type=type, + visibility=visibility, + default=default, + format=format, + is_multipart_file_input=is_multipart_file_input, + xml=xml, + ) + + +def rest_discriminator( + *, + name: typing.Optional[str] = None, + type: typing.Optional[typing.Callable] = None, # pylint: disable=redefined-builtin + visibility: typing.Optional[list[str]] = None, + xml: typing.Optional[dict[str, typing.Any]] = None, +) -> typing.Any: + return _RestField(name=name, type=type, is_discriminator=True, visibility=visibility, xml=xml) + + +def serialize_xml(model: Model, exclude_readonly: bool = False) -> str: + """Serialize a model to XML. + + :param Model model: The model to serialize. + :param bool exclude_readonly: Whether to exclude readonly properties. + :returns: The XML representation of the model. + :rtype: str + """ + return ET.tostring(_get_element(model, exclude_readonly), encoding="unicode") # type: ignore + + +def _get_element( + o: typing.Any, + exclude_readonly: bool = False, + parent_meta: typing.Optional[dict[str, typing.Any]] = None, + wrapped_element: typing.Optional[ET.Element] = None, +) -> typing.Union[ET.Element, list[ET.Element]]: + if _is_model(o): + model_meta = getattr(o, "_xml", {}) + + # if prop is a model, then use the prop element directly, else generate a wrapper of model + if wrapped_element is None: + wrapped_element = _create_xml_element( + model_meta.get("name", o.__class__.__name__), + model_meta.get("prefix"), + model_meta.get("ns"), + ) + + readonly_props = [] + if exclude_readonly: + readonly_props = [p._rest_name for p in o._attr_to_rest_field.values() if _is_readonly(p)] + + for k, v in o.items(): + # do not serialize readonly properties + if exclude_readonly and k in readonly_props: + continue + + prop_rest_field = _get_rest_field(o._attr_to_rest_field, k) + if prop_rest_field: + prop_meta = getattr(prop_rest_field, "_xml").copy() + # use the wire name as xml name if no specific name is set + if prop_meta.get("name") is None: + prop_meta["name"] = k + else: + # additional properties will not have rest field, use the wire name as xml name + prop_meta = {"name": k} + + # if no ns for prop, use model's + if prop_meta.get("ns") is None and model_meta.get("ns"): + prop_meta["ns"] = model_meta.get("ns") + prop_meta["prefix"] = model_meta.get("prefix") + + if prop_meta.get("unwrapped", False): + # unwrapped could only set on array + wrapped_element.extend(_get_element(v, exclude_readonly, prop_meta)) + elif prop_meta.get("text", False): + # text could only set on primitive type + wrapped_element.text = _get_primitive_type_value(v) + elif prop_meta.get("attribute", False): + xml_name = prop_meta.get("name", k) + if prop_meta.get("ns"): + ET.register_namespace(prop_meta.get("prefix"), prop_meta.get("ns")) # pyright: ignore + xml_name = "{" + prop_meta.get("ns") + "}" + xml_name # pyright: ignore + # attribute should be primitive type + wrapped_element.set(xml_name, _get_primitive_type_value(v)) + else: + # other wrapped prop element + wrapped_element.append(_get_wrapped_element(v, exclude_readonly, prop_meta)) + return wrapped_element + if isinstance(o, list): + return [_get_element(x, exclude_readonly, parent_meta) for x in o] # type: ignore + if isinstance(o, dict): + result = [] + for k, v in o.items(): + result.append( + _get_wrapped_element( + v, + exclude_readonly, + { + "name": k, + "ns": parent_meta.get("ns") if parent_meta else None, + "prefix": parent_meta.get("prefix") if parent_meta else None, + }, + ) + ) + return result + + # primitive case need to create element based on parent_meta + if parent_meta: + return _get_wrapped_element( + o, + exclude_readonly, + { + "name": parent_meta.get("itemsName", parent_meta.get("name")), + "prefix": parent_meta.get("itemsPrefix", parent_meta.get("prefix")), + "ns": parent_meta.get("itemsNs", parent_meta.get("ns")), + }, + ) + + raise ValueError("Could not serialize value into xml: " + o) + + +def _get_wrapped_element( + v: typing.Any, + exclude_readonly: bool, + meta: typing.Optional[dict[str, typing.Any]], +) -> ET.Element: + wrapped_element = _create_xml_element( + meta.get("name") if meta else None, meta.get("prefix") if meta else None, meta.get("ns") if meta else None + ) + if isinstance(v, (dict, list)): + wrapped_element.extend(_get_element(v, exclude_readonly, meta)) + elif _is_model(v): + _get_element(v, exclude_readonly, meta, wrapped_element) + else: + wrapped_element.text = _get_primitive_type_value(v) + return wrapped_element + + +def _get_primitive_type_value(v) -> str: + if v is True: + return "true" + if v is False: + return "false" + if isinstance(v, _Null): + return "" + return str(v) + + +def _create_xml_element(tag, prefix=None, ns=None): + if prefix and ns: + ET.register_namespace(prefix, ns) + if ns: + return ET.Element("{" + ns + "}" + tag) + return ET.Element(tag) + + +def _deserialize_xml( + deserializer: typing.Any, + value: str, +) -> typing.Any: + element = ET.fromstring(value) # nosec + return _deserialize(deserializer, element) + + +def _convert_element(e: ET.Element): + # dict case + if len(e.attrib) > 0 or len({child.tag for child in e}) > 1: + dict_result: dict[str, typing.Any] = {} + for child in e: + if dict_result.get(child.tag) is not None: + if isinstance(dict_result[child.tag], list): + dict_result[child.tag].append(_convert_element(child)) + else: + dict_result[child.tag] = [dict_result[child.tag], _convert_element(child)] + else: + dict_result[child.tag] = _convert_element(child) + dict_result.update(e.attrib) + return dict_result + # array case + if len(e) > 0: + array_result: list[typing.Any] = [] + for child in e: + array_result.append(_convert_element(child)) + return array_result + # primitive case + return e.text diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/serialization.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/serialization.py new file mode 100644 index 000000000000..45a3e44e45cb --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/serialization.py @@ -0,0 +1,2030 @@ +# pylint: disable=line-too-long,useless-suppression,too-many-lines +# 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. +# -------------------------------------------------------------------------- + +# pyright: reportUnnecessaryTypeIgnoreComment=false + +from base64 import b64decode, b64encode +import calendar +import datetime +import decimal +import email +from enum import Enum +import json +import logging +import re +import sys +import codecs +from typing import ( + Any, + cast, + Optional, + Union, + AnyStr, + IO, + Mapping, + Callable, + MutableMapping, +) + +try: + from urllib import quote # type: ignore +except ImportError: + from urllib.parse import quote +import xml.etree.ElementTree as ET + +import isodate # type: ignore +from typing_extensions import Self + +from azure.core.exceptions import DeserializationError, SerializationError +from azure.core.serialization import NULL as CoreNull + +_BOM = codecs.BOM_UTF8.decode(encoding="utf-8") + +JSON = MutableMapping[str, Any] + + +class RawDeserializer: + + # Accept "text" because we're open minded people... + JSON_REGEXP = re.compile(r"^(application|text)/([a-z+.]+\+)?json$") + + # Name used in context + CONTEXT_NAME = "deserialized_data" + + @classmethod + def deserialize_from_text(cls, data: Optional[Union[AnyStr, IO]], content_type: Optional[str] = None) -> Any: + """Decode data according to content-type. + + Accept a stream of data as well, but will be load at once in memory for now. + + If no content-type, will return the string version (not bytes, not stream) + + :param data: Input, could be bytes or stream (will be decoded with UTF8) or text + :type data: str or bytes or IO + :param str content_type: The content type. + :return: The deserialized data. + :rtype: object + """ + if hasattr(data, "read"): + # Assume a stream + data = cast(IO, data).read() + + if isinstance(data, bytes): + data_as_str = data.decode(encoding="utf-8-sig") + else: + # Explain to mypy the correct type. + data_as_str = cast(str, data) + + # Remove Byte Order Mark if present in string + data_as_str = data_as_str.lstrip(_BOM) + + if content_type is None: + return data + + if cls.JSON_REGEXP.match(content_type): + try: + return json.loads(data_as_str) + except ValueError as err: + raise DeserializationError("JSON is invalid: {}".format(err), err) from err + elif "xml" in (content_type or []): + try: + + try: + if isinstance(data, unicode): # type: ignore + # If I'm Python 2.7 and unicode XML will scream if I try a "fromstring" on unicode string + data_as_str = data_as_str.encode(encoding="utf-8") # type: ignore + except NameError: + pass + + return ET.fromstring(data_as_str) # nosec + except ET.ParseError as err: + # It might be because the server has an issue, and returned JSON with + # content-type XML.... + # So let's try a JSON load, and if it's still broken + # let's flow the initial exception + def _json_attemp(data): + try: + return True, json.loads(data) + except ValueError: + return False, None # Don't care about this one + + success, json_result = _json_attemp(data) + if success: + return json_result + # If i'm here, it's not JSON, it's not XML, let's scream + # and raise the last context in this block (the XML exception) + # The function hack is because Py2.7 messes up with exception + # context otherwise. + _LOGGER.critical("Wasn't XML not JSON, failing") + raise DeserializationError("XML is invalid") from err + elif content_type.startswith("text/"): + return data_as_str + raise DeserializationError("Cannot deserialize content-type: {}".format(content_type)) + + @classmethod + def deserialize_from_http_generics(cls, body_bytes: Optional[Union[AnyStr, IO]], headers: Mapping) -> Any: + """Deserialize from HTTP response. + + Use bytes and headers to NOT use any requests/aiohttp or whatever + specific implementation. + Headers will tested for "content-type" + + :param bytes body_bytes: The body of the response. + :param dict headers: The headers of the response. + :returns: The deserialized data. + :rtype: object + """ + # Try to use content-type from headers if available + content_type = None + if "content-type" in headers: + content_type = headers["content-type"].split(";")[0].strip().lower() + # Ouch, this server did not declare what it sent... + # Let's guess it's JSON... + # Also, since Autorest was considering that an empty body was a valid JSON, + # need that test as well.... + else: + content_type = "application/json" + + if body_bytes: + return cls.deserialize_from_text(body_bytes, content_type) + return None + + +_LOGGER = logging.getLogger(__name__) + +try: + _long_type = long # type: ignore +except NameError: + _long_type = int + +TZ_UTC = datetime.timezone.utc + +_FLATTEN = re.compile(r"(? None: + self.additional_properties: Optional[dict[str, Any]] = {} + for k in kwargs: # pylint: disable=consider-using-dict-items + if k not in self._attribute_map: + _LOGGER.warning("%s is not a known attribute of class %s and will be ignored", k, self.__class__) + elif k in self._validation and self._validation[k].get("readonly", False): + _LOGGER.warning("Readonly attribute %s will be ignored in class %s", k, self.__class__) + else: + setattr(self, k, kwargs[k]) + + def __eq__(self, other: Any) -> bool: + """Compare objects by comparing all attributes. + + :param object other: The object to compare + :returns: True if objects are equal + :rtype: bool + """ + if isinstance(other, self.__class__): + return self.__dict__ == other.__dict__ + return False + + def __ne__(self, other: Any) -> bool: + """Compare objects by comparing all attributes. + + :param object other: The object to compare + :returns: True if objects are not equal + :rtype: bool + """ + return not self.__eq__(other) + + def __str__(self) -> str: + return str(self.__dict__) + + @classmethod + def enable_additional_properties_sending(cls) -> None: + cls._attribute_map["additional_properties"] = {"key": "", "type": "{object}"} + + @classmethod + def is_xml_model(cls) -> bool: + try: + cls._xml_map # type: ignore + except AttributeError: + return False + return True + + @classmethod + def _create_xml_node(cls): + """Create XML node. + + :returns: The XML node + :rtype: xml.etree.ElementTree.Element + """ + try: + xml_map = cls._xml_map # type: ignore + except AttributeError: + xml_map = {} + + return _create_xml_node(xml_map.get("name", cls.__name__), xml_map.get("prefix", None), xml_map.get("ns", None)) + + def serialize(self, keep_readonly: bool = False, **kwargs: Any) -> JSON: + """Return the JSON that would be sent to server from this model. + + This is an alias to `as_dict(full_restapi_key_transformer, keep_readonly=False)`. + + If you want XML serialization, you can pass the kwargs is_xml=True. + + :param bool keep_readonly: If you want to serialize the readonly attributes + :returns: A dict JSON compatible object + :rtype: dict + """ + serializer = Serializer(self._infer_class_models()) + return serializer._serialize( # type: ignore # pylint: disable=protected-access + self, keep_readonly=keep_readonly, **kwargs + ) + + def as_dict( + self, + keep_readonly: bool = True, + key_transformer: Callable[[str, dict[str, Any], Any], Any] = attribute_transformer, + **kwargs: Any + ) -> JSON: + """Return a dict that can be serialized using json.dump. + + Advanced usage might optionally use a callback as parameter: + + .. code::python + + def my_key_transformer(key, attr_desc, value): + return key + + Key is the attribute name used in Python. Attr_desc + is a dict of metadata. Currently contains 'type' with the + msrest type and 'key' with the RestAPI encoded key. + Value is the current value in this object. + + The string returned will be used to serialize the key. + If the return type is a list, this is considered hierarchical + result dict. + + See the three examples in this file: + + - attribute_transformer + - full_restapi_key_transformer + - last_restapi_key_transformer + + If you want XML serialization, you can pass the kwargs is_xml=True. + + :param bool keep_readonly: If you want to serialize the readonly attributes + :param function key_transformer: A key transformer function. + :returns: A dict JSON compatible object + :rtype: dict + """ + serializer = Serializer(self._infer_class_models()) + return serializer._serialize( # type: ignore # pylint: disable=protected-access + self, key_transformer=key_transformer, keep_readonly=keep_readonly, **kwargs + ) + + @classmethod + def _infer_class_models(cls): + try: + str_models = cls.__module__.rsplit(".", 1)[0] + models = sys.modules[str_models] + client_models = {k: v for k, v in models.__dict__.items() if isinstance(v, type)} + if cls.__name__ not in client_models: + raise ValueError("Not Autorest generated code") + except Exception: # pylint: disable=broad-exception-caught + # Assume it's not Autorest generated (tests?). Add ourselves as dependencies. + client_models = {cls.__name__: cls} + return client_models + + @classmethod + def deserialize(cls, data: Any, content_type: Optional[str] = None) -> Self: + """Parse a str using the RestAPI syntax and return a model. + + :param str data: A str using RestAPI structure. JSON by default. + :param str content_type: JSON by default, set application/xml if XML. + :returns: An instance of this model + :raises DeserializationError: if something went wrong + :rtype: Self + """ + deserializer = Deserializer(cls._infer_class_models()) + return deserializer(cls.__name__, data, content_type=content_type) # type: ignore + + @classmethod + def from_dict( + cls, + data: Any, + key_extractors: Optional[Callable[[str, dict[str, Any], Any], Any]] = None, + content_type: Optional[str] = None, + ) -> Self: + """Parse a dict using given key extractor return a model. + + By default consider key + extractors (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor + and last_rest_key_case_insensitive_extractor) + + :param dict data: A dict using RestAPI structure + :param function key_extractors: A key extractor function. + :param str content_type: JSON by default, set application/xml if XML. + :returns: An instance of this model + :raises DeserializationError: if something went wrong + :rtype: Self + """ + deserializer = Deserializer(cls._infer_class_models()) + deserializer.key_extractors = ( # type: ignore + [ # type: ignore + attribute_key_case_insensitive_extractor, + rest_key_case_insensitive_extractor, + last_rest_key_case_insensitive_extractor, + ] + if key_extractors is None + else key_extractors + ) + return deserializer(cls.__name__, data, content_type=content_type) # type: ignore + + @classmethod + def _flatten_subtype(cls, key, objects): + if "_subtype_map" not in cls.__dict__: + return {} + result = dict(cls._subtype_map[key]) + for valuetype in cls._subtype_map[key].values(): + result |= objects[valuetype]._flatten_subtype(key, objects) # pylint: disable=protected-access + return result + + @classmethod + def _classify(cls, response, objects): + """Check the class _subtype_map for any child classes. + We want to ignore any inherited _subtype_maps. + + :param dict response: The initial data + :param dict objects: The class objects + :returns: The class to be used + :rtype: class + """ + for subtype_key in cls.__dict__.get("_subtype_map", {}).keys(): + subtype_value = None + + if not isinstance(response, ET.Element): + rest_api_response_key = cls._get_rest_key_parts(subtype_key)[-1] + subtype_value = response.get(rest_api_response_key, None) or response.get(subtype_key, None) + else: + subtype_value = xml_key_extractor(subtype_key, cls._attribute_map[subtype_key], response) + if subtype_value: + # Try to match base class. Can be class name only + # (bug to fix in Autorest to support x-ms-discriminator-name) + if cls.__name__ == subtype_value: + return cls + flatten_mapping_type = cls._flatten_subtype(subtype_key, objects) + try: + return objects[flatten_mapping_type[subtype_value]] # type: ignore + except KeyError: + _LOGGER.warning( + "Subtype value %s has no mapping, use base class %s.", + subtype_value, + cls.__name__, + ) + break + else: + _LOGGER.warning("Discriminator %s is absent or null, use base class %s.", subtype_key, cls.__name__) + break + return cls + + @classmethod + def _get_rest_key_parts(cls, attr_key): + """Get the RestAPI key of this attr, split it and decode part + :param str attr_key: Attribute key must be in attribute_map. + :returns: A list of RestAPI part + :rtype: list + """ + rest_split_key = _FLATTEN.split(cls._attribute_map[attr_key]["key"]) + return [_decode_attribute_map_key(key_part) for key_part in rest_split_key] + + +def _decode_attribute_map_key(key): + """This decode a key in an _attribute_map to the actual key we want to look at + inside the received data. + + :param str key: A key string from the generated code + :returns: The decoded key + :rtype: str + """ + return key.replace("\\.", ".") + + +class Serializer: # pylint: disable=too-many-public-methods + """Request object model serializer.""" + + basic_types = {str: "str", int: "int", bool: "bool", float: "float"} + + _xml_basic_types_serializers = {"bool": lambda x: str(x).lower()} + days = {0: "Mon", 1: "Tue", 2: "Wed", 3: "Thu", 4: "Fri", 5: "Sat", 6: "Sun"} + months = { + 1: "Jan", + 2: "Feb", + 3: "Mar", + 4: "Apr", + 5: "May", + 6: "Jun", + 7: "Jul", + 8: "Aug", + 9: "Sep", + 10: "Oct", + 11: "Nov", + 12: "Dec", + } + validation = { + "min_length": lambda x, y: len(x) < y, + "max_length": lambda x, y: len(x) > y, + "minimum": lambda x, y: x < y, + "maximum": lambda x, y: x > y, + "minimum_ex": lambda x, y: x <= y, + "maximum_ex": lambda x, y: x >= y, + "min_items": lambda x, y: len(x) < y, + "max_items": lambda x, y: len(x) > y, + "pattern": lambda x, y: not re.match(y, x, re.UNICODE), + "unique": lambda x, y: len(x) != len(set(x)), + "multiple": lambda x, y: x % y != 0, + } + + def __init__(self, classes: Optional[Mapping[str, type]] = None) -> None: + self.serialize_type = { + "iso-8601": Serializer.serialize_iso, + "rfc-1123": Serializer.serialize_rfc, + "unix-time": Serializer.serialize_unix, + "duration": Serializer.serialize_duration, + "date": Serializer.serialize_date, + "time": Serializer.serialize_time, + "decimal": Serializer.serialize_decimal, + "long": Serializer.serialize_long, + "bytearray": Serializer.serialize_bytearray, + "base64": Serializer.serialize_base64, + "object": self.serialize_object, + "[]": self.serialize_iter, + "{}": self.serialize_dict, + } + self.dependencies: dict[str, type] = dict(classes) if classes else {} + self.key_transformer = full_restapi_key_transformer + self.client_side_validation = True + + def _serialize( # pylint: disable=too-many-nested-blocks, too-many-branches, too-many-statements, too-many-locals + self, target_obj, data_type=None, **kwargs + ): + """Serialize data into a string according to type. + + :param object target_obj: The data to be serialized. + :param str data_type: The type to be serialized from. + :rtype: str, dict + :raises SerializationError: if serialization fails. + :returns: The serialized data. + """ + key_transformer = kwargs.get("key_transformer", self.key_transformer) + keep_readonly = kwargs.get("keep_readonly", False) + if target_obj is None: + return None + + attr_name = None + class_name = target_obj.__class__.__name__ + + if data_type: + return self.serialize_data(target_obj, data_type, **kwargs) + + if not hasattr(target_obj, "_attribute_map"): + data_type = type(target_obj).__name__ + if data_type in self.basic_types.values(): + return self.serialize_data(target_obj, data_type, **kwargs) + + # Force "is_xml" kwargs if we detect a XML model + try: + is_xml_model_serialization = kwargs["is_xml"] + except KeyError: + is_xml_model_serialization = kwargs.setdefault("is_xml", target_obj.is_xml_model()) + + serialized = {} + if is_xml_model_serialization: + serialized = target_obj._create_xml_node() # pylint: disable=protected-access + try: + attributes = target_obj._attribute_map # pylint: disable=protected-access + for attr, attr_desc in attributes.items(): + attr_name = attr + if not keep_readonly and target_obj._validation.get( # pylint: disable=protected-access + attr_name, {} + ).get("readonly", False): + continue + + if attr_name == "additional_properties" and attr_desc["key"] == "": + if target_obj.additional_properties is not None: + serialized |= target_obj.additional_properties + continue + try: + + orig_attr = getattr(target_obj, attr) + if is_xml_model_serialization: + pass # Don't provide "transformer" for XML for now. Keep "orig_attr" + else: # JSON + keys, orig_attr = key_transformer(attr, attr_desc.copy(), orig_attr) + keys = keys if isinstance(keys, list) else [keys] + + kwargs["serialization_ctxt"] = attr_desc + new_attr = self.serialize_data(orig_attr, attr_desc["type"], **kwargs) + + if is_xml_model_serialization: + xml_desc = attr_desc.get("xml", {}) + xml_name = xml_desc.get("name", attr_desc["key"]) + xml_prefix = xml_desc.get("prefix", None) + xml_ns = xml_desc.get("ns", None) + if xml_desc.get("attr", False): + if xml_ns: + ET.register_namespace(xml_prefix, xml_ns) + xml_name = "{{{}}}{}".format(xml_ns, xml_name) + serialized.set(xml_name, new_attr) # type: ignore + continue + if xml_desc.get("text", False): + serialized.text = new_attr # type: ignore + continue + if isinstance(new_attr, list): + serialized.extend(new_attr) # type: ignore + elif isinstance(new_attr, ET.Element): + # If the down XML has no XML/Name, + # we MUST replace the tag with the local tag. But keeping the namespaces. + if "name" not in getattr(orig_attr, "_xml_map", {}): + splitted_tag = new_attr.tag.split("}") + if len(splitted_tag) == 2: # Namespace + new_attr.tag = "}".join([splitted_tag[0], xml_name]) + else: + new_attr.tag = xml_name + serialized.append(new_attr) # type: ignore + else: # That's a basic type + # Integrate namespace if necessary + local_node = _create_xml_node(xml_name, xml_prefix, xml_ns) + local_node.text = str(new_attr) + serialized.append(local_node) # type: ignore + else: # JSON + for k in reversed(keys): # type: ignore + new_attr = {k: new_attr} + + _new_attr = new_attr + _serialized = serialized + for k in keys: # type: ignore + if k not in _serialized: + _serialized.update(_new_attr) # type: ignore + _new_attr = _new_attr[k] # type: ignore + _serialized = _serialized[k] + except ValueError as err: + if isinstance(err, SerializationError): + raise + + except (AttributeError, KeyError, TypeError) as err: + msg = "Attribute {} in object {} cannot be serialized.\n{}".format(attr_name, class_name, str(target_obj)) + raise SerializationError(msg) from err + return serialized + + def body(self, data, data_type, **kwargs): + """Serialize data intended for a request body. + + :param object data: The data to be serialized. + :param str data_type: The type to be serialized from. + :rtype: dict + :raises SerializationError: if serialization fails. + :raises ValueError: if data is None + :returns: The serialized request body + """ + + # Just in case this is a dict + internal_data_type_str = data_type.strip("[]{}") + internal_data_type = self.dependencies.get(internal_data_type_str, None) + try: + is_xml_model_serialization = kwargs["is_xml"] + except KeyError: + if internal_data_type and issubclass(internal_data_type, Model): + is_xml_model_serialization = kwargs.setdefault("is_xml", internal_data_type.is_xml_model()) + else: + is_xml_model_serialization = False + if internal_data_type and not isinstance(internal_data_type, Enum): + try: + deserializer = Deserializer(self.dependencies) + # Since it's on serialization, it's almost sure that format is not JSON REST + # We're not able to deal with additional properties for now. + deserializer.additional_properties_detection = False + if is_xml_model_serialization: + deserializer.key_extractors = [ # type: ignore + attribute_key_case_insensitive_extractor, + ] + else: + deserializer.key_extractors = [ + rest_key_case_insensitive_extractor, + attribute_key_case_insensitive_extractor, + last_rest_key_case_insensitive_extractor, + ] + data = deserializer._deserialize(data_type, data) # pylint: disable=protected-access + except DeserializationError as err: + raise SerializationError("Unable to build a model: " + str(err)) from err + + return self._serialize(data, data_type, **kwargs) + + def url(self, name, data, data_type, **kwargs): + """Serialize data intended for a URL path. + + :param str name: The name of the URL path parameter. + :param object data: The data to be serialized. + :param str data_type: The type to be serialized from. + :rtype: str + :returns: The serialized URL path + :raises TypeError: if serialization fails. + :raises ValueError: if data is None + """ + try: + output = self.serialize_data(data, data_type, **kwargs) + if data_type == "bool": + output = json.dumps(output) + + if kwargs.get("skip_quote") is True: + output = str(output) + output = output.replace("{", quote("{")).replace("}", quote("}")) + else: + output = quote(str(output), safe="") + except SerializationError as exc: + raise TypeError("{} must be type {}.".format(name, data_type)) from exc + return output + + def query(self, name, data, data_type, **kwargs): + """Serialize data intended for a URL query. + + :param str name: The name of the query parameter. + :param object data: The data to be serialized. + :param str data_type: The type to be serialized from. + :rtype: str, list + :raises TypeError: if serialization fails. + :raises ValueError: if data is None + :returns: The serialized query parameter + """ + try: + # Treat the list aside, since we don't want to encode the div separator + if data_type.startswith("["): + internal_data_type = data_type[1:-1] + do_quote = not kwargs.get("skip_quote", False) + return self.serialize_iter(data, internal_data_type, do_quote=do_quote, **kwargs) + + # Not a list, regular serialization + output = self.serialize_data(data, data_type, **kwargs) + if data_type == "bool": + output = json.dumps(output) + if kwargs.get("skip_quote") is True: + output = str(output) + else: + output = quote(str(output), safe="") + except SerializationError as exc: + raise TypeError("{} must be type {}.".format(name, data_type)) from exc + return str(output) + + def header(self, name, data, data_type, **kwargs): + """Serialize data intended for a request header. + + :param str name: The name of the header. + :param object data: The data to be serialized. + :param str data_type: The type to be serialized from. + :rtype: str + :raises TypeError: if serialization fails. + :raises ValueError: if data is None + :returns: The serialized header + """ + try: + if data_type in ["[str]"]: + data = ["" if d is None else d for d in data] + + output = self.serialize_data(data, data_type, **kwargs) + if data_type == "bool": + output = json.dumps(output) + except SerializationError as exc: + raise TypeError("{} must be type {}.".format(name, data_type)) from exc + return str(output) + + def serialize_data(self, data, data_type, **kwargs): + """Serialize generic data according to supplied data type. + + :param object data: The data to be serialized. + :param str data_type: The type to be serialized from. + :raises AttributeError: if required data is None. + :raises ValueError: if data is None + :raises SerializationError: if serialization fails. + :returns: The serialized data. + :rtype: str, int, float, bool, dict, list + """ + if data is None: + raise ValueError("No value for given attribute") + + try: + if data is CoreNull: + return None + if data_type in self.basic_types.values(): + return self.serialize_basic(data, data_type, **kwargs) + + if data_type in self.serialize_type: + return self.serialize_type[data_type](data, **kwargs) + + # If dependencies is empty, try with current data class + # It has to be a subclass of Enum anyway + enum_type = self.dependencies.get(data_type, cast(type, data.__class__)) + if issubclass(enum_type, Enum): + return Serializer.serialize_enum(data, enum_obj=enum_type) + + iter_type = data_type[0] + data_type[-1] + if iter_type in self.serialize_type: + return self.serialize_type[iter_type](data, data_type[1:-1], **kwargs) + + except (ValueError, TypeError) as err: + msg = "Unable to serialize value: {!r} as type: {!r}." + raise SerializationError(msg.format(data, data_type)) from err + return self._serialize(data, **kwargs) + + @classmethod + def _get_custom_serializers(cls, data_type, **kwargs): # pylint: disable=inconsistent-return-statements + custom_serializer = kwargs.get("basic_types_serializers", {}).get(data_type) + if custom_serializer: + return custom_serializer + if kwargs.get("is_xml", False): + return cls._xml_basic_types_serializers.get(data_type) + + @classmethod + def serialize_basic(cls, data, data_type, **kwargs): + """Serialize basic builting data type. + Serializes objects to str, int, float or bool. + + Possible kwargs: + - basic_types_serializers dict[str, callable] : If set, use the callable as serializer + - is_xml bool : If set, use xml_basic_types_serializers + + :param obj data: Object to be serialized. + :param str data_type: Type of object in the iterable. + :rtype: str, int, float, bool + :return: serialized object + """ + custom_serializer = cls._get_custom_serializers(data_type, **kwargs) + if custom_serializer: + return custom_serializer(data) + if data_type == "str": + return cls.serialize_unicode(data) + return eval(data_type)(data) # nosec # pylint: disable=eval-used + + @classmethod + def serialize_unicode(cls, data): + """Special handling for serializing unicode strings in Py2. + Encode to UTF-8 if unicode, otherwise handle as a str. + + :param str data: Object to be serialized. + :rtype: str + :return: serialized object + """ + try: # If I received an enum, return its value + return data.value + except AttributeError: + pass + + try: + if isinstance(data, unicode): # type: ignore + # Don't change it, JSON and XML ElementTree are totally able + # to serialize correctly u'' strings + return data + except NameError: + return str(data) + return str(data) + + def serialize_iter(self, data, iter_type, div=None, **kwargs): + """Serialize iterable. + + Supported kwargs: + - serialization_ctxt dict : The current entry of _attribute_map, or same format. + serialization_ctxt['type'] should be same as data_type. + - is_xml bool : If set, serialize as XML + + :param list data: Object to be serialized. + :param str iter_type: Type of object in the iterable. + :param str div: If set, this str will be used to combine the elements + in the iterable into a combined string. Default is 'None'. + Defaults to False. + :rtype: list, str + :return: serialized iterable + """ + if isinstance(data, str): + raise SerializationError("Refuse str type as a valid iter type.") + + serialization_ctxt = kwargs.get("serialization_ctxt", {}) + is_xml = kwargs.get("is_xml", False) + + serialized = [] + for d in data: + try: + serialized.append(self.serialize_data(d, iter_type, **kwargs)) + except ValueError as err: + if isinstance(err, SerializationError): + raise + serialized.append(None) + + if kwargs.get("do_quote", False): + serialized = ["" if s is None else quote(str(s), safe="") for s in serialized] + + if div: + serialized = ["" if s is None else str(s) for s in serialized] + serialized = div.join(serialized) + + if "xml" in serialization_ctxt or is_xml: + # XML serialization is more complicated + xml_desc = serialization_ctxt.get("xml", {}) + xml_name = xml_desc.get("name") + if not xml_name: + xml_name = serialization_ctxt["key"] + + # Create a wrap node if necessary (use the fact that Element and list have "append") + is_wrapped = xml_desc.get("wrapped", False) + node_name = xml_desc.get("itemsName", xml_name) + if is_wrapped: + final_result = _create_xml_node(xml_name, xml_desc.get("prefix", None), xml_desc.get("ns", None)) + else: + final_result = [] + # All list elements to "local_node" + for el in serialized: + if isinstance(el, ET.Element): + el_node = el + else: + el_node = _create_xml_node(node_name, xml_desc.get("prefix", None), xml_desc.get("ns", None)) + if el is not None: # Otherwise it writes "None" :-p + el_node.text = str(el) + final_result.append(el_node) + return final_result + return serialized + + def serialize_dict(self, attr, dict_type, **kwargs): + """Serialize a dictionary of objects. + + :param dict attr: Object to be serialized. + :param str dict_type: Type of object in the dictionary. + :rtype: dict + :return: serialized dictionary + """ + serialization_ctxt = kwargs.get("serialization_ctxt", {}) + serialized = {} + for key, value in attr.items(): + try: + serialized[self.serialize_unicode(key)] = self.serialize_data(value, dict_type, **kwargs) + except ValueError as err: + if isinstance(err, SerializationError): + raise + serialized[self.serialize_unicode(key)] = None + + if "xml" in serialization_ctxt: + # XML serialization is more complicated + xml_desc = serialization_ctxt["xml"] + xml_name = xml_desc["name"] + + final_result = _create_xml_node(xml_name, xml_desc.get("prefix", None), xml_desc.get("ns", None)) + for key, value in serialized.items(): + ET.SubElement(final_result, key).text = value + return final_result + + return serialized + + def serialize_object(self, attr, **kwargs): # pylint: disable=too-many-return-statements + """Serialize a generic object. + This will be handled as a dictionary. If object passed in is not + a basic type (str, int, float, dict, list) it will simply be + cast to str. + + :param dict attr: Object to be serialized. + :rtype: dict or str + :return: serialized object + """ + if attr is None: + return None + if isinstance(attr, ET.Element): + return attr + obj_type = type(attr) + if obj_type in self.basic_types: + return self.serialize_basic(attr, self.basic_types[obj_type], **kwargs) + if obj_type is _long_type: + return self.serialize_long(attr) + if obj_type is str: + return self.serialize_unicode(attr) + if obj_type is datetime.datetime: + return self.serialize_iso(attr) + if obj_type is datetime.date: + return self.serialize_date(attr) + if obj_type is datetime.time: + return self.serialize_time(attr) + if obj_type is datetime.timedelta: + return self.serialize_duration(attr) + if obj_type is decimal.Decimal: + return self.serialize_decimal(attr) + + # If it's a model or I know this dependency, serialize as a Model + if obj_type in self.dependencies.values() or isinstance(attr, Model): + return self._serialize(attr) + + if obj_type == dict: + serialized = {} + for key, value in attr.items(): + try: + serialized[self.serialize_unicode(key)] = self.serialize_object(value, **kwargs) + except ValueError: + serialized[self.serialize_unicode(key)] = None + return serialized + + if obj_type == list: + serialized = [] + for obj in attr: + try: + serialized.append(self.serialize_object(obj, **kwargs)) + except ValueError: + pass + return serialized + return str(attr) + + @staticmethod + def serialize_enum(attr, enum_obj=None): + try: + result = attr.value + except AttributeError: + result = attr + try: + enum_obj(result) # type: ignore + return result + except ValueError as exc: + for enum_value in enum_obj: # type: ignore + if enum_value.value.lower() == str(attr).lower(): + return enum_value.value + error = "{!r} is not valid value for enum {!r}" + raise SerializationError(error.format(attr, enum_obj)) from exc + + @staticmethod + def serialize_bytearray(attr, **kwargs): # pylint: disable=unused-argument + """Serialize bytearray into base-64 string. + + :param str attr: Object to be serialized. + :rtype: str + :return: serialized base64 + """ + return b64encode(attr).decode() + + @staticmethod + def serialize_base64(attr, **kwargs): # pylint: disable=unused-argument + """Serialize str into base-64 string. + + :param str attr: Object to be serialized. + :rtype: str + :return: serialized base64 + """ + encoded = b64encode(attr).decode("ascii") + return encoded.strip("=").replace("+", "-").replace("/", "_") + + @staticmethod + def serialize_decimal(attr, **kwargs): # pylint: disable=unused-argument + """Serialize Decimal object to float. + + :param decimal attr: Object to be serialized. + :rtype: float + :return: serialized decimal + """ + return float(attr) + + @staticmethod + def serialize_long(attr, **kwargs): # pylint: disable=unused-argument + """Serialize long (Py2) or int (Py3). + + :param int attr: Object to be serialized. + :rtype: int/long + :return: serialized long + """ + return _long_type(attr) + + @staticmethod + def serialize_date(attr, **kwargs): # pylint: disable=unused-argument + """Serialize Date object into ISO-8601 formatted string. + + :param Date attr: Object to be serialized. + :rtype: str + :return: serialized date + """ + if isinstance(attr, str): + attr = isodate.parse_date(attr) + t = "{:04}-{:02}-{:02}".format(attr.year, attr.month, attr.day) + return t + + @staticmethod + def serialize_time(attr, **kwargs): # pylint: disable=unused-argument + """Serialize Time object into ISO-8601 formatted string. + + :param datetime.time attr: Object to be serialized. + :rtype: str + :return: serialized time + """ + if isinstance(attr, str): + attr = isodate.parse_time(attr) + t = "{:02}:{:02}:{:02}".format(attr.hour, attr.minute, attr.second) + if attr.microsecond: + t += ".{:02}".format(attr.microsecond) + return t + + @staticmethod + def serialize_duration(attr, **kwargs): # pylint: disable=unused-argument + """Serialize TimeDelta object into ISO-8601 formatted string. + + :param TimeDelta attr: Object to be serialized. + :rtype: str + :return: serialized duration + """ + if isinstance(attr, str): + attr = isodate.parse_duration(attr) + return isodate.duration_isoformat(attr) + + @staticmethod + def serialize_rfc(attr, **kwargs): # pylint: disable=unused-argument + """Serialize Datetime object into RFC-1123 formatted string. + + :param Datetime attr: Object to be serialized. + :rtype: str + :raises TypeError: if format invalid. + :return: serialized rfc + """ + try: + if not attr.tzinfo: + _LOGGER.warning("Datetime with no tzinfo will be considered UTC.") + utc = attr.utctimetuple() + except AttributeError as exc: + raise TypeError("RFC1123 object must be valid Datetime object.") from exc + + return "{}, {:02} {} {:04} {:02}:{:02}:{:02} GMT".format( + Serializer.days[utc.tm_wday], + utc.tm_mday, + Serializer.months[utc.tm_mon], + utc.tm_year, + utc.tm_hour, + utc.tm_min, + utc.tm_sec, + ) + + @staticmethod + def serialize_iso(attr, **kwargs): # pylint: disable=unused-argument + """Serialize Datetime object into ISO-8601 formatted string. + + :param Datetime attr: Object to be serialized. + :rtype: str + :raises SerializationError: if format invalid. + :return: serialized iso + """ + if isinstance(attr, str): + attr = isodate.parse_datetime(attr) + try: + if not attr.tzinfo: + _LOGGER.warning("Datetime with no tzinfo will be considered UTC.") + utc = attr.utctimetuple() + if utc.tm_year > 9999 or utc.tm_year < 1: + raise OverflowError("Hit max or min date") + + microseconds = str(attr.microsecond).rjust(6, "0").rstrip("0").ljust(3, "0") + if microseconds: + microseconds = "." + microseconds + date = "{:04}-{:02}-{:02}T{:02}:{:02}:{:02}".format( + utc.tm_year, utc.tm_mon, utc.tm_mday, utc.tm_hour, utc.tm_min, utc.tm_sec + ) + return date + microseconds + "Z" + except (ValueError, OverflowError) as err: + msg = "Unable to serialize datetime object." + raise SerializationError(msg) from err + except AttributeError as err: + msg = "ISO-8601 object must be valid Datetime object." + raise TypeError(msg) from err + + @staticmethod + def serialize_unix(attr, **kwargs): # pylint: disable=unused-argument + """Serialize Datetime object into IntTime format. + This is represented as seconds. + + :param Datetime attr: Object to be serialized. + :rtype: int + :raises SerializationError: if format invalid + :return: serialied unix + """ + if isinstance(attr, int): + return attr + try: + if not attr.tzinfo: + _LOGGER.warning("Datetime with no tzinfo will be considered UTC.") + return int(calendar.timegm(attr.utctimetuple())) + except AttributeError as exc: + raise TypeError("Unix time object must be valid Datetime object.") from exc + + +def rest_key_extractor(attr, attr_desc, data): # pylint: disable=unused-argument + key = attr_desc["key"] + working_data = data + + while "." in key: + # Need the cast, as for some reasons "split" is typed as list[str | Any] + dict_keys = cast(list[str], _FLATTEN.split(key)) + if len(dict_keys) == 1: + key = _decode_attribute_map_key(dict_keys[0]) + break + working_key = _decode_attribute_map_key(dict_keys[0]) + working_data = working_data.get(working_key, data) + if working_data is None: + # If at any point while following flatten JSON path see None, it means + # that all properties under are None as well + return None + key = ".".join(dict_keys[1:]) + + return working_data.get(key) + + +def rest_key_case_insensitive_extractor( # pylint: disable=unused-argument, inconsistent-return-statements + attr, attr_desc, data +): + key = attr_desc["key"] + working_data = data + + while "." in key: + dict_keys = _FLATTEN.split(key) + if len(dict_keys) == 1: + key = _decode_attribute_map_key(dict_keys[0]) + break + working_key = _decode_attribute_map_key(dict_keys[0]) + working_data = attribute_key_case_insensitive_extractor(working_key, None, working_data) + if working_data is None: + # If at any point while following flatten JSON path see None, it means + # that all properties under are None as well + return None + key = ".".join(dict_keys[1:]) + + if working_data: + return attribute_key_case_insensitive_extractor(key, None, working_data) + + +def last_rest_key_extractor(attr, attr_desc, data): # pylint: disable=unused-argument + """Extract the attribute in "data" based on the last part of the JSON path key. + + :param str attr: The attribute to extract + :param dict attr_desc: The attribute description + :param dict data: The data to extract from + :rtype: object + :returns: The extracted attribute + """ + key = attr_desc["key"] + dict_keys = _FLATTEN.split(key) + return attribute_key_extractor(dict_keys[-1], None, data) + + +def last_rest_key_case_insensitive_extractor(attr, attr_desc, data): # pylint: disable=unused-argument + """Extract the attribute in "data" based on the last part of the JSON path key. + + This is the case insensitive version of "last_rest_key_extractor" + :param str attr: The attribute to extract + :param dict attr_desc: The attribute description + :param dict data: The data to extract from + :rtype: object + :returns: The extracted attribute + """ + key = attr_desc["key"] + dict_keys = _FLATTEN.split(key) + return attribute_key_case_insensitive_extractor(dict_keys[-1], None, data) + + +def attribute_key_extractor(attr, _, data): + return data.get(attr) + + +def attribute_key_case_insensitive_extractor(attr, _, data): + found_key = None + lower_attr = attr.lower() + for key in data: + if lower_attr == key.lower(): + found_key = key + break + + return data.get(found_key) + + +def _extract_name_from_internal_type(internal_type): + """Given an internal type XML description, extract correct XML name with namespace. + + :param dict internal_type: An model type + :rtype: tuple + :returns: A tuple XML name + namespace dict + """ + internal_type_xml_map = getattr(internal_type, "_xml_map", {}) + xml_name = internal_type_xml_map.get("name", internal_type.__name__) + xml_ns = internal_type_xml_map.get("ns", None) + if xml_ns: + xml_name = "{{{}}}{}".format(xml_ns, xml_name) + return xml_name + + +def xml_key_extractor(attr, attr_desc, data): # pylint: disable=unused-argument,too-many-return-statements + if isinstance(data, dict): + return None + + # Test if this model is XML ready first + if not isinstance(data, ET.Element): + return None + + xml_desc = attr_desc.get("xml", {}) + xml_name = xml_desc.get("name", attr_desc["key"]) + + # Look for a children + is_iter_type = attr_desc["type"].startswith("[") + is_wrapped = xml_desc.get("wrapped", False) + internal_type = attr_desc.get("internalType", None) + internal_type_xml_map = getattr(internal_type, "_xml_map", {}) + + # Integrate namespace if necessary + xml_ns = xml_desc.get("ns", internal_type_xml_map.get("ns", None)) + if xml_ns: + xml_name = "{{{}}}{}".format(xml_ns, xml_name) + + # If it's an attribute, that's simple + if xml_desc.get("attr", False): + return data.get(xml_name) + + # If it's x-ms-text, that's simple too + if xml_desc.get("text", False): + return data.text + + # Scenario where I take the local name: + # - Wrapped node + # - Internal type is an enum (considered basic types) + # - Internal type has no XML/Name node + if is_wrapped or (internal_type and (issubclass(internal_type, Enum) or "name" not in internal_type_xml_map)): + children = data.findall(xml_name) + # If internal type has a local name and it's not a list, I use that name + elif not is_iter_type and internal_type and "name" in internal_type_xml_map: + xml_name = _extract_name_from_internal_type(internal_type) + children = data.findall(xml_name) + # That's an array + else: + if internal_type: # Complex type, ignore itemsName and use the complex type name + items_name = _extract_name_from_internal_type(internal_type) + else: + items_name = xml_desc.get("itemsName", xml_name) + children = data.findall(items_name) + + if len(children) == 0: + if is_iter_type: + if is_wrapped: + return None # is_wrapped no node, we want None + return [] # not wrapped, assume empty list + return None # Assume it's not there, maybe an optional node. + + # If is_iter_type and not wrapped, return all found children + if is_iter_type: + if not is_wrapped: + return children + # Iter and wrapped, should have found one node only (the wrap one) + if len(children) != 1: + raise DeserializationError( + "Tried to deserialize an array not wrapped, and found several nodes '{}'. Maybe you should declare this array as wrapped?".format( + xml_name + ) + ) + return list(children[0]) # Might be empty list and that's ok. + + # Here it's not a itertype, we should have found one element only or empty + if len(children) > 1: + raise DeserializationError("Find several XML '{}' where it was not expected".format(xml_name)) + return children[0] + + +class Deserializer: + """Response object model deserializer. + + :param dict classes: Class type dictionary for deserializing complex types. + :ivar list key_extractors: Ordered list of extractors to be used by this deserializer. + """ + + basic_types = {str: "str", int: "int", bool: "bool", float: "float"} + + valid_date = re.compile(r"\d{4}[-]\d{2}[-]\d{2}T\d{2}:\d{2}:\d{2}\.?\d*Z?[-+]?[\d{2}]?:?[\d{2}]?") + + def __init__(self, classes: Optional[Mapping[str, type]] = None) -> None: + self.deserialize_type = { + "iso-8601": Deserializer.deserialize_iso, + "rfc-1123": Deserializer.deserialize_rfc, + "unix-time": Deserializer.deserialize_unix, + "duration": Deserializer.deserialize_duration, + "date": Deserializer.deserialize_date, + "time": Deserializer.deserialize_time, + "decimal": Deserializer.deserialize_decimal, + "long": Deserializer.deserialize_long, + "bytearray": Deserializer.deserialize_bytearray, + "base64": Deserializer.deserialize_base64, + "object": self.deserialize_object, + "[]": self.deserialize_iter, + "{}": self.deserialize_dict, + } + self.deserialize_expected_types = { + "duration": (isodate.Duration, datetime.timedelta), + "iso-8601": (datetime.datetime), + } + self.dependencies: dict[str, type] = dict(classes) if classes else {} + self.key_extractors = [rest_key_extractor, xml_key_extractor] + # Additional properties only works if the "rest_key_extractor" is used to + # extract the keys. Making it to work whatever the key extractor is too much + # complicated, with no real scenario for now. + # So adding a flag to disable additional properties detection. This flag should be + # used if your expect the deserialization to NOT come from a JSON REST syntax. + # Otherwise, result are unexpected + self.additional_properties_detection = True + + def __call__(self, target_obj, response_data, content_type=None): + """Call the deserializer to process a REST response. + + :param str target_obj: Target data type to deserialize to. + :param requests.Response response_data: REST response object. + :param str content_type: Swagger "produces" if available. + :raises DeserializationError: if deserialization fails. + :return: Deserialized object. + :rtype: object + """ + data = self._unpack_content(response_data, content_type) + return self._deserialize(target_obj, data) + + def _deserialize(self, target_obj, data): # pylint: disable=inconsistent-return-statements + """Call the deserializer on a model. + + Data needs to be already deserialized as JSON or XML ElementTree + + :param str target_obj: Target data type to deserialize to. + :param object data: Object to deserialize. + :raises DeserializationError: if deserialization fails. + :return: Deserialized object. + :rtype: object + """ + # This is already a model, go recursive just in case + if hasattr(data, "_attribute_map"): + constants = [name for name, config in getattr(data, "_validation", {}).items() if config.get("constant")] + try: + for attr, mapconfig in data._attribute_map.items(): # pylint: disable=protected-access + if attr in constants: + continue + value = getattr(data, attr) + if value is None: + continue + local_type = mapconfig["type"] + internal_data_type = local_type.strip("[]{}") + if internal_data_type not in self.dependencies or isinstance(internal_data_type, Enum): + continue + setattr(data, attr, self._deserialize(local_type, value)) + return data + except AttributeError: + return + + response, class_name = self._classify_target(target_obj, data) + + if isinstance(response, str): + return self.deserialize_data(data, response) + if isinstance(response, type) and issubclass(response, Enum): + return self.deserialize_enum(data, response) + + if data is None or data is CoreNull: + return data + try: + attributes = response._attribute_map # type: ignore # pylint: disable=protected-access + d_attrs = {} + for attr, attr_desc in attributes.items(): + # Check empty string. If it's not empty, someone has a real "additionalProperties"... + if attr == "additional_properties" and attr_desc["key"] == "": + continue + raw_value = None + # Enhance attr_desc with some dynamic data + attr_desc = attr_desc.copy() # Do a copy, do not change the real one + internal_data_type = attr_desc["type"].strip("[]{}") + if internal_data_type in self.dependencies: + attr_desc["internalType"] = self.dependencies[internal_data_type] + + for key_extractor in self.key_extractors: + found_value = key_extractor(attr, attr_desc, data) + if found_value is not None: + if raw_value is not None and raw_value != found_value: + msg = ( + "Ignoring extracted value '%s' from %s for key '%s'" + " (duplicate extraction, follow extractors order)" + ) + _LOGGER.warning(msg, found_value, key_extractor, attr) + continue + raw_value = found_value + + value = self.deserialize_data(raw_value, attr_desc["type"]) + d_attrs[attr] = value + except (AttributeError, TypeError, KeyError) as err: + msg = "Unable to deserialize to object: " + class_name # type: ignore + raise DeserializationError(msg) from err + additional_properties = self._build_additional_properties(attributes, data) + return self._instantiate_model(response, d_attrs, additional_properties) + + def _build_additional_properties(self, attribute_map, data): + if not self.additional_properties_detection: + return None + if "additional_properties" in attribute_map and attribute_map.get("additional_properties", {}).get("key") != "": + # Check empty string. If it's not empty, someone has a real "additionalProperties" + return None + if isinstance(data, ET.Element): + data = {el.tag: el.text for el in data} + + known_keys = { + _decode_attribute_map_key(_FLATTEN.split(desc["key"])[0]) + for desc in attribute_map.values() + if desc["key"] != "" + } + present_keys = set(data.keys()) + missing_keys = present_keys - known_keys + return {key: data[key] for key in missing_keys} + + def _classify_target(self, target, data): + """Check to see whether the deserialization target object can + be classified into a subclass. + Once classification has been determined, initialize object. + + :param str target: The target object type to deserialize to. + :param str/dict data: The response data to deserialize. + :return: The classified target object and its class name. + :rtype: tuple + """ + if target is None: + return None, None + + if isinstance(target, str): + try: + target = self.dependencies[target] + except KeyError: + return target, target + + try: + target = target._classify(data, self.dependencies) # type: ignore # pylint: disable=protected-access + except AttributeError: + pass # Target is not a Model, no classify + return target, target.__class__.__name__ # type: ignore + + def failsafe_deserialize(self, target_obj, data, content_type=None): + """Ignores any errors encountered in deserialization, + and falls back to not deserializing the object. Recommended + for use in error deserialization, as we want to return the + HttpResponseError to users, and not have them deal with + a deserialization error. + + :param str target_obj: The target object type to deserialize to. + :param str/dict data: The response data to deserialize. + :param str content_type: Swagger "produces" if available. + :return: Deserialized object. + :rtype: object + """ + try: + return self(target_obj, data, content_type=content_type) + except: # pylint: disable=bare-except + _LOGGER.debug( + "Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True + ) + return None + + @staticmethod + def _unpack_content(raw_data, content_type=None): + """Extract the correct structure for deserialization. + + If raw_data is a PipelineResponse, try to extract the result of RawDeserializer. + if we can't, raise. Your Pipeline should have a RawDeserializer. + + If not a pipeline response and raw_data is bytes or string, use content-type + to decode it. If no content-type, try JSON. + + If raw_data is something else, bypass all logic and return it directly. + + :param obj raw_data: Data to be processed. + :param str content_type: How to parse if raw_data is a string/bytes. + :raises JSONDecodeError: If JSON is requested and parsing is impossible. + :raises UnicodeDecodeError: If bytes is not UTF8 + :rtype: object + :return: Unpacked content. + """ + # Assume this is enough to detect a Pipeline Response without importing it + context = getattr(raw_data, "context", {}) + if context: + if RawDeserializer.CONTEXT_NAME in context: + return context[RawDeserializer.CONTEXT_NAME] + raise ValueError("This pipeline didn't have the RawDeserializer policy; can't deserialize") + + # Assume this is enough to recognize universal_http.ClientResponse without importing it + if hasattr(raw_data, "body"): + return RawDeserializer.deserialize_from_http_generics(raw_data.text(), raw_data.headers) + + # Assume this enough to recognize requests.Response without importing it. + if hasattr(raw_data, "_content_consumed"): + return RawDeserializer.deserialize_from_http_generics(raw_data.text, raw_data.headers) + + if isinstance(raw_data, (str, bytes)) or hasattr(raw_data, "read"): + return RawDeserializer.deserialize_from_text(raw_data, content_type) # type: ignore + return raw_data + + def _instantiate_model(self, response, attrs, additional_properties=None): + """Instantiate a response model passing in deserialized args. + + :param Response response: The response model class. + :param dict attrs: The deserialized response attributes. + :param dict additional_properties: Additional properties to be set. + :rtype: Response + :return: The instantiated response model. + """ + if callable(response): + subtype = getattr(response, "_subtype_map", {}) + try: + readonly = [ + k + for k, v in response._validation.items() # pylint: disable=protected-access # type: ignore + if v.get("readonly") + ] + const = [ + k + for k, v in response._validation.items() # pylint: disable=protected-access # type: ignore + if v.get("constant") + ] + kwargs = {k: v for k, v in attrs.items() if k not in subtype and k not in readonly + const} + response_obj = response(**kwargs) + for attr in readonly: + setattr(response_obj, attr, attrs.get(attr)) + if additional_properties: + response_obj.additional_properties = additional_properties # type: ignore + return response_obj + except TypeError as err: + msg = "Unable to deserialize {} into model {}. ".format(kwargs, response) # type: ignore + raise DeserializationError(msg + str(err)) from err + else: + try: + for attr, value in attrs.items(): + setattr(response, attr, value) + return response + except Exception as exp: + msg = "Unable to populate response model. " + msg += "Type: {}, Error: {}".format(type(response), exp) + raise DeserializationError(msg) from exp + + def deserialize_data(self, data, data_type): # pylint: disable=too-many-return-statements + """Process data for deserialization according to data type. + + :param str data: The response string to be deserialized. + :param str data_type: The type to deserialize to. + :raises DeserializationError: if deserialization fails. + :return: Deserialized object. + :rtype: object + """ + if data is None: + return data + + try: + if not data_type: + return data + if data_type in self.basic_types.values(): + return self.deserialize_basic(data, data_type) + if data_type in self.deserialize_type: + if isinstance(data, self.deserialize_expected_types.get(data_type, tuple())): + return data + + is_a_text_parsing_type = lambda x: x not in [ # pylint: disable=unnecessary-lambda-assignment + "object", + "[]", + r"{}", + ] + if isinstance(data, ET.Element) and is_a_text_parsing_type(data_type) and not data.text: + return None + data_val = self.deserialize_type[data_type](data) + return data_val + + iter_type = data_type[0] + data_type[-1] + if iter_type in self.deserialize_type: + return self.deserialize_type[iter_type](data, data_type[1:-1]) + + obj_type = self.dependencies[data_type] + if issubclass(obj_type, Enum): + if isinstance(data, ET.Element): + data = data.text + return self.deserialize_enum(data, obj_type) + + except (ValueError, TypeError, AttributeError) as err: + msg = "Unable to deserialize response data." + msg += " Data: {}, {}".format(data, data_type) + raise DeserializationError(msg) from err + return self._deserialize(obj_type, data) + + def deserialize_iter(self, attr, iter_type): + """Deserialize an iterable. + + :param list attr: Iterable to be deserialized. + :param str iter_type: The type of object in the iterable. + :return: Deserialized iterable. + :rtype: list + """ + if attr is None: + return None + if isinstance(attr, ET.Element): # If I receive an element here, get the children + attr = list(attr) + if not isinstance(attr, (list, set)): + raise DeserializationError("Cannot deserialize as [{}] an object of type {}".format(iter_type, type(attr))) + return [self.deserialize_data(a, iter_type) for a in attr] + + def deserialize_dict(self, attr, dict_type): + """Deserialize a dictionary. + + :param dict/list attr: Dictionary to be deserialized. Also accepts + a list of key, value pairs. + :param str dict_type: The object type of the items in the dictionary. + :return: Deserialized dictionary. + :rtype: dict + """ + if isinstance(attr, list): + return {x["key"]: self.deserialize_data(x["value"], dict_type) for x in attr} + + if isinstance(attr, ET.Element): + # Transform value into {"Key": "value"} + attr = {el.tag: el.text for el in attr} + return {k: self.deserialize_data(v, dict_type) for k, v in attr.items()} + + def deserialize_object(self, attr, **kwargs): # pylint: disable=too-many-return-statements + """Deserialize a generic object. + This will be handled as a dictionary. + + :param dict attr: Dictionary to be deserialized. + :return: Deserialized object. + :rtype: dict + :raises TypeError: if non-builtin datatype encountered. + """ + if attr is None: + return None + if isinstance(attr, ET.Element): + # Do no recurse on XML, just return the tree as-is + return attr + if isinstance(attr, str): + return self.deserialize_basic(attr, "str") + obj_type = type(attr) + if obj_type in self.basic_types: + return self.deserialize_basic(attr, self.basic_types[obj_type]) + if obj_type is _long_type: + return self.deserialize_long(attr) + + if obj_type == dict: + deserialized = {} + for key, value in attr.items(): + try: + deserialized[key] = self.deserialize_object(value, **kwargs) + except ValueError: + deserialized[key] = None + return deserialized + + if obj_type == list: + deserialized = [] + for obj in attr: + try: + deserialized.append(self.deserialize_object(obj, **kwargs)) + except ValueError: + pass + return deserialized + + error = "Cannot deserialize generic object with type: " + raise TypeError(error + str(obj_type)) + + def deserialize_basic(self, attr, data_type): # pylint: disable=too-many-return-statements + """Deserialize basic builtin data type from string. + Will attempt to convert to str, int, float and bool. + This function will also accept '1', '0', 'true' and 'false' as + valid bool values. + + :param str attr: response string to be deserialized. + :param str data_type: deserialization data type. + :return: Deserialized basic type. + :rtype: str, int, float or bool + :raises TypeError: if string format is not valid. + """ + # If we're here, data is supposed to be a basic type. + # If it's still an XML node, take the text + if isinstance(attr, ET.Element): + attr = attr.text + if not attr: + if data_type == "str": + # None or '', node is empty string. + return "" + # None or '', node with a strong type is None. + # Don't try to model "empty bool" or "empty int" + return None + + if data_type == "bool": + if attr in [True, False, 1, 0]: + return bool(attr) + if isinstance(attr, str): + if attr.lower() in ["true", "1"]: + return True + if attr.lower() in ["false", "0"]: + return False + raise TypeError("Invalid boolean value: {}".format(attr)) + + if data_type == "str": + return self.deserialize_unicode(attr) + return eval(data_type)(attr) # nosec # pylint: disable=eval-used + + @staticmethod + def deserialize_unicode(data): + """Preserve unicode objects in Python 2, otherwise return data + as a string. + + :param str data: response string to be deserialized. + :return: Deserialized string. + :rtype: str or unicode + """ + # We might be here because we have an enum modeled as string, + # and we try to deserialize a partial dict with enum inside + if isinstance(data, Enum): + return data + + # Consider this is real string + try: + if isinstance(data, unicode): # type: ignore + return data + except NameError: + return str(data) + return str(data) + + @staticmethod + def deserialize_enum(data, enum_obj): + """Deserialize string into enum object. + + If the string is not a valid enum value it will be returned as-is + and a warning will be logged. + + :param str data: Response string to be deserialized. If this value is + None or invalid it will be returned as-is. + :param Enum enum_obj: Enum object to deserialize to. + :return: Deserialized enum object. + :rtype: Enum + """ + if isinstance(data, enum_obj) or data is None: + return data + if isinstance(data, Enum): + data = data.value + if isinstance(data, int): + # Workaround. We might consider remove it in the future. + try: + return list(enum_obj.__members__.values())[data] + except IndexError as exc: + error = "{!r} is not a valid index for enum {!r}" + raise DeserializationError(error.format(data, enum_obj)) from exc + try: + return enum_obj(str(data)) + except ValueError: + for enum_value in enum_obj: + if enum_value.value.lower() == str(data).lower(): + return enum_value + # We don't fail anymore for unknown value, we deserialize as a string + _LOGGER.warning("Deserializer is not able to find %s as valid enum in %s", data, enum_obj) + return Deserializer.deserialize_unicode(data) + + @staticmethod + def deserialize_bytearray(attr): + """Deserialize string into bytearray. + + :param str attr: response string to be deserialized. + :return: Deserialized bytearray + :rtype: bytearray + :raises TypeError: if string format invalid. + """ + if isinstance(attr, ET.Element): + attr = attr.text + return bytearray(b64decode(attr)) # type: ignore + + @staticmethod + def deserialize_base64(attr): + """Deserialize base64 encoded string into string. + + :param str attr: response string to be deserialized. + :return: Deserialized base64 string + :rtype: bytearray + :raises TypeError: if string format invalid. + """ + if isinstance(attr, ET.Element): + attr = attr.text + padding = "=" * (3 - (len(attr) + 3) % 4) # type: ignore + attr = attr + padding # type: ignore + encoded = attr.replace("-", "+").replace("_", "/") + return b64decode(encoded) + + @staticmethod + def deserialize_decimal(attr): + """Deserialize string into Decimal object. + + :param str attr: response string to be deserialized. + :return: Deserialized decimal + :raises DeserializationError: if string format invalid. + :rtype: decimal + """ + if isinstance(attr, ET.Element): + attr = attr.text + try: + return decimal.Decimal(str(attr)) # type: ignore + except decimal.DecimalException as err: + msg = "Invalid decimal {}".format(attr) + raise DeserializationError(msg) from err + + @staticmethod + def deserialize_long(attr): + """Deserialize string into long (Py2) or int (Py3). + + :param str attr: response string to be deserialized. + :return: Deserialized int + :rtype: long or int + :raises ValueError: if string format invalid. + """ + if isinstance(attr, ET.Element): + attr = attr.text + return _long_type(attr) # type: ignore + + @staticmethod + def deserialize_duration(attr): + """Deserialize ISO-8601 formatted string into TimeDelta object. + + :param str attr: response string to be deserialized. + :return: Deserialized duration + :rtype: TimeDelta + :raises DeserializationError: if string format invalid. + """ + if isinstance(attr, ET.Element): + attr = attr.text + try: + duration = isodate.parse_duration(attr) + except (ValueError, OverflowError, AttributeError) as err: + msg = "Cannot deserialize duration object." + raise DeserializationError(msg) from err + return duration + + @staticmethod + def deserialize_date(attr): + """Deserialize ISO-8601 formatted string into Date object. + + :param str attr: response string to be deserialized. + :return: Deserialized date + :rtype: Date + :raises DeserializationError: if string format invalid. + """ + if isinstance(attr, ET.Element): + attr = attr.text + if re.search(r"[^\W\d_]", attr, re.I + re.U): # type: ignore + raise DeserializationError("Date must have only digits and -. Received: %s" % attr) + # This must NOT use defaultmonth/defaultday. Using None ensure this raises an exception. + return isodate.parse_date(attr, defaultmonth=0, defaultday=0) + + @staticmethod + def deserialize_time(attr): + """Deserialize ISO-8601 formatted string into time object. + + :param str attr: response string to be deserialized. + :return: Deserialized time + :rtype: datetime.time + :raises DeserializationError: if string format invalid. + """ + if isinstance(attr, ET.Element): + attr = attr.text + if re.search(r"[^\W\d_]", attr, re.I + re.U): # type: ignore + raise DeserializationError("Date must have only digits and -. Received: %s" % attr) + return isodate.parse_time(attr) + + @staticmethod + def deserialize_rfc(attr): + """Deserialize RFC-1123 formatted string into Datetime object. + + :param str attr: response string to be deserialized. + :return: Deserialized RFC datetime + :rtype: Datetime + :raises DeserializationError: if string format invalid. + """ + if isinstance(attr, ET.Element): + attr = attr.text + try: + parsed_date = email.utils.parsedate_tz(attr) # type: ignore + date_obj = datetime.datetime( + *parsed_date[:6], tzinfo=datetime.timezone(datetime.timedelta(minutes=(parsed_date[9] or 0) / 60)) + ) + if not date_obj.tzinfo: + date_obj = date_obj.astimezone(tz=TZ_UTC) + except ValueError as err: + msg = "Cannot deserialize to rfc datetime object." + raise DeserializationError(msg) from err + return date_obj + + @staticmethod + def deserialize_iso(attr): + """Deserialize ISO-8601 formatted string into Datetime object. + + :param str attr: response string to be deserialized. + :return: Deserialized ISO datetime + :rtype: Datetime + :raises DeserializationError: if string format invalid. + """ + if isinstance(attr, ET.Element): + attr = attr.text + try: + attr = attr.upper() # type: ignore + match = Deserializer.valid_date.match(attr) + if not match: + raise ValueError("Invalid datetime string: " + attr) + + check_decimal = attr.split(".") + if len(check_decimal) > 1: + decimal_str = "" + for digit in check_decimal[1]: + if digit.isdigit(): + decimal_str += digit + else: + break + if len(decimal_str) > 6: + attr = attr.replace(decimal_str, decimal_str[0:6]) + + date_obj = isodate.parse_datetime(attr) + test_utc = date_obj.utctimetuple() + if test_utc.tm_year > 9999 or test_utc.tm_year < 1: + raise OverflowError("Hit max or min date") + except (ValueError, OverflowError, AttributeError) as err: + msg = "Cannot deserialize datetime object." + raise DeserializationError(msg) from err + return date_obj + + @staticmethod + def deserialize_unix(attr): + """Serialize Datetime object into IntTime format. + This is represented as seconds. + + :param int attr: Object to be serialized. + :return: Deserialized datetime + :rtype: Datetime + :raises DeserializationError: if format invalid + """ + if isinstance(attr, ET.Element): + attr = int(attr.text) # type: ignore + try: + attr = int(attr) + date_obj = datetime.datetime.fromtimestamp(attr, TZ_UTC) + except ValueError as err: + msg = "Cannot deserialize to unix datetime object." + raise DeserializationError(msg) from err + return date_obj diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/utils.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/utils.py new file mode 100644 index 000000000000..35c9c836f85f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_utils/utils.py @@ -0,0 +1,25 @@ +# -------------------------------------------------------------------------- +# 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 abc import ABC +from typing import Generic, TYPE_CHECKING, TypeVar + +if TYPE_CHECKING: + from .serialization import Deserializer, Serializer + + +TClient = TypeVar("TClient") +TConfig = TypeVar("TConfig") + + +class ClientMixinABC(ABC, Generic[TClient, TConfig]): + """DO NOT use this class. It is for internal typing use only.""" + + _client: TClient + _config: TConfig + _serialize: "Serializer" + _deserialize: "Deserializer" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_validation.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_validation.py new file mode 100644 index 000000000000..f5af3a4eb8a2 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_validation.py @@ -0,0 +1,66 @@ +# -------------------------------------------------------------------------- +# 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. +# -------------------------------------------------------------------------- +import functools + + +def api_version_validation(**kwargs): + params_added_on = kwargs.pop("params_added_on", {}) + method_added_on = kwargs.pop("method_added_on", "") + api_versions_list = kwargs.pop("api_versions_list", []) + + def _index_with_default(value: str, default: int = -1) -> int: + """Get the index of value in lst, or return default if not found. + + :param value: The value to search for in the api_versions_list. + :type value: str + :param default: The default value to return if the value is not found. + :type default: int + :return: The index of the value in the list, or the default value if not found. + :rtype: int + """ + try: + return api_versions_list.index(value) + except ValueError: + return default + + def decorator(func): + @functools.wraps(func) + def wrapper(*args, **kwargs): + try: + # this assumes the client has an _api_version attribute + client = args[0] + client_api_version = client._config.api_version # pylint: disable=protected-access + except AttributeError: + return func(*args, **kwargs) + + if _index_with_default(method_added_on) > _index_with_default(client_api_version): + raise ValueError( + f"'{func.__name__}' is not available in API version " + f"{client_api_version}. Pass service API version {method_added_on} or newer to your client." + ) + + unsupported = { + parameter: api_version + for api_version, parameters in params_added_on.items() + for parameter in parameters + if parameter in kwargs and _index_with_default(api_version) > _index_with_default(client_api_version) + } + if unsupported: + raise ValueError( + "".join( + [ + f"'{param}' is not available in API version {client_api_version}. " + f"Use service API version {version} or newer.\n" + for param, version in unsupported.items() + ] + ) + ) + return func(*args, **kwargs) + + return wrapper + + return decorator diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_version.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_version.py new file mode 100644 index 000000000000..be71c81bd282 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_version.py @@ -0,0 +1,9 @@ +# 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. +# -------------------------------------------------------------------------- + +VERSION = "1.0.0b1" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/__init__.py new file mode 100644 index 000000000000..a22f0fcf4d7a --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/__init__.py @@ -0,0 +1,29 @@ +# 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 + +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() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_client.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_client.py new file mode 100644 index 000000000000..c0445231fcdd --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_client.py @@ -0,0 +1,107 @@ +# 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, Awaitable, TYPE_CHECKING, Union +from typing_extensions import Self + +from azure.core import AsyncPipelineClient +from azure.core.credentials import AzureKeyCredential +from azure.core.pipeline import policies +from azure.core.rest import AsyncHttpResponse, HttpRequest + +from .._utils.serialization import Deserializer, Serializer +from ._configuration import ContentUnderstandingClientConfiguration +from ._operations import _ContentUnderstandingClientOperationsMixin + +if TYPE_CHECKING: + from azure.core.credentials_async import AsyncTokenCredential + + +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_async.AsyncTokenCredential + :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, "AsyncTokenCredential"], **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: AsyncPipelineClient = AsyncPipelineClient(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 + ) -> Awaitable[AsyncHttpResponse]: + """Runs the network request through the client's chained policies. + + >>> from azure.core.rest import HttpRequest + >>> request = HttpRequest("GET", "https://www.example.org/") + + >>> response = await client.send_request(request) + + + 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.AsyncHttpResponse + """ + + 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 + + async def close(self) -> None: + await self._client.close() + + async def __aenter__(self) -> Self: + await self._client.__aenter__() + return self + + async def __aexit__(self, *exc_details: Any) -> None: + await self._client.__aexit__(*exc_details) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_configuration.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_configuration.py new file mode 100644 index 000000000000..3dcb9b1b2fbc --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_configuration.py @@ -0,0 +1,73 @@ +# 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 typing import Any, TYPE_CHECKING, Union + +from azure.core.credentials import AzureKeyCredential +from azure.core.pipeline import policies + +from .._version import VERSION + +if TYPE_CHECKING: + from azure.core.credentials_async import AsyncTokenCredential + + +class ContentUnderstandingClientConfiguration: # pylint: disable=too-many-instance-attributes + """Configuration for ContentUnderstandingClient. + + Note that all parameters used to create this instance are saved as instance + attributes. + + :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_async.AsyncTokenCredential + :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 + """ + + def __init__( + self, endpoint: str, credential: Union[AzureKeyCredential, "AsyncTokenCredential"], **kwargs: Any + ) -> None: + api_version: str = kwargs.pop("api_version", "2025-11-01") + + if endpoint is None: + raise ValueError("Parameter 'endpoint' must not be None.") + if credential is None: + raise ValueError("Parameter 'credential' must not be None.") + + self.endpoint = endpoint + self.credential = credential + self.api_version = api_version + self.credential_scopes = kwargs.pop("credential_scopes", ["https://cognitiveservices.azure.com/.default"]) + kwargs.setdefault("sdk_moniker", "ai-contentunderstanding/{}".format(VERSION)) + self.polling_interval = kwargs.get("polling_interval", 30) + self._configure(**kwargs) + + def _infer_policy(self, **kwargs): + if isinstance(self.credential, AzureKeyCredential): + return policies.AzureKeyCredentialPolicy(self.credential, "Ocp-Apim-Subscription-Key", **kwargs) + if hasattr(self.credential, "get_token"): + return policies.AsyncBearerTokenCredentialPolicy(self.credential, *self.credential_scopes, **kwargs) + raise TypeError(f"Unsupported credential: {self.credential}") + + def _configure(self, **kwargs: Any) -> None: + self.user_agent_policy = kwargs.get("user_agent_policy") or policies.UserAgentPolicy(**kwargs) + self.headers_policy = kwargs.get("headers_policy") or policies.HeadersPolicy(**kwargs) + self.proxy_policy = kwargs.get("proxy_policy") or policies.ProxyPolicy(**kwargs) + self.logging_policy = kwargs.get("logging_policy") or policies.NetworkTraceLoggingPolicy(**kwargs) + self.http_logging_policy = kwargs.get("http_logging_policy") or policies.HttpLoggingPolicy(**kwargs) + self.custom_hook_policy = kwargs.get("custom_hook_policy") or policies.CustomHookPolicy(**kwargs) + self.redirect_policy = kwargs.get("redirect_policy") or policies.AsyncRedirectPolicy(**kwargs) + self.retry_policy = kwargs.get("retry_policy") or policies.AsyncRetryPolicy(**kwargs) + self.authentication_policy = kwargs.get("authentication_policy") + if self.credential and not self.authentication_policy: + self.authentication_policy = self._infer_policy(**kwargs) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/__init__.py new file mode 100644 index 000000000000..36e7d1668ee5 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/__init__.py @@ -0,0 +1,23 @@ +# 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 ._operations import _ContentUnderstandingClientOperationsMixin # type: ignore # pylint: disable=unused-import + +from ._patch import __all__ as _patch_all +from ._patch import * +from ._patch import patch_sdk as _patch_sdk + +__all__ = [] +__all__.extend([p for p in _patch_all if p not in __all__]) # pyright: ignore +_patch_sdk() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py new file mode 100644 index 000000000000..5ea8b0491723 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py @@ -0,0 +1,2051 @@ +# pylint: disable=line-too-long,useless-suppression,too-many-lines +# 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 collections.abc import MutableMapping +from io import IOBase +import json +from typing import Any, AsyncIterator, Callable, IO, Optional, TypeVar, Union, cast, overload +import urllib.parse + +from azure.core import AsyncPipelineClient +from azure.core.async_paging import AsyncItemPaged, AsyncList +from azure.core.exceptions import ( + ClientAuthenticationError, + HttpResponseError, + ResourceExistsError, + ResourceNotFoundError, + ResourceNotModifiedError, + StreamClosedError, + StreamConsumedError, + map_error, +) +from azure.core.pipeline import PipelineResponse +from azure.core.polling import AsyncLROPoller, AsyncNoPolling, AsyncPollingMethod +from azure.core.polling.async_base_polling import AsyncLROBasePolling +from azure.core.rest import AsyncHttpResponse, HttpRequest +from azure.core.tracing.decorator import distributed_trace +from azure.core.tracing.decorator_async import distributed_trace_async +from azure.core.utils import case_insensitive_dict + +from ... import models as _models +from ..._operations._operations import ( + build_content_understanding_analyze_binary_request, + build_content_understanding_analyze_request, + build_content_understanding_copy_request, + build_content_understanding_create_or_replace_request, + build_content_understanding_delete_request, + build_content_understanding_delete_result_request, + build_content_understanding_get_defaults_request, + build_content_understanding_get_operation_status_request, + build_content_understanding_get_request, + build_content_understanding_get_result_file_request, + build_content_understanding_get_result_request, + build_content_understanding_grant_copy_authorization_request, + build_content_understanding_list_request, + build_content_understanding_update_defaults_request, + build_content_understanding_update_request, +) +from ..._utils.model_base import SdkJSONEncoder, _deserialize +from ..._utils.utils import ClientMixinABC +from ..._validation import api_version_validation +from .._configuration import ContentUnderstandingClientConfiguration + +JSON = MutableMapping[str, Any] +_Unset: Any = object() +T = TypeVar("T") +ClsType = Optional[Callable[[PipelineResponse[HttpRequest, AsyncHttpResponse], T, dict[str, Any]], Any]] +List = list + + +class _ContentUnderstandingClientOperationsMixin( + ClientMixinABC[AsyncPipelineClient[HttpRequest, AsyncHttpResponse], ContentUnderstandingClientConfiguration] +): + + async def _analyze_initial( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + inputs: Optional[List[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any + ) -> AsyncIterator[bytes]: + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) + + if body is _Unset: + body = {"inputs": inputs, "modelDeployments": model_deployments} + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_analyze_request( + analyzer_id=analyzer_id, + string_encoding=string_encoding, + processing_location=processing_location, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [202]: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + async def begin_analyze( + self, + analyzer_id: str, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + inputs: Optional[List[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any + ) -> AsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. Default + value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of AsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping + :rtype: ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def begin_analyze( + self, + analyzer_id: str, + body: JSON, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> AsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: JSON + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping + :rtype: ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def begin_analyze( + self, + analyzer_id: str, + body: IO[bytes], + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> AsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: IO[bytes] + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping + :rtype: ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + async def begin_analyze( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + inputs: Optional[List[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any + ) -> AsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Is either a JSON type or a IO[bytes] type. Required. + :type body: JSON or IO[bytes] + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. Default + value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of AsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping + :rtype: ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.AnalyzeResult] = kwargs.pop("cls", None) + polling: Union[bool, AsyncPollingMethod] = kwargs.pop("polling", True) + lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) + cont_token: Optional[str] = kwargs.pop("continuation_token", None) + if cont_token is None: + raw_result = await self._analyze_initial( + analyzer_id=analyzer_id, + body=body, + string_encoding=string_encoding, + processing_location=processing_location, + inputs=inputs, + model_deployments=model_deployments, + content_type=content_type, + cls=lambda x, y, z: x, + headers=_headers, + params=_params, + **kwargs + ) + await raw_result.http_response.read() # type: ignore + kwargs.pop("error_map", None) + + def get_long_running_output(pipeline_response): + response_headers = {} + response = pipeline_response.http_response + response_headers["Operation-Location"] = self._deserialize( + "str", response.headers.get("Operation-Location") + ) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = _deserialize(_models.AnalyzeResult, response.json().get("result", {})) + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + return deserialized + + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + + if polling is True: + polling_method: AsyncPollingMethod = cast( + AsyncPollingMethod, + AsyncLROBasePolling(lro_delay, path_format_arguments=path_format_arguments, **kwargs), + ) + elif polling is False: + polling_method = cast(AsyncPollingMethod, AsyncNoPolling()) + else: + polling_method = polling + if cont_token: + return AsyncLROPoller[_models.AnalyzeResult].from_continuation_token( + polling_method=polling_method, + continuation_token=cont_token, + client=self._client, + deserialization_callback=get_long_running_output, + ) + return AsyncLROPoller[_models.AnalyzeResult]( + self._client, raw_result, get_long_running_output, polling_method # type: ignore + ) + + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={ + "2025-11-01": [ + "api_version", + "analyzer_id", + "string_encoding", + "processing_location", + "content_type", + "input_range", + "client_request_id", + "accept", + ] + }, + api_versions_list=["2025-11-01"], + ) + async def _analyze_binary_initial( + self, + analyzer_id: str, + binary_input: bytes, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + input_range: Optional[str] = None, + **kwargs: Any + ) -> AsyncIterator[bytes]: + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + content_type: str = kwargs.pop("content_type") + cls: ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) + + _content = binary_input + + _request = build_content_understanding_analyze_binary_request( + analyzer_id=analyzer_id, + string_encoding=string_encoding, + processing_location=processing_location, + input_range=input_range, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [202]: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @distributed_trace_async + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={ + "2025-11-01": [ + "api_version", + "analyzer_id", + "string_encoding", + "processing_location", + "content_type", + "input_range", + "client_request_id", + "accept", + ] + }, + api_versions_list=["2025-11-01"], + ) + async def begin_analyze_binary( + self, + analyzer_id: str, + binary_input: bytes, + *, + string_encoding: Optional[str] = None, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + input_range: Optional[str] = None, + **kwargs: Any + ) -> AsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param binary_input: The binary content of the document to analyze. Required. + :type binary_input: bytes + :keyword string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + Default value is None. + :paramtype string_encoding: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses + 1-based page numbers, while audio visual content uses integer milliseconds. Default value is + None. + :paramtype input_range: str + :return: An instance of AsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping + :rtype: ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + content_type: str = kwargs.pop("content_type") + cls: ClsType[_models.AnalyzeResult] = kwargs.pop("cls", None) + polling: Union[bool, AsyncPollingMethod] = kwargs.pop("polling", True) + lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) + cont_token: Optional[str] = kwargs.pop("continuation_token", None) + if cont_token is None: + raw_result = await self._analyze_binary_initial( + analyzer_id=analyzer_id, + binary_input=binary_input, + string_encoding=string_encoding, + processing_location=processing_location, + input_range=input_range, + content_type=content_type, + cls=lambda x, y, z: x, + headers=_headers, + params=_params, + **kwargs + ) + await raw_result.http_response.read() # type: ignore + kwargs.pop("error_map", None) + + def get_long_running_output(pipeline_response): + response_headers = {} + response = pipeline_response.http_response + response_headers["Operation-Location"] = self._deserialize( + "str", response.headers.get("Operation-Location") + ) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = _deserialize(_models.AnalyzeResult, response.json().get("result", {})) + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + return deserialized + + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + + if polling is True: + polling_method: AsyncPollingMethod = cast( + AsyncPollingMethod, + AsyncLROBasePolling(lro_delay, path_format_arguments=path_format_arguments, **kwargs), + ) + elif polling is False: + polling_method = cast(AsyncPollingMethod, AsyncNoPolling()) + else: + polling_method = polling + if cont_token: + return AsyncLROPoller[_models.AnalyzeResult].from_continuation_token( + polling_method=polling_method, + continuation_token=cont_token, + client=self._client, + deserialization_callback=get_long_running_output, + ) + return AsyncLROPoller[_models.AnalyzeResult]( + self._client, raw_result, get_long_running_output, polling_method # type: ignore + ) + + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={ + "2025-11-01": ["api_version", "analyzer_id", "allow_replace", "client_request_id", "content_type", "accept"] + }, + api_versions_list=["2025-11-01"], + ) + async def _copy_initial( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + source_analyzer_id: str = _Unset, + allow_replace: Optional[bool] = None, + source_azure_resource_id: Optional[str] = None, + source_region: Optional[str] = None, + **kwargs: Any + ) -> AsyncIterator[bytes]: + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) + + if body is _Unset: + if source_analyzer_id is _Unset: + raise TypeError("missing required argument: source_analyzer_id") + body = { + "sourceAnalyzerId": source_analyzer_id, + "sourceAzureResourceId": source_azure_resource_id, + "sourceRegion": source_region, + } + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_copy_request( + analyzer_id=analyzer_id, + allow_replace=allow_replace, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [202]: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + async def begin_copy( + self, + analyzer_id: str, + *, + source_analyzer_id: str, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + source_azure_resource_id: Optional[str] = None, + source_region: Optional[str] = None, + **kwargs: Any + ) -> AsyncLROPoller[_models.ContentAnalyzer]: + """Create a copy of the source analyzer to the current location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword source_analyzer_id: Source analyzer ID. Required. + :paramtype source_analyzer_id: str + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword source_azure_resource_id: Azure resource ID of the source analyzer location. Defaults + to the current resource. Default value is None. + :paramtype source_azure_resource_id: str + :keyword source_region: Azure region of the source analyzer location. Defaults to current + region. Default value is None. + :paramtype source_region: str + :return: An instance of AsyncLROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: + ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def begin_copy( + self, + analyzer_id: str, + body: JSON, + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> AsyncLROPoller[_models.ContentAnalyzer]: + """Create a copy of the source analyzer to the current location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: JSON + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AsyncLROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: + ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def begin_copy( + self, + analyzer_id: str, + body: IO[bytes], + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> AsyncLROPoller[_models.ContentAnalyzer]: + """Create a copy of the source analyzer to the current location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: IO[bytes] + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AsyncLROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: + ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={ + "2025-11-01": ["api_version", "analyzer_id", "allow_replace", "client_request_id", "content_type", "accept"] + }, + api_versions_list=["2025-11-01"], + ) + async def begin_copy( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + source_analyzer_id: str = _Unset, + allow_replace: Optional[bool] = None, + source_azure_resource_id: Optional[str] = None, + source_region: Optional[str] = None, + **kwargs: Any + ) -> AsyncLROPoller[_models.ContentAnalyzer]: + """Create a copy of the source analyzer to the current location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Is either a JSON type or a IO[bytes] type. Required. + :type body: JSON or IO[bytes] + :keyword source_analyzer_id: Source analyzer ID. Required. + :paramtype source_analyzer_id: str + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword source_azure_resource_id: Azure resource ID of the source analyzer location. Defaults + to the current resource. Default value is None. + :paramtype source_azure_resource_id: str + :keyword source_region: Azure region of the source analyzer location. Defaults to current + region. Default value is None. + :paramtype source_region: str + :return: An instance of AsyncLROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: + ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) + polling: Union[bool, AsyncPollingMethod] = kwargs.pop("polling", True) + lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) + cont_token: Optional[str] = kwargs.pop("continuation_token", None) + if cont_token is None: + raw_result = await self._copy_initial( + analyzer_id=analyzer_id, + body=body, + source_analyzer_id=source_analyzer_id, + allow_replace=allow_replace, + source_azure_resource_id=source_azure_resource_id, + source_region=source_region, + content_type=content_type, + cls=lambda x, y, z: x, + headers=_headers, + params=_params, + **kwargs + ) + await raw_result.http_response.read() # type: ignore + kwargs.pop("error_map", None) + + def get_long_running_output(pipeline_response): + response_headers = {} + response = pipeline_response.http_response + response_headers["Operation-Location"] = self._deserialize( + "str", response.headers.get("Operation-Location") + ) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = _deserialize(_models.ContentAnalyzer, response.json().get("result", {})) + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + return deserialized + + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + + if polling is True: + polling_method: AsyncPollingMethod = cast( + AsyncPollingMethod, + AsyncLROBasePolling(lro_delay, path_format_arguments=path_format_arguments, **kwargs), + ) + elif polling is False: + polling_method = cast(AsyncPollingMethod, AsyncNoPolling()) + else: + polling_method = polling + if cont_token: + return AsyncLROPoller[_models.ContentAnalyzer].from_continuation_token( + polling_method=polling_method, + continuation_token=cont_token, + client=self._client, + deserialization_callback=get_long_running_output, + ) + return AsyncLROPoller[_models.ContentAnalyzer]( + self._client, raw_result, get_long_running_output, polling_method # type: ignore + ) + + @api_version_validation( + params_added_on={"2025-11-01": ["allow_replace"]}, + api_versions_list=["2025-05-01-preview", "2025-11-01"], + ) + async def _create_or_replace_initial( + self, + analyzer_id: str, + resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], + *, + allow_replace: Optional[bool] = None, + **kwargs: Any + ) -> AsyncIterator[bytes]: + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(resource, (IOBase, bytes)): + _content = resource + else: + _content = json.dumps(resource, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_create_or_replace_request( + analyzer_id=analyzer_id, + allow_replace=allow_replace, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200, 201]: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + async def begin_create_or_replace( + self, + analyzer_id: str, + resource: _models.ContentAnalyzer, + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> AsyncLROPoller[_models.ContentAnalyzer]: + """Create a new analyzer asynchronously. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AsyncLROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: + ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def begin_create_or_replace( + self, + analyzer_id: str, + resource: JSON, + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> AsyncLROPoller[_models.ContentAnalyzer]: + """Create a new analyzer asynchronously. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: JSON + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AsyncLROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: + ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def begin_create_or_replace( + self, + analyzer_id: str, + resource: IO[bytes], + *, + allow_replace: Optional[bool] = None, + content_type: str = "application/json", + **kwargs: Any + ) -> AsyncLROPoller[_models.ContentAnalyzer]: + """Create a new analyzer asynchronously. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: IO[bytes] + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AsyncLROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: + ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + @api_version_validation( + params_added_on={"2025-11-01": ["allow_replace"]}, + api_versions_list=["2025-05-01-preview", "2025-11-01"], + ) + async def begin_create_or_replace( + self, + analyzer_id: str, + resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], + *, + allow_replace: Optional[bool] = None, + **kwargs: Any + ) -> AsyncLROPoller[_models.ContentAnalyzer]: + """Create a new analyzer asynchronously. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Is one of the following types: ContentAnalyzer, JSON, + IO[bytes] Required. + :type resource: ~azure.ai.contentunderstanding.models.ContentAnalyzer or JSON or IO[bytes] + :keyword allow_replace: Allow the operation to replace an existing resource. Default value is + None. + :paramtype allow_replace: bool + :return: An instance of AsyncLROPoller that returns ContentAnalyzer. The ContentAnalyzer is + compatible with MutableMapping + :rtype: + ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) + polling: Union[bool, AsyncPollingMethod] = kwargs.pop("polling", True) + lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) + cont_token: Optional[str] = kwargs.pop("continuation_token", None) + if cont_token is None: + raw_result = await self._create_or_replace_initial( + analyzer_id=analyzer_id, + resource=resource, + allow_replace=allow_replace, + content_type=content_type, + cls=lambda x, y, z: x, + headers=_headers, + params=_params, + **kwargs + ) + await raw_result.http_response.read() # type: ignore + kwargs.pop("error_map", None) + + def get_long_running_output(pipeline_response): + response_headers = {} + response = pipeline_response.http_response + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + response_headers["Operation-Location"] = self._deserialize( + "str", response.headers.get("Operation-Location") + ) + + deserialized = _deserialize(_models.ContentAnalyzer, response.json().get("result", {})) + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + return deserialized + + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + + if polling is True: + polling_method: AsyncPollingMethod = cast( + AsyncPollingMethod, + AsyncLROBasePolling(lro_delay, path_format_arguments=path_format_arguments, **kwargs), + ) + elif polling is False: + polling_method = cast(AsyncPollingMethod, AsyncNoPolling()) + else: + polling_method = polling + if cont_token: + return AsyncLROPoller[_models.ContentAnalyzer].from_continuation_token( + polling_method=polling_method, + continuation_token=cont_token, + client=self._client, + deserialization_callback=get_long_running_output, + ) + return AsyncLROPoller[_models.ContentAnalyzer]( + self._client, raw_result, get_long_running_output, polling_method # type: ignore + ) + + @distributed_trace_async + async def delete(self, analyzer_id: str, **kwargs: Any) -> None: + """Delete analyzer. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :return: None + :rtype: None + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[None] = kwargs.pop("cls", None) + + _request = build_content_understanding_delete_request( + analyzer_id=analyzer_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = False + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [204]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + if cls: + return cls(pipeline_response, None, response_headers) # type: ignore + + @distributed_trace_async + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={"2025-11-01": ["api_version", "operation_id"]}, + api_versions_list=["2025-11-01"], + ) + async def delete_result(self, operation_id: str, **kwargs: Any) -> None: + """Mark the result of an analysis operation for deletion. + + :param operation_id: Operation identifier. Required. + :type operation_id: str + :return: None + :rtype: None + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[None] = kwargs.pop("cls", None) + + _request = build_content_understanding_delete_result_request( + operation_id=operation_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = False + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [204]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if cls: + return cls(pipeline_response, None, {}) # type: ignore + + @distributed_trace_async + async def get(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyzer: + """Get analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_request( + analyzer_id=analyzer_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentAnalyzer, response.json()) + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @distributed_trace_async + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={"2025-11-01": ["api_version", "accept"]}, + api_versions_list=["2025-11-01"], + ) + async def get_defaults(self, **kwargs: Any) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[_models.ContentUnderstandingDefaults] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_defaults_request( + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentUnderstandingDefaults, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @distributed_trace_async + async def get_operation_status( + self, analyzer_id: str, operation_id: str, **kwargs: Any + ) -> _models.ContentAnalyzerOperationStatus: + """Get the status of an analyzer creation operation. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param operation_id: The unique ID of the operation. Required. + :type operation_id: str + :return: ContentAnalyzerOperationStatus. The ContentAnalyzerOperationStatus is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzerOperationStatus + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[_models.ContentAnalyzerOperationStatus] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_operation_status_request( + analyzer_id=analyzer_id, + operation_id=operation_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentAnalyzerOperationStatus, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @distributed_trace_async + async def _get_result(self, operation_id: str, **kwargs: Any) -> _models.ContentAnalyzerAnalyzeOperationStatus: + """Get the result of an analysis operation. + + :param operation_id: The unique ID of the operation. Required. + :type operation_id: str + :return: ContentAnalyzerAnalyzeOperationStatus. The ContentAnalyzerAnalyzeOperationStatus is + compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzerAnalyzeOperationStatus + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[_models.ContentAnalyzerAnalyzeOperationStatus] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_result_request( + operation_id=operation_id, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentAnalyzerAnalyzeOperationStatus, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @distributed_trace_async + async def get_result_file(self, operation_id: str, path: str, **kwargs: Any) -> AsyncIterator[bytes]: + """Get a file associated with the result of an analysis operation. + + :param operation_id: Operation identifier. Required. + :type operation_id: str + :param path: File path. Required. + :type path: str + :return: AsyncIterator[bytes] + :rtype: AsyncIterator[bytes] + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) + + _request = build_content_understanding_get_result_file_request( + operation_id=operation_id, + path=path, + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", True) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["content-type"] = self._deserialize("str", response.headers.get("content-type")) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + async def grant_copy_authorization( + self, + analyzer_id: str, + *, + target_azure_resource_id: str, + content_type: str = "application/json", + target_region: Optional[str] = None, + **kwargs: Any + ) -> _models.CopyAuthorization: + """Get authorization for copying this analyzer to another location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword target_azure_resource_id: Azure resource ID of the target analyzer location. Required. + :paramtype target_azure_resource_id: str + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword target_region: Azure region of the target analyzer location. Defaults to current + region. Default value is None. + :paramtype target_region: str + :return: CopyAuthorization. The CopyAuthorization is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.CopyAuthorization + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def grant_copy_authorization( + self, analyzer_id: str, body: JSON, *, content_type: str = "application/json", **kwargs: Any + ) -> _models.CopyAuthorization: + """Get authorization for copying this analyzer to another location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: CopyAuthorization. The CopyAuthorization is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.CopyAuthorization + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def grant_copy_authorization( + self, analyzer_id: str, body: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> _models.CopyAuthorization: + """Get authorization for copying this analyzer to another location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Required. + :type body: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: CopyAuthorization. The CopyAuthorization is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.CopyAuthorization + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={"2025-11-01": ["api_version", "analyzer_id", "client_request_id", "content_type", "accept"]}, + api_versions_list=["2025-11-01"], + ) + async def grant_copy_authorization( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + target_azure_resource_id: str = _Unset, + target_region: Optional[str] = None, + **kwargs: Any + ) -> _models.CopyAuthorization: + """Get authorization for copying this analyzer to another location. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Is either a JSON type or a IO[bytes] type. Required. + :type body: JSON or IO[bytes] + :keyword target_azure_resource_id: Azure resource ID of the target analyzer location. Required. + :paramtype target_azure_resource_id: str + :keyword target_region: Azure region of the target analyzer location. Defaults to current + region. Default value is None. + :paramtype target_region: str + :return: CopyAuthorization. The CopyAuthorization is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.CopyAuthorization + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.CopyAuthorization] = kwargs.pop("cls", None) + + if body is _Unset: + if target_azure_resource_id is _Unset: + raise TypeError("missing required argument: target_azure_resource_id") + body = {"targetAzureResourceId": target_azure_resource_id, "targetRegion": target_region} + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_grant_copy_authorization_request( + analyzer_id=analyzer_id, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.CopyAuthorization, response.json()) + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @distributed_trace + def list(self, **kwargs: Any) -> AsyncItemPaged["_models.ContentAnalyzer"]: + """List analyzers. + + :return: An iterator like instance of ContentAnalyzer + :rtype: + ~azure.core.async_paging.AsyncItemPaged[~azure.ai.contentunderstanding.models.ContentAnalyzer] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = kwargs.pop("headers", {}) or {} + _params = kwargs.pop("params", {}) or {} + + cls: ClsType[List[_models.ContentAnalyzer]] = kwargs.pop("cls", None) + + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + def prepare_request(next_link=None): + if not next_link: + + _request = build_content_understanding_list_request( + api_version=self._config.api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.endpoint", self._config.endpoint, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + else: + # make call to next link with the client's api-version + _parsed_next_link = urllib.parse.urlparse(next_link) + _next_request_params = case_insensitive_dict( + { + key: [urllib.parse.quote(v) for v in value] + for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items() + } + ) + _next_request_params["api-version"] = self._config.api_version + _request = HttpRequest( + "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params + ) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.endpoint", self._config.endpoint, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + return _request + + async def extract_data(pipeline_response): + deserialized = pipeline_response.http_response.json() + list_of_elem = _deserialize(List[_models.ContentAnalyzer], deserialized.get("value", [])) + if cls: + list_of_elem = cls(list_of_elem) # type: ignore + return deserialized.get("nextLink") or None, AsyncList(list_of_elem) + + async def get_next(next_link=None): + _request = prepare_request(next_link) + + _stream = False + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + response = pipeline_response.http_response + + if response.status_code not in [200]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + return pipeline_response + + return AsyncItemPaged(get_next, extract_data) + + @overload + async def update( + self, + analyzer_id: str, + resource: _models.ContentAnalyzer, + *, + content_type: str = "application/merge-patch+json", + **kwargs: Any + ) -> _models.ContentAnalyzer: + """Update analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def update( + self, analyzer_id: str, resource: JSON, *, content_type: str = "application/merge-patch+json", **kwargs: Any + ) -> _models.ContentAnalyzer: + """Update analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def update( + self, + analyzer_id: str, + resource: IO[bytes], + *, + content_type: str = "application/merge-patch+json", + **kwargs: Any + ) -> _models.ContentAnalyzer: + """Update analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Required. + :type resource: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + async def update( + self, analyzer_id: str, resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], **kwargs: Any + ) -> _models.ContentAnalyzer: + """Update analyzer properties. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param resource: The resource instance. Is one of the following types: ContentAnalyzer, JSON, + IO[bytes] Required. + :type resource: ~azure.ai.contentunderstanding.models.ContentAnalyzer or JSON or IO[bytes] + :return: ContentAnalyzer. The ContentAnalyzer is compatible with MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) + + content_type = content_type or "application/merge-patch+json" + _content = None + if isinstance(resource, (IOBase, bytes)): + _content = resource + else: + _content = json.dumps(resource, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_update_request( + analyzer_id=analyzer_id, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentAnalyzer, response.json()) + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + @overload + async def update_defaults( + self, + *, + content_type: str = "application/merge-patch+json", + model_deployments: Optional[_models.RecordMergePatchUpdate] = None, + **kwargs: Any + ) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :keyword model_deployments: Mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: ~azure.ai.contentunderstanding.models.RecordMergePatchUpdate + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def update_defaults( + self, body: JSON, *, content_type: str = "application/merge-patch+json", **kwargs: Any + ) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :param body: Required. + :type body: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def update_defaults( + self, body: IO[bytes], *, content_type: str = "application/merge-patch+json", **kwargs: Any + ) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :param body: Required. + :type body: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/merge-patch+json". + :paramtype content_type: str + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + @api_version_validation( + method_added_on="2025-11-01", + params_added_on={"2025-11-01": ["api_version", "content_type", "accept"]}, + api_versions_list=["2025-11-01"], + ) + async def update_defaults( + self, + body: Union[JSON, IO[bytes]] = _Unset, + *, + model_deployments: Optional[_models.RecordMergePatchUpdate] = None, + **kwargs: Any + ) -> _models.ContentUnderstandingDefaults: + """Return default settings for this Content Understanding resource. + + :param body: Is either a JSON type or a IO[bytes] type. Required. + :type body: JSON or IO[bytes] + :keyword model_deployments: Mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: ~azure.ai.contentunderstanding.models.RecordMergePatchUpdate + :return: ContentUnderstandingDefaults. The ContentUnderstandingDefaults is compatible with + MutableMapping + :rtype: ~azure.ai.contentunderstanding.models.ContentUnderstandingDefaults + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} + + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ContentUnderstandingDefaults] = kwargs.pop("cls", None) + + if body is _Unset: + body = {"modelDeployments": model_deployments} + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/merge-patch+json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_content_understanding_update_defaults_request( + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + if _stream: + deserialized = response.iter_bytes() + else: + deserialized = _deserialize(_models.ContentUnderstandingDefaults, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py new file mode 100644 index 000000000000..87676c65a8f0 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -0,0 +1,21 @@ +# 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. +# -------------------------------------------------------------------------- +"""Customize generated code here. + +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +""" + + +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level + + +def patch_sdk(): + """Do not remove from this file. + + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize + """ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py new file mode 100644 index 000000000000..87676c65a8f0 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py @@ -0,0 +1,21 @@ +# 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. +# -------------------------------------------------------------------------- +"""Customize generated code here. + +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +""" + + +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level + + +def patch_sdk(): + """Do not remove from this file. + + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize + """ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py new file mode 100644 index 000000000000..15b346e544bc --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py @@ -0,0 +1,164 @@ +# 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 ._models import ( # type: ignore + AnalyzeInput, + AnalyzeResult, + ArrayField, + AudioVisualContent, + AudioVisualContentSegment, + BooleanField, + ContentAnalyzer, + ContentAnalyzerAnalyzeOperationStatus, + ContentAnalyzerConfig, + ContentAnalyzerOperationStatus, + ContentCategoryDefinition, + ContentField, + ContentFieldDefinition, + ContentFieldSchema, + ContentSpan, + ContentUnderstandingDefaults, + CopyAuthorization, + DateField, + DetectedPerson, + DocumentAnnotation, + DocumentAnnotationComment, + DocumentBarcode, + DocumentCaption, + DocumentChartFigure, + DocumentContent, + DocumentContentSegment, + DocumentFigure, + DocumentFootnote, + DocumentFormula, + DocumentHyperlink, + DocumentLine, + DocumentMermaidFigure, + DocumentPage, + DocumentParagraph, + DocumentSection, + DocumentTable, + DocumentTableCell, + DocumentWord, + IntegerField, + JsonField, + KnowledgeSource, + LabeledDataKnowledgeSource, + MediaContent, + NumberField, + ObjectField, + StringField, + SupportedModels, + TimeField, + TranscriptPhrase, + TranscriptWord, + UsageDetails, +) + +from ._enums import ( # type: ignore + AnnotationFormat, + ChartFormat, + ContentAnalyzerStatus, + ContentFieldType, + DocumentAnnotationKind, + DocumentBarcodeKind, + DocumentFigureKind, + DocumentFormulaKind, + DocumentTableCellKind, + GenerationMethod, + KnowledgeSourceKind, + LengthUnit, + MediaContentKind, + OperationState, + ProcessingLocation, + SemanticRole, + TableFormat, +) +from ._patch import __all__ as _patch_all +from ._patch import * +from ._patch import patch_sdk as _patch_sdk + +__all__ = [ + "AnalyzeInput", + "AnalyzeResult", + "ArrayField", + "AudioVisualContent", + "AudioVisualContentSegment", + "BooleanField", + "ContentAnalyzer", + "ContentAnalyzerAnalyzeOperationStatus", + "ContentAnalyzerConfig", + "ContentAnalyzerOperationStatus", + "ContentCategoryDefinition", + "ContentField", + "ContentFieldDefinition", + "ContentFieldSchema", + "ContentSpan", + "ContentUnderstandingDefaults", + "CopyAuthorization", + "DateField", + "DetectedPerson", + "DocumentAnnotation", + "DocumentAnnotationComment", + "DocumentBarcode", + "DocumentCaption", + "DocumentChartFigure", + "DocumentContent", + "DocumentContentSegment", + "DocumentFigure", + "DocumentFootnote", + "DocumentFormula", + "DocumentHyperlink", + "DocumentLine", + "DocumentMermaidFigure", + "DocumentPage", + "DocumentParagraph", + "DocumentSection", + "DocumentTable", + "DocumentTableCell", + "DocumentWord", + "IntegerField", + "JsonField", + "KnowledgeSource", + "LabeledDataKnowledgeSource", + "MediaContent", + "NumberField", + "ObjectField", + "StringField", + "SupportedModels", + "TimeField", + "TranscriptPhrase", + "TranscriptWord", + "UsageDetails", + "AnnotationFormat", + "ChartFormat", + "ContentAnalyzerStatus", + "ContentFieldType", + "DocumentAnnotationKind", + "DocumentBarcodeKind", + "DocumentFigureKind", + "DocumentFormulaKind", + "DocumentTableCellKind", + "GenerationMethod", + "KnowledgeSourceKind", + "LengthUnit", + "MediaContentKind", + "OperationState", + "ProcessingLocation", + "SemanticRole", + "TableFormat", +] +__all__.extend([p for p in _patch_all if p not in __all__]) # pyright: ignore +_patch_sdk() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_enums.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_enums.py new file mode 100644 index 000000000000..efbbf20ad2ee --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_enums.py @@ -0,0 +1,248 @@ +# 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 enum import Enum +from azure.core import CaseInsensitiveEnumMeta + + +class AnnotationFormat(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Representation format of annotations in analyze result markdown.""" + + NONE = "none" + """Do not represent annotations.""" + MARKDOWN = "markdown" + """Represent basic annotation information using markdown formatting.""" + + +class ChartFormat(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Representation format of charts in analyze result markdown.""" + + CHART_JS = "chartJs" + """Represent charts as Chart.js code blocks.""" + MARKDOWN = "markdown" + """Represent charts as markdown tables.""" + + +class ContentAnalyzerStatus(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Status of a resource.""" + + CREATING = "creating" + """The resource is being created.""" + READY = "ready" + """The resource is ready.""" + DELETING = "deleting" + """The resource is being deleted.""" + FAILED = "failed" + """The resource failed during creation.""" + + +class ContentFieldType(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Semantic data type of the field value.""" + + STRING = "string" + """Plain text.""" + DATE = "date" + """Date, normalized to ISO 8601 (YYYY-MM-DD) format.""" + TIME = "time" + """Time, normalized to ISO 8601 (hh:mm:ss) format.""" + NUMBER = "number" + """Number as double precision floating point.""" + INTEGER = "integer" + """Integer as 64-bit signed integer.""" + BOOLEAN = "boolean" + """Boolean value.""" + ARRAY = "array" + """List of subfields of the same type.""" + OBJECT = "object" + """Named list of subfields.""" + JSON = "json" + """JSON object.""" + + +class DocumentAnnotationKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Document annotation kind.""" + + HIGHLIGHT = "highlight" + """Highlight annotation.""" + STRIKETHROUGH = "strikethrough" + """Strikethrough annotation.""" + UNDERLINE = "underline" + """Underline annotation.""" + ITALIC = "italic" + """Italic annotation.""" + BOLD = "bold" + """Bold annotation.""" + CIRCLE = "circle" + """Circle annotation.""" + NOTE = "note" + """Note annotation.""" + + +class DocumentBarcodeKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Barcode kind.""" + + QR_CODE = "QRCode" + """QR code, as defined in ISO/IEC 18004:2015.""" + PDF417 = "PDF417" + """PDF417, as defined in ISO 15438.""" + UPCA = "UPCA" + """GS1 12-digit Universal Product Code.""" + UPCE = "UPCE" + """GS1 6-digit Universal Product Code.""" + CODE39 = "Code39" + """Code 39 barcode, as defined in ISO/IEC 16388:2007.""" + CODE128 = "Code128" + """Code 128 barcode, as defined in ISO/IEC 15417:2007.""" + EAN8 = "EAN8" + """GS1 8-digit International Article Number (European Article Number).""" + EAN13 = "EAN13" + """GS1 13-digit International Article Number (European Article Number).""" + DATA_BAR = "DataBar" + """GS1 DataBar barcode.""" + CODE93 = "Code93" + """Code 93 barcode, as defined in ANSI/AIM BC5-1995.""" + CODABAR = "Codabar" + """Codabar barcode, as defined in ANSI/AIM BC3-1995.""" + DATA_BAR_EXPANDED = "DataBarExpanded" + """GS1 DataBar Expanded barcode.""" + ITF = "ITF" + """Interleaved 2 of 5 barcode, as defined in ANSI/AIM BC2-1995.""" + MICRO_QR_CODE = "MicroQRCode" + """Micro QR code, as defined in ISO/IEC 23941:2022.""" + AZTEC = "Aztec" + """Aztec code, as defined in ISO/IEC 24778:2008.""" + DATA_MATRIX = "DataMatrix" + """Data matrix code, as defined in ISO/IEC 16022:2006.""" + MAXI_CODE = "MaxiCode" + """MaxiCode, as defined in ISO/IEC 16023:2000.""" + + +class DocumentFigureKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Figure kind.""" + + UNKNOWN = "unknown" + """Unknown figure kind.""" + CHART = "chart" + """Figure containing a chart, such as a bar chart, line chart, or pie chart.""" + MERMAID = "mermaid" + """Figure containing a diagram, such as a flowchart or network diagram.""" + + +class DocumentFormulaKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Formula kind.""" + + INLINE = "inline" + """A formula embedded within the content of a paragraph.""" + DISPLAY = "display" + """A formula in display mode that takes up an entire line.""" + + +class DocumentTableCellKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Table cell kind.""" + + CONTENT = "content" + """Main content/data.""" + ROW_HEADER = "rowHeader" + """Description of the row content.""" + COLUMN_HEADER = "columnHeader" + """Description the column content.""" + STUB_HEAD = "stubHead" + """Description of the row headers, usually located at the top left corner of a table.""" + DESCRIPTION = "description" + """Description of the content in (parts of) the table.""" + + +class GenerationMethod(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Generation method.""" + + GENERATE = "generate" + """Values are generated freely based on the content.""" + EXTRACT = "extract" + """Values are extracted as they appear in the content.""" + CLASSIFY = "classify" + """Values are classified against a predefined set of categories.""" + + +class KnowledgeSourceKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Knowledge source kind.""" + + LABELED_DATA = "labeledData" + """A labeled data knowledge source.""" + + +class LengthUnit(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Length unit used by the width, height, and source properties.""" + + PIXEL = "pixel" + """Pixel unit.""" + INCH = "inch" + """Inch unit.""" + + +class MediaContentKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Kind of media content.""" + + DOCUMENT = "document" + """Document content, such as pdf, image, txt, etc.""" + AUDIO_VISUAL = "audioVisual" + """Audio visual content, such as mp3, mp4, etc.""" + + +class OperationState(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Enum describing allowed operation states.""" + + NOT_STARTED = "NotStarted" + """The operation has not started.""" + RUNNING = "Running" + """The operation is in progress.""" + SUCCEEDED = "Succeeded" + """The operation has completed successfully.""" + FAILED = "Failed" + """The operation has failed.""" + CANCELED = "Canceled" + """The operation has been canceled by the user.""" + + +class ProcessingLocation(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """The location where the data may be processed.""" + + GEOGRAPHY = "geography" + """Data may be processed in the same geography as the resource.""" + DATA_ZONE = "dataZone" + """Data may be processed in the same data zone as the resource.""" + GLOBAL = "global" + """Data may be processed in any Azure data center globally.""" + + +class SemanticRole(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Semantic role of the paragraph.""" + + PAGE_HEADER = "pageHeader" + """Text near the top edge of the page.""" + PAGE_FOOTER = "pageFooter" + """Text near the bottom edge of the page.""" + PAGE_NUMBER = "pageNumber" + """Page number.""" + TITLE = "title" + """Top-level title describing the entire document.""" + SECTION_HEADING = "sectionHeading" + """Sub heading describing a section of the document.""" + FOOTNOTE = "footnote" + """Note usually placed after the main content on a page.""" + FORMULA_BLOCK = "formulaBlock" + """Block of formulas, often with shared alignment.""" + + +class TableFormat(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Representation format of tables in analyze result markdown.""" + + HTML = "html" + """Represent tables using HTML table elements: \\, \\, \\
, \\
.""" + MARKDOWN = "markdown" + """Represent tables using GitHub Flavored Markdown table syntax, which does not support merged + cells or rich headers.""" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py new file mode 100644 index 000000000000..940a0a4d32df --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py @@ -0,0 +1,2993 @@ +# pylint: disable=line-too-long,useless-suppression,too-many-lines +# 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=useless-super-delegation + +import datetime +from typing import Any, Literal, Mapping, Optional, TYPE_CHECKING, Union, overload + +from azure.core.exceptions import ODataV4Format + +from .._utils.model_base import Model as _Model, rest_discriminator, rest_field +from ._enums import ContentFieldType, DocumentFigureKind, KnowledgeSourceKind, MediaContentKind + +if TYPE_CHECKING: + from .. import models as _models + + +class AnalyzeInput(_Model): + """Additional input to analyze. + + :ivar url: The URL of the input to analyze. Only one of url or data should be specified. + :vartype url: str + :ivar data: Raw image bytes. Provide bytes-like object; do not base64-encode. Only one of url + or data should be specified. + :vartype data: bytes + :ivar name: Name of the input. + :vartype name: str + :ivar mime_type: The MIME type of the input content. Ex. application/pdf, image/jpeg, etc. + :vartype mime_type: str + :ivar input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses + 1-based page numbers, while audio visual content uses integer milliseconds. + :vartype input_range: str + """ + + url: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The URL of the input to analyze. Only one of url or data should be specified.""" + data: Optional[bytes] = rest_field(visibility=["read", "create", "update", "delete", "query"], format="base64") + """Raw image bytes. Provide bytes-like object; do not base64-encode. Only one of url or data + should be specified.""" + name: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Name of the input.""" + mime_type: Optional[str] = rest_field(name="mimeType", visibility=["read", "create", "update", "delete", "query"]) + """The MIME type of the input content. Ex. application/pdf, image/jpeg, etc.""" + input_range: Optional[str] = rest_field(name="range", visibility=["read", "create", "update", "delete", "query"]) + """Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses 1-based page numbers, + while audio visual content uses integer milliseconds.""" + + @overload + def __init__( + self, + *, + url: Optional[str] = None, + data: Optional[bytes] = None, + name: Optional[str] = None, + mime_type: Optional[str] = None, + input_range: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class AnalyzeResult(_Model): + """Analyze operation result. + + :ivar analyzer_id: The unique identifier of the analyzer. + :vartype analyzer_id: str + :ivar api_version: The version of the API used to analyze the document. + :vartype api_version: str + :ivar created_at: The date and time when the result was created. + :vartype created_at: ~datetime.datetime + :ivar warnings: Warnings encountered while analyzing the document. + :vartype warnings: list[~azure.core.ODataV4Format] + :ivar string_encoding: The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``."). + :vartype string_encoding: str + :ivar contents: The extracted content. Required. + :vartype contents: list[~azure.ai.contentunderstanding.models.MediaContent] + """ + + analyzer_id: Optional[str] = rest_field( + name="analyzerId", visibility=["read", "create", "update", "delete", "query"] + ) + """The unique identifier of the analyzer.""" + api_version: Optional[str] = rest_field( + name="apiVersion", visibility=["read", "create", "update", "delete", "query"] + ) + """The version of the API used to analyze the document.""" + created_at: Optional[datetime.datetime] = rest_field( + name="createdAt", visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """The date and time when the result was created.""" + warnings: Optional[list[ODataV4Format]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Warnings encountered while analyzing the document.""" + string_encoding: Optional[str] = rest_field( + name="stringEncoding", visibility=["read", "create", "update", "delete", "query"] + ) + """ The string encoding format for content spans in the response. + Possible values are 'codePoint', 'utf16', and ``utf8``. Default is ``codePoint``.\").""" + contents: list["_models.MediaContent"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The extracted content. Required.""" + + @overload + def __init__( + self, + *, + contents: list["_models.MediaContent"], + analyzer_id: Optional[str] = None, + api_version: Optional[str] = None, + created_at: Optional[datetime.datetime] = None, + warnings: Optional[list[ODataV4Format]] = None, + string_encoding: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentField(_Model): + """Field extracted from the content. + + You probably want to use the sub-classes and not this class directly. Known sub-classes are: + ArrayField, BooleanField, DateField, IntegerField, JsonField, NumberField, ObjectField, + StringField, TimeField + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + spans: Optional[list["_models.ContentSpan"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Span(s) associated with the field value in the markdown content.""" + confidence: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Confidence of predicting the field value.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the field value in the content.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ArrayField(ContentField, discriminator="array"): + """Array field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. List of subfields of the + same type. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.ARRAY + :ivar value_array: Array field value. + :vartype value_array: list[~azure.ai.contentunderstanding.models.ContentField] + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.ARRAY] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. List of subfields of the same type.""" + value_array: Optional[list["_models.ContentField"]] = rest_field( + name="valueArray", visibility=["read", "create", "update", "delete", "query"] + ) + """Array field value.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_array: Optional[list["_models.ContentField"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.ARRAY # type: ignore + + +class MediaContent(_Model): + """Media content base class. + + You probably want to use the sub-classes and not this class directly. Known sub-classes are: + AudioVisualContent, DocumentContent + + :ivar kind: Content kind. Required. Known values are: "document" and "audioVisual". + :vartype kind: str or ~azure.ai.contentunderstanding.models.MediaContentKind + :ivar mime_type: Detected MIME type of the content. Ex. application/pdf, image/jpeg, etc. + Required. + :vartype mime_type: str + :ivar analyzer_id: The analyzer that generated this content. + :vartype analyzer_id: str + :ivar category: Classified content category. + :vartype category: str + :ivar path: The path of the content in the input. + :vartype path: str + :ivar markdown: Markdown representation of the content. + :vartype markdown: str + :ivar fields: Extracted fields from the content. + :vartype fields: dict[str, ~azure.ai.contentunderstanding.models.ContentField] + """ + + __mapping__: dict[str, _Model] = {} + kind: str = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) + """Content kind. Required. Known values are: \"document\" and \"audioVisual\".""" + mime_type: str = rest_field(name="mimeType", visibility=["read", "create", "update", "delete", "query"]) + """Detected MIME type of the content. Ex. application/pdf, image/jpeg, etc. Required.""" + analyzer_id: Optional[str] = rest_field( + name="analyzerId", visibility=["read", "create", "update", "delete", "query"] + ) + """The analyzer that generated this content.""" + category: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Classified content category.""" + path: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The path of the content in the input.""" + markdown: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Markdown representation of the content.""" + fields: Optional[dict[str, "_models.ContentField"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Extracted fields from the content.""" + + @overload + def __init__( + self, + *, + kind: str, + mime_type: str, + analyzer_id: Optional[str] = None, + category: Optional[str] = None, + path: Optional[str] = None, + markdown: Optional[str] = None, + fields: Optional[dict[str, "_models.ContentField"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class AudioVisualContent(MediaContent, discriminator="audioVisual"): + """Audio visual content. Ex. audio/wav, video/mp4. + + :ivar mime_type: Detected MIME type of the content. Ex. application/pdf, image/jpeg, etc. + Required. + :vartype mime_type: str + :ivar analyzer_id: The analyzer that generated this content. + :vartype analyzer_id: str + :ivar category: Classified content category. + :vartype category: str + :ivar path: The path of the content in the input. + :vartype path: str + :ivar markdown: Markdown representation of the content. + :vartype markdown: str + :ivar fields: Extracted fields from the content. + :vartype fields: dict[str, ~azure.ai.contentunderstanding.models.ContentField] + :ivar kind: Content kind. Required. Audio visual content, such as mp3, mp4, etc. + :vartype kind: str or ~azure.ai.contentunderstanding.models.AUDIO_VISUAL + :ivar start_time_ms: Start time of the content in milliseconds. Required. + :vartype start_time_ms: int + :ivar end_time_ms: End time of the content in milliseconds. Required. + :vartype end_time_ms: int + :ivar width: Width of each video frame in pixels, if applicable. + :vartype width: int + :ivar height: Height of each video frame in pixels, if applicable. + :vartype height: int + :ivar camera_shot_times_ms: List of camera shot changes in the video, represented by its + timestamp in milliseconds. Only if returnDetails is true. + :vartype camera_shot_times_ms: list[int] + :ivar key_frame_times_ms: List of key frames in the video, represented by its timestamp in + milliseconds. Only if returnDetails is true. + :vartype key_frame_times_ms: list[int] + :ivar transcript_phrases: List of transcript phrases. Only if returnDetails is true. + :vartype transcript_phrases: list[~azure.ai.contentunderstanding.models.TranscriptPhrase] + :ivar segments: List of detected content segments. Only if enableSegment is true. + :vartype segments: list[~azure.ai.contentunderstanding.models.AudioVisualContentSegment] + """ + + kind: Literal[MediaContentKind.AUDIO_VISUAL] = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Content kind. Required. Audio visual content, such as mp3, mp4, etc.""" + start_time_ms: int = rest_field(name="startTimeMs", visibility=["read", "create", "update", "delete", "query"]) + """Start time of the content in milliseconds. Required.""" + end_time_ms: int = rest_field(name="endTimeMs", visibility=["read", "create", "update", "delete", "query"]) + """End time of the content in milliseconds. Required.""" + width: Optional[int] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Width of each video frame in pixels, if applicable.""" + height: Optional[int] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Height of each video frame in pixels, if applicable.""" + camera_shot_times_ms: Optional[list[int]] = rest_field( + name="cameraShotTimesMs", visibility=["read", "create", "update", "delete", "query"] + ) + """List of camera shot changes in the video, represented by its timestamp in milliseconds. Only + if returnDetails is true.""" + key_frame_times_ms: Optional[list[int]] = rest_field( + name="keyFrameTimesMs", visibility=["read", "create", "update", "delete", "query"] + ) + """List of key frames in the video, represented by its timestamp in milliseconds. Only if + returnDetails is true.""" + transcript_phrases: Optional[list["_models.TranscriptPhrase"]] = rest_field( + name="transcriptPhrases", visibility=["read", "create", "update", "delete", "query"] + ) + """List of transcript phrases. Only if returnDetails is true.""" + segments: Optional[list["_models.AudioVisualContentSegment"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of detected content segments. Only if enableSegment is true.""" + + @overload + def __init__( + self, + *, + mime_type: str, + start_time_ms: int, + end_time_ms: int, + analyzer_id: Optional[str] = None, + category: Optional[str] = None, + path: Optional[str] = None, + markdown: Optional[str] = None, + fields: Optional[dict[str, "_models.ContentField"]] = None, + width: Optional[int] = None, + height: Optional[int] = None, + camera_shot_times_ms: Optional[list[int]] = None, + key_frame_times_ms: Optional[list[int]] = None, + transcript_phrases: Optional[list["_models.TranscriptPhrase"]] = None, + segments: Optional[list["_models.AudioVisualContentSegment"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.kind = MediaContentKind.AUDIO_VISUAL # type: ignore + + +class AudioVisualContentSegment(_Model): + """Detected audio/visual content segment. + + :ivar segment_id: Segment identifier. Required. + :vartype segment_id: str + :ivar category: Classified content category. Required. + :vartype category: str + :ivar span: Span of the segment in the markdown content. Required. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar start_time_ms: Start time of the segment in milliseconds. Required. + :vartype start_time_ms: int + :ivar end_time_ms: End time of the segment in milliseconds. Required. + :vartype end_time_ms: int + """ + + segment_id: str = rest_field(name="segmentId", visibility=["read", "create", "update", "delete", "query"]) + """Segment identifier. Required.""" + category: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Classified content category. Required.""" + span: "_models.ContentSpan" = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the segment in the markdown content. Required.""" + start_time_ms: int = rest_field(name="startTimeMs", visibility=["read", "create", "update", "delete", "query"]) + """Start time of the segment in milliseconds. Required.""" + end_time_ms: int = rest_field(name="endTimeMs", visibility=["read", "create", "update", "delete", "query"]) + """End time of the segment in milliseconds. Required.""" + + @overload + def __init__( + self, + *, + segment_id: str, + category: str, + span: "_models.ContentSpan", + start_time_ms: int, + end_time_ms: int, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class BooleanField(ContentField, discriminator="boolean"): + """Boolean field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. Boolean value. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.BOOLEAN + :ivar value_boolean: Boolean field value. + :vartype value_boolean: bool + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.BOOLEAN] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. Boolean value.""" + value_boolean: Optional[bool] = rest_field( + name="valueBoolean", visibility=["read", "create", "update", "delete", "query"] + ) + """Boolean field value.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_boolean: Optional[bool] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.BOOLEAN # type: ignore + + +class ContentAnalyzer(_Model): + """Analyzer that extracts content and fields from multimodal documents. + + :ivar analyzer_id: The unique identifier of the analyzer. Required. + :vartype analyzer_id: str + :ivar description: A description of the analyzer. + :vartype description: str + :ivar tags: Tags associated with the analyzer. + :vartype tags: dict[str, str] + :ivar status: The status of the analyzer. Required. Known values are: "creating", "ready", + "deleting", and "failed". + :vartype status: str or ~azure.ai.contentunderstanding.models.ContentAnalyzerStatus + :ivar created_at: The date and time when the analyzer was created. Required. + :vartype created_at: ~datetime.datetime + :ivar last_modified_at: The date and time when the analyzer was last modified. Required. + :vartype last_modified_at: ~datetime.datetime + :ivar warnings: Warnings encountered while creating the analyzer. + :vartype warnings: list[~azure.core.ODataV4Format] + :ivar base_analyzer_id: The analyzer to incrementally train from. + :vartype base_analyzer_id: str + :ivar config: Analyzer configuration settings. + :vartype config: ~azure.ai.contentunderstanding.models.ContentAnalyzerConfig + :ivar field_schema: The schema of fields to extracted. + :vartype field_schema: ~azure.ai.contentunderstanding.models.ContentFieldSchema + :ivar dynamic_field_schema: Indicates whether the result may contain additional fields outside + of the defined schema. + :vartype dynamic_field_schema: bool + :ivar processing_location: The location where the data may be processed. Defaults to global. + Known values are: "geography", "dataZone", and "global". + :vartype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :ivar knowledge_sources: Additional knowledge sources used to enhance the analyzer. + :vartype knowledge_sources: list[~azure.ai.contentunderstanding.models.KnowledgeSource] + :ivar models: Mapping of model roles to specific model names. + Ex. { "completion": "gpt-4.1", "embedding": "text-embedding-3-large" }. + :vartype models: dict[str, str] + :ivar supported_models: Chat completion and embedding models supported by the analyzer. + :vartype supported_models: ~azure.ai.contentunderstanding.models.SupportedModels + """ + + analyzer_id: str = rest_field(name="analyzerId", visibility=["read"]) + """The unique identifier of the analyzer. Required.""" + description: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """A description of the analyzer.""" + tags: Optional[dict[str, str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Tags associated with the analyzer.""" + status: Union[str, "_models.ContentAnalyzerStatus"] = rest_field(visibility=["read"]) + """The status of the analyzer. Required. Known values are: \"creating\", \"ready\", \"deleting\", + and \"failed\".""" + created_at: datetime.datetime = rest_field(name="createdAt", visibility=["read"], format="rfc3339") + """The date and time when the analyzer was created. Required.""" + last_modified_at: datetime.datetime = rest_field(name="lastModifiedAt", visibility=["read"], format="rfc3339") + """The date and time when the analyzer was last modified. Required.""" + warnings: Optional[list[ODataV4Format]] = rest_field(visibility=["read"]) + """Warnings encountered while creating the analyzer.""" + base_analyzer_id: Optional[str] = rest_field(name="baseAnalyzerId", visibility=["read", "create"]) + """The analyzer to incrementally train from.""" + config: Optional["_models.ContentAnalyzerConfig"] = rest_field(visibility=["read", "create"]) + """Analyzer configuration settings.""" + field_schema: Optional["_models.ContentFieldSchema"] = rest_field(name="fieldSchema", visibility=["read", "create"]) + """The schema of fields to extracted.""" + dynamic_field_schema: Optional[bool] = rest_field(name="dynamicFieldSchema", visibility=["read", "create"]) + """Indicates whether the result may contain additional fields outside of the defined schema.""" + processing_location: Optional[Union[str, "_models.ProcessingLocation"]] = rest_field( + name="processingLocation", visibility=["read", "create"] + ) + """The location where the data may be processed. Defaults to global. Known values are: + \"geography\", \"dataZone\", and \"global\".""" + knowledge_sources: Optional[list["_models.KnowledgeSource"]] = rest_field( + name="knowledgeSources", visibility=["read", "create"] + ) + """Additional knowledge sources used to enhance the analyzer.""" + models: Optional[dict[str, str]] = rest_field(visibility=["read", "create"]) + """Mapping of model roles to specific model names. + Ex. { \"completion\": \"gpt-4.1\", \"embedding\": \"text-embedding-3-large\" }.""" + supported_models: Optional["_models.SupportedModels"] = rest_field(name="supportedModels", visibility=["read"]) + """Chat completion and embedding models supported by the analyzer.""" + + @overload + def __init__( + self, + *, + description: Optional[str] = None, + tags: Optional[dict[str, str]] = None, + base_analyzer_id: Optional[str] = None, + config: Optional["_models.ContentAnalyzerConfig"] = None, + field_schema: Optional["_models.ContentFieldSchema"] = None, + dynamic_field_schema: Optional[bool] = None, + processing_location: Optional[Union[str, "_models.ProcessingLocation"]] = None, + knowledge_sources: Optional[list["_models.KnowledgeSource"]] = None, + models: Optional[dict[str, str]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentAnalyzerAnalyzeOperationStatus(_Model): + """Provides status details for analyze operations. + + :ivar id: The unique ID of the operation. Required. + :vartype id: str + :ivar status: The status of the operation. Required. Known values are: "NotStarted", "Running", + "Succeeded", "Failed", and "Canceled". + :vartype status: str or ~azure.ai.contentunderstanding.models.OperationState + :ivar error: Error object that describes the error when status is "Failed". + :vartype error: ~azure.core.ODataV4Format + :ivar result: The result of the operation. + :vartype result: ~azure.ai.contentunderstanding.models.AnalyzeResult + :ivar usage: Usage details of the analyze operation. + :vartype usage: ~azure.ai.contentunderstanding.models.UsageDetails + """ + + id: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The unique ID of the operation. Required.""" + status: Union[str, "_models.OperationState"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The status of the operation. Required. Known values are: \"NotStarted\", \"Running\", + \"Succeeded\", \"Failed\", and \"Canceled\".""" + error: Optional[ODataV4Format] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Error object that describes the error when status is \"Failed\".""" + result: Optional["_models.AnalyzeResult"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The result of the operation.""" + usage: Optional["_models.UsageDetails"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Usage details of the analyze operation.""" + + @overload + def __init__( + self, + *, + id: str, # pylint: disable=redefined-builtin + status: Union[str, "_models.OperationState"], + error: Optional[ODataV4Format] = None, + result: Optional["_models.AnalyzeResult"] = None, + usage: Optional["_models.UsageDetails"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentAnalyzerConfig(_Model): + """Configuration settings for an analyzer. + + :ivar return_details: Return all content details. + :vartype return_details: bool + :ivar locales: List of locale hints for speech transcription. + :vartype locales: list[str] + :ivar enable_ocr: Enable optical character recognition (OCR). + :vartype enable_ocr: bool + :ivar enable_layout: Enable layout analysis. + :vartype enable_layout: bool + :ivar enable_figure_description: Enable generation of figure description. + :vartype enable_figure_description: bool + :ivar enable_figure_analysis: Enable analysis of figures, such as charts and diagrams. + :vartype enable_figure_analysis: bool + :ivar enable_formula: Enable mathematical formula detection. + :vartype enable_formula: bool + :ivar table_format: Representation format of tables in analyze result markdown. Known values + are: "html" and "markdown". + :vartype table_format: str or ~azure.ai.contentunderstanding.models.TableFormat + :ivar chart_format: Representation format of charts in analyze result markdown. Known values + are: "chartJs" and "markdown". + :vartype chart_format: str or ~azure.ai.contentunderstanding.models.ChartFormat + :ivar annotation_format: Representation format of annotations in analyze result markdown. Known + values are: "none" and "markdown". + :vartype annotation_format: str or ~azure.ai.contentunderstanding.models.AnnotationFormat + :ivar disable_face_blurring: Disable the default blurring of faces for privacy while processing + the content. + :vartype disable_face_blurring: bool + :ivar estimate_field_source_and_confidence: Return field grounding source and confidence. + :vartype estimate_field_source_and_confidence: bool + :ivar content_categories: Map of categories to classify the input content(s) against. + :vartype content_categories: dict[str, + ~azure.ai.contentunderstanding.models.ContentCategoryDefinition] + :ivar enable_segment: Enable segmentation of the input by contentCategories. + :vartype enable_segment: bool + :ivar segment_per_page: Force segmentation of document content by page. + :vartype segment_per_page: bool + :ivar omit_content: Omit the content for this analyzer from analyze result. + Only return content(s) from additional analyzers specified in contentCategories, if any. + :vartype omit_content: bool + """ + + return_details: Optional[bool] = rest_field( + name="returnDetails", visibility=["read", "create", "update", "delete", "query"] + ) + """Return all content details.""" + locales: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """List of locale hints for speech transcription.""" + enable_ocr: Optional[bool] = rest_field( + name="enableOcr", visibility=["read", "create", "update", "delete", "query"] + ) + """Enable optical character recognition (OCR).""" + enable_layout: Optional[bool] = rest_field( + name="enableLayout", visibility=["read", "create", "update", "delete", "query"] + ) + """Enable layout analysis.""" + enable_figure_description: Optional[bool] = rest_field( + name="enableFigureDescription", visibility=["read", "create", "update", "delete", "query"] + ) + """Enable generation of figure description.""" + enable_figure_analysis: Optional[bool] = rest_field( + name="enableFigureAnalysis", visibility=["read", "create", "update", "delete", "query"] + ) + """Enable analysis of figures, such as charts and diagrams.""" + enable_formula: Optional[bool] = rest_field( + name="enableFormula", visibility=["read", "create", "update", "delete", "query"] + ) + """Enable mathematical formula detection.""" + table_format: Optional[Union[str, "_models.TableFormat"]] = rest_field( + name="tableFormat", visibility=["read", "create", "update", "delete", "query"] + ) + """Representation format of tables in analyze result markdown. Known values are: \"html\" and + \"markdown\".""" + chart_format: Optional[Union[str, "_models.ChartFormat"]] = rest_field( + name="chartFormat", visibility=["read", "create", "update", "delete", "query"] + ) + """Representation format of charts in analyze result markdown. Known values are: \"chartJs\" and + \"markdown\".""" + annotation_format: Optional[Union[str, "_models.AnnotationFormat"]] = rest_field( + name="annotationFormat", visibility=["read", "create", "update", "delete", "query"] + ) + """Representation format of annotations in analyze result markdown. Known values are: \"none\" and + \"markdown\".""" + disable_face_blurring: Optional[bool] = rest_field( + name="disableFaceBlurring", visibility=["read", "create", "update", "delete", "query"] + ) + """Disable the default blurring of faces for privacy while processing the content.""" + estimate_field_source_and_confidence: Optional[bool] = rest_field( + name="estimateFieldSourceAndConfidence", visibility=["read", "create", "update", "delete", "query"] + ) + """Return field grounding source and confidence.""" + content_categories: Optional[dict[str, "_models.ContentCategoryDefinition"]] = rest_field( + name="contentCategories", visibility=["read", "create", "update", "delete", "query"] + ) + """Map of categories to classify the input content(s) against.""" + enable_segment: Optional[bool] = rest_field( + name="enableSegment", visibility=["read", "create", "update", "delete", "query"] + ) + """Enable segmentation of the input by contentCategories.""" + segment_per_page: Optional[bool] = rest_field( + name="segmentPerPage", visibility=["read", "create", "update", "delete", "query"] + ) + """Force segmentation of document content by page.""" + omit_content: Optional[bool] = rest_field( + name="omitContent", visibility=["read", "create", "update", "delete", "query"] + ) + """Omit the content for this analyzer from analyze result. + Only return content(s) from additional analyzers specified in contentCategories, if any.""" + + @overload + def __init__( + self, + *, + return_details: Optional[bool] = None, + locales: Optional[list[str]] = None, + enable_ocr: Optional[bool] = None, + enable_layout: Optional[bool] = None, + enable_figure_description: Optional[bool] = None, + enable_figure_analysis: Optional[bool] = None, + enable_formula: Optional[bool] = None, + table_format: Optional[Union[str, "_models.TableFormat"]] = None, + chart_format: Optional[Union[str, "_models.ChartFormat"]] = None, + annotation_format: Optional[Union[str, "_models.AnnotationFormat"]] = None, + disable_face_blurring: Optional[bool] = None, + estimate_field_source_and_confidence: Optional[bool] = None, + content_categories: Optional[dict[str, "_models.ContentCategoryDefinition"]] = None, + enable_segment: Optional[bool] = None, + segment_per_page: Optional[bool] = None, + omit_content: Optional[bool] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentAnalyzerOperationStatus(_Model): + """Provides status details for analyzer creation operations. + + :ivar id: The unique ID of the operation. Required. + :vartype id: str + :ivar status: The status of the operation. Required. Known values are: "NotStarted", "Running", + "Succeeded", "Failed", and "Canceled". + :vartype status: str or ~azure.ai.contentunderstanding.models.OperationState + :ivar error: Error object that describes the error when status is "Failed". + :vartype error: ~azure.core.ODataV4Format + :ivar result: The result of the operation. + :vartype result: ~azure.ai.contentunderstanding.models.ContentAnalyzer + :ivar usage: Usage details of the analyzer creation operation. + :vartype usage: ~azure.ai.contentunderstanding.models.UsageDetails + """ + + id: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The unique ID of the operation. Required.""" + status: Union[str, "_models.OperationState"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The status of the operation. Required. Known values are: \"NotStarted\", \"Running\", + \"Succeeded\", \"Failed\", and \"Canceled\".""" + error: Optional[ODataV4Format] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Error object that describes the error when status is \"Failed\".""" + result: Optional["_models.ContentAnalyzer"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The result of the operation.""" + usage: Optional["_models.UsageDetails"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Usage details of the analyzer creation operation.""" + + @overload + def __init__( + self, + *, + id: str, # pylint: disable=redefined-builtin + status: Union[str, "_models.OperationState"], + error: Optional[ODataV4Format] = None, + result: Optional["_models.ContentAnalyzer"] = None, + usage: Optional["_models.UsageDetails"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentCategoryDefinition(_Model): + """Content category definition. + + :ivar description: The description of the category. + :vartype description: str + :ivar analyzer_id: Optional analyzer used to process the content. + :vartype analyzer_id: str + :ivar analyzer: Optional inline definition of analyzer used to process the content. + :vartype analyzer: ~azure.ai.contentunderstanding.models.ContentAnalyzer + """ + + description: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The description of the category.""" + analyzer_id: Optional[str] = rest_field( + name="analyzerId", visibility=["read", "create", "update", "delete", "query"] + ) + """Optional analyzer used to process the content.""" + analyzer: Optional["_models.ContentAnalyzer"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Optional inline definition of analyzer used to process the content.""" + + @overload + def __init__( + self, + *, + description: Optional[str] = None, + analyzer_id: Optional[str] = None, + analyzer: Optional["_models.ContentAnalyzer"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentFieldDefinition(_Model): + """Definition of the field using a JSON Schema like syntax. + + :ivar method: Generation method. Known values are: "generate", "extract", and "classify". + :vartype method: str or ~azure.ai.contentunderstanding.models.GenerationMethod + :ivar type: Semantic data type of the field value. Known values are: "string", "date", "time", + "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar description: Field description. + :vartype description: str + :ivar item_definition: Field type schema of each array element, if type is array. + :vartype item_definition: ~azure.ai.contentunderstanding.models.ContentFieldDefinition + :ivar properties: Named sub-fields, if type is object. + :vartype properties: dict[str, ~azure.ai.contentunderstanding.models.ContentFieldDefinition] + :ivar examples: Examples of field values. + :vartype examples: list[str] + :ivar enum: Enumeration of possible field values. + :vartype enum: list[str] + :ivar enum_descriptions: Descriptions for each enumeration value. + :vartype enum_descriptions: dict[str, str] + :ivar ref: Reference to another field definition. + :vartype ref: str + :ivar estimate_source_and_confidence: Return grounding source and confidence. + :vartype estimate_source_and_confidence: bool + """ + + method: Optional[Union[str, "_models.GenerationMethod"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Generation method. Known values are: \"generate\", \"extract\", and \"classify\".""" + type: Optional[Union[str, "_models.ContentFieldType"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Semantic data type of the field value. Known values are: \"string\", \"date\", \"time\", + \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + description: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Field description.""" + item_definition: Optional["_models.ContentFieldDefinition"] = rest_field( + name="items", visibility=["read", "create", "update", "delete", "query"] + ) + """Field type schema of each array element, if type is array.""" + properties: Optional[dict[str, "_models.ContentFieldDefinition"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Named sub-fields, if type is object.""" + examples: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Examples of field values.""" + enum: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Enumeration of possible field values.""" + enum_descriptions: Optional[dict[str, str]] = rest_field( + name="enumDescriptions", visibility=["read", "create", "update", "delete", "query"] + ) + """Descriptions for each enumeration value.""" + ref: Optional[str] = rest_field(name="$ref", visibility=["read", "create", "update", "delete", "query"]) + """Reference to another field definition.""" + estimate_source_and_confidence: Optional[bool] = rest_field( + name="estimateSourceAndConfidence", visibility=["read", "create", "update", "delete", "query"] + ) + """Return grounding source and confidence.""" + + @overload + def __init__( + self, + *, + method: Optional[Union[str, "_models.GenerationMethod"]] = None, + type: Optional[Union[str, "_models.ContentFieldType"]] = None, + description: Optional[str] = None, + item_definition: Optional["_models.ContentFieldDefinition"] = None, + properties: Optional[dict[str, "_models.ContentFieldDefinition"]] = None, + examples: Optional[list[str]] = None, + enum: Optional[list[str]] = None, + enum_descriptions: Optional[dict[str, str]] = None, + ref: Optional[str] = None, + estimate_source_and_confidence: Optional[bool] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentFieldSchema(_Model): + """Schema of fields to be extracted from documents. + + :ivar name: The name of the field schema. + :vartype name: str + :ivar description: A description of the field schema. + :vartype description: str + :ivar fields: The fields defined in the schema. Required. + :vartype fields: dict[str, ~azure.ai.contentunderstanding.models.ContentFieldDefinition] + :ivar definitions: Additional definitions referenced by the fields in the schema. + :vartype definitions: dict[str, ~azure.ai.contentunderstanding.models.ContentFieldDefinition] + """ + + name: Optional[str] = rest_field(visibility=["read", "create"]) + """The name of the field schema.""" + description: Optional[str] = rest_field(visibility=["read", "create"]) + """A description of the field schema.""" + fields: dict[str, "_models.ContentFieldDefinition"] = rest_field(visibility=["read", "create"]) + """The fields defined in the schema. Required.""" + definitions: Optional[dict[str, "_models.ContentFieldDefinition"]] = rest_field(visibility=["read", "create"]) + """Additional definitions referenced by the fields in the schema.""" + + @overload + def __init__( + self, + *, + fields: dict[str, "_models.ContentFieldDefinition"], + name: Optional[str] = None, + description: Optional[str] = None, + definitions: Optional[dict[str, "_models.ContentFieldDefinition"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentSpan(_Model): + """Position of the element in markdown, specified as a character offset and length. + + :ivar offset: Starting position (0-indexed) of the element in markdown, specified in + characters. Required. + :vartype offset: int + :ivar length: Length of the element in markdown, specified in characters. Required. + :vartype length: int + """ + + offset: int = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Starting position (0-indexed) of the element in markdown, specified in characters. Required.""" + length: int = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Length of the element in markdown, specified in characters. Required.""" + + @overload + def __init__( + self, + *, + offset: int, + length: int, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ContentUnderstandingDefaults(_Model): + """default settings for this Content Understanding resource. + + :ivar model_deployments: Mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Required. + :vartype model_deployments: dict[str, str] + """ + + model_deployments: dict[str, str] = rest_field(name="modelDeployments", visibility=["read", "create", "update"]) + """Mapping of model names to deployments. + Ex. { \"gpt-4.1\": \"myGpt41Deployment\", \"text-embedding-3-large\": + \"myTextEmbedding3LargeDeployment\" }. Required.""" + + @overload + def __init__( + self, + *, + model_deployments: dict[str, str], + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class CopyAuthorization(_Model): + """Copy authorization details for cross-resource copy. + + :ivar source: Full path of the source analyzer. Required. + :vartype source: str + :ivar target_azure_resource_id: Azure resource ID of the target location to copy to. Required. + :vartype target_azure_resource_id: str + :ivar expires_at: Date/time when the copy authorization expires. Required. + :vartype expires_at: ~datetime.datetime + """ + + source: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Full path of the source analyzer. Required.""" + target_azure_resource_id: str = rest_field( + name="targetAzureResourceId", visibility=["read", "create", "update", "delete", "query"] + ) + """Azure resource ID of the target location to copy to. Required.""" + expires_at: datetime.datetime = rest_field( + name="expiresAt", visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """Date/time when the copy authorization expires. Required.""" + + @overload + def __init__( + self, + *, + source: str, + target_azure_resource_id: str, + expires_at: datetime.datetime, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DateField(ContentField, discriminator="date"): + """Date field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. Date, normalized to ISO 8601 + (YYYY-MM-DD) format. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.DATE + :ivar value_date: Date field value, in ISO 8601 (YYYY-MM-DD) format. + :vartype value_date: ~datetime.date + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.DATE] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. Date, normalized to ISO 8601 (YYYY-MM-DD) + format.""" + value_date: Optional[datetime.date] = rest_field( + name="valueDate", visibility=["read", "create", "update", "delete", "query"] + ) + """Date field value, in ISO 8601 (YYYY-MM-DD) format.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_date: Optional[datetime.date] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.DATE # type: ignore + + +class DetectedPerson(_Model): + """Detected person. + + :ivar person_id: Person identifier in the optional person directory if found. Otherwise, each + unknown person is assigned a unique ``Person-{Number}``. + :vartype person_id: str + :ivar confidence: Confidence of the person identification, if a person directory is provided. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the person in the input content. + :vartype source: str + """ + + person_id: Optional[str] = rest_field(name="personId", visibility=["read", "create", "update", "delete", "query"]) + """Person identifier in the optional person directory if found. Otherwise, each unknown person is + assigned a unique ``Person-{Number}``.""" + confidence: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Confidence of the person identification, if a person directory is provided.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the person in the input content.""" + + @overload + def __init__( + self, + *, + person_id: Optional[str] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentAnnotation(_Model): + """Annotation in a document, such as a strikethrough or a comment. + + :ivar id: Annotation identifier. Required. + :vartype id: str + :ivar kind: Annotation kind. Required. Known values are: "highlight", "strikethrough", + "underline", "italic", "bold", "circle", and "note". + :vartype kind: str or ~azure.ai.contentunderstanding.models.DocumentAnnotationKind + :ivar spans: Spans of the content associated with the annotation. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar source: Position of the annotation. + :vartype source: str + :ivar comments: Comments associated with the annotation. + :vartype comments: list[~azure.ai.contentunderstanding.models.DocumentAnnotationComment] + :ivar author: Annotation author. + :vartype author: str + :ivar created_at: Date and time when the annotation was created. + :vartype created_at: ~datetime.datetime + :ivar last_modified_at: Date and time when the annotation was last modified. + :vartype last_modified_at: ~datetime.datetime + :ivar tags: Tags associated with the annotation. + :vartype tags: list[str] + """ + + id: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Annotation identifier. Required.""" + kind: Union[str, "_models.DocumentAnnotationKind"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Annotation kind. Required. Known values are: \"highlight\", \"strikethrough\", \"underline\", + \"italic\", \"bold\", \"circle\", and \"note\".""" + spans: Optional[list["_models.ContentSpan"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Spans of the content associated with the annotation.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Position of the annotation.""" + comments: Optional[list["_models.DocumentAnnotationComment"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Comments associated with the annotation.""" + author: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Annotation author.""" + created_at: Optional[datetime.datetime] = rest_field( + name="createdAt", visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """Date and time when the annotation was created.""" + last_modified_at: Optional[datetime.datetime] = rest_field( + name="lastModifiedAt", visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """Date and time when the annotation was last modified.""" + tags: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Tags associated with the annotation.""" + + @overload + def __init__( + self, + *, + id: str, # pylint: disable=redefined-builtin + kind: Union[str, "_models.DocumentAnnotationKind"], + spans: Optional[list["_models.ContentSpan"]] = None, + source: Optional[str] = None, + comments: Optional[list["_models.DocumentAnnotationComment"]] = None, + author: Optional[str] = None, + created_at: Optional[datetime.datetime] = None, + last_modified_at: Optional[datetime.datetime] = None, + tags: Optional[list[str]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentAnnotationComment(_Model): + """Comment associated with a document annotation. + + :ivar message: Comment message in Markdown. Required. + :vartype message: str + :ivar author: Author of the comment. + :vartype author: str + :ivar created_at: Date and time when the comment was created. + :vartype created_at: ~datetime.datetime + :ivar last_modified_at: Date and time when the comment was last modified. + :vartype last_modified_at: ~datetime.datetime + :ivar tags: Tags associated with the comment. + :vartype tags: list[str] + """ + + message: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Comment message in Markdown. Required.""" + author: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Author of the comment.""" + created_at: Optional[datetime.datetime] = rest_field( + name="createdAt", visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """Date and time when the comment was created.""" + last_modified_at: Optional[datetime.datetime] = rest_field( + name="lastModifiedAt", visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """Date and time when the comment was last modified.""" + tags: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Tags associated with the comment.""" + + @overload + def __init__( + self, + *, + message: str, + author: Optional[str] = None, + created_at: Optional[datetime.datetime] = None, + last_modified_at: Optional[datetime.datetime] = None, + tags: Optional[list[str]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentBarcode(_Model): + """Barcode in a document. + + :ivar kind: Barcode kind. Required. Known values are: "QRCode", "PDF417", "UPCA", "UPCE", + "Code39", "Code128", "EAN8", "EAN13", "DataBar", "Code93", "Codabar", "DataBarExpanded", "ITF", + "MicroQRCode", "Aztec", "DataMatrix", and "MaxiCode". + :vartype kind: str or ~azure.ai.contentunderstanding.models.DocumentBarcodeKind + :ivar value: Barcode value. Required. + :vartype value: str + :ivar source: Encoded source that identifies the position of the barcode in the content. + :vartype source: str + :ivar span: Span of the barcode in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar confidence: Confidence of predicting the barcode. + :vartype confidence: float + """ + + kind: Union[str, "_models.DocumentBarcodeKind"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Barcode kind. Required. Known values are: \"QRCode\", \"PDF417\", \"UPCA\", \"UPCE\", + \"Code39\", \"Code128\", \"EAN8\", \"EAN13\", \"DataBar\", \"Code93\", \"Codabar\", + \"DataBarExpanded\", \"ITF\", \"MicroQRCode\", \"Aztec\", \"DataMatrix\", and \"MaxiCode\".""" + value: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Barcode value. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the barcode in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the barcode in the markdown content.""" + confidence: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Confidence of predicting the barcode.""" + + @overload + def __init__( + self, + *, + kind: Union[str, "_models.DocumentBarcodeKind"], + value: str, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + confidence: Optional[float] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentCaption(_Model): + """Caption of a table or figure. + + :ivar content: Content of the caption. Required. + :vartype content: str + :ivar source: Encoded source that identifies the position of the caption in the content. + :vartype source: str + :ivar span: Span of the caption in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar elements: Child elements of the caption. + :vartype elements: list[str] + """ + + content: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Content of the caption. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the caption in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the caption in the markdown content.""" + elements: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Child elements of the caption.""" + + @overload + def __init__( + self, + *, + content: str, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + elements: Optional[list[str]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentFigure(_Model): + """Figure in a document. + + You probably want to use the sub-classes and not this class directly. Known sub-classes are: + DocumentChartFigure, DocumentMermaidFigure + + :ivar kind: Figure kind. Required. Known values are: "unknown", "chart", and "mermaid". + :vartype kind: str or ~azure.ai.contentunderstanding.models.DocumentFigureKind + :ivar id: Figure identifier. Required. + :vartype id: str + :ivar source: Encoded source that identifies the position of the figure in the content. + :vartype source: str + :ivar span: Span of the figure in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar elements: Child elements of the figure, excluding any caption or footnotes. + :vartype elements: list[str] + :ivar caption: Figure caption. + :vartype caption: ~azure.ai.contentunderstanding.models.DocumentCaption + :ivar footnotes: List of figure footnotes. + :vartype footnotes: list[~azure.ai.contentunderstanding.models.DocumentFootnote] + :ivar description: Description of the figure. + :vartype description: str + :ivar role: Semantic role of the figure. Known values are: "pageHeader", "pageFooter", + "pageNumber", "title", "sectionHeading", "footnote", and "formulaBlock". + :vartype role: str or ~azure.ai.contentunderstanding.models.SemanticRole + """ + + __mapping__: dict[str, _Model] = {} + kind: str = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) + """Figure kind. Required. Known values are: \"unknown\", \"chart\", and \"mermaid\".""" + id: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Figure identifier. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the figure in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the figure in the markdown content.""" + elements: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Child elements of the figure, excluding any caption or footnotes.""" + caption: Optional["_models.DocumentCaption"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Figure caption.""" + footnotes: Optional[list["_models.DocumentFootnote"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of figure footnotes.""" + description: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Description of the figure.""" + role: Optional[Union[str, "_models.SemanticRole"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Semantic role of the figure. Known values are: \"pageHeader\", \"pageFooter\", \"pageNumber\", + \"title\", \"sectionHeading\", \"footnote\", and \"formulaBlock\".""" + + @overload + def __init__( + self, + *, + kind: str, + id: str, # pylint: disable=redefined-builtin + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + elements: Optional[list[str]] = None, + caption: Optional["_models.DocumentCaption"] = None, + footnotes: Optional[list["_models.DocumentFootnote"]] = None, + description: Optional[str] = None, + role: Optional[Union[str, "_models.SemanticRole"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentChartFigure(DocumentFigure, discriminator="chart"): + """Figure containing a chart, such as a bar chart, line chart, or pie chart. + + :ivar id: Figure identifier. Required. + :vartype id: str + :ivar source: Encoded source that identifies the position of the figure in the content. + :vartype source: str + :ivar span: Span of the figure in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar elements: Child elements of the figure, excluding any caption or footnotes. + :vartype elements: list[str] + :ivar caption: Figure caption. + :vartype caption: ~azure.ai.contentunderstanding.models.DocumentCaption + :ivar footnotes: List of figure footnotes. + :vartype footnotes: list[~azure.ai.contentunderstanding.models.DocumentFootnote] + :ivar description: Description of the figure. + :vartype description: str + :ivar role: Semantic role of the figure. Known values are: "pageHeader", "pageFooter", + "pageNumber", "title", "sectionHeading", "footnote", and "formulaBlock". + :vartype role: str or ~azure.ai.contentunderstanding.models.SemanticRole + :ivar kind: Figure kind. Required. Figure containing a chart, such as a bar chart, line chart, + or pie chart. + :vartype kind: str or ~azure.ai.contentunderstanding.models.CHART + :ivar content: Chart content represented using `Chart.js config + `_. Required. + :vartype content: any + """ + + kind: Literal[DocumentFigureKind.CHART] = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Figure kind. Required. Figure containing a chart, such as a bar chart, line chart, or pie + chart.""" + content: Any = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Chart content represented using `Chart.js config + `_. Required.""" + + @overload + def __init__( + self, + *, + id: str, # pylint: disable=redefined-builtin + content: Any, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + elements: Optional[list[str]] = None, + caption: Optional["_models.DocumentCaption"] = None, + footnotes: Optional[list["_models.DocumentFootnote"]] = None, + description: Optional[str] = None, + role: Optional[Union[str, "_models.SemanticRole"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.kind = DocumentFigureKind.CHART # type: ignore + + +class DocumentContent(MediaContent, discriminator="document"): + """Document content. Ex. text/plain, application/pdf, image/jpeg. + + :ivar mime_type: Detected MIME type of the content. Ex. application/pdf, image/jpeg, etc. + Required. + :vartype mime_type: str + :ivar analyzer_id: The analyzer that generated this content. + :vartype analyzer_id: str + :ivar category: Classified content category. + :vartype category: str + :ivar path: The path of the content in the input. + :vartype path: str + :ivar markdown: Markdown representation of the content. + :vartype markdown: str + :ivar fields: Extracted fields from the content. + :vartype fields: dict[str, ~azure.ai.contentunderstanding.models.ContentField] + :ivar kind: Content kind. Required. Document content, such as pdf, image, txt, etc. + :vartype kind: str or ~azure.ai.contentunderstanding.models.DOCUMENT + :ivar start_page_number: Start page number (1-indexed) of the content. Required. + :vartype start_page_number: int + :ivar end_page_number: End page number (1-indexed) of the content. Required. + :vartype end_page_number: int + :ivar unit: Length unit used by the width, height, and source properties. + For images/tiff, the default unit is pixel. For PDF, the default unit is inch. Known values + are: "pixel" and "inch". + :vartype unit: str or ~azure.ai.contentunderstanding.models.LengthUnit + :ivar pages: List of pages in the document. + :vartype pages: list[~azure.ai.contentunderstanding.models.DocumentPage] + :ivar paragraphs: List of paragraphs in the document. Only if enableOcr and returnDetails are + true. + :vartype paragraphs: list[~azure.ai.contentunderstanding.models.DocumentParagraph] + :ivar sections: List of sections in the document. Only if enableLayout and returnDetails are + true. + :vartype sections: list[~azure.ai.contentunderstanding.models.DocumentSection] + :ivar tables: List of tables in the document. Only if enableLayout and returnDetails are true. + :vartype tables: list[~azure.ai.contentunderstanding.models.DocumentTable] + :ivar figures: List of figures in the document. Only if enableLayout and returnDetails are + true. + :vartype figures: list[~azure.ai.contentunderstanding.models.DocumentFigure] + :ivar persons: List of detected persons in the document. Only if enableFace and returnDetails + are true. + :vartype persons: list[~azure.ai.contentunderstanding.models.DetectedPerson] + :ivar annotations: List of annotations in the document. Only if enableAnnotations and + returnDetails are true. + :vartype annotations: list[~azure.ai.contentunderstanding.models.DocumentAnnotation] + :ivar hyperlinks: List of hyperlinks in the document. Only if returnDetails are true. + :vartype hyperlinks: list[~azure.ai.contentunderstanding.models.DocumentHyperlink] + :ivar segments: List of detected content segments. Only if enableSegment is true. + :vartype segments: list[~azure.ai.contentunderstanding.models.DocumentContentSegment] + """ + + kind: Literal[MediaContentKind.DOCUMENT] = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Content kind. Required. Document content, such as pdf, image, txt, etc.""" + start_page_number: int = rest_field( + name="startPageNumber", visibility=["read", "create", "update", "delete", "query"] + ) + """Start page number (1-indexed) of the content. Required.""" + end_page_number: int = rest_field(name="endPageNumber", visibility=["read", "create", "update", "delete", "query"]) + """End page number (1-indexed) of the content. Required.""" + unit: Optional[Union[str, "_models.LengthUnit"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Length unit used by the width, height, and source properties. + For images/tiff, the default unit is pixel. For PDF, the default unit is inch. Known values + are: \"pixel\" and \"inch\".""" + pages: Optional[list["_models.DocumentPage"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of pages in the document.""" + paragraphs: Optional[list["_models.DocumentParagraph"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of paragraphs in the document. Only if enableOcr and returnDetails are true.""" + sections: Optional[list["_models.DocumentSection"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of sections in the document. Only if enableLayout and returnDetails are true.""" + tables: Optional[list["_models.DocumentTable"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of tables in the document. Only if enableLayout and returnDetails are true.""" + figures: Optional[list["_models.DocumentFigure"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of figures in the document. Only if enableLayout and returnDetails are true.""" + persons: Optional[list["_models.DetectedPerson"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of detected persons in the document. Only if enableFace and returnDetails are true.""" + annotations: Optional[list["_models.DocumentAnnotation"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of annotations in the document. Only if enableAnnotations and returnDetails are true.""" + hyperlinks: Optional[list["_models.DocumentHyperlink"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of hyperlinks in the document. Only if returnDetails are true.""" + segments: Optional[list["_models.DocumentContentSegment"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of detected content segments. Only if enableSegment is true.""" + + @overload + def __init__( + self, + *, + mime_type: str, + start_page_number: int, + end_page_number: int, + analyzer_id: Optional[str] = None, + category: Optional[str] = None, + path: Optional[str] = None, + markdown: Optional[str] = None, + fields: Optional[dict[str, "_models.ContentField"]] = None, + unit: Optional[Union[str, "_models.LengthUnit"]] = None, + pages: Optional[list["_models.DocumentPage"]] = None, + paragraphs: Optional[list["_models.DocumentParagraph"]] = None, + sections: Optional[list["_models.DocumentSection"]] = None, + tables: Optional[list["_models.DocumentTable"]] = None, + figures: Optional[list["_models.DocumentFigure"]] = None, + persons: Optional[list["_models.DetectedPerson"]] = None, + annotations: Optional[list["_models.DocumentAnnotation"]] = None, + hyperlinks: Optional[list["_models.DocumentHyperlink"]] = None, + segments: Optional[list["_models.DocumentContentSegment"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.kind = MediaContentKind.DOCUMENT # type: ignore + + +class DocumentContentSegment(_Model): + """Detected document content segment. + + :ivar segment_id: Segment identifier. Required. + :vartype segment_id: str + :ivar category: Classified content category. Required. + :vartype category: str + :ivar span: Span of the segment in the markdown content. Required. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar start_page_number: Start page number (1-indexed) of the segment. Required. + :vartype start_page_number: int + :ivar end_page_number: End page number (1-indexed) of the segment. Required. + :vartype end_page_number: int + """ + + segment_id: str = rest_field(name="segmentId", visibility=["read", "create", "update", "delete", "query"]) + """Segment identifier. Required.""" + category: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Classified content category. Required.""" + span: "_models.ContentSpan" = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the segment in the markdown content. Required.""" + start_page_number: int = rest_field( + name="startPageNumber", visibility=["read", "create", "update", "delete", "query"] + ) + """Start page number (1-indexed) of the segment. Required.""" + end_page_number: int = rest_field(name="endPageNumber", visibility=["read", "create", "update", "delete", "query"]) + """End page number (1-indexed) of the segment. Required.""" + + @overload + def __init__( + self, + *, + segment_id: str, + category: str, + span: "_models.ContentSpan", + start_page_number: int, + end_page_number: int, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentFootnote(_Model): + """Footnote of a table or figure. + + :ivar content: Content of the footnote. Required. + :vartype content: str + :ivar source: Encoded source that identifies the position of the footnote in the content. + :vartype source: str + :ivar span: Span of the footnote in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar elements: Child elements of the footnote. + :vartype elements: list[str] + """ + + content: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Content of the footnote. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the footnote in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the footnote in the markdown content.""" + elements: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Child elements of the footnote.""" + + @overload + def __init__( + self, + *, + content: str, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + elements: Optional[list[str]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentFormula(_Model): + """Mathematical formula in a document. + + :ivar kind: Formula kind. Required. Known values are: "inline" and "display". + :vartype kind: str or ~azure.ai.contentunderstanding.models.DocumentFormulaKind + :ivar value: LaTex expression describing the formula. Required. + :vartype value: str + :ivar source: Encoded source that identifies the position of the formula in the content. + :vartype source: str + :ivar span: Span of the formula in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar confidence: Confidence of predicting the formula. + :vartype confidence: float + """ + + kind: Union[str, "_models.DocumentFormulaKind"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Formula kind. Required. Known values are: \"inline\" and \"display\".""" + value: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """LaTex expression describing the formula. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the formula in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the formula in the markdown content.""" + confidence: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Confidence of predicting the formula.""" + + @overload + def __init__( + self, + *, + kind: Union[str, "_models.DocumentFormulaKind"], + value: str, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + confidence: Optional[float] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentHyperlink(_Model): + """Hyperlink in a document, such as a link to a web page or an email address. + + :ivar content: Hyperlinked content. Required. + :vartype content: str + :ivar url: URL of the hyperlink. Required. + :vartype url: str + :ivar span: Span of the hyperlink in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar source: Position of the hyperlink. + :vartype source: str + """ + + content: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Hyperlinked content. Required.""" + url: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """URL of the hyperlink. Required.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the hyperlink in the markdown content.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Position of the hyperlink.""" + + @overload + def __init__( + self, + *, + content: str, + url: str, + span: Optional["_models.ContentSpan"] = None, + source: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentLine(_Model): + """Line in a document, consisting of an contiguous sequence of words. + + :ivar content: Line text. Required. + :vartype content: str + :ivar source: Encoded source that identifies the position of the line in the content. + :vartype source: str + :ivar span: Span of the line in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + """ + + content: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Line text. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the line in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the line in the markdown content.""" + + @overload + def __init__( + self, + *, + content: str, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentMermaidFigure(DocumentFigure, discriminator="mermaid"): + """Figure containing a diagram, such as a flowchart or network diagram. + + :ivar id: Figure identifier. Required. + :vartype id: str + :ivar source: Encoded source that identifies the position of the figure in the content. + :vartype source: str + :ivar span: Span of the figure in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar elements: Child elements of the figure, excluding any caption or footnotes. + :vartype elements: list[str] + :ivar caption: Figure caption. + :vartype caption: ~azure.ai.contentunderstanding.models.DocumentCaption + :ivar footnotes: List of figure footnotes. + :vartype footnotes: list[~azure.ai.contentunderstanding.models.DocumentFootnote] + :ivar description: Description of the figure. + :vartype description: str + :ivar role: Semantic role of the figure. Known values are: "pageHeader", "pageFooter", + "pageNumber", "title", "sectionHeading", "footnote", and "formulaBlock". + :vartype role: str or ~azure.ai.contentunderstanding.models.SemanticRole + :ivar kind: Figure kind. Required. Figure containing a diagram, such as a flowchart or network + diagram. + :vartype kind: str or ~azure.ai.contentunderstanding.models.MERMAID + :ivar content: Diagram content represented using `Mermaid syntax + `_. Required. + :vartype content: str + """ + + kind: Literal[DocumentFigureKind.MERMAID] = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Figure kind. Required. Figure containing a diagram, such as a flowchart or network diagram.""" + content: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Diagram content represented using `Mermaid syntax `_. Required.""" + + @overload + def __init__( + self, + *, + id: str, # pylint: disable=redefined-builtin + content: str, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + elements: Optional[list[str]] = None, + caption: Optional["_models.DocumentCaption"] = None, + footnotes: Optional[list["_models.DocumentFootnote"]] = None, + description: Optional[str] = None, + role: Optional[Union[str, "_models.SemanticRole"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.kind = DocumentFigureKind.MERMAID # type: ignore + + +class DocumentPage(_Model): + """Content from a document page. + + :ivar page_number: Page number (1-based). Required. + :vartype page_number: int + :ivar width: Width of the page. + :vartype width: float + :ivar height: Height of the page. + :vartype height: float + :ivar spans: Span(s) associated with the page in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar angle: The general orientation of the content in clockwise direction, + measured in degrees between (-180, 180]. + Only if enableOcr is true. + :vartype angle: float + :ivar words: List of words in the page. Only if enableOcr and returnDetails are true. + :vartype words: list[~azure.ai.contentunderstanding.models.DocumentWord] + :ivar lines: List of lines in the page. Only if enableOcr and returnDetails are true. + :vartype lines: list[~azure.ai.contentunderstanding.models.DocumentLine] + :ivar barcodes: List of barcodes in the page. Only if enableBarcode and returnDetails are + true. + :vartype barcodes: list[~azure.ai.contentunderstanding.models.DocumentBarcode] + :ivar formulas: List of mathematical formulas in the page. Only if enableFormula and + returnDetails are true. + :vartype formulas: list[~azure.ai.contentunderstanding.models.DocumentFormula] + """ + + page_number: int = rest_field(name="pageNumber", visibility=["read", "create", "update", "delete", "query"]) + """Page number (1-based). Required.""" + width: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Width of the page.""" + height: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Height of the page.""" + spans: Optional[list["_models.ContentSpan"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Span(s) associated with the page in the markdown content.""" + angle: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The general orientation of the content in clockwise direction, + measured in degrees between (-180, 180]. + Only if enableOcr is true.""" + words: Optional[list["_models.DocumentWord"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of words in the page. Only if enableOcr and returnDetails are true.""" + lines: Optional[list["_models.DocumentLine"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of lines in the page. Only if enableOcr and returnDetails are true.""" + barcodes: Optional[list["_models.DocumentBarcode"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of barcodes in the page. Only if enableBarcode and returnDetails are true.""" + formulas: Optional[list["_models.DocumentFormula"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of mathematical formulas in the page. Only if enableFormula and returnDetails are true.""" + + @overload + def __init__( + self, + *, + page_number: int, + width: Optional[float] = None, + height: Optional[float] = None, + spans: Optional[list["_models.ContentSpan"]] = None, + angle: Optional[float] = None, + words: Optional[list["_models.DocumentWord"]] = None, + lines: Optional[list["_models.DocumentLine"]] = None, + barcodes: Optional[list["_models.DocumentBarcode"]] = None, + formulas: Optional[list["_models.DocumentFormula"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentParagraph(_Model): + """Paragraph in a document, generally consisting of an contiguous sequence of lines + with common alignment and spacing. + + :ivar role: Semantic role of the paragraph. Known values are: "pageHeader", "pageFooter", + "pageNumber", "title", "sectionHeading", "footnote", and "formulaBlock". + :vartype role: str or ~azure.ai.contentunderstanding.models.SemanticRole + :ivar content: Paragraph text. Required. + :vartype content: str + :ivar source: Encoded source that identifies the position of the paragraph in the content. + :vartype source: str + :ivar span: Span of the paragraph in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + """ + + role: Optional[Union[str, "_models.SemanticRole"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Semantic role of the paragraph. Known values are: \"pageHeader\", \"pageFooter\", + \"pageNumber\", \"title\", \"sectionHeading\", \"footnote\", and \"formulaBlock\".""" + content: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Paragraph text. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the paragraph in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the paragraph in the markdown content.""" + + @overload + def __init__( + self, + *, + content: str, + role: Optional[Union[str, "_models.SemanticRole"]] = None, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentSection(_Model): + """Section in a document. + + :ivar span: Span of the section in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar elements: Child elements of the section. + :vartype elements: list[str] + """ + + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the section in the markdown content.""" + elements: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Child elements of the section.""" + + @overload + def __init__( + self, + *, + span: Optional["_models.ContentSpan"] = None, + elements: Optional[list[str]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentTable(_Model): + """Table in a document, consisting table cells arranged in a rectangular layout. + + :ivar row_count: Number of rows in the table. Required. + :vartype row_count: int + :ivar column_count: Number of columns in the table. Required. + :vartype column_count: int + :ivar cells: Cells contained within the table. Required. + :vartype cells: list[~azure.ai.contentunderstanding.models.DocumentTableCell] + :ivar source: Encoded source that identifies the position of the table in the content. + :vartype source: str + :ivar span: Span of the table in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar caption: Table caption. + :vartype caption: ~azure.ai.contentunderstanding.models.DocumentCaption + :ivar footnotes: List of table footnotes. + :vartype footnotes: list[~azure.ai.contentunderstanding.models.DocumentFootnote] + :ivar role: Semantic role of the table. Known values are: "pageHeader", "pageFooter", + "pageNumber", "title", "sectionHeading", "footnote", and "formulaBlock". + :vartype role: str or ~azure.ai.contentunderstanding.models.SemanticRole + """ + + row_count: int = rest_field(name="rowCount", visibility=["read", "create", "update", "delete", "query"]) + """Number of rows in the table. Required.""" + column_count: int = rest_field(name="columnCount", visibility=["read", "create", "update", "delete", "query"]) + """Number of columns in the table. Required.""" + cells: list["_models.DocumentTableCell"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Cells contained within the table. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the table in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the table in the markdown content.""" + caption: Optional["_models.DocumentCaption"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Table caption.""" + footnotes: Optional[list["_models.DocumentFootnote"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """List of table footnotes.""" + role: Optional[Union[str, "_models.SemanticRole"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Semantic role of the table. Known values are: \"pageHeader\", \"pageFooter\", \"pageNumber\", + \"title\", \"sectionHeading\", \"footnote\", and \"formulaBlock\".""" + + @overload + def __init__( + self, + *, + row_count: int, + column_count: int, + cells: list["_models.DocumentTableCell"], + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + caption: Optional["_models.DocumentCaption"] = None, + footnotes: Optional[list["_models.DocumentFootnote"]] = None, + role: Optional[Union[str, "_models.SemanticRole"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentTableCell(_Model): + """Table cell in a document table. + + :ivar kind: Table cell kind. Known values are: "content", "rowHeader", "columnHeader", + "stubHead", and "description". + :vartype kind: str or ~azure.ai.contentunderstanding.models.DocumentTableCellKind + :ivar row_index: Row index of the cell. Required. + :vartype row_index: int + :ivar column_index: Column index of the cell. Required. + :vartype column_index: int + :ivar row_span: Number of rows spanned by this cell. + :vartype row_span: int + :ivar column_span: Number of columns spanned by this cell. + :vartype column_span: int + :ivar content: Content of the table cell. Required. + :vartype content: str + :ivar source: Encoded source that identifies the position of the table cell in the content. + :vartype source: str + :ivar span: Span of the table cell in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar elements: Child elements of the table cell. + :vartype elements: list[str] + """ + + kind: Optional[Union[str, "_models.DocumentTableCellKind"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Table cell kind. Known values are: \"content\", \"rowHeader\", \"columnHeader\", \"stubHead\", + and \"description\".""" + row_index: int = rest_field(name="rowIndex", visibility=["read", "create", "update", "delete", "query"]) + """Row index of the cell. Required.""" + column_index: int = rest_field(name="columnIndex", visibility=["read", "create", "update", "delete", "query"]) + """Column index of the cell. Required.""" + row_span: Optional[int] = rest_field(name="rowSpan", visibility=["read", "create", "update", "delete", "query"]) + """Number of rows spanned by this cell.""" + column_span: Optional[int] = rest_field( + name="columnSpan", visibility=["read", "create", "update", "delete", "query"] + ) + """Number of columns spanned by this cell.""" + content: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Content of the table cell. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the table cell in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the table cell in the markdown content.""" + elements: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Child elements of the table cell.""" + + @overload + def __init__( + self, + *, + row_index: int, + column_index: int, + content: str, + kind: Optional[Union[str, "_models.DocumentTableCellKind"]] = None, + row_span: Optional[int] = None, + column_span: Optional[int] = None, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + elements: Optional[list[str]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class DocumentWord(_Model): + """Word in a document, consisting of a contiguous sequence of characters. + For non-space delimited languages, such as Chinese, Japanese, and Korean, + each character is represented as its own word. + + :ivar content: Word text. Required. + :vartype content: str + :ivar source: Encoded source that identifies the position of the word in the content. + :vartype source: str + :ivar span: Span of the word in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar confidence: Confidence of predicting the word. + :vartype confidence: float + """ + + content: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Word text. Required.""" + source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Encoded source that identifies the position of the word in the content.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the word in the markdown content.""" + confidence: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Confidence of predicting the word.""" + + @overload + def __init__( + self, + *, + content: str, + source: Optional[str] = None, + span: Optional["_models.ContentSpan"] = None, + confidence: Optional[float] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class IntegerField(ContentField, discriminator="integer"): + """Integer field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. Integer as 64-bit signed + integer. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.INTEGER + :ivar value_integer: Integer field value. + :vartype value_integer: int + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.INTEGER] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. Integer as 64-bit signed integer.""" + value_integer: Optional[int] = rest_field( + name="valueInteger", visibility=["read", "create", "update", "delete", "query"] + ) + """Integer field value.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_integer: Optional[int] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.INTEGER # type: ignore + + +class JsonField(ContentField, discriminator="json"): + """JSON field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. JSON object. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.JSON + :ivar value_json: JSON field value. + :vartype value_json: any + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.JSON] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. JSON object.""" + value_json: Optional[Any] = rest_field(name="valueJson", visibility=["read", "create", "update", "delete", "query"]) + """JSON field value.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_json: Optional[Any] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.JSON # type: ignore + + +class KnowledgeSource(_Model): + """Knowledge source. + + You probably want to use the sub-classes and not this class directly. Known sub-classes are: + LabeledDataKnowledgeSource + + :ivar kind: The kind of knowledge source. Required. "labeledData" + :vartype kind: str or ~azure.ai.contentunderstanding.models.KnowledgeSourceKind + """ + + __mapping__: dict[str, _Model] = {} + kind: str = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) + """The kind of knowledge source. Required. \"labeledData\"""" + + @overload + def __init__( + self, + *, + kind: str, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class LabeledDataKnowledgeSource(KnowledgeSource, discriminator="labeledData"): + """Labeled data knowledge source. + + :ivar kind: A blob container containing labeled data. Required. A labeled data knowledge + source. + :vartype kind: str or ~azure.ai.contentunderstanding.models.LABELED_DATA + :ivar container_url: The URL of the blob container containing labeled data. Required. + :vartype container_url: str + :ivar prefix: An optional prefix to filter blobs within the container. + :vartype prefix: str + :ivar file_list_path: An optional path to a file listing specific blobs to include. Required. + :vartype file_list_path: str + """ + + kind: Literal[KnowledgeSourceKind.LABELED_DATA] = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """A blob container containing labeled data. Required. A labeled data knowledge source.""" + container_url: str = rest_field(name="containerUrl", visibility=["read", "create", "update", "delete", "query"]) + """The URL of the blob container containing labeled data. Required.""" + prefix: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """An optional prefix to filter blobs within the container.""" + file_list_path: str = rest_field(name="fileListPath", visibility=["read", "create", "update", "delete", "query"]) + """An optional path to a file listing specific blobs to include. Required.""" + + @overload + def __init__( + self, + *, + container_url: str, + file_list_path: str, + prefix: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.kind = KnowledgeSourceKind.LABELED_DATA # type: ignore + + +class NumberField(ContentField, discriminator="number"): + """Number field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. Number as double precision + floating point. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.NUMBER + :ivar value_number: Number field value. + :vartype value_number: float + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.NUMBER] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. Number as double precision floating point.""" + value_number: Optional[float] = rest_field( + name="valueNumber", visibility=["read", "create", "update", "delete", "query"] + ) + """Number field value.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_number: Optional[float] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.NUMBER # type: ignore + + +class ObjectField(ContentField, discriminator="object"): + """Object field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. Named list of subfields. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.OBJECT + :ivar value_object: Object field value. + :vartype value_object: dict[str, ~azure.ai.contentunderstanding.models.ContentField] + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.OBJECT] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. Named list of subfields.""" + value_object: Optional[dict[str, "_models.ContentField"]] = rest_field( + name="valueObject", visibility=["read", "create", "update", "delete", "query"] + ) + """Object field value.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_object: Optional[dict[str, "_models.ContentField"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.OBJECT # type: ignore + + +class StringField(ContentField, discriminator="string"): + """String field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. Plain text. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.STRING + :ivar value_string: String field value. + :vartype value_string: str + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.STRING] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. Plain text.""" + value_string: Optional[str] = rest_field( + name="valueString", visibility=["read", "create", "update", "delete", "query"] + ) + """String field value.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_string: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.STRING # type: ignore + + +class SupportedModels(_Model): + """Chat completion and embedding models supported by the analyzer. + + :ivar completion: Chat completion models supported by the analyzer. Required. + :vartype completion: dict[str, str] + :ivar embedding: Embedding models supported by the analyzer. Required. + :vartype embedding: dict[str, str] + """ + + completion: dict[str, str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Chat completion models supported by the analyzer. Required.""" + embedding: dict[str, str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Embedding models supported by the analyzer. Required.""" + + @overload + def __init__( + self, + *, + completion: dict[str, str], + embedding: dict[str, str], + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class TimeField(ContentField, discriminator="time"): + """Time field extracted from the content. + + :ivar type: Semantic data type of the field value. Required. Known values are: "string", + "date", "time", "number", "integer", "boolean", "array", "object", and "json". + :vartype type: str or ~azure.ai.contentunderstanding.models.ContentFieldType + :ivar spans: Span(s) associated with the field value in the markdown content. + :vartype spans: list[~azure.ai.contentunderstanding.models.ContentSpan] + :ivar confidence: Confidence of predicting the field value. + :vartype confidence: float + :ivar source: Encoded source that identifies the position of the field value in the content. + :vartype source: str + :ivar field_type: Semantic data type of the field value. Required. Time, normalized to ISO 8601 + (hh:mm:ss) format. + :vartype field_type: str or ~azure.ai.contentunderstanding.models.TIME + :ivar value_time: Time field value, in ISO 8601 (hh:mm:ss) format. + :vartype value_time: ~datetime.time + """ + + __mapping__: dict[str, _Model] = {} + type: str = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) + """Semantic data type of the field value. Required. Known values are: \"string\", \"date\", + \"time\", \"number\", \"integer\", \"boolean\", \"array\", \"object\", and \"json\".""" + field_type: Literal[ContentFieldType.TIME] = rest_discriminator(name="type", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Semantic data type of the field value. Required. Time, normalized to ISO 8601 (hh:mm:ss) + format.""" + value_time: Optional[datetime.time] = rest_field( + name="valueTime", visibility=["read", "create", "update", "delete", "query"] + ) + """Time field value, in ISO 8601 (hh:mm:ss) format.""" + + @overload + def __init__( + self, + *, + type: str, + spans: Optional[list["_models.ContentSpan"]] = None, + confidence: Optional[float] = None, + source: Optional[str] = None, + value_time: Optional[datetime.time] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.field_type = ContentFieldType.TIME # type: ignore + + +class TranscriptPhrase(_Model): + """Transcript phrase. + + :ivar speaker: Speaker index or name. + :vartype speaker: str + :ivar start_time_ms: Start time of the phrase in milliseconds. Required. + :vartype start_time_ms: int + :ivar end_time_ms: End time of the phrase in milliseconds. Required. + :vartype end_time_ms: int + :ivar locale: Detected locale of the phrase. Ex. en-US. + :vartype locale: str + :ivar text: Transcript text. Required. + :vartype text: str + :ivar confidence: Confidence of predicting the phrase. + :vartype confidence: float + :ivar span: Span of the phrase in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + :ivar words: List of words in the phrase. Required. + :vartype words: list[~azure.ai.contentunderstanding.models.TranscriptWord] + """ + + speaker: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Speaker index or name.""" + start_time_ms: int = rest_field(name="startTimeMs", visibility=["read", "create", "update", "delete", "query"]) + """Start time of the phrase in milliseconds. Required.""" + end_time_ms: int = rest_field(name="endTimeMs", visibility=["read", "create", "update", "delete", "query"]) + """End time of the phrase in milliseconds. Required.""" + locale: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Detected locale of the phrase. Ex. en-US.""" + text: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Transcript text. Required.""" + confidence: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Confidence of predicting the phrase.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the phrase in the markdown content.""" + words: list["_models.TranscriptWord"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """List of words in the phrase. Required.""" + + @overload + def __init__( + self, + *, + start_time_ms: int, + end_time_ms: int, + text: str, + words: list["_models.TranscriptWord"], + speaker: Optional[str] = None, + locale: Optional[str] = None, + confidence: Optional[float] = None, + span: Optional["_models.ContentSpan"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class TranscriptWord(_Model): + """Transcript word. + + :ivar start_time_ms: Start time of the word in milliseconds. Required. + :vartype start_time_ms: int + :ivar end_time_ms: End time of the word in milliseconds. Required. + :vartype end_time_ms: int + :ivar text: Transcript text. Required. + :vartype text: str + :ivar span: Span of the word in the markdown content. + :vartype span: ~azure.ai.contentunderstanding.models.ContentSpan + """ + + start_time_ms: int = rest_field(name="startTimeMs", visibility=["read", "create", "update", "delete", "query"]) + """Start time of the word in milliseconds. Required.""" + end_time_ms: int = rest_field(name="endTimeMs", visibility=["read", "create", "update", "delete", "query"]) + """End time of the word in milliseconds. Required.""" + text: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Transcript text. Required.""" + span: Optional["_models.ContentSpan"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Span of the word in the markdown content.""" + + @overload + def __init__( + self, + *, + start_time_ms: int, + end_time_ms: int, + text: str, + span: Optional["_models.ContentSpan"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class UsageDetails(_Model): + """Usage details. + + :ivar document_pages_minimal: The number of document pages processed at the minimal level. + For documents without explicit pages (ex. txt, html), every 3000 UTF-16 characters is counted + as one page. + :vartype document_pages_minimal: int + :ivar document_pages_basic: The number of document pages processed at the basic level. + For documents without explicit pages (ex. txt, html), every 3000 UTF-16 characters is counted + as one page. + :vartype document_pages_basic: int + :ivar document_pages_standard: The number of document pages processed at the standard level. + For documents without explicit pages (ex. txt, html), every 3000 UTF-16 characters is counted + as one page. + :vartype document_pages_standard: int + :ivar audio_hours: The hours of audio processed. + :vartype audio_hours: float + :ivar video_hours: The hours of video processed. + :vartype video_hours: float + :ivar contextualization_tokens: The number of contextualization tokens consumed for preparing + context, generating confidence scores, source grounding, and output formatting. + :vartype contextualization_tokens: int + :ivar tokens: The number of LLM and embedding tokens consumed, grouped by model (ex. GTP 4.1) + and type (ex. input, cached input, output). + :vartype tokens: dict[str, int] + """ + + document_pages_minimal: Optional[int] = rest_field( + name="documentPagesMinimal", visibility=["read", "create", "update", "delete", "query"] + ) + """The number of document pages processed at the minimal level. + For documents without explicit pages (ex. txt, html), every 3000 UTF-16 characters is counted + as one page.""" + document_pages_basic: Optional[int] = rest_field( + name="documentPagesBasic", visibility=["read", "create", "update", "delete", "query"] + ) + """The number of document pages processed at the basic level. + For documents without explicit pages (ex. txt, html), every 3000 UTF-16 characters is counted + as one page.""" + document_pages_standard: Optional[int] = rest_field( + name="documentPagesStandard", visibility=["read", "create", "update", "delete", "query"] + ) + """The number of document pages processed at the standard level. + For documents without explicit pages (ex. txt, html), every 3000 UTF-16 characters is counted + as one page.""" + audio_hours: Optional[float] = rest_field( + name="audioHours", visibility=["read", "create", "update", "delete", "query"] + ) + """The hours of audio processed.""" + video_hours: Optional[float] = rest_field( + name="videoHours", visibility=["read", "create", "update", "delete", "query"] + ) + """The hours of video processed.""" + contextualization_tokens: Optional[int] = rest_field( + name="contextualizationTokens", visibility=["read", "create", "update", "delete", "query"] + ) + """The number of contextualization tokens consumed for preparing context, generating confidence + scores, source grounding, and output formatting.""" + tokens: Optional[dict[str, int]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The number of LLM and embedding tokens consumed, grouped by model (ex. GTP 4.1) and type (ex. + input, cached input, output).""" + + @overload + def __init__( + self, + *, + document_pages_minimal: Optional[int] = None, + document_pages_basic: Optional[int] = None, + document_pages_standard: Optional[int] = None, + audio_hours: Optional[float] = None, + video_hours: Optional[float] = None, + contextualization_tokens: Optional[int] = None, + tokens: Optional[dict[str, int]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py new file mode 100644 index 000000000000..87676c65a8f0 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -0,0 +1,21 @@ +# 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. +# -------------------------------------------------------------------------- +"""Customize generated code here. + +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +""" + + +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level + + +def patch_sdk(): + """Do not remove from this file. + + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize + """ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/py.typed b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/py.typed new file mode 100644 index 000000000000..e5aff4f83af8 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/py.typed @@ -0,0 +1 @@ +# Marker file for PEP 561. \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/dev_requirements.txt b/sdk/contentunderstanding/azure-ai-contentunderstanding/dev_requirements.txt new file mode 100644 index 000000000000..0e53b6a72db5 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/dev_requirements.txt @@ -0,0 +1,3 @@ +-e ../../../eng/tools/azure-sdk-tools +../../core/azure-core +aiohttp \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/conftest.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/conftest.py new file mode 100644 index 000000000000..ebb1cc0e636a --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/conftest.py @@ -0,0 +1,45 @@ +# 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. +# -------------------------------------------------------------------------- +import os +import pytest +from dotenv import load_dotenv +from devtools_testutils import ( + test_proxy, + add_general_regex_sanitizer, + add_body_key_sanitizer, + add_header_regex_sanitizer, +) + +load_dotenv() + + +# For security, please avoid record sensitive identity information in recordings +@pytest.fixture(scope="session", autouse=True) +def add_sanitizers(test_proxy): + contentunderstanding_subscription_id = os.environ.get( + "CONTENTUNDERSTANDING_SUBSCRIPTION_ID", "00000000-0000-0000-0000-000000000000" + ) + contentunderstanding_tenant_id = os.environ.get( + "CONTENTUNDERSTANDING_TENANT_ID", "00000000-0000-0000-0000-000000000000" + ) + contentunderstanding_client_id = os.environ.get( + "CONTENTUNDERSTANDING_CLIENT_ID", "00000000-0000-0000-0000-000000000000" + ) + contentunderstanding_client_secret = os.environ.get( + "CONTENTUNDERSTANDING_CLIENT_SECRET", "00000000-0000-0000-0000-000000000000" + ) + add_general_regex_sanitizer( + regex=contentunderstanding_subscription_id, value="00000000-0000-0000-0000-000000000000" + ) + add_general_regex_sanitizer(regex=contentunderstanding_tenant_id, value="00000000-0000-0000-0000-000000000000") + add_general_regex_sanitizer(regex=contentunderstanding_client_id, value="00000000-0000-0000-0000-000000000000") + add_general_regex_sanitizer(regex=contentunderstanding_client_secret, value="00000000-0000-0000-0000-000000000000") + + add_header_regex_sanitizer(key="Set-Cookie", value="[set-cookie;]") + add_header_regex_sanitizer(key="Cookie", value="cookie;") + add_body_key_sanitizer(json_path="$..access_token", value="access_token") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py new file mode 100644 index 000000000000..1b31d40d85b9 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py @@ -0,0 +1,313 @@ +# 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. +# -------------------------------------------------------------------------- +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingClientTestBase, ContentUnderstandingPreparer + + +@pytest.mark.skip("you may need to update the auto-generated test case before run it") +class TestContentUnderstanding(ContentUnderstandingClientTestBase): + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_begin_analyze(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.begin_analyze( + analyzer_id="str", + body={ + "inputs": [ + { + "data": bytes("bytes", encoding="utf-8"), + "mimeType": "str", + "name": "str", + "range": "str", + "url": "str", + } + ], + "modelDeployments": {"str": "str"}, + }, + ).result() # call '.result()' to poll until service return final result + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_begin_analyze_binary(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.begin_analyze_binary( + analyzer_id="str", + binary_input=bytes("bytes", encoding="utf-8"), + content_type="str", + ).result() # call '.result()' to poll until service return final result + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_begin_copy(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.begin_copy( + analyzer_id="str", + body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, + source_analyzer_id="str", + ).result() # call '.result()' to poll until service return final result + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_begin_create_or_replace(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.begin_create_or_replace( + analyzer_id="str", + resource={ + "analyzerId": "str", + "createdAt": "2020-02-20 00:00:00", + "lastModifiedAt": "2020-02-20 00:00:00", + "status": "str", + "baseAnalyzerId": "str", + "config": { + "annotationFormat": "str", + "chartFormat": "str", + "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, + "disableFaceBlurring": bool, + "enableFigureAnalysis": bool, + "enableFigureDescription": bool, + "enableFormula": bool, + "enableLayout": bool, + "enableOcr": bool, + "enableSegment": bool, + "estimateFieldSourceAndConfidence": bool, + "locales": ["str"], + "omitContent": bool, + "returnDetails": bool, + "segmentPerPage": bool, + "tableFormat": "str", + }, + "description": "str", + "dynamicFieldSchema": bool, + "fieldSchema": { + "fields": { + "str": { + "$ref": "str", + "description": "str", + "enum": ["str"], + "enumDescriptions": {"str": "str"}, + "estimateSourceAndConfidence": bool, + "examples": ["str"], + "items": ..., + "method": "str", + "properties": {"str": ...}, + "type": "str", + } + }, + "definitions": { + "str": { + "$ref": "str", + "description": "str", + "enum": ["str"], + "enumDescriptions": {"str": "str"}, + "estimateSourceAndConfidence": bool, + "examples": ["str"], + "items": ..., + "method": "str", + "properties": {"str": ...}, + "type": "str", + } + }, + "description": "str", + "name": "str", + }, + "knowledgeSources": ["knowledge_source"], + "models": {"str": "str"}, + "processingLocation": "str", + "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, + "tags": {"str": "str"}, + "warnings": [~azure.core.ODataV4Format], + }, + ).result() # call '.result()' to poll until service return final result + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_delete(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.delete( + analyzer_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_delete_result(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.delete_result( + operation_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_get(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.get( + analyzer_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_get_defaults(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.get_defaults() + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_get_operation_status(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.get_operation_status( + analyzer_id="str", + operation_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_get_result_file(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.get_result_file( + operation_id="str", + path="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_grant_copy_authorization(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.grant_copy_authorization( + analyzer_id="str", + body={"targetAzureResourceId": "str", "targetRegion": "str"}, + target_azure_resource_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_list(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.list() + result = [r for r in response] + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_update(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.update( + analyzer_id="str", + resource={ + "analyzerId": "str", + "createdAt": "2020-02-20 00:00:00", + "lastModifiedAt": "2020-02-20 00:00:00", + "status": "str", + "baseAnalyzerId": "str", + "config": { + "annotationFormat": "str", + "chartFormat": "str", + "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, + "disableFaceBlurring": bool, + "enableFigureAnalysis": bool, + "enableFigureDescription": bool, + "enableFormula": bool, + "enableLayout": bool, + "enableOcr": bool, + "enableSegment": bool, + "estimateFieldSourceAndConfidence": bool, + "locales": ["str"], + "omitContent": bool, + "returnDetails": bool, + "segmentPerPage": bool, + "tableFormat": "str", + }, + "description": "str", + "dynamicFieldSchema": bool, + "fieldSchema": { + "fields": { + "str": { + "$ref": "str", + "description": "str", + "enum": ["str"], + "enumDescriptions": {"str": "str"}, + "estimateSourceAndConfidence": bool, + "examples": ["str"], + "items": ..., + "method": "str", + "properties": {"str": ...}, + "type": "str", + } + }, + "definitions": { + "str": { + "$ref": "str", + "description": "str", + "enum": ["str"], + "enumDescriptions": {"str": "str"}, + "estimateSourceAndConfidence": bool, + "examples": ["str"], + "items": ..., + "method": "str", + "properties": {"str": ...}, + "type": "str", + } + }, + "description": "str", + "name": "str", + }, + "knowledgeSources": ["knowledge_source"], + "models": {"str": "str"}, + "processingLocation": "str", + "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, + "tags": {"str": "str"}, + "warnings": [~azure.core.ODataV4Format], + }, + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_update_defaults(self, contentunderstanding_endpoint): + client = self.create_client(endpoint=contentunderstanding_endpoint) + response = client.update_defaults( + body={"modelDeployments": {}}, + ) + + # please add some check logic here by yourself + # ... diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py new file mode 100644 index 000000000000..2dd3eda1d9b9 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py @@ -0,0 +1,322 @@ +# 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. +# -------------------------------------------------------------------------- +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer import ContentUnderstandingPreparer +from testpreparer_async import ContentUnderstandingClientTestBaseAsync + + +@pytest.mark.skip("you may need to update the auto-generated test case before run it") +class TestContentUnderstandingAsync(ContentUnderstandingClientTestBaseAsync): + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_begin_analyze(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await ( + await client.begin_analyze( + analyzer_id="str", + body={ + "inputs": [ + { + "data": bytes("bytes", encoding="utf-8"), + "mimeType": "str", + "name": "str", + "range": "str", + "url": "str", + } + ], + "modelDeployments": {"str": "str"}, + }, + ) + ).result() # call '.result()' to poll until service return final result + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_begin_analyze_binary(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await ( + await client.begin_analyze_binary( + analyzer_id="str", + binary_input=bytes("bytes", encoding="utf-8"), + content_type="str", + ) + ).result() # call '.result()' to poll until service return final result + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_begin_copy(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await ( + await client.begin_copy( + analyzer_id="str", + body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, + source_analyzer_id="str", + ) + ).result() # call '.result()' to poll until service return final result + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_begin_create_or_replace(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await ( + await client.begin_create_or_replace( + analyzer_id="str", + resource={ + "analyzerId": "str", + "createdAt": "2020-02-20 00:00:00", + "lastModifiedAt": "2020-02-20 00:00:00", + "status": "str", + "baseAnalyzerId": "str", + "config": { + "annotationFormat": "str", + "chartFormat": "str", + "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, + "disableFaceBlurring": bool, + "enableFigureAnalysis": bool, + "enableFigureDescription": bool, + "enableFormula": bool, + "enableLayout": bool, + "enableOcr": bool, + "enableSegment": bool, + "estimateFieldSourceAndConfidence": bool, + "locales": ["str"], + "omitContent": bool, + "returnDetails": bool, + "segmentPerPage": bool, + "tableFormat": "str", + }, + "description": "str", + "dynamicFieldSchema": bool, + "fieldSchema": { + "fields": { + "str": { + "$ref": "str", + "description": "str", + "enum": ["str"], + "enumDescriptions": {"str": "str"}, + "estimateSourceAndConfidence": bool, + "examples": ["str"], + "items": ..., + "method": "str", + "properties": {"str": ...}, + "type": "str", + } + }, + "definitions": { + "str": { + "$ref": "str", + "description": "str", + "enum": ["str"], + "enumDescriptions": {"str": "str"}, + "estimateSourceAndConfidence": bool, + "examples": ["str"], + "items": ..., + "method": "str", + "properties": {"str": ...}, + "type": "str", + } + }, + "description": "str", + "name": "str", + }, + "knowledgeSources": ["knowledge_source"], + "models": {"str": "str"}, + "processingLocation": "str", + "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, + "tags": {"str": "str"}, + "warnings": [~azure.core.ODataV4Format], + }, + ) + ).result() # call '.result()' to poll until service return final result + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_delete(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.delete( + analyzer_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_delete_result(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.delete_result( + operation_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_get(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.get( + analyzer_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_get_defaults(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.get_defaults() + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_get_operation_status(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.get_operation_status( + analyzer_id="str", + operation_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_get_result_file(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.get_result_file( + operation_id="str", + path="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_grant_copy_authorization(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.grant_copy_authorization( + analyzer_id="str", + body={"targetAzureResourceId": "str", "targetRegion": "str"}, + target_azure_resource_id="str", + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_list(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = client.list() + result = [r async for r in response] + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_update(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.update( + analyzer_id="str", + resource={ + "analyzerId": "str", + "createdAt": "2020-02-20 00:00:00", + "lastModifiedAt": "2020-02-20 00:00:00", + "status": "str", + "baseAnalyzerId": "str", + "config": { + "annotationFormat": "str", + "chartFormat": "str", + "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, + "disableFaceBlurring": bool, + "enableFigureAnalysis": bool, + "enableFigureDescription": bool, + "enableFormula": bool, + "enableLayout": bool, + "enableOcr": bool, + "enableSegment": bool, + "estimateFieldSourceAndConfidence": bool, + "locales": ["str"], + "omitContent": bool, + "returnDetails": bool, + "segmentPerPage": bool, + "tableFormat": "str", + }, + "description": "str", + "dynamicFieldSchema": bool, + "fieldSchema": { + "fields": { + "str": { + "$ref": "str", + "description": "str", + "enum": ["str"], + "enumDescriptions": {"str": "str"}, + "estimateSourceAndConfidence": bool, + "examples": ["str"], + "items": ..., + "method": "str", + "properties": {"str": ...}, + "type": "str", + } + }, + "definitions": { + "str": { + "$ref": "str", + "description": "str", + "enum": ["str"], + "enumDescriptions": {"str": "str"}, + "estimateSourceAndConfidence": bool, + "examples": ["str"], + "items": ..., + "method": "str", + "properties": {"str": ...}, + "type": "str", + } + }, + "description": "str", + "name": "str", + }, + "knowledgeSources": ["knowledge_source"], + "models": {"str": "str"}, + "processingLocation": "str", + "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, + "tags": {"str": "str"}, + "warnings": [~azure.core.ODataV4Format], + }, + ) + + # please add some check logic here by yourself + # ... + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_update_defaults(self, contentunderstanding_endpoint): + client = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.update_defaults( + body={"modelDeployments": {}}, + ) + + # please add some check logic here by yourself + # ... diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer.py new file mode 100644 index 000000000000..59d6d08b3a68 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer.py @@ -0,0 +1,28 @@ +# 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 azure.ai.contentunderstanding import ContentUnderstandingClient +from devtools_testutils import AzureRecordedTestCase, PowerShellPreparer +import functools + + +class ContentUnderstandingClientTestBase(AzureRecordedTestCase): + + def create_client(self, endpoint): + credential = self.get_credential(ContentUnderstandingClient) + return self.create_client_from_credential( + ContentUnderstandingClient, + credential=credential, + endpoint=endpoint, + ) + + +ContentUnderstandingPreparer = functools.partial( + PowerShellPreparer, + "contentunderstanding", + contentunderstanding_endpoint="https://fake_contentunderstanding_endpoint.com", +) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer_async.py new file mode 100644 index 000000000000..1ca8d36c5713 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer_async.py @@ -0,0 +1,20 @@ +# 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 azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from devtools_testutils import AzureRecordedTestCase + + +class ContentUnderstandingClientTestBaseAsync(AzureRecordedTestCase): + + def create_async_client(self, endpoint): + credential = self.get_credential(ContentUnderstandingClient, is_async=True) + return self.create_client_from_credential( + ContentUnderstandingClient, + credential=credential, + endpoint=endpoint, + ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml new file mode 100644 index 000000000000..cd660792b3c1 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml @@ -0,0 +1,61 @@ +# -------------------------------------------------------------------------- +# 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. +# -------------------------------------------------------------------------- + +[build-system] +requires = ["setuptools>=77.0.3", "wheel"] +build-backend = "setuptools.build_meta" + +[project] +name = "azure-ai-contentunderstanding" +authors = [ + { name = "Microsoft Corporation", email = "azpysdkhelp@microsoft.com" }, +] +description = "Microsoft Corporation Azure AI Content Understanding Client Library for Python" +license = "MIT" +classifiers = [ + "Development Status :: 4 - Beta", + "Programming Language :: Python", + "Programming Language :: Python :: 3 :: Only", + "Programming Language :: Python :: 3", + "Programming Language :: Python :: 3.9", + "Programming Language :: Python :: 3.10", + "Programming Language :: Python :: 3.11", + "Programming Language :: Python :: 3.12", + "Programming Language :: Python :: 3.13", +] +requires-python = ">=3.9" +keywords = ["azure", "azure sdk"] + +dependencies = [ + "isodate>=0.6.1", + "azure-core>=1.35.0", + "typing-extensions>=4.6.0", +] +dynamic = [ +"version", "readme" +] + +[project.urls] +repository = "https://github.com/Azure/azure-sdk-for-python" + +[tool.setuptools.dynamic] +version = {attr = "azure.ai.contentunderstanding._version.VERSION"} +readme = {file = ["README.md", "CHANGELOG.md"], content-type = "text/markdown"} + +[tool.setuptools.packages.find] +exclude = [ + "tests*", + "generated_tests*", + "samples*", + "generated_samples*", + "doc*", + "azure", + "azure.ai", +] + +[tool.setuptools.package-data] +pytyped = ["py.typed"] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml new file mode 100644 index 000000000000..d99ca2bae886 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml @@ -0,0 +1,4 @@ +directory: specification/ai/ContentUnderstanding +commit: 57cfe1e680b2521e03e1d8a0955bba0257439dca +repo: Azure/azure-rest-api-specs +additionalDirectories: diff --git a/sdk/contentunderstanding/ci.yml b/sdk/contentunderstanding/ci.yml new file mode 100644 index 000000000000..526dd03bda6a --- /dev/null +++ b/sdk/contentunderstanding/ci.yml @@ -0,0 +1,34 @@ +# DO NOT EDIT THIS FILE +# This file is generated automatically and any changes will be lost. + +trigger: + branches: + include: + - main + - hotfix/* + - release/* + - restapi* + paths: + include: + - sdk/contentunderstanding/ + +pr: + branches: + include: + - main + - feature/* + - hotfix/* + - release/* + - restapi* + paths: + include: + - sdk/contentunderstanding/ + +extends: + template: ../../eng/pipelines/templates/stages/archetype-sdk-client.yml + parameters: + ServiceDirectory: contentunderstanding + TestProxy: true + Artifacts: + - name: azure-ai-contentunderstanding + safeName: azureaicontentunderstanding From e8a9ed815884b4d6292ee9ae357c5a34d04fa12b Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 16:55:01 +0000 Subject: [PATCH 002/105] MIGRATE: Copy over the basic README.md --- .../azure-ai-contentunderstanding/README.md | 235 ++++++++++++++++-- 1 file changed, 210 insertions(+), 25 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index ff2efa1c51b6..c61ec4dd36bb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -1,43 +1,228 @@ # Azure AI Content Understanding client library for Python - + +Azure AI Content Understanding is a solution that analyzes and comprehends various media content—such as documents, images, audio, and video—transforming it into structured, organized, and searchable data. + +This table shows the relationship between SDK versions and supported API service versions: + +| SDK version | Supported API service version | +| ----------- | ----------------------------- | +| 1.0.0 | 2025-11-01 | ## Getting started +### Prerequisites + +- Python 3.9 or later is required to use this package. +- You need an [Azure subscription][azure_sub] to use this package. +- Once you have your Azure subscription, create an [Azure AI Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) in the Azure portal. Be sure to create it in a [supported region](https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support). +- For more information, see: https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api?tabs=document + ### Install the package ```bash python -m pip install azure-ai-contentunderstanding ``` -#### Prequisites +## Key concepts -- Python 3.9 or later is required to use this package. -- You need an [Azure subscription][azure_sub] to use this package. -- An existing Azure AI Content Understanding instance. +Content Understanding provides the following main capability: + +### Content Analyzers +Analyze documents and extract structured information using prebuilt or custom analyzers: +- **Prebuilt analyzers**: Ready-to-use analyzers for multi-modal content processing including `prebuilt-documentSearch`, `prebuilt-invoice`, `prebuilt-videoSearch` (examples - see [full list of prebuilt analyzers](https://learn.microsoft.com/azure/ai-services/content-understanding/concepts/prebuilt-analyzers)) +- **Custom analyzers**: Create analyzers with specific field schemas for multi-modal content processing (documents, images, audio, video) +- **Multiple input formats**: URLs, binary data, and various document types + +## Examples + +### Extract Markdown Content from Documents + +Use the `prebuilt-documentSearch` to extract markdown content from documents: + +```python +import asyncio +import os +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import AnalyzeResult, MediaContent, DocumentContent, MediaContentKind +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential +load_dotenv() -## Contributing +async def analyze_document(): + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + # Analyze document using prebuilt-documentSearch + poller = await client.content_analyzers.begin_analyze( + analyzer_id="prebuilt-documentSearch", + url=file_url + ) + result: AnalyzeResult = await poller.result() + + # Extract markdown content + content: MediaContent = result.contents[0] + print("📄 Markdown Content:") + print(content.markdown) + + # Access document-specific properties + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + print(f"📚 Pages: {document_content.start_page_number} - {document_content.end_page_number}") + + if isinstance(credential, DefaultAzureCredential): + await credential.close() + +# Run the analysis +asyncio.run(analyze_document()) +``` + +### Extract Structured Fields from Invoices + +Use the `prebuilt-invoice` analyzer to extract structured invoice fields: + +```python +import asyncio +import os +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import AnalyzeResult, MediaContent +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + +def get_field_value(fields, field_name): + """Helper function to safely extract field values.""" + field = fields.get(field_name) + return field.value if field else None + +async def analyze_invoice(): + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + # Analyze invoice using prebuilt-invoice analyzer + poller = await client.content_analyzers.begin_analyze( + analyzer_id="prebuilt-invoice", + url=file_url + ) + result: AnalyzeResult = await poller.result() + + # Extract invoice fields + content: MediaContent = result.contents[0] + + # Extract basic invoice information + customer_name = get_field_value(content.fields, "CustomerName") + invoice_total = get_field_value(content.fields, "InvoiceTotal") + invoice_date = get_field_value(content.fields, "InvoiceDate") + + print(f"Customer Name: {customer_name or '(None)'}") + print(f"Invoice Total: ${invoice_total or '(None)'}") + print(f"Invoice Date: {invoice_date or '(None)'}") + + # Extract invoice items (array field) + items = get_field_value(content.fields, "Items") + if items: + print("\n🛒 Invoice Items:") + for i, item in enumerate(items): + if hasattr(item, 'value_object') and item.value_object: + item_obj = item.value_object + description = get_field_value(item_obj, "Description") + quantity = get_field_value(item_obj, "Quantity") + unit_price = get_field_value(item_obj, "UnitPrice") + + print(f" Item {i + 1}: {description} - Qty: {quantity} @ ${unit_price}") + + if isinstance(credential, DefaultAzureCredential): + await credential.close() + +# Run the analysis +asyncio.run(analyze_invoice()) +``` + +## Troubleshooting + +### Azure AI Foundry Resource and Regional Support + +Azure AI Content Understanding requires an [Azure AI Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) and is only available in certain [supported regions](https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support). Make sure to: + +- Create an Azure AI Foundry resource in the Azure portal under **AI Foundry** > **AI Foundry** +- Select a supported region when creating the resource + +For detailed setup instructions and current supported regions, see: **[Azure AI Content Understanding Quickstart Guide](https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api)** + +## Next steps + +For more information about Azure AI Content Understanding, see the following additional resources: +- **[Azure AI Content Understanding Documentation](https://learn.microsoft.com/azure/ai-services/content-understanding/)** +- **[REST API Reference](https://learn.microsoft.com/rest/api/content-understanding/)** +- **[Quickstart Guide](https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api)** + +## Running Tests + +To run the tests for this package, you need to set up a `.env` file with your test credentials. + +### Setting up the .env file + +1. The `env.sample` file is located in this package directory (`sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample`). This file contains a template with all the required environment variables. + +2. **Important**: The `.env` file should be placed at the **root of the `azure-sdk-for-python` repository**, not in the package directory. This follows the Azure SDK testing guidelines. + +3. Copy the `env.sample` file from this package to the repo root to create your `.env` file: + ```bash + # From the repo root directory + cp sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample .env + ``` + + Or if you're in the package directory: + ```bash + # From the package directory + cp env.sample ../../../../.env + ``` + +4. Edit the `.env` file at the repo root and fill in your actual values: + - `CONTENTUNDERSTANDING_ENDPOINT`: Your Azure AI Foundry resource endpoint + - `AZURE_CONTENT_UNDERSTANDING_KEY`: Your API key (optional if using DefaultAzureCredential) + - `AZURE_TEST_RUN_LIVE`: Set to `true` to run tests against real Azure resources + - `AZURE_SKIP_LIVE_RECORDING`: Set to `true` to skip recording when running live tests + +### Running tests + +Install the development dependencies: +```bash +pip install -r dev_requirements.txt +pip install -e . +``` + +Run tests with pytest: +```bash +pytest tests/ +``` + +#### Running tests in parallel + +The tests support parallel execution using `pytest-xdist` for faster test runs: + +```bash +# Auto-detect number of CPUs and run tests in parallel +pytest tests/ -n auto + +# Or specify the number of workers +pytest tests/ -n 4 +``` -This project welcomes contributions and suggestions. Most contributions require -you to agree to a Contributor License Agreement (CLA) declaring that you have -the right to, and actually do, grant us the rights to use your contribution. -For details, visit https://cla.microsoft.com. +**Note:** The test proxy server is session-scoped and automatically handles parallel execution, so no additional configuration is needed. -When you submit a pull request, a CLA-bot will automatically determine whether -you need to provide a CLA and decorate the PR appropriately (e.g., label, -comment). Simply follow the instructions provided by the bot. You will only -need to do this once across all repos using our CLA. +For more information about running tests, see the [Azure SDK Python Testing Guide](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md). -This project has adopted the -[Microsoft Open Source Code of Conduct][code_of_conduct]. For more information, -see the Code of Conduct FAQ or contact opencode@microsoft.com with any -additional questions or comments. - -[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ -[authenticate_with_token]: https://docs.microsoft.com/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-an-authentication-token -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#credentials -[azure_identity_pip]: https://pypi.org/project/azure-identity/ -[default_azure_credential]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#defaultazurecredential -[pip]: https://pypi.org/project/pip/ [azure_sub]: https://azure.microsoft.com/free/ From a00ff257df696fde3a0244151086b08bc49c23a0 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 17:56:15 +0000 Subject: [PATCH 003/105] MIGRATE: Migrate patch changes --- .../azure-ai-contentunderstanding/README.md | 4 +- .../_operations/_operations.py | 19 +++- .../_operations/_patch.py | 55 ++++++++++- .../aio/_operations/_operations.py | 16 +++- .../aio/_operations/_patch.py | 55 ++++++++++- .../aio/operations/_patch.py | 91 ++++++++++++++++++ .../ai/contentunderstanding/models/_patch.py | 84 ++++++++++++++-- .../contentunderstanding/operations/_patch.py | 96 +++++++++++++++++++ .../azure-ai-contentunderstanding/env.sample | 89 +++++++++++++++++ 9 files changed, 487 insertions(+), 22 deletions(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index c61ec4dd36bb..b2d2861e025f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -197,7 +197,9 @@ To run the tests for this package, you need to set up a `.env` file with your te ### Running tests -Install the development dependencies: +**Important:** Make sure you have activated the virtual environment before running tests (see [Virtual Environment Setup](#virtual-environment-setup) above). + +Install the development dependencies (if not already installed): ```bash pip install -r dev_requirements.txt pip install -e . diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py index b830c2679c36..1487b3717c90 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py @@ -6,6 +6,9 @@ # Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- +# +# MANUAL CUSTOMIZATIONS APPLIED - Search for "EMITTER-FIX" to find all changes +# from collections.abc import MutableMapping from io import IOBase import json @@ -96,7 +99,8 @@ def build_content_understanding_analyze_binary_request( # pylint: disable=name- _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - content_type: str = kwargs.pop("content_type") + # EMITTER-FIX: Add fallback default for content_type (TypeSpec specifies "application/octet-stream") + content_type: str = kwargs.pop("content_type", "application/octet-stream") api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) accept = _headers.pop("Accept", "application/json") @@ -762,6 +766,8 @@ def _analyze_binary_initial( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, input_range: Optional[str] = None, + # EMITTER-FIX: content_type default value missing (TypeSpec specifies "application/octet-stream") + content_type: str = "application/octet-stream", **kwargs: Any ) -> Iterator[bytes]: error_map: MutableMapping = { @@ -775,7 +781,8 @@ def _analyze_binary_initial( _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - content_type: str = kwargs.pop("content_type") + # EMITTER-FIX: Use parameter instead of kwargs.pop + # content_type: str = kwargs.pop("content_type") # Original (broken) cls: ClsType[Iterator[bytes]] = kwargs.pop("cls", None) _content = binary_input @@ -849,6 +856,8 @@ def begin_analyze_binary( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, input_range: Optional[str] = None, + # EMITTER-FIX: content_type default value missing (TypeSpec specifies "application/octet-stream") + content_type: str = "application/octet-stream", **kwargs: Any ) -> LROPoller[_models.AnalyzeResult]: """Extract content and fields from input. @@ -868,6 +877,9 @@ def begin_analyze_binary( 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. :paramtype input_range: str + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/octet-stream". + :paramtype content_type: str :return: An instance of LROPoller that returns AnalyzeResult. The AnalyzeResult is compatible with MutableMapping :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] @@ -876,7 +888,8 @@ def begin_analyze_binary( _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - content_type: str = kwargs.pop("content_type") + # EMITTER-FIX: Use parameter instead of kwargs.pop + # content_type: str = kwargs.pop("content_type") # Original (broken) cls: ClsType[_models.AnalyzeResult] = kwargs.pop("cls", None) polling: Union[bool, PollingMethod] = kwargs.pop("polling", True) lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index 87676c65a8f0..97b53259c609 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -7,15 +7,60 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ +from typing import Any, TYPE_CHECKING +if TYPE_CHECKING: + from azure.core.polling import LROPoller + from azure.ai.contentunderstanding.models import AnalyzeResult __all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): - """Do not remove from this file. - - `patch_sdk` is a last resort escape hatch that allows you to do customizations - you can't accomplish using the techniques described in - https://aka.ms/azsdk/python/dpcodegen/python/customize + """Patch the generated code to add custom functionality. + + Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property. + + Note: content_type default fix is now directly in generated code (search for EMITTER-FIX) """ + from ._operations import _ContentUnderstandingClientOperationsMixin + from ..operations._patch import AnalyzeLROPoller + + # Store original methods + original_begin_analyze = _ContentUnderstandingClientOperationsMixin.begin_analyze + original_begin_analyze_binary = _ContentUnderstandingClientOperationsMixin.begin_analyze_binary + + # Wrap begin_analyze to return custom LROPoller with .details property + def begin_analyze_wrapped( + self, + analyzer_id: str, + **kwargs: Any + ) -> "LROPoller[AnalyzeResult]": + """Wrapper that returns custom poller with .details property.""" + poller = original_begin_analyze(self, analyzer_id, **kwargs) + return AnalyzeLROPoller( + self._client, # type: ignore + poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access + poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access + poller._polling_method, # pylint: disable=protected-access + ) + + # Wrap begin_analyze_binary to return custom poller + def begin_analyze_binary_wrapped( + self, + analyzer_id: str, + binary_input: bytes, + **kwargs: Any + ) -> "LROPoller[AnalyzeResult]": + """Wrapper that returns custom poller with .details property.""" + poller = original_begin_analyze_binary(self, analyzer_id, binary_input, **kwargs) + return AnalyzeLROPoller( + self._client, # type: ignore + poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access + poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access + poller._polling_method, # pylint: disable=protected-access + ) + + # Replace the methods + _ContentUnderstandingClientOperationsMixin.begin_analyze = begin_analyze_wrapped + _ContentUnderstandingClientOperationsMixin.begin_analyze_binary = begin_analyze_binary_wrapped diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py index 5ea8b0491723..a095b925ed3a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py @@ -6,6 +6,9 @@ # Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- +# +# MANUAL CUSTOMIZATIONS APPLIED - Search for "EMITTER-FIX" to find all changes +# from collections.abc import MutableMapping from io import IOBase import json @@ -374,6 +377,8 @@ async def _analyze_binary_initial( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, input_range: Optional[str] = None, + # EMITTER-FIX: content_type default value missing (TypeSpec specifies "application/octet-stream") + content_type: str = "application/octet-stream", **kwargs: Any ) -> AsyncIterator[bytes]: error_map: MutableMapping = { @@ -387,7 +392,8 @@ async def _analyze_binary_initial( _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - content_type: str = kwargs.pop("content_type") + # EMITTER-FIX: Use parameter instead of kwargs.pop + # content_type: str = kwargs.pop("content_type") # Original (broken) cls: ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) _content = binary_input @@ -461,6 +467,8 @@ async def begin_analyze_binary( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, input_range: Optional[str] = None, + # EMITTER-FIX: content_type default value missing (TypeSpec specifies "application/octet-stream") + content_type: str = "application/octet-stream", **kwargs: Any ) -> AsyncLROPoller[_models.AnalyzeResult]: """Extract content and fields from input. @@ -480,6 +488,9 @@ async def begin_analyze_binary( 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. :paramtype input_range: str + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/octet-stream". + :paramtype content_type: str :return: An instance of AsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is compatible with MutableMapping :rtype: ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] @@ -488,7 +499,8 @@ async def begin_analyze_binary( _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - content_type: str = kwargs.pop("content_type") + # EMITTER-FIX: Use parameter instead of kwargs.pop + # content_type: str = kwargs.pop("content_type") # Original (broken) cls: ClsType[_models.AnalyzeResult] = kwargs.pop("cls", None) polling: Union[bool, AsyncPollingMethod] = kwargs.pop("polling", True) lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index 87676c65a8f0..60c1c2309349 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -7,15 +7,60 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ +from typing import Any, TYPE_CHECKING +if TYPE_CHECKING: + from azure.core.polling import AsyncLROPoller + from azure.ai.contentunderstanding.models import AnalyzeResult __all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): - """Do not remove from this file. - - `patch_sdk` is a last resort escape hatch that allows you to do customizations - you can't accomplish using the techniques described in - https://aka.ms/azsdk/python/dpcodegen/python/customize + """Patch the generated code to add custom functionality. + + Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property. + + Note: content_type default fix is now directly in generated code (search for EMITTER-FIX) """ + from ._operations import _ContentUnderstandingClientOperationsMixin + from ...aio.operations._patch import AnalyzeAsyncLROPoller + + # Store original methods + original_begin_analyze = _ContentUnderstandingClientOperationsMixin.begin_analyze + original_begin_analyze_binary = _ContentUnderstandingClientOperationsMixin.begin_analyze_binary + + # Wrap begin_analyze to return custom poller + async def begin_analyze_wrapped( + self, + analyzer_id: str, + **kwargs: Any + ) -> "AsyncLROPoller[AnalyzeResult]": + """Wrapper that returns custom async poller with .details property.""" + poller = await original_begin_analyze(self, analyzer_id, **kwargs) + return AnalyzeAsyncLROPoller( + self._client, # type: ignore + poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access + poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access + poller._polling_method, # pylint: disable=protected-access + ) + + # Wrap begin_analyze_binary to return custom poller + async def begin_analyze_binary_wrapped( + self, + analyzer_id: str, + binary_input: bytes, + **kwargs: Any + ) -> "AsyncLROPoller[AnalyzeResult]": + """Wrapper that returns custom async poller with .details property.""" + poller = await original_begin_analyze_binary(self, analyzer_id, binary_input, **kwargs) + return AnalyzeAsyncLROPoller( + self._client, # type: ignore + poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access + poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access + poller._polling_method, # pylint: disable=protected-access + ) + + # Replace the methods + _ContentUnderstandingClientOperationsMixin.begin_analyze = begin_analyze_wrapped + _ContentUnderstandingClientOperationsMixin.begin_analyze_binary = begin_analyze_binary_wrapped diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py new file mode 100644 index 000000000000..b59bc2e4d297 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py @@ -0,0 +1,91 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +"""Customize generated code here. + +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +""" +import re +from typing import Any +from azure.core.polling import AsyncLROPoller +from ... import models as _models + +__all__ = ["AnalyzeAsyncLROPoller"] + + +def _parse_operation_id(operation_location_header: str) -> str: + """Parse operation ID from Operation-Location header for analyze operations. + + :param operation_location_header: The Operation-Location header value + :type operation_location_header: str + :return: The extracted operation ID + :rtype: str + :raises ValueError: If operation ID cannot be extracted + """ + # Pattern: https://endpoint/.../analyzerResults/{operation_id}?api-version=... + regex = r".*/analyzerResults/([^?/]+)" + + match = re.search(regex, operation_location_header) + if not match: + raise ValueError(f"Could not extract operation ID from: {operation_location_header}") + + return match.group(1) + + +class AnalyzeAsyncLROPoller(AsyncLROPoller[_models.AnalyzeResult]): + """Custom AsyncLROPoller for Content Understanding analyze operations with details property.""" + + @property + def details(self) -> dict[str, Any]: + """Get operation details including operation ID. + + :return: Dictionary containing operation details + :rtype: dict[str, Any] + :raises ValueError: If operation details cannot be extracted + """ + try: + initial_response = self._polling_method._initial_response # type: ignore[attr-defined] # pylint: disable=protected-access + operation_location = initial_response.http_response.headers.get("Operation-Location") + if not operation_location: + raise ValueError("No Operation-Location header found in initial response") + + operation_id = _parse_operation_id(operation_location) + return { + "operation_id": operation_id, + } + except Exception as e: + raise ValueError(f"Could not extract operation details: {e}") from e + + @classmethod + async def from_continuation_token( + cls, polling_method: Any, continuation_token: str, **kwargs: Any + ) -> "AnalyzeAsyncLROPoller": + """Create a new poller from a continuation token. + + :param polling_method: The polling method to use + :type polling_method: Any + :param continuation_token: The continuation token + :type continuation_token: str + :return: A new AnalyzeAsyncLROPoller instance + :rtype: AnalyzeAsyncLROPoller + """ + client, initial_response, deserialization_callback = await polling_method.from_continuation_token( + continuation_token, **kwargs + ) + return cls(client, initial_response, deserialization_callback, polling_method) + + +def patch_sdk(): + """Do not remove from this file. + + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize + + :return: None + :rtype: None + """ + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index 87676c65a8f0..0fe7f0099331 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -7,15 +7,87 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ +from typing import Optional, Any, Dict, List, Union, TYPE_CHECKING +from ._models import ( + StringField, + IntegerField, + NumberField, + BooleanField, + DateField, + TimeField, + ArrayField, + ObjectField, + JsonField, + ContentField, +) +# Type stub to help mypy and pyright understand that ContentField has a .value property +if TYPE_CHECKING: -__all__: list[str] = [] # Add all objects you want publicly available to users at this package level + class ContentFieldTypeStub: + """Type stub for ContentField to help type checkers understand the .value property.""" + + @property + def value( + self, + ) -> Union[ + Optional[str], + Optional[float], + Optional[int], + Optional[bool], + Optional[Any], + Optional[List[Any]], + Optional[dict[str, Any]], + ]: + """Get the value of this field regardless of its type.""" + ... # pylint: disable=unnecessary-ellipsis + + +__all__ = [ + "RecordMergePatchUpdate", + "StringField", + "IntegerField", + "NumberField", + "BooleanField", + "DateField", + "TimeField", + "ArrayField", + "ObjectField", + "JsonField", +] + +# RecordMergePatchUpdate is a TypeSpec artifact that wasn't generated +# It's just an alias for dict[str, str] for model deployments +RecordMergePatchUpdate = Dict[str, str] + + +def _add_value_property_to_field(field_class: type, value_attr: str) -> None: + """Add a .value property to a field class that returns the appropriate attribute.""" + + @property # type: ignore[misc] + def value(self) -> Any: # type: ignore[misc] + """Get the value of this field.""" + return getattr(self, value_attr) + + setattr(field_class, "value", value) def patch_sdk(): - """Do not remove from this file. + """Patch the SDK to add missing models and convenience properties.""" + from . import _models + + # Add RecordMergePatchUpdate as an alias + # (AnalyzeInput is now generated in _models.py, so we don\'t need to add it) + _models.RecordMergePatchUpdate = RecordMergePatchUpdate # type: ignore[attr-defined] - `patch_sdk` is a last resort escape hatch that allows you to do customizations - you can't accomplish using the techniques described in - https://aka.ms/azsdk/python/dpcodegen/python/customize - """ + # Add .value property to all ContentField subclasses for easier access + # Note: The attribute names follow the pattern "value_" + _add_value_property_to_field(StringField, "value_string") + _add_value_property_to_field(IntegerField, "value_integer") + _add_value_property_to_field(NumberField, "value_number") + _add_value_property_to_field(BooleanField, "value_boolean") + _add_value_property_to_field(DateField, "value_date") + _add_value_property_to_field(TimeField, "value_time") + _add_value_property_to_field(ArrayField, "value_array") + _add_value_property_to_field(ObjectField, "value_object") + _add_value_property_to_field(JsonField, "value_json") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py new file mode 100644 index 000000000000..f61d20b73a26 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py @@ -0,0 +1,96 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +"""Customize generated code here. + +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +""" +import re +from typing import Any, Mapping, TypeVar +from azure.core.polling import LROPoller, PollingMethod + +PollingReturnType_co = TypeVar("PollingReturnType_co", covariant=True) + +__all__ = ["AnalyzeLROPoller"] + + +def _parse_operation_id(operation_location_header: str) -> str: + """Parse operation ID from Operation-Location header for analyze operations. + + :param operation_location_header: The Operation-Location header value + :type operation_location_header: str + :return: The extracted operation ID + :rtype: str + :raises ValueError: If operation ID cannot be extracted + """ + # Pattern: https://endpoint/.../analyzerResults/{operation_id}?api-version=... + regex = r".*/analyzerResults/([^?/]+)" + + match = re.search(regex, operation_location_header) + if not match: + raise ValueError(f"Could not extract operation ID from: {operation_location_header}") + + return match.group(1) + + +class AnalyzeLROPoller(LROPoller[PollingReturnType_co]): + """Custom LROPoller for Content Understanding analyze operations. + + Provides access to operation details including the operation ID. + """ + + @property + def details(self) -> Mapping[str, Any]: + """Returns metadata associated with the long-running operation. + + :return: Returns metadata associated with the long-running operation. + :rtype: Mapping[str, Any] + """ + try: + operation_location = self.polling_method()._initial_response.http_response.headers["Operation-Location"] # type: ignore # pylint: disable=protected-access + operation_id = _parse_operation_id(operation_location) + return {"operation_id": operation_id, "operation_type": "analyze"} + except (KeyError, ValueError) as e: + return { + "operation_id": None, + "operation_type": "analyze", + "error": f"Could not extract operation details: {str(e)}", + } + + @classmethod + def from_continuation_token( + cls, polling_method: PollingMethod[PollingReturnType_co], continuation_token: str, **kwargs: Any + ) -> "AnalyzeLROPoller": + """Create a poller from a continuation token. + + :param polling_method: The polling strategy to adopt + :type polling_method: ~azure.core.polling.PollingMethod + :param continuation_token: An opaque continuation token + :type continuation_token: str + :return: An instance of AnalyzeLROPoller + :rtype: AnalyzeLROPoller + :raises ~azure.core.exceptions.HttpResponseError: If the continuation token is invalid. + """ + ( + client, + initial_response, + deserialization_callback, + ) = polling_method.from_continuation_token(continuation_token, **kwargs) + + return cls(client, initial_response, deserialization_callback, polling_method) + + +def patch_sdk(): + """Do not remove from this file. + + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize + + :return: None + :rtype: None + """ + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample new file mode 100644 index 000000000000..8c9678f65173 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample @@ -0,0 +1,89 @@ +# Azure AI Content Understanding Test Configuration +# Copy this file to .env and fill in your actual values + +# ============================================================================ +# Required Configuration +# ============================================================================ + +# The endpoint URL of your Azure AI Foundry resource +# Used by all samples +AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://your-resource.services.ai.azure.com/ + +# ============================================================================ +# Authentication Configuration +# ============================================================================ + +# Option 1: API Key Authentication +# Uncomment and set your API key if using key-based authentication +# Used by all samples (optional - DefaultAzureCredential will be used if not set) +AZURE_CONTENT_UNDERSTANDING_KEY= + +# Option 2: DefaultAzureCredential (Recommended for local development) +# If AZURE_CONTENT_UNDERSTANDING_KEY is not set, the tests will use DefaultAzureCredential +# Set one of the following to enable the corresponding authentication method: + +# Use Azure CLI authentication (az login) +# AZURE_TEST_USE_CLI_AUTH=true + +# Use Azure PowerShell authentication +# AZURE_TEST_USE_PWSH_AUTH=true + +# Use Azure Developer CLI authentication (azd login) +# AZURE_TEST_USE_AZD_AUTH=true + +# ============================================================================ +# Test Execution Configuration +# ============================================================================ + +# Enable live test mode (set to true to run tests against real Azure resources) +# Default: false +AZURE_TEST_RUN_LIVE=false + +# Skip recording when running live tests (set to true to skip recording) +# Default: false +AZURE_SKIP_LIVE_RECORDING=false + +# ============================================================================ +# Sanitization Configuration (for test recordings) +# ============================================================================ +# These values are used for sanitizing sensitive information in test recordings +# Set these if you want to sanitize specific values in recordings + +# CONTENTUNDERSTANDING_SUBSCRIPTION_ID=00000000-0000-0000-0000-000000000000 +# CONTENTUNDERSTANDING_TENANT_ID=00000000-0000-0000-0000-000000000000 +# CONTENTUNDERSTANDING_CLIENT_ID=00000000-0000-0000-0000-000000000000 +# CONTENTUNDERSTANDING_CLIENT_SECRET=your-client-secret + +# ============================================================================ +# Custom Model Training Configuration +# ============================================================================ +# These variables are used by build_custom_model_with_training.py sample + +# SAS URL to Azure Blob Storage container containing training files +# Required for build_custom_model_with_training.py +# Format: https://.blob.core.windows.net/? +CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL= + +# Optional: Path to a file listing specific blobs to include in training +# If empty, all files in the container/prefix will be used +# Example: "filelist.jsonl" +CONTENT_UNDERSTANDING_FILE_LIST_PATH= + +# Optional: Prefix to filter blobs within the container +# If empty, all files in the container will be used +# Example: "sdk_sample_training_files_updated/" +# Note: Training files must use schema version "2025-11-01" in *.labels.json files +CONTENT_UNDERSTANDING_STORAGE_PREFIX= + +# ============================================================================ +# Usage Instructions +# ============================================================================ +# 1. Copy this file to .env: +# cp env.sample .env +# +# 2. Edit .env and fill in your actual values +# +# 3. The .env file is automatically loaded by the tests via conftest.py +# +# 4. Make sure .env is in your .gitignore to avoid committing secrets + From 04f30a1ae950180874de8607ff863c6fd622e2b2 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 18:34:06 +0000 Subject: [PATCH 004/105] SAMPLE: Migrate analyze_url.py: - Updated `dev_requirements.txt` to include `pytest-xdist`, `python-dotenv`, and `azure-identity`. - Added `analyze_url.py` sample for extracting content from a URL using the prebuilt-documentSearch analyzer. - Created `sample_helper.py` for utility functions to save JSON results and manage sample files. - Updated `README.md` in samples directory with setup instructions and sample descriptions. --- .../_operations/_patch.py | 94 +++++- .../aio/_operations/_patch.py | 94 +++++- .../aio/operations/_patch.py | 1 + .../contentunderstanding/operations/_patch.py | 1 + .../dev_requirements.txt | 5 +- .../azure-ai-contentunderstanding/env.sample | 1 + .../samples/README.md | 312 ++++++++++++++++++ .../samples/analyze_url.py | 128 +++++++ .../samples/sample_helper.py | 71 ++++ 9 files changed, 692 insertions(+), 15 deletions(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index 97b53259c609..e3266aec1782 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -19,7 +19,8 @@ def patch_sdk(): """Patch the generated code to add custom functionality. - Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property. + 1. Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property + 2. Hide string_encoding parameter and always use "codePoint" (correct for Python) Note: content_type default fix is now directly in generated code (search for EMITTER-FIX) """ @@ -30,14 +31,55 @@ def patch_sdk(): original_begin_analyze = _ContentUnderstandingClientOperationsMixin.begin_analyze original_begin_analyze_binary = _ContentUnderstandingClientOperationsMixin.begin_analyze_binary - # Wrap begin_analyze to return custom LROPoller with .details property + # Wrap begin_analyze to return custom LROPoller and set string_encoding def begin_analyze_wrapped( self, analyzer_id: str, + *, + processing_location: Any = None, + content_type: str = "application/json", + inputs: Any = None, + model_deployments: Any = None, **kwargs: Any ) -> "LROPoller[AnalyzeResult]": - """Wrapper that returns custom poller with .details property.""" - poller = original_begin_analyze(self, analyzer_id, **kwargs) + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. + Default value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes a .details property with operation metadata. + :rtype: ~azure.ai.contentunderstanding.operations.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + # Always use codePoint encoding for Python (matches Python's string indexing) + kwargs["string_encoding"] = "codePoint" + poller = original_begin_analyze( + self, + analyzer_id, + processing_location=processing_location, + content_type=content_type, + inputs=inputs, + model_deployments=model_deployments, + **kwargs + ) return AnalyzeLROPoller( self._client, # type: ignore poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access @@ -45,15 +87,53 @@ def begin_analyze_wrapped( poller._polling_method, # pylint: disable=protected-access ) - # Wrap begin_analyze_binary to return custom poller + # Wrap begin_analyze_binary to return custom poller and set string_encoding def begin_analyze_binary_wrapped( self, analyzer_id: str, binary_input: bytes, + *, + processing_location: Any = None, + input_range: Any = None, + content_type: str = "application/octet-stream", **kwargs: Any ) -> "LROPoller[AnalyzeResult]": - """Wrapper that returns custom poller with .details property.""" - poller = original_begin_analyze_binary(self, analyzer_id, binary_input, **kwargs) + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param binary_input: The binary content of the document to analyze. Required. + :type binary_input: bytes + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str + :keyword input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses + 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. + :paramtype input_range: str + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/octet-stream". + :paramtype content_type: str + :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes a .details property with operation metadata. + :rtype: ~azure.ai.contentunderstanding.operations.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + # Always use codePoint encoding for Python (matches Python's string indexing) + kwargs["string_encoding"] = "codePoint" + poller = original_begin_analyze_binary( + self, + analyzer_id, + binary_input, + processing_location=processing_location, + input_range=input_range, + content_type=content_type, + **kwargs + ) return AnalyzeLROPoller( self._client, # type: ignore poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index 60c1c2309349..b4e344f419a3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -19,7 +19,8 @@ def patch_sdk(): """Patch the generated code to add custom functionality. - Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property. + 1. Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property + 2. Hide string_encoding parameter and always use "codePoint" (correct for Python) Note: content_type default fix is now directly in generated code (search for EMITTER-FIX) """ @@ -30,14 +31,55 @@ def patch_sdk(): original_begin_analyze = _ContentUnderstandingClientOperationsMixin.begin_analyze original_begin_analyze_binary = _ContentUnderstandingClientOperationsMixin.begin_analyze_binary - # Wrap begin_analyze to return custom poller + # Wrap begin_analyze to return custom poller and set string_encoding async def begin_analyze_wrapped( self, analyzer_id: str, + *, + processing_location: Any = None, + content_type: str = "application/json", + inputs: Any = None, + model_deployments: Any = None, **kwargs: Any ) -> "AsyncLROPoller[AnalyzeResult]": - """Wrapper that returns custom async poller with .details property.""" - poller = await original_begin_analyze(self, analyzer_id, **kwargs) + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. + Default value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes a .details property with operation metadata. + :rtype: ~azure.ai.contentunderstanding.aio.operations.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + # Always use codePoint encoding for Python (matches Python's string indexing) + kwargs["string_encoding"] = "codePoint" + poller = await original_begin_analyze( + self, + analyzer_id, + processing_location=processing_location, + content_type=content_type, + inputs=inputs, + model_deployments=model_deployments, + **kwargs + ) return AnalyzeAsyncLROPoller( self._client, # type: ignore poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access @@ -45,15 +87,53 @@ async def begin_analyze_wrapped( poller._polling_method, # pylint: disable=protected-access ) - # Wrap begin_analyze_binary to return custom poller + # Wrap begin_analyze_binary to return custom poller and set string_encoding async def begin_analyze_binary_wrapped( self, analyzer_id: str, binary_input: bytes, + *, + processing_location: Any = None, + input_range: Any = None, + content_type: str = "application/octet-stream", **kwargs: Any ) -> "AsyncLROPoller[AnalyzeResult]": - """Wrapper that returns custom async poller with .details property.""" - poller = await original_begin_analyze_binary(self, analyzer_id, binary_input, **kwargs) + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param binary_input: The binary content of the document to analyze. Required. + :type binary_input: bytes + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str + :keyword input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses + 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. + :paramtype input_range: str + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/octet-stream". + :paramtype content_type: str + :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes a .details property with operation metadata. + :rtype: ~azure.ai.contentunderstanding.aio.operations.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + # Always use codePoint encoding for Python (matches Python's string indexing) + kwargs["string_encoding"] = "codePoint" + poller = await original_begin_analyze_binary( + self, + analyzer_id, + binary_input, + processing_location=processing_location, + input_range=input_range, + content_type=content_type, + **kwargs + ) return AnalyzeAsyncLROPoller( self._client, # type: ignore poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py index b59bc2e4d297..804937756e22 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py @@ -89,3 +89,4 @@ def patch_sdk(): :rtype: None """ + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py index f61d20b73a26..c55c22808ae6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py @@ -94,3 +94,4 @@ def patch_sdk(): :rtype: None """ + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/dev_requirements.txt b/sdk/contentunderstanding/azure-ai-contentunderstanding/dev_requirements.txt index 0e53b6a72db5..7a8114c9916a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/dev_requirements.txt +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/dev_requirements.txt @@ -1,3 +1,6 @@ -e ../../../eng/tools/azure-sdk-tools ../../core/azure-core -aiohttp \ No newline at end of file +aiohttp +pytest-xdist +python-dotenv +azure-identity \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample index 8c9678f65173..6f2c8d12c2de 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample @@ -87,3 +87,4 @@ CONTENT_UNDERSTANDING_STORAGE_PREFIX= # # 4. Make sure .env is in your .gitignore to avoid committing secrets + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md new file mode 100644 index 000000000000..8078981e348b --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -0,0 +1,312 @@ +--- +page_type: sample +languages: + - python +products: + - azure +urlFragment: azure-ai-contentunderstanding-samples +--- + +# Azure AI Content Understanding client library for Python Samples + +These code samples demonstrate common scenarios with the Azure AI Content Understanding client library. + +**Note:** All samples use async operations for better performance and modern Python best practices. + +## Prerequisites + +* Python 3.9 or later is required to use this package +* You need an [Azure subscription][azure_sub] and an [Azure AI Foundry resource][contentunderstanding_quickstart] to use this package. +* The Azure AI Foundry resource must be created in a [supported region][contentunderstanding_regions]. + +## Setup + +### Quick Start (Recommended) + +```bash +# 1. Navigate to package directory +cd sdk/contentunderstanding/azure-ai-contentunderstanding + +# 2. Activate virtual environment +source .venv/bin/activate # On Linux/macOS +# .venv\Scripts\activate # On Windows + +# 3. Install SDK and all dependencies +pip install -e . +pip install -r dev_requirements.txt # Includes aiohttp, pytest, python-dotenv, azure-identity + +# 4. Set up environment variables +cd samples +cp ../env.sample .env +# Edit .env with your credentials + +# 5. Run a sample +python analyze_url.py +``` + +### Detailed Setup Instructions + +#### 1. Activate the Virtual Environment + +**This project uses a virtual environment. All samples MUST be run from the activated virtual environment.** + +```bash +# From the package directory +cd sdk/contentunderstanding/azure-ai-contentunderstanding + +# Activate virtual environment +source .venv/bin/activate # On Linux/macOS +# or +.venv\Scripts\activate # On Windows + +# Verify activation +which python # Should show: .../azure-ai-contentunderstanding/.venv/bin/python +``` + +#### 2. Install Dependencies + +```bash +# Install the SDK in editable mode +pip install -e . + +# Install development dependencies (includes aiohttp, pytest, python-dotenv, azure-identity) +pip install -r dev_requirements.txt +``` + +**Note:** All dependencies for running samples and tests are in `dev_requirements.txt`. This includes: +- `aiohttp` - Required for async operations +- `python-dotenv` - For loading `.env` files +- `azure-identity` - For `DefaultAzureCredential` authentication +- `pytest-xdist` - For parallel test execution + +#### 3. Configure Environment Variables + +```bash +# Navigate to samples directory +cd samples + +# Copy the env.sample file +cp ../env.sample .env + +# Edit .env file with your credentials +# Use your favorite editor (vim, nano, code, cursor, etc.) +``` + +Set the following in `.env`: +* `AZURE_CONTENT_UNDERSTANDING_ENDPOINT` (required) - Your Azure AI Foundry resource endpoint +* `AZURE_CONTENT_UNDERSTANDING_KEY` (optional) - Your API key. If not set, `DefaultAzureCredential` will be used. + +**Example `.env` file:** +```bash +AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://your-resource.services.ai.azure.com/ +AZURE_CONTENT_UNDERSTANDING_KEY=your-api-key-here # Optional +``` + +#### 4. Authenticate (if using DefaultAzureCredential) + +If you're not using an API key, authenticate with Azure CLI: +```bash +az login +``` + +## Running the Samples + +**Important:** Always run samples from the activated virtual environment! + +```bash +# Make sure virtual environment is activated +source .venv/bin/activate + +# Run a sample +python samples/analyze_url.py +``` + +## Sample Files + +### Getting Started Samples + +#### `analyze_url.py` ⭐ +**Start here!** Analyzes a document from a remote URL using `prebuilt-documentSearch`. Shows basic document analysis, content extraction, and object model navigation. + +**Key concepts:** +- Using `begin_analyze` with URL input +- Extracting markdown content +- Accessing document pages and tables +- Working with the analysis result object model + +#### `analyze_binary.py` +Analyzes a PDF document from local binary data using `prebuilt-documentSearch`. Demonstrates how to read local files and analyze them. + +**Key concepts:** +- Using `begin_analyze_binary` with binary input +- Reading local PDF files +- Same content extraction as `analyze_url.py` + +#### `analyze_url_prebuilt_invoice.py` +Extracts structured fields from invoices using `prebuilt-invoice` analyzer. Shows how to work with structured field extraction. + +**Key concepts:** +- Using specialized prebuilt analyzers +- Extracting structured fields (customer name, totals, dates, line items) +- Working with field types (StringField, NumberField, ArrayField) +- Using the convenience `.value` property + +### Advanced Analysis Samples + +#### `analyze_binary_raw_json.py` +Shows how to access the raw JSON response before deserialization for debugging or custom processing. + +#### `analyze_binary_features.py` +Demonstrates advanced features like figure analysis, chart extraction, and custom output options. + +#### `compare_prebuilt_analyzers.py` +Compares results from different prebuilt analyzers (`prebuilt-document` vs `prebuilt-documentSearch`) to show differences. + +#### `analyze_category_enable_segments.py` +Creates a custom analyzer with content categories for document classification and automatic page segmentation. + +**Use case:** Multi-page documents with mixed content types (e.g., PDF with invoices and bank statements) + +### Custom Analyzer Management + +#### `create_or_replace.py` +Creates or replaces a custom analyzer with field schemas and analysis configuration. + +#### `get_analyzer.py` +Retrieves analyzer configuration and details. + +#### `list_analyzers.py` +Lists all available analyzers (prebuilt and custom). + +#### `update_analyzer.py` +Updates an existing analyzer configuration. + +#### `delete_analyzer.py` +Deletes a custom analyzer. + +### Advanced Features + +#### `build_custom_model_with_training.py` +Builds a custom analyzer using training data from Azure Blob Storage. Requires additional configuration (see `env.sample`). + +#### `copy_analyzer.py` +Copies an analyzer from one location/region to another. + +#### `get_result_file.py` +Downloads result files from analysis operations (e.g., extracted video keyframes). + +### Utility + +#### `sample_helper.py` +Helper functions for saving results and working with sample files. + +#### `run_all_samples.py` +Runs all samples sequentially for testing. Stops on first error. + +## Common Patterns + +### Authentication + +All samples support two authentication methods: + +**Option 1: API Key (simpler)** +```python +from azure.core.credentials import AzureKeyCredential +credential = AzureKeyCredential(api_key) +``` + +**Option 2: DefaultAzureCredential (recommended)** +```python +from azure.identity.aio import DefaultAzureCredential +credential = DefaultAzureCredential() +# Requires: az login +``` + +### Async Context Managers + +All samples use async context managers for proper resource cleanup: + +```python +async with ContentUnderstandingClient(endpoint, credential) as client: + # Client automatically closed when exiting context + poller = await client.begin_analyze(...) + result = await poller.result() + +# Clean up credential if using DefaultAzureCredential +if isinstance(credential, DefaultAzureCredential): + await credential.close() +``` + +### Working with Results + +**Access markdown content:** +```python +result: AnalyzeResult = await poller.result() +content: MediaContent = result.contents[0] +print(content.markdown) +``` + +**Access structured fields:** +```python +# For prebuilt-invoice +content: MediaContent = result.contents[0] +customer_name = content.fields["CustomerName"].value # Using .value property +invoice_total = content.fields["InvoiceTotal"].value +``` + +**Access document properties:** +```python +if content.kind == MediaContentKind.DOCUMENT: + doc_content: DocumentContent = content # type: ignore + print(f"Pages: {doc_content.start_page_number} - {doc_content.end_page_number}") + for table in doc_content.tables: + print(f"Table: {table.row_count} x {table.column_count}") +``` + +## Troubleshooting + +### "ModuleNotFoundError: No module named 'azure.ai.contentunderstanding'" + +**Solution:** Make sure the virtual environment is activated and the SDK is installed: +```bash +source .venv/bin/activate +pip install -e . +``` + +### "ImportError: aiohttp package is not installed" + +**Solution:** Install the development dependencies: +```bash +source .venv/bin/activate +pip install -r dev_requirements.txt +``` + +### "KeyError: 'AZURE_CONTENT_UNDERSTANDING_ENDPOINT'" + +**Solution:** Create a `.env` file with your credentials (see Setup step 3). + +### "Could not load credentials from the environment" + +**Solution:** Either set `AZURE_CONTENT_UNDERSTANDING_KEY` in `.env` or run `az login`. + +### Import errors or type checking issues + +**Solution:** Reinstall the SDK in the virtual environment: +```bash +source .venv/bin/activate +pip install -e . --force-reinstall +``` + +## Next Steps + +* Review the [Azure AI Content Understanding documentation][contentunderstanding_docs] +* Check the [API reference][apiref] for detailed API information +* See the main [README](../README.md) for more getting started information + + +[azure_sub]: https://azure.microsoft.com/free/ +[contentunderstanding_docs]: https://learn.microsoft.com/azure/ai-services/content-understanding/ +[contentunderstanding_quickstart]: https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api +[contentunderstanding_regions]: https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support +[apiref]: https://learn.microsoft.com/python/api/azure-ai-contentunderstanding/ + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py new file mode 100644 index 000000000000..c15bf1fd2b8f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py @@ -0,0 +1,128 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: use the prebuilt-documentSearch to extract content from a URL. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python analyze_url.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + MediaContent, + DocumentContent, + MediaContentKind, +) +from sample_helper import save_json_to_file +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Extract content from URL using begin_analyze API +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Analyze a document from a remote URL using begin_analyze with prebuilt-documentSearch +# 3. Print the markdown content from the analysis result +# +# prebuilt-documentSearch is an AI-enhanced analyzer that extends prebuilt-document with: +# - Document summarization: Returns a "Summary" field with AI-generated document summaries +# - Figure analysis: Extracts descriptions and analyzes figures in documents (enableFigureDescription, enableFigureAnalysis) +# - Enhanced output: Provides more detailed analysis results (returnDetails: true) +# - AI completion model: Uses gpt-4.1-mini for intelligent content extraction + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + print(f"Analyzing remote document from {file_url} with prebuilt-documentSearch...") + poller = await client.begin_analyze( + analyzer_id="prebuilt-documentSearch", inputs=[AnalyzeInput(url=file_url)] + ) + result: AnalyzeResult = await poller.result() + + # AnalyzeResult contains the full analysis result and can be used to access various properties + # We are using markdown content as an example of what can be extracted + print("\nMarkdown Content:") + print("=" * 50) + # A PDF file has only one content element even if it contains multiple pages + content: MediaContent = result.contents[0] + print(content.markdown) + print("=" * 50) + + # Check if this is document content to access document-specific properties + assert content.kind == MediaContentKind.DOCUMENT, "\nDocument Information: Not available for this content type" + # Type assertion: we know this is DocumentContent for PDF files + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f"Start page: {document_content.start_page_number}") + print(f"End page: {document_content.end_page_number}") + print(f"Total pages: {document_content.end_page_number - document_content.start_page_number + 1}") + + # Check for pages + if document_content.pages is not None: + print(f"\nPages ({len(document_content.pages)}):") + for i, page in enumerate(document_content.pages): + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + + # The following code shows how to access DocumentContent properties + # Check if there are tables in the document + if document_content.tables is not None: + print(f"\nTables ({len(document_content.tables)}):") + table_counter = 1 + # Iterate through tables, each table is of type DocumentTable + for table in document_content.tables: + # Type: table is DocumentTable + # Get basic table dimensions + row_count: int = table.row_count + col_count: int = table.column_count + print(f" Table {table_counter}: {row_count} rows x {col_count} columns") + table_counter += 1 + # You can use the table object model to get detailed information + # such as cell content, borders, spans, etc. (not shown to keep code concise) + + # Uncomment the following line to save the response to a file for object model inspection + # Note: This saves the object model, not the raw JSON response + # To get the full raw JSON response, see the sample: analyze_binary_raw_json.py + # save_json_to_file(result.as_dict(), filename_prefix="analyze_url") + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) + + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py new file mode 100644 index 000000000000..63ab26d92cdc --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py @@ -0,0 +1,71 @@ +# 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. +# -------------------------------------------------------------------------- +"""Helper utilities for Content Understanding samples.""" + +from __future__ import annotations +import json +import os +from datetime import datetime +from pathlib import Path +from typing import Any + + +def save_json_to_file(data: dict[str, Any], filename_prefix: str = "result") -> str: + """Save JSON data to a file with timestamp. + + :param data: Dictionary to save as JSON + :type data: dict[str, Any] + :param filename_prefix: Prefix for the output filename + :type filename_prefix: str + :return: Path to the saved file + :rtype: str + """ + # Create output directory if it doesn't exist + output_dir = Path(__file__).parent / "output" + output_dir.mkdir(exist_ok=True) + + # Generate filename with timestamp + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + filename = f"{filename_prefix}_{timestamp}.json" + filepath = output_dir / filename + + # Save to file + with open(filepath, "w", encoding="utf-8") as f: + json.dump(data, f, indent=2, ensure_ascii=False) + + print(f"\n✓ Saved to: {filepath}") + return str(filepath) + + +def get_sample_file_path(filename: str) -> str: + """Get the absolute path to a sample file. + + :param filename: Name of the sample file + :type filename: str + :return: Absolute path to the file + :rtype: str + """ + samples_dir = Path(__file__).parent + filepath = samples_dir / "sample_files" / filename + + if not filepath.exists(): + raise FileNotFoundError(f"Sample file not found: {filepath}") + + return str(filepath) + + +def read_binary_file(filepath: str) -> bytes: + """Read a binary file and return its contents. + + :param filepath: Path to the file + :type filepath: str + :return: File contents as bytes + :rtype: bytes + """ + with open(filepath, "rb") as f: + return f.read() + + From 2c5f1bbfbb7ee1e75a2103bff856a3ccdc47ea42 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 20:05:05 +0000 Subject: [PATCH 005/105] SDK-GEN: Re-generate with updated TypeSpec --- .../_operations/_operations.py | 98 ++++++++----------- .../_operations/_patch.py | 21 ++-- .../aio/_operations/_operations.py | 91 ++++++++--------- .../aio/_operations/_patch.py | 21 ++-- .../aio/operations/_patch.py | 2 - .../contentunderstanding/operations/_patch.py | 2 - .../test_content_understanding.py | 36 +++---- .../test_content_understanding_async.py | 36 +++---- .../tsp-location.yaml | 2 +- 9 files changed, 129 insertions(+), 180 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py index 1487b3717c90..ec652108e5b0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py @@ -6,9 +6,6 @@ # Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- -# -# MANUAL CUSTOMIZATIONS APPLIED - Search for "EMITTER-FIX" to find all changes -# from collections.abc import MutableMapping from io import IOBase import json @@ -45,7 +42,6 @@ _Unset: Any = object() T = TypeVar("T") ClsType = Optional[Callable[[PipelineResponse[HttpRequest, HttpResponse], T, dict[str, Any]], Any]] -List = list _SERIALIZER = Serializer() _SERIALIZER.client_side_validation = False @@ -99,8 +95,7 @@ def build_content_understanding_analyze_binary_request( # pylint: disable=name- _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - # EMITTER-FIX: Add fallback default for content_type (TypeSpec specifies "application/octet-stream") - content_type: str = kwargs.pop("content_type", "application/octet-stream") + content_type: str = kwargs.pop("content_type") api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-11-01")) accept = _headers.pop("Accept", "application/json") @@ -128,7 +123,7 @@ def build_content_understanding_analyze_binary_request( # pylint: disable=name- return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) -def build_content_understanding_copy_request( +def build_content_understanding_copy_analyzer_request( # pylint: disable=name-too-long analyzer_id: str, *, allow_replace: Optional[bool] = None, **kwargs: Any ) -> HttpRequest: _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) @@ -139,7 +134,7 @@ def build_content_understanding_copy_request( accept = _headers.pop("Accept", "application/json") # Construct URL - _url = "/analyzers/{analyzerId}:copy" + _url = "/analyzers/{analyzerId}:copyAnalyzer" path_format_arguments = { "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), } @@ -159,7 +154,7 @@ def build_content_understanding_copy_request( return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) -def build_content_understanding_create_or_replace_request( # pylint: disable=name-too-long +def build_content_understanding_create_analyzer_request( # pylint: disable=name-too-long analyzer_id: str, *, allow_replace: Optional[bool] = None, **kwargs: Any ) -> HttpRequest: _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) @@ -190,7 +185,7 @@ def build_content_understanding_create_or_replace_request( # pylint: disable=na return HttpRequest(method="PUT", url=_url, params=_params, headers=_headers, **kwargs) -def build_content_understanding_delete_request( # pylint: disable=name-too-long +def build_content_understanding_delet_analyzer_request( # pylint: disable=name-too-long analyzer_id: str, **kwargs: Any ) -> HttpRequest: _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) @@ -233,7 +228,9 @@ def build_content_understanding_delete_result_request( # pylint: disable=name-t return HttpRequest(method="DELETE", url=_url, params=_params, **kwargs) -def build_content_understanding_get_request(analyzer_id: str, **kwargs: Any) -> HttpRequest: +def build_content_understanding_get_analyzer_request( # pylint: disable=name-too-long + analyzer_id: str, **kwargs: Any +) -> HttpRequest: _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) @@ -385,7 +382,7 @@ def build_content_understanding_grant_copy_authorization_request( # pylint: dis return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) -def build_content_understanding_list_request(**kwargs: Any) -> HttpRequest: +def build_content_understanding_list_analyzers_request(**kwargs: Any) -> HttpRequest: # pylint: disable=name-too-long _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) @@ -404,7 +401,7 @@ def build_content_understanding_list_request(**kwargs: Any) -> HttpRequest: return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) -def build_content_understanding_update_request( # pylint: disable=name-too-long +def build_content_understanding_update_analyzer_request( # pylint: disable=name-too-long analyzer_id: str, **kwargs: Any ) -> HttpRequest: _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) @@ -466,7 +463,7 @@ def _analyze_initial( *, string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, - inputs: Optional[List[_models.AnalyzeInput]] = None, + inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any ) -> Iterator[bytes]: @@ -545,7 +542,7 @@ def begin_analyze( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, content_type: str = "application/json", - inputs: Optional[List[_models.AnalyzeInput]] = None, + inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any ) -> LROPoller[_models.AnalyzeResult]: @@ -650,7 +647,7 @@ def begin_analyze( *, string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, - inputs: Optional[List[_models.AnalyzeInput]] = None, + inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any ) -> LROPoller[_models.AnalyzeResult]: @@ -766,8 +763,6 @@ def _analyze_binary_initial( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, input_range: Optional[str] = None, - # EMITTER-FIX: content_type default value missing (TypeSpec specifies "application/octet-stream") - content_type: str = "application/octet-stream", **kwargs: Any ) -> Iterator[bytes]: error_map: MutableMapping = { @@ -781,8 +776,7 @@ def _analyze_binary_initial( _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - # EMITTER-FIX: Use parameter instead of kwargs.pop - # content_type: str = kwargs.pop("content_type") # Original (broken) + content_type: str = kwargs.pop("content_type") cls: ClsType[Iterator[bytes]] = kwargs.pop("cls", None) _content = binary_input @@ -856,8 +850,6 @@ def begin_analyze_binary( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, input_range: Optional[str] = None, - # EMITTER-FIX: content_type default value missing (TypeSpec specifies "application/octet-stream") - content_type: str = "application/octet-stream", **kwargs: Any ) -> LROPoller[_models.AnalyzeResult]: """Extract content and fields from input. @@ -877,9 +869,6 @@ def begin_analyze_binary( 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. :paramtype input_range: str - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/octet-stream". - :paramtype content_type: str :return: An instance of LROPoller that returns AnalyzeResult. The AnalyzeResult is compatible with MutableMapping :rtype: ~azure.core.polling.LROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] @@ -888,8 +877,7 @@ def begin_analyze_binary( _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - # EMITTER-FIX: Use parameter instead of kwargs.pop - # content_type: str = kwargs.pop("content_type") # Original (broken) + content_type: str = kwargs.pop("content_type") cls: ClsType[_models.AnalyzeResult] = kwargs.pop("cls", None) polling: Union[bool, PollingMethod] = kwargs.pop("polling", True) lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) @@ -955,7 +943,7 @@ def get_long_running_output(pipeline_response): }, api_versions_list=["2025-11-01"], ) - def _copy_initial( + def _copy_analyzer_initial( self, analyzer_id: str, body: Union[JSON, IO[bytes]] = _Unset, @@ -996,7 +984,7 @@ def _copy_initial( else: _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore - _request = build_content_understanding_copy_request( + _request = build_content_understanding_copy_analyzer_request( analyzer_id=analyzer_id, allow_replace=allow_replace, content_type=content_type, @@ -1039,7 +1027,7 @@ def _copy_initial( return deserialized # type: ignore @overload - def begin_copy( + def begin_copy_analyzer( self, analyzer_id: str, *, @@ -1075,7 +1063,7 @@ def begin_copy( """ @overload - def begin_copy( + def begin_copy_analyzer( self, analyzer_id: str, body: JSON, @@ -1103,7 +1091,7 @@ def begin_copy( """ @overload - def begin_copy( + def begin_copy_analyzer( self, analyzer_id: str, body: IO[bytes], @@ -1138,7 +1126,7 @@ def begin_copy( }, api_versions_list=["2025-11-01"], ) - def begin_copy( + def begin_copy_analyzer( self, analyzer_id: str, body: Union[JSON, IO[bytes]] = _Unset, @@ -1180,7 +1168,7 @@ def begin_copy( lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) cont_token: Optional[str] = kwargs.pop("continuation_token", None) if cont_token is None: - raw_result = self._copy_initial( + raw_result = self._copy_analyzer_initial( analyzer_id=analyzer_id, body=body, source_analyzer_id=source_analyzer_id, @@ -1238,7 +1226,7 @@ def get_long_running_output(pipeline_response): params_added_on={"2025-11-01": ["allow_replace"]}, api_versions_list=["2025-05-01-preview", "2025-11-01"], ) - def _create_or_replace_initial( + def _create_analyzer_initial( self, analyzer_id: str, resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], @@ -1267,7 +1255,7 @@ def _create_or_replace_initial( else: _content = json.dumps(resource, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore - _request = build_content_understanding_create_or_replace_request( + _request = build_content_understanding_create_analyzer_request( analyzer_id=analyzer_id, allow_replace=allow_replace, content_type=content_type, @@ -1310,7 +1298,7 @@ def _create_or_replace_initial( return deserialized # type: ignore @overload - def begin_create_or_replace( + def begin_create_analyzer( self, analyzer_id: str, resource: _models.ContentAnalyzer, @@ -1338,7 +1326,7 @@ def begin_create_or_replace( """ @overload - def begin_create_or_replace( + def begin_create_analyzer( self, analyzer_id: str, resource: JSON, @@ -1366,7 +1354,7 @@ def begin_create_or_replace( """ @overload - def begin_create_or_replace( + def begin_create_analyzer( self, analyzer_id: str, resource: IO[bytes], @@ -1398,7 +1386,7 @@ def begin_create_or_replace( params_added_on={"2025-11-01": ["allow_replace"]}, api_versions_list=["2025-05-01-preview", "2025-11-01"], ) - def begin_create_or_replace( + def begin_create_analyzer( self, analyzer_id: str, resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], @@ -1430,7 +1418,7 @@ def begin_create_or_replace( lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) cont_token: Optional[str] = kwargs.pop("continuation_token", None) if cont_token is None: - raw_result = self._create_or_replace_initial( + raw_result = self._create_analyzer_initial( analyzer_id=analyzer_id, resource=resource, allow_replace=allow_replace, @@ -1482,7 +1470,7 @@ def get_long_running_output(pipeline_response): ) @distributed_trace - def delete(self, analyzer_id: str, **kwargs: Any) -> None: # pylint: disable=inconsistent-return-statements + def delet_analyzer(self, analyzer_id: str, **kwargs: Any) -> None: # pylint: disable=inconsistent-return-statements """Delete analyzer. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -1504,7 +1492,7 @@ def delete(self, analyzer_id: str, **kwargs: Any) -> None: # pylint: disable=in cls: ClsType[None] = kwargs.pop("cls", None) - _request = build_content_understanding_delete_request( + _request = build_content_understanding_delet_analyzer_request( analyzer_id=analyzer_id, api_version=self._config.api_version, headers=_headers, @@ -1588,7 +1576,7 @@ def delete_result(self, operation_id: str, **kwargs: Any) -> None: # pylint: di return cls(pipeline_response, None, {}) # type: ignore @distributed_trace - def get(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyzer: + def get_analyzer(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyzer: """Get analyzer properties. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -1610,7 +1598,7 @@ def get(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyzer: cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) - _request = build_content_understanding_get_request( + _request = build_content_understanding_get_analyzer_request( analyzer_id=analyzer_id, api_version=self._config.api_version, headers=_headers, @@ -1716,7 +1704,7 @@ def get_defaults(self, **kwargs: Any) -> _models.ContentUnderstandingDefaults: return deserialized # type: ignore @distributed_trace - def get_operation_status( + def _get_operation_status( self, analyzer_id: str, operation_id: str, **kwargs: Any ) -> _models.ContentAnalyzerOperationStatus: """Get the status of an analyzer creation operation. @@ -2069,7 +2057,7 @@ def grant_copy_authorization( return deserialized # type: ignore @distributed_trace - def list(self, **kwargs: Any) -> ItemPaged["_models.ContentAnalyzer"]: + def list_analyzers(self, **kwargs: Any) -> ItemPaged["_models.ContentAnalyzer"]: """List analyzers. :return: An iterator like instance of ContentAnalyzer @@ -2079,7 +2067,7 @@ def list(self, **kwargs: Any) -> ItemPaged["_models.ContentAnalyzer"]: _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - cls: ClsType[List[_models.ContentAnalyzer]] = kwargs.pop("cls", None) + cls: ClsType[list[_models.ContentAnalyzer]] = kwargs.pop("cls", None) error_map: MutableMapping = { 401: ClientAuthenticationError, @@ -2092,7 +2080,7 @@ def list(self, **kwargs: Any) -> ItemPaged["_models.ContentAnalyzer"]: def prepare_request(next_link=None): if not next_link: - _request = build_content_understanding_list_request( + _request = build_content_understanding_list_analyzers_request( api_version=self._config.api_version, headers=_headers, params=_params, @@ -2128,7 +2116,7 @@ def prepare_request(next_link=None): def extract_data(pipeline_response): deserialized = pipeline_response.http_response.json() - list_of_elem = _deserialize(List[_models.ContentAnalyzer], deserialized.get("value", [])) + list_of_elem = _deserialize(list[_models.ContentAnalyzer], deserialized.get("value", [])) if cls: list_of_elem = cls(list_of_elem) # type: ignore return deserialized.get("nextLink") or None, iter(list_of_elem) @@ -2151,7 +2139,7 @@ def get_next(next_link=None): return ItemPaged(get_next, extract_data) @overload - def update( + def update_analyzer( self, analyzer_id: str, resource: _models.ContentAnalyzer, @@ -2174,7 +2162,7 @@ def update( """ @overload - def update( + def update_analyzer( self, analyzer_id: str, resource: JSON, *, content_type: str = "application/merge-patch+json", **kwargs: Any ) -> _models.ContentAnalyzer: """Update analyzer properties. @@ -2192,7 +2180,7 @@ def update( """ @overload - def update( + def update_analyzer( self, analyzer_id: str, resource: IO[bytes], @@ -2215,7 +2203,7 @@ def update( """ @distributed_trace - def update( + def update_analyzer( self, analyzer_id: str, resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], **kwargs: Any ) -> _models.ContentAnalyzer: """Update analyzer properties. @@ -2250,7 +2238,7 @@ def update( else: _content = json.dumps(resource, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore - _request = build_content_understanding_update_request( + _request = build_content_understanding_update_analyzer_request( analyzer_id=analyzer_id, content_type=content_type, api_version=self._config.api_version, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index e3266aec1782..7f32479eab0c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. @@ -18,19 +19,19 @@ def patch_sdk(): """Patch the generated code to add custom functionality. - + 1. Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property 2. Hide string_encoding parameter and always use "codePoint" (correct for Python) - + Note: content_type default fix is now directly in generated code (search for EMITTER-FIX) """ from ._operations import _ContentUnderstandingClientOperationsMixin from ..operations._patch import AnalyzeLROPoller - + # Store original methods original_begin_analyze = _ContentUnderstandingClientOperationsMixin.begin_analyze original_begin_analyze_binary = _ContentUnderstandingClientOperationsMixin.begin_analyze_binary - + # Wrap begin_analyze to return custom LROPoller and set string_encoding def begin_analyze_wrapped( self, @@ -43,7 +44,7 @@ def begin_analyze_wrapped( **kwargs: Any ) -> "LROPoller[AnalyzeResult]": """Extract content and fields from input. - + :param analyzer_id: The unique identifier of the analyzer. Required. :type analyzer_id: str :keyword processing_location: The location where the data may be processed. Defaults to @@ -63,7 +64,7 @@ def begin_analyze_wrapped( compatible with MutableMapping. The poller includes a .details property with operation metadata. :rtype: ~azure.ai.contentunderstanding.operations.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] :raises ~azure.core.exceptions.HttpResponseError: - + .. note:: The string_encoding parameter is automatically set to "codePoint" for Python as it matches Python's native string indexing behavior (len() and str[i] use code points). @@ -86,7 +87,7 @@ def begin_analyze_wrapped( poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access poller._polling_method, # pylint: disable=protected-access ) - + # Wrap begin_analyze_binary to return custom poller and set string_encoding def begin_analyze_binary_wrapped( self, @@ -99,7 +100,7 @@ def begin_analyze_binary_wrapped( **kwargs: Any ) -> "LROPoller[AnalyzeResult]": """Extract content and fields from input. - + :param analyzer_id: The unique identifier of the analyzer. Required. :type analyzer_id: str :param binary_input: The binary content of the document to analyze. Required. @@ -117,7 +118,7 @@ def begin_analyze_binary_wrapped( compatible with MutableMapping. The poller includes a .details property with operation metadata. :rtype: ~azure.ai.contentunderstanding.operations.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] :raises ~azure.core.exceptions.HttpResponseError: - + .. note:: The string_encoding parameter is automatically set to "codePoint" for Python as it matches Python's native string indexing behavior (len() and str[i] use code points). @@ -140,7 +141,7 @@ def begin_analyze_binary_wrapped( poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access poller._polling_method, # pylint: disable=protected-access ) - + # Replace the methods _ContentUnderstandingClientOperationsMixin.begin_analyze = begin_analyze_wrapped _ContentUnderstandingClientOperationsMixin.begin_analyze_binary = begin_analyze_binary_wrapped diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py index a095b925ed3a..bf15dc3f8773 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py @@ -6,9 +6,6 @@ # Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- -# -# MANUAL CUSTOMIZATIONS APPLIED - Search for "EMITTER-FIX" to find all changes -# from collections.abc import MutableMapping from io import IOBase import json @@ -39,19 +36,19 @@ from ..._operations._operations import ( build_content_understanding_analyze_binary_request, build_content_understanding_analyze_request, - build_content_understanding_copy_request, - build_content_understanding_create_or_replace_request, - build_content_understanding_delete_request, + build_content_understanding_copy_analyzer_request, + build_content_understanding_create_analyzer_request, + build_content_understanding_delet_analyzer_request, build_content_understanding_delete_result_request, + build_content_understanding_get_analyzer_request, build_content_understanding_get_defaults_request, build_content_understanding_get_operation_status_request, - build_content_understanding_get_request, build_content_understanding_get_result_file_request, build_content_understanding_get_result_request, build_content_understanding_grant_copy_authorization_request, - build_content_understanding_list_request, + build_content_understanding_list_analyzers_request, + build_content_understanding_update_analyzer_request, build_content_understanding_update_defaults_request, - build_content_understanding_update_request, ) from ..._utils.model_base import SdkJSONEncoder, _deserialize from ..._utils.utils import ClientMixinABC @@ -62,7 +59,6 @@ _Unset: Any = object() T = TypeVar("T") ClsType = Optional[Callable[[PipelineResponse[HttpRequest, AsyncHttpResponse], T, dict[str, Any]], Any]] -List = list class _ContentUnderstandingClientOperationsMixin( @@ -76,7 +72,7 @@ async def _analyze_initial( *, string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, - inputs: Optional[List[_models.AnalyzeInput]] = None, + inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any ) -> AsyncIterator[bytes]: @@ -155,7 +151,7 @@ async def begin_analyze( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, content_type: str = "application/json", - inputs: Optional[List[_models.AnalyzeInput]] = None, + inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any ) -> AsyncLROPoller[_models.AnalyzeResult]: @@ -260,7 +256,7 @@ async def begin_analyze( *, string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, - inputs: Optional[List[_models.AnalyzeInput]] = None, + inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any ) -> AsyncLROPoller[_models.AnalyzeResult]: @@ -377,8 +373,6 @@ async def _analyze_binary_initial( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, input_range: Optional[str] = None, - # EMITTER-FIX: content_type default value missing (TypeSpec specifies "application/octet-stream") - content_type: str = "application/octet-stream", **kwargs: Any ) -> AsyncIterator[bytes]: error_map: MutableMapping = { @@ -392,8 +386,7 @@ async def _analyze_binary_initial( _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - # EMITTER-FIX: Use parameter instead of kwargs.pop - # content_type: str = kwargs.pop("content_type") # Original (broken) + content_type: str = kwargs.pop("content_type") cls: ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) _content = binary_input @@ -467,8 +460,6 @@ async def begin_analyze_binary( string_encoding: Optional[str] = None, processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, input_range: Optional[str] = None, - # EMITTER-FIX: content_type default value missing (TypeSpec specifies "application/octet-stream") - content_type: str = "application/octet-stream", **kwargs: Any ) -> AsyncLROPoller[_models.AnalyzeResult]: """Extract content and fields from input. @@ -488,9 +479,6 @@ async def begin_analyze_binary( 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. :paramtype input_range: str - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/octet-stream". - :paramtype content_type: str :return: An instance of AsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is compatible with MutableMapping :rtype: ~azure.core.polling.AsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] @@ -499,8 +487,7 @@ async def begin_analyze_binary( _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - # EMITTER-FIX: Use parameter instead of kwargs.pop - # content_type: str = kwargs.pop("content_type") # Original (broken) + content_type: str = kwargs.pop("content_type") cls: ClsType[_models.AnalyzeResult] = kwargs.pop("cls", None) polling: Union[bool, AsyncPollingMethod] = kwargs.pop("polling", True) lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) @@ -567,7 +554,7 @@ def get_long_running_output(pipeline_response): }, api_versions_list=["2025-11-01"], ) - async def _copy_initial( + async def _copy_analyzer_initial( self, analyzer_id: str, body: Union[JSON, IO[bytes]] = _Unset, @@ -608,7 +595,7 @@ async def _copy_initial( else: _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore - _request = build_content_understanding_copy_request( + _request = build_content_understanding_copy_analyzer_request( analyzer_id=analyzer_id, allow_replace=allow_replace, content_type=content_type, @@ -651,7 +638,7 @@ async def _copy_initial( return deserialized # type: ignore @overload - async def begin_copy( + async def begin_copy_analyzer( self, analyzer_id: str, *, @@ -688,7 +675,7 @@ async def begin_copy( """ @overload - async def begin_copy( + async def begin_copy_analyzer( self, analyzer_id: str, body: JSON, @@ -717,7 +704,7 @@ async def begin_copy( """ @overload - async def begin_copy( + async def begin_copy_analyzer( self, analyzer_id: str, body: IO[bytes], @@ -753,7 +740,7 @@ async def begin_copy( }, api_versions_list=["2025-11-01"], ) - async def begin_copy( + async def begin_copy_analyzer( self, analyzer_id: str, body: Union[JSON, IO[bytes]] = _Unset, @@ -796,7 +783,7 @@ async def begin_copy( lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) cont_token: Optional[str] = kwargs.pop("continuation_token", None) if cont_token is None: - raw_result = await self._copy_initial( + raw_result = await self._copy_analyzer_initial( analyzer_id=analyzer_id, body=body, source_analyzer_id=source_analyzer_id, @@ -855,7 +842,7 @@ def get_long_running_output(pipeline_response): params_added_on={"2025-11-01": ["allow_replace"]}, api_versions_list=["2025-05-01-preview", "2025-11-01"], ) - async def _create_or_replace_initial( + async def _create_analyzer_initial( self, analyzer_id: str, resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], @@ -884,7 +871,7 @@ async def _create_or_replace_initial( else: _content = json.dumps(resource, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore - _request = build_content_understanding_create_or_replace_request( + _request = build_content_understanding_create_analyzer_request( analyzer_id=analyzer_id, allow_replace=allow_replace, content_type=content_type, @@ -927,7 +914,7 @@ async def _create_or_replace_initial( return deserialized # type: ignore @overload - async def begin_create_or_replace( + async def begin_create_analyzer( self, analyzer_id: str, resource: _models.ContentAnalyzer, @@ -956,7 +943,7 @@ async def begin_create_or_replace( """ @overload - async def begin_create_or_replace( + async def begin_create_analyzer( self, analyzer_id: str, resource: JSON, @@ -985,7 +972,7 @@ async def begin_create_or_replace( """ @overload - async def begin_create_or_replace( + async def begin_create_analyzer( self, analyzer_id: str, resource: IO[bytes], @@ -1018,7 +1005,7 @@ async def begin_create_or_replace( params_added_on={"2025-11-01": ["allow_replace"]}, api_versions_list=["2025-05-01-preview", "2025-11-01"], ) - async def begin_create_or_replace( + async def begin_create_analyzer( self, analyzer_id: str, resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], @@ -1051,7 +1038,7 @@ async def begin_create_or_replace( lro_delay = kwargs.pop("polling_interval", self._config.polling_interval) cont_token: Optional[str] = kwargs.pop("continuation_token", None) if cont_token is None: - raw_result = await self._create_or_replace_initial( + raw_result = await self._create_analyzer_initial( analyzer_id=analyzer_id, resource=resource, allow_replace=allow_replace, @@ -1104,7 +1091,7 @@ def get_long_running_output(pipeline_response): ) @distributed_trace_async - async def delete(self, analyzer_id: str, **kwargs: Any) -> None: + async def delet_analyzer(self, analyzer_id: str, **kwargs: Any) -> None: """Delete analyzer. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -1126,7 +1113,7 @@ async def delete(self, analyzer_id: str, **kwargs: Any) -> None: cls: ClsType[None] = kwargs.pop("cls", None) - _request = build_content_understanding_delete_request( + _request = build_content_understanding_delet_analyzer_request( analyzer_id=analyzer_id, api_version=self._config.api_version, headers=_headers, @@ -1210,7 +1197,7 @@ async def delete_result(self, operation_id: str, **kwargs: Any) -> None: return cls(pipeline_response, None, {}) # type: ignore @distributed_trace_async - async def get(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyzer: + async def get_analyzer(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyzer: """Get analyzer properties. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -1232,7 +1219,7 @@ async def get(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyzer: cls: ClsType[_models.ContentAnalyzer] = kwargs.pop("cls", None) - _request = build_content_understanding_get_request( + _request = build_content_understanding_get_analyzer_request( analyzer_id=analyzer_id, api_version=self._config.api_version, headers=_headers, @@ -1338,7 +1325,7 @@ async def get_defaults(self, **kwargs: Any) -> _models.ContentUnderstandingDefau return deserialized # type: ignore @distributed_trace_async - async def get_operation_status( + async def _get_operation_status( self, analyzer_id: str, operation_id: str, **kwargs: Any ) -> _models.ContentAnalyzerOperationStatus: """Get the status of an analyzer creation operation. @@ -1691,7 +1678,7 @@ async def grant_copy_authorization( return deserialized # type: ignore @distributed_trace - def list(self, **kwargs: Any) -> AsyncItemPaged["_models.ContentAnalyzer"]: + def list_analyzers(self, **kwargs: Any) -> AsyncItemPaged["_models.ContentAnalyzer"]: """List analyzers. :return: An iterator like instance of ContentAnalyzer @@ -1702,7 +1689,7 @@ def list(self, **kwargs: Any) -> AsyncItemPaged["_models.ContentAnalyzer"]: _headers = kwargs.pop("headers", {}) or {} _params = kwargs.pop("params", {}) or {} - cls: ClsType[List[_models.ContentAnalyzer]] = kwargs.pop("cls", None) + cls: ClsType[list[_models.ContentAnalyzer]] = kwargs.pop("cls", None) error_map: MutableMapping = { 401: ClientAuthenticationError, @@ -1715,7 +1702,7 @@ def list(self, **kwargs: Any) -> AsyncItemPaged["_models.ContentAnalyzer"]: def prepare_request(next_link=None): if not next_link: - _request = build_content_understanding_list_request( + _request = build_content_understanding_list_analyzers_request( api_version=self._config.api_version, headers=_headers, params=_params, @@ -1751,7 +1738,7 @@ def prepare_request(next_link=None): async def extract_data(pipeline_response): deserialized = pipeline_response.http_response.json() - list_of_elem = _deserialize(List[_models.ContentAnalyzer], deserialized.get("value", [])) + list_of_elem = _deserialize(list[_models.ContentAnalyzer], deserialized.get("value", [])) if cls: list_of_elem = cls(list_of_elem) # type: ignore return deserialized.get("nextLink") or None, AsyncList(list_of_elem) @@ -1774,7 +1761,7 @@ async def get_next(next_link=None): return AsyncItemPaged(get_next, extract_data) @overload - async def update( + async def update_analyzer( self, analyzer_id: str, resource: _models.ContentAnalyzer, @@ -1797,7 +1784,7 @@ async def update( """ @overload - async def update( + async def update_analyzer( self, analyzer_id: str, resource: JSON, *, content_type: str = "application/merge-patch+json", **kwargs: Any ) -> _models.ContentAnalyzer: """Update analyzer properties. @@ -1815,7 +1802,7 @@ async def update( """ @overload - async def update( + async def update_analyzer( self, analyzer_id: str, resource: IO[bytes], @@ -1838,7 +1825,7 @@ async def update( """ @distributed_trace_async - async def update( + async def update_analyzer( self, analyzer_id: str, resource: Union[_models.ContentAnalyzer, JSON, IO[bytes]], **kwargs: Any ) -> _models.ContentAnalyzer: """Update analyzer properties. @@ -1873,7 +1860,7 @@ async def update( else: _content = json.dumps(resource, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore - _request = build_content_understanding_update_request( + _request = build_content_understanding_update_analyzer_request( analyzer_id=analyzer_id, content_type=content_type, api_version=self._config.api_version, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index b4e344f419a3..bbc400f9d1cf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. @@ -18,19 +19,19 @@ def patch_sdk(): """Patch the generated code to add custom functionality. - + 1. Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property 2. Hide string_encoding parameter and always use "codePoint" (correct for Python) - + Note: content_type default fix is now directly in generated code (search for EMITTER-FIX) """ from ._operations import _ContentUnderstandingClientOperationsMixin from ...aio.operations._patch import AnalyzeAsyncLROPoller - + # Store original methods original_begin_analyze = _ContentUnderstandingClientOperationsMixin.begin_analyze original_begin_analyze_binary = _ContentUnderstandingClientOperationsMixin.begin_analyze_binary - + # Wrap begin_analyze to return custom poller and set string_encoding async def begin_analyze_wrapped( self, @@ -43,7 +44,7 @@ async def begin_analyze_wrapped( **kwargs: Any ) -> "AsyncLROPoller[AnalyzeResult]": """Extract content and fields from input. - + :param analyzer_id: The unique identifier of the analyzer. Required. :type analyzer_id: str :keyword processing_location: The location where the data may be processed. Defaults to @@ -63,7 +64,7 @@ async def begin_analyze_wrapped( compatible with MutableMapping. The poller includes a .details property with operation metadata. :rtype: ~azure.ai.contentunderstanding.aio.operations.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] :raises ~azure.core.exceptions.HttpResponseError: - + .. note:: The string_encoding parameter is automatically set to "codePoint" for Python as it matches Python's native string indexing behavior (len() and str[i] use code points). @@ -86,7 +87,7 @@ async def begin_analyze_wrapped( poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access poller._polling_method, # pylint: disable=protected-access ) - + # Wrap begin_analyze_binary to return custom poller and set string_encoding async def begin_analyze_binary_wrapped( self, @@ -99,7 +100,7 @@ async def begin_analyze_binary_wrapped( **kwargs: Any ) -> "AsyncLROPoller[AnalyzeResult]": """Extract content and fields from input. - + :param analyzer_id: The unique identifier of the analyzer. Required. :type analyzer_id: str :param binary_input: The binary content of the document to analyze. Required. @@ -117,7 +118,7 @@ async def begin_analyze_binary_wrapped( compatible with MutableMapping. The poller includes a .details property with operation metadata. :rtype: ~azure.ai.contentunderstanding.aio.operations.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] :raises ~azure.core.exceptions.HttpResponseError: - + .. note:: The string_encoding parameter is automatically set to "codePoint" for Python as it matches Python's native string indexing behavior (len() and str[i] use code points). @@ -140,7 +141,7 @@ async def begin_analyze_binary_wrapped( poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access poller._polling_method, # pylint: disable=protected-access ) - + # Replace the methods _ContentUnderstandingClientOperationsMixin.begin_analyze = begin_analyze_wrapped _ContentUnderstandingClientOperationsMixin.begin_analyze_binary = begin_analyze_binary_wrapped diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py index 804937756e22..fd918326d1af 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py @@ -88,5 +88,3 @@ def patch_sdk(): :return: None :rtype: None """ - - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py index c55c22808ae6..e8c6a10759f6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py @@ -93,5 +93,3 @@ def patch_sdk(): :return: None :rtype: None """ - - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py index 1b31d40d85b9..199162fd8705 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py @@ -50,9 +50,9 @@ def test_begin_analyze_binary(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_begin_copy(self, contentunderstanding_endpoint): + def test_begin_copy_analyzer(self, contentunderstanding_endpoint): client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.begin_copy( + response = client.begin_copy_analyzer( analyzer_id="str", body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, source_analyzer_id="str", @@ -63,9 +63,9 @@ def test_begin_copy(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_begin_create_or_replace(self, contentunderstanding_endpoint): + def test_begin_create_analyzer(self, contentunderstanding_endpoint): client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.begin_create_or_replace( + response = client.begin_create_analyzer( analyzer_id="str", resource={ "analyzerId": "str", @@ -139,9 +139,9 @@ def test_begin_create_or_replace(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_delete(self, contentunderstanding_endpoint): + def test_delet_analyzer(self, contentunderstanding_endpoint): client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.delete( + response = client.delet_analyzer( analyzer_id="str", ) @@ -161,9 +161,9 @@ def test_delete_result(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_get(self, contentunderstanding_endpoint): + def test_get_analyzer(self, contentunderstanding_endpoint): client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.get( + response = client.get_analyzer( analyzer_id="str", ) @@ -179,18 +179,6 @@ def test_get_defaults(self, contentunderstanding_endpoint): # please add some check logic here by yourself # ... - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_get_operation_status(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.get_operation_status( - analyzer_id="str", - operation_id="str", - ) - - # please add some check logic here by yourself - # ... - @ContentUnderstandingPreparer() @recorded_by_proxy def test_get_result_file(self, contentunderstanding_endpoint): @@ -218,18 +206,18 @@ def test_grant_copy_authorization(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_list(self, contentunderstanding_endpoint): + def test_list_analyzers(self, contentunderstanding_endpoint): client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.list() + response = client.list_analyzers() result = [r for r in response] # please add some check logic here by yourself # ... @ContentUnderstandingPreparer() @recorded_by_proxy - def test_update(self, contentunderstanding_endpoint): + def test_update_analyzer(self, contentunderstanding_endpoint): client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.update( + response = client.update_analyzer( analyzer_id="str", resource={ "analyzerId": "str", diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py index 2dd3eda1d9b9..d5a9d161c082 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py @@ -55,10 +55,10 @@ async def test_begin_analyze_binary(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_begin_copy(self, contentunderstanding_endpoint): + async def test_begin_copy_analyzer(self, contentunderstanding_endpoint): client = self.create_async_client(endpoint=contentunderstanding_endpoint) response = await ( - await client.begin_copy( + await client.begin_copy_analyzer( analyzer_id="str", body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, source_analyzer_id="str", @@ -70,10 +70,10 @@ async def test_begin_copy(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_begin_create_or_replace(self, contentunderstanding_endpoint): + async def test_begin_create_analyzer(self, contentunderstanding_endpoint): client = self.create_async_client(endpoint=contentunderstanding_endpoint) response = await ( - await client.begin_create_or_replace( + await client.begin_create_analyzer( analyzer_id="str", resource={ "analyzerId": "str", @@ -148,9 +148,9 @@ async def test_begin_create_or_replace(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_delete(self, contentunderstanding_endpoint): + async def test_delet_analyzer(self, contentunderstanding_endpoint): client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.delete( + response = await client.delet_analyzer( analyzer_id="str", ) @@ -170,9 +170,9 @@ async def test_delete_result(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_get(self, contentunderstanding_endpoint): + async def test_get_analyzer(self, contentunderstanding_endpoint): client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.get( + response = await client.get_analyzer( analyzer_id="str", ) @@ -188,18 +188,6 @@ async def test_get_defaults(self, contentunderstanding_endpoint): # please add some check logic here by yourself # ... - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_get_operation_status(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.get_operation_status( - analyzer_id="str", - operation_id="str", - ) - - # please add some check logic here by yourself - # ... - @ContentUnderstandingPreparer() @recorded_by_proxy_async async def test_get_result_file(self, contentunderstanding_endpoint): @@ -227,18 +215,18 @@ async def test_grant_copy_authorization(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_list(self, contentunderstanding_endpoint): + async def test_list_analyzers(self, contentunderstanding_endpoint): client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = client.list() + response = client.list_analyzers() result = [r async for r in response] # please add some check logic here by yourself # ... @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_update(self, contentunderstanding_endpoint): + async def test_update_analyzer(self, contentunderstanding_endpoint): client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.update( + response = await client.update_analyzer( analyzer_id="str", resource={ "analyzerId": "str", diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml index d99ca2bae886..81fc226f998f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml @@ -1,4 +1,4 @@ directory: specification/ai/ContentUnderstanding -commit: 57cfe1e680b2521e03e1d8a0955bba0257439dca +commit: 43cede02b48e5f36a3b67f47663c4e6f16413e61 repo: Azure/azure-rest-api-specs additionalDirectories: From 9c0774301c7bc1c55f82637390418dd371b26130 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 20:14:35 +0000 Subject: [PATCH 006/105] SDK-GEN: Re-generate for operation name fix --- .../_metadata.json | 2 +- .../apiview-properties.json | 26 +++++++++---------- .../_operations/_operations.py | 8 +++--- .../aio/_operations/_operations.py | 6 ++--- .../test_content_understanding.py | 4 +-- .../test_content_understanding_async.py | 4 +-- .../samples/analyze_url.py | 6 +---- .../samples/sample_helper.py | 2 -- .../tsp-location.yaml | 2 +- 9 files changed, 27 insertions(+), 33 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json index 5874c0664350..afaae3701e35 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json @@ -1,6 +1,6 @@ { "apiVersion": "2025-11-01", - "commit": "57cfe1e680b2521e03e1d8a0955bba0257439dca", + "commit": "88218cd4248be9482eea5100e72814adf5be248b", "repository_url": "https://github.com/Azure/azure-rest-api-specs", "typespec_src": "specification/ai/ContentUnderstanding", "emitterVersion": "0.53.2" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json index 203ba5dda0c1..adbea869e890 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json @@ -73,28 +73,26 @@ "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": "ClientCustomizations.ContentUnderstandingClient.copy", - "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.begin_copy": "ClientCustomizations.ContentUnderstandingClient.copy", - "azure.ai.contentunderstanding.ContentUnderstandingClient.begin_create_or_replace": "ClientCustomizations.ContentUnderstandingClient.createOrReplace", - "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.begin_create_or_replace": "ClientCustomizations.ContentUnderstandingClient.createOrReplace", - "azure.ai.contentunderstanding.ContentUnderstandingClient.delete": "ClientCustomizations.ContentUnderstandingClient.delete", - "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.delete": "ClientCustomizations.ContentUnderstandingClient.delete", + "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": "ClientCustomizations.ContentUnderstandingClient.get", - "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.get": "ClientCustomizations.ContentUnderstandingClient.get", + "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_operation_status": "ClientCustomizations.ContentUnderstandingClient.getOperationStatus", - "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.get_operation_status": "ClientCustomizations.ContentUnderstandingClient.getOperationStatus", "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": "ClientCustomizations.ContentUnderstandingClient.list", - "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.list": "ClientCustomizations.ContentUnderstandingClient.list", - "azure.ai.contentunderstanding.ContentUnderstandingClient.update": "ClientCustomizations.ContentUnderstandingClient.update", - "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.update": "ClientCustomizations.ContentUnderstandingClient.update", + "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" } diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py index ec652108e5b0..4c761ce494b9 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py @@ -185,7 +185,7 @@ def build_content_understanding_create_analyzer_request( # pylint: disable=name return HttpRequest(method="PUT", url=_url, params=_params, headers=_headers, **kwargs) -def build_content_understanding_delet_analyzer_request( # pylint: disable=name-too-long +def build_content_understanding_delete_analyzer_request( # pylint: disable=name-too-long analyzer_id: str, **kwargs: Any ) -> HttpRequest: _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) @@ -1470,7 +1470,9 @@ def get_long_running_output(pipeline_response): ) @distributed_trace - def delet_analyzer(self, analyzer_id: str, **kwargs: Any) -> None: # pylint: disable=inconsistent-return-statements + def delete_analyzer( # pylint: disable=inconsistent-return-statements + self, analyzer_id: str, **kwargs: Any + ) -> None: """Delete analyzer. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -1492,7 +1494,7 @@ def delet_analyzer(self, analyzer_id: str, **kwargs: Any) -> None: # pylint: di cls: ClsType[None] = kwargs.pop("cls", None) - _request = build_content_understanding_delet_analyzer_request( + _request = build_content_understanding_delete_analyzer_request( analyzer_id=analyzer_id, api_version=self._config.api_version, headers=_headers, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py index bf15dc3f8773..02aa1b9a0fe1 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py @@ -38,7 +38,7 @@ build_content_understanding_analyze_request, build_content_understanding_copy_analyzer_request, build_content_understanding_create_analyzer_request, - build_content_understanding_delet_analyzer_request, + build_content_understanding_delete_analyzer_request, build_content_understanding_delete_result_request, build_content_understanding_get_analyzer_request, build_content_understanding_get_defaults_request, @@ -1091,7 +1091,7 @@ def get_long_running_output(pipeline_response): ) @distributed_trace_async - async def delet_analyzer(self, analyzer_id: str, **kwargs: Any) -> None: + async def delete_analyzer(self, analyzer_id: str, **kwargs: Any) -> None: """Delete analyzer. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -1113,7 +1113,7 @@ async def delet_analyzer(self, analyzer_id: str, **kwargs: Any) -> None: cls: ClsType[None] = kwargs.pop("cls", None) - _request = build_content_understanding_delet_analyzer_request( + _request = build_content_understanding_delete_analyzer_request( analyzer_id=analyzer_id, api_version=self._config.api_version, headers=_headers, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py index 199162fd8705..d570db867e1f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py @@ -139,9 +139,9 @@ def test_begin_create_analyzer(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_delet_analyzer(self, contentunderstanding_endpoint): + def test_delete_analyzer(self, contentunderstanding_endpoint): client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.delet_analyzer( + response = client.delete_analyzer( analyzer_id="str", ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py index d5a9d161c082..a587c1be2188 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py @@ -148,9 +148,9 @@ async def test_begin_create_analyzer(self, contentunderstanding_endpoint): @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_delet_analyzer(self, contentunderstanding_endpoint): + async def test_delete_analyzer(self, contentunderstanding_endpoint): client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.delet_analyzer( + response = await client.delete_analyzer( analyzer_id="str", ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py index c15bf1fd2b8f..176dbfc96359 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py @@ -66,9 +66,7 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" print(f"Analyzing remote document from {file_url} with prebuilt-documentSearch...") - poller = await client.begin_analyze( - analyzer_id="prebuilt-documentSearch", inputs=[AnalyzeInput(url=file_url)] - ) + poller = await client.begin_analyze(analyzer_id="prebuilt-documentSearch", inputs=[AnalyzeInput(url=file_url)]) result: AnalyzeResult = await poller.result() # AnalyzeResult contains the full analysis result and can be used to access various properties @@ -124,5 +122,3 @@ async def main() -> None: if __name__ == "__main__": asyncio.run(main()) - - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py index 63ab26d92cdc..1cc2a3dd6e5c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py @@ -67,5 +67,3 @@ def read_binary_file(filepath: str) -> bytes: """ with open(filepath, "rb") as f: return f.read() - - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml index 81fc226f998f..ebb0da02b4dd 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml @@ -1,4 +1,4 @@ directory: specification/ai/ContentUnderstanding -commit: 43cede02b48e5f36a3b67f47663c4e6f16413e61 +commit: 88218cd4248be9482eea5100e72814adf5be248b repo: Azure/azure-rest-api-specs additionalDirectories: From af7c2fe78f63897e990f0ee59dd7c9e597c4ae1f Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 20:51:02 +0000 Subject: [PATCH 007/105] PATCH: Refactor patch to be static only for client, analyze overloads, and custom poller --- .../_operations/_patch.py | 135 +------- .../azure/ai/contentunderstanding/_patch.py | 300 ++++++++++++++++- .../aio/_operations/_patch.py | 135 +------- .../ai/contentunderstanding/aio/_patch.py | 302 +++++++++++++++++- .../aio/models/__init__.py | 11 + .../contentunderstanding/aio/models/_patch.py | 97 ++++++ .../aio/operations/_patch.py | 68 +--- .../ai/contentunderstanding/models/_patch.py | 72 ++++- .../contentunderstanding/operations/_patch.py | 73 +---- 9 files changed, 793 insertions(+), 400 deletions(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/__init__.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index 7f32479eab0c..cc86db4005cf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -8,140 +8,17 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import Any, TYPE_CHECKING - -if TYPE_CHECKING: - from azure.core.polling import LROPoller - from azure.ai.contentunderstanding.models import AnalyzeResult __all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): - """Patch the generated code to add custom functionality. + """Do not remove from this file. - 1. Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property - 2. Hide string_encoding parameter and always use "codePoint" (correct for Python) + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize - Note: content_type default fix is now directly in generated code (search for EMITTER-FIX) + :return: None + :rtype: None """ - from ._operations import _ContentUnderstandingClientOperationsMixin - from ..operations._patch import AnalyzeLROPoller - - # Store original methods - original_begin_analyze = _ContentUnderstandingClientOperationsMixin.begin_analyze - original_begin_analyze_binary = _ContentUnderstandingClientOperationsMixin.begin_analyze_binary - - # Wrap begin_analyze to return custom LROPoller and set string_encoding - def begin_analyze_wrapped( - self, - analyzer_id: str, - *, - processing_location: Any = None, - content_type: str = "application/json", - inputs: Any = None, - model_deployments: Any = None, - **kwargs: Any - ) -> "LROPoller[AnalyzeResult]": - """Extract content and fields from input. - - :param analyzer_id: The unique identifier of the analyzer. Required. - :type analyzer_id: str - :keyword processing_location: The location where the data may be processed. Defaults to - global. Known values are: "geography", "dataZone", and "global". Default value is None. - :paramtype processing_location: str - :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. - Default value is "application/json". - :paramtype content_type: str - :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. - Default value is None. - :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] - :keyword model_deployments: Override default mapping of model names to deployments. - Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": - "myTextEmbedding3LargeDeployment" }. Default value is None. - :paramtype model_deployments: dict[str, str] - :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is - compatible with MutableMapping. The poller includes a .details property with operation metadata. - :rtype: ~azure.ai.contentunderstanding.operations.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] - :raises ~azure.core.exceptions.HttpResponseError: - - .. note:: - The string_encoding parameter is automatically set to "codePoint" for Python as it - matches Python's native string indexing behavior (len() and str[i] use code points). - This ensures ContentSpan offsets work correctly with Python string slicing. - """ - # Always use codePoint encoding for Python (matches Python's string indexing) - kwargs["string_encoding"] = "codePoint" - poller = original_begin_analyze( - self, - analyzer_id, - processing_location=processing_location, - content_type=content_type, - inputs=inputs, - model_deployments=model_deployments, - **kwargs - ) - return AnalyzeLROPoller( - self._client, # type: ignore - poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access - poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access - poller._polling_method, # pylint: disable=protected-access - ) - - # Wrap begin_analyze_binary to return custom poller and set string_encoding - def begin_analyze_binary_wrapped( - self, - analyzer_id: str, - binary_input: bytes, - *, - processing_location: Any = None, - input_range: Any = None, - content_type: str = "application/octet-stream", - **kwargs: Any - ) -> "LROPoller[AnalyzeResult]": - """Extract content and fields from input. - - :param analyzer_id: The unique identifier of the analyzer. Required. - :type analyzer_id: str - :param binary_input: The binary content of the document to analyze. Required. - :type binary_input: bytes - :keyword processing_location: The location where the data may be processed. Defaults to - global. Known values are: "geography", "dataZone", and "global". Default value is None. - :paramtype processing_location: str - :keyword input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses - 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. - :paramtype input_range: str - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/octet-stream". - :paramtype content_type: str - :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is - compatible with MutableMapping. The poller includes a .details property with operation metadata. - :rtype: ~azure.ai.contentunderstanding.operations.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] - :raises ~azure.core.exceptions.HttpResponseError: - - .. note:: - The string_encoding parameter is automatically set to "codePoint" for Python as it - matches Python's native string indexing behavior (len() and str[i] use code points). - This ensures ContentSpan offsets work correctly with Python string slicing. - """ - # Always use codePoint encoding for Python (matches Python's string indexing) - kwargs["string_encoding"] = "codePoint" - poller = original_begin_analyze_binary( - self, - analyzer_id, - binary_input, - processing_location=processing_location, - input_range=input_range, - content_type=content_type, - **kwargs - ) - return AnalyzeLROPoller( - self._client, # type: ignore - poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access - poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access - poller._polling_method, # pylint: disable=protected-access - ) - - # Replace the methods - _ContentUnderstandingClientOperationsMixin.begin_analyze = begin_analyze_wrapped - _ContentUnderstandingClientOperationsMixin.begin_analyze_binary = begin_analyze_binary_wrapped diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py index 87676c65a8f0..233d6d4e60c8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py @@ -7,9 +7,307 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ +from typing import Any, Optional, Union, IO, overload +from typing_extensions import Self +from azure.core.credentials import AzureKeyCredential +from azure.core.rest import HttpRequest, HttpResponse +from ._client import ContentUnderstandingClient as GeneratedClient +from . import models as _models +from .models import AnalyzeLROPoller -__all__: list[str] = [] # Add all objects you want publicly available to users at this package level +if False: # TYPE_CHECKING + from azure.core.credentials import TokenCredential + +JSON = dict[str, Any] +_Unset: Any = object() + +__all__ = ["ContentUnderstandingClient"] + + +class ContentUnderstandingClient(GeneratedClient): + """Custom ContentUnderstandingClient with static patches for analyze operations. + + This wrapper: + - Hides the string_encoding parameter (always uses "codePoint" for Python) + - Returns AnalyzeLROPoller with .operation_id property + - Fixes content_type default for begin_analyze_binary + + :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. + """ + + @overload + def begin_analyze( + self, + analyzer_id: str, + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + inputs: Optional[list[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any, + ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. + Default value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.models.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + + @overload + def begin_analyze( + self, + analyzer_id: str, + body: JSON, + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + **kwargs: Any, + ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: JSON body. Required. + :type body: JSON + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.models.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + + @overload + def begin_analyze( + self, + analyzer_id: str, + body: IO[bytes], + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + **kwargs: Any, + ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Binary stream body. Required. + :type body: IO[bytes] + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.models.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + + def begin_analyze( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: Optional[str] = None, + inputs: Optional[list[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any, + ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Is either a JSON type or a IO[bytes] type. Default value is None. + :type body: JSON or IO[bytes] + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Default value is "application/json". + :paramtype content_type: str + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. + Default value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.models.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + # Set string_encoding to "codePoint" (matches Python's string indexing) + kwargs["string_encoding"] = "codePoint" + + # Call parent implementation + # Only pass body if it's not _Unset (let parent construct from inputs if not provided) + if body is not _Unset: + poller = super().begin_analyze( + analyzer_id=analyzer_id, + body=body, + processing_location=processing_location, + content_type=content_type, + inputs=inputs, + model_deployments=model_deployments, + **kwargs, + ) + else: + poller = super().begin_analyze( + analyzer_id=analyzer_id, + processing_location=processing_location, + content_type=content_type, + inputs=inputs, + model_deployments=model_deployments, + **kwargs, + ) + + # Wrap in custom poller with .operation_id property + return AnalyzeLROPoller( + self._client, + poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access + poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access + poller._polling_method, # pylint: disable=protected-access + ) + + def begin_analyze_binary( + self, + analyzer_id: str, + binary_input: bytes, + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + input_range: Optional[str] = None, + content_type: str = "application/octet-stream", + **kwargs: Any, + ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param binary_input: The binary content of the document to analyze. Required. + :type binary_input: bytes + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses + 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. + :paramtype input_range: str + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/octet-stream". + :paramtype content_type: str + :return: An instance of AnalyzeLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.models.AnalyzeLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + # Set string_encoding to "codePoint" (matches Python's string indexing) + kwargs["string_encoding"] = "codePoint" + + # Call parent implementation + poller = super().begin_analyze_binary( + analyzer_id=analyzer_id, + binary_input=binary_input, + processing_location=processing_location, + input_range=input_range, + content_type=content_type, + **kwargs, + ) + + # Wrap in custom poller with .operation_id property + return AnalyzeLROPoller( + self._client, + poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access + poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access + poller._polling_method, # pylint: disable=protected-access + ) + + 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/") + + >>> response = client.send_request(request) + + + 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 + """ + return super().send_request(request, stream=stream, **kwargs) + + def close(self) -> None: + """Close the client session.""" + super().close() + + def __enter__(self) -> Self: + super().__enter__() + return self + + def __exit__(self, *exc_details: Any) -> None: + super().__exit__(*exc_details) def patch_sdk(): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index bbc400f9d1cf..cc86db4005cf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -8,140 +8,17 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import Any, TYPE_CHECKING - -if TYPE_CHECKING: - from azure.core.polling import AsyncLROPoller - from azure.ai.contentunderstanding.models import AnalyzeResult __all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): - """Patch the generated code to add custom functionality. + """Do not remove from this file. - 1. Wrap begin_analyze and begin_analyze_binary to return custom LROPoller with .details property - 2. Hide string_encoding parameter and always use "codePoint" (correct for Python) + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize - Note: content_type default fix is now directly in generated code (search for EMITTER-FIX) + :return: None + :rtype: None """ - from ._operations import _ContentUnderstandingClientOperationsMixin - from ...aio.operations._patch import AnalyzeAsyncLROPoller - - # Store original methods - original_begin_analyze = _ContentUnderstandingClientOperationsMixin.begin_analyze - original_begin_analyze_binary = _ContentUnderstandingClientOperationsMixin.begin_analyze_binary - - # Wrap begin_analyze to return custom poller and set string_encoding - async def begin_analyze_wrapped( - self, - analyzer_id: str, - *, - processing_location: Any = None, - content_type: str = "application/json", - inputs: Any = None, - model_deployments: Any = None, - **kwargs: Any - ) -> "AsyncLROPoller[AnalyzeResult]": - """Extract content and fields from input. - - :param analyzer_id: The unique identifier of the analyzer. Required. - :type analyzer_id: str - :keyword processing_location: The location where the data may be processed. Defaults to - global. Known values are: "geography", "dataZone", and "global". Default value is None. - :paramtype processing_location: str - :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. - Default value is "application/json". - :paramtype content_type: str - :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. - Default value is None. - :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] - :keyword model_deployments: Override default mapping of model names to deployments. - Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": - "myTextEmbedding3LargeDeployment" }. Default value is None. - :paramtype model_deployments: dict[str, str] - :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is - compatible with MutableMapping. The poller includes a .details property with operation metadata. - :rtype: ~azure.ai.contentunderstanding.aio.operations.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] - :raises ~azure.core.exceptions.HttpResponseError: - - .. note:: - The string_encoding parameter is automatically set to "codePoint" for Python as it - matches Python's native string indexing behavior (len() and str[i] use code points). - This ensures ContentSpan offsets work correctly with Python string slicing. - """ - # Always use codePoint encoding for Python (matches Python's string indexing) - kwargs["string_encoding"] = "codePoint" - poller = await original_begin_analyze( - self, - analyzer_id, - processing_location=processing_location, - content_type=content_type, - inputs=inputs, - model_deployments=model_deployments, - **kwargs - ) - return AnalyzeAsyncLROPoller( - self._client, # type: ignore - poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access - poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access - poller._polling_method, # pylint: disable=protected-access - ) - - # Wrap begin_analyze_binary to return custom poller and set string_encoding - async def begin_analyze_binary_wrapped( - self, - analyzer_id: str, - binary_input: bytes, - *, - processing_location: Any = None, - input_range: Any = None, - content_type: str = "application/octet-stream", - **kwargs: Any - ) -> "AsyncLROPoller[AnalyzeResult]": - """Extract content and fields from input. - - :param analyzer_id: The unique identifier of the analyzer. Required. - :type analyzer_id: str - :param binary_input: The binary content of the document to analyze. Required. - :type binary_input: bytes - :keyword processing_location: The location where the data may be processed. Defaults to - global. Known values are: "geography", "dataZone", and "global". Default value is None. - :paramtype processing_location: str - :keyword input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses - 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. - :paramtype input_range: str - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/octet-stream". - :paramtype content_type: str - :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is - compatible with MutableMapping. The poller includes a .details property with operation metadata. - :rtype: ~azure.ai.contentunderstanding.aio.operations.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] - :raises ~azure.core.exceptions.HttpResponseError: - - .. note:: - The string_encoding parameter is automatically set to "codePoint" for Python as it - matches Python's native string indexing behavior (len() and str[i] use code points). - This ensures ContentSpan offsets work correctly with Python string slicing. - """ - # Always use codePoint encoding for Python (matches Python's string indexing) - kwargs["string_encoding"] = "codePoint" - poller = await original_begin_analyze_binary( - self, - analyzer_id, - binary_input, - processing_location=processing_location, - input_range=input_range, - content_type=content_type, - **kwargs - ) - return AnalyzeAsyncLROPoller( - self._client, # type: ignore - poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access - poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access - poller._polling_method, # pylint: disable=protected-access - ) - - # Replace the methods - _ContentUnderstandingClientOperationsMixin.begin_analyze = begin_analyze_wrapped - _ContentUnderstandingClientOperationsMixin.begin_analyze_binary = begin_analyze_binary_wrapped diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py index 87676c65a8f0..e2f5dea5539f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py @@ -7,9 +7,309 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ +from typing import Any, Optional, Union, IO, overload +from typing_extensions import Self +from azure.core.credentials import AzureKeyCredential +from azure.core.rest import AsyncHttpResponse, HttpRequest +from ._client import ContentUnderstandingClient as GeneratedClient +from .. import models as _models +from .models import AnalyzeAsyncLROPoller -__all__: list[str] = [] # Add all objects you want publicly available to users at this package level +if False: # TYPE_CHECKING + from azure.core.credentials_async import AsyncTokenCredential + +JSON = dict[str, Any] +_Unset: Any = object() + +__all__ = ["ContentUnderstandingClient"] + + +class ContentUnderstandingClient(GeneratedClient): + """Custom async ContentUnderstandingClient with static patches for analyze operations. + + This wrapper: + - Hides the string_encoding parameter (always uses "codePoint" for Python) + - Returns AnalyzeAsyncLROPoller with .operation_id property + - Fixes content_type default for begin_analyze_binary + + :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_async.AsyncTokenCredential + :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. + """ + + @overload + async def begin_analyze( + self, + analyzer_id: str, + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + inputs: Optional[list[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any, + ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. + Default value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.aio.models.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + + @overload + async def begin_analyze( + self, + analyzer_id: str, + body: JSON, + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + **kwargs: Any, + ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: JSON body. Required. + :type body: JSON + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.aio.models.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + + @overload + async def begin_analyze( + self, + analyzer_id: str, + body: IO[bytes], + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: str = "application/json", + **kwargs: Any, + ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Binary stream body. Required. + :type body: IO[bytes] + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.aio.models.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + + async def begin_analyze( + self, + analyzer_id: str, + body: Union[JSON, IO[bytes]] = _Unset, + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + content_type: Optional[str] = None, + inputs: Optional[list[_models.AnalyzeInput]] = None, + model_deployments: Optional[dict[str, str]] = None, + **kwargs: Any, + ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param body: Is either a JSON type or a IO[bytes] type. Default value is None. + :type body: JSON or IO[bytes] + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword content_type: Body Parameter content-type. Default value is "application/json". + :paramtype content_type: str + :keyword inputs: Inputs to analyze. Currently, only pro mode supports multiple inputs. + Default value is None. + :paramtype inputs: list[~azure.ai.contentunderstanding.models.AnalyzeInput] + :keyword model_deployments: Override default mapping of model names to deployments. + Ex. { "gpt-4.1": "myGpt41Deployment", "text-embedding-3-large": + "myTextEmbedding3LargeDeployment" }. Default value is None. + :paramtype model_deployments: dict[str, str] + :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.aio.models.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + # Set string_encoding to "codePoint" (matches Python's string indexing) + kwargs["string_encoding"] = "codePoint" + + # Call parent implementation + # Only pass body if it's not _Unset (let parent construct from inputs if not provided) + if body is not _Unset: + poller = await super().begin_analyze( + analyzer_id=analyzer_id, + body=body, + processing_location=processing_location, + content_type=content_type, + inputs=inputs, + model_deployments=model_deployments, + **kwargs, + ) + else: + poller = await super().begin_analyze( + analyzer_id=analyzer_id, + processing_location=processing_location, + content_type=content_type, + inputs=inputs, + model_deployments=model_deployments, + **kwargs, + ) + + # Wrap in custom poller with .operation_id property + return AnalyzeAsyncLROPoller( + self._client, + poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access + poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access + poller._polling_method, # pylint: disable=protected-access + ) + + async def begin_analyze_binary( + self, + analyzer_id: str, + binary_input: bytes, + *, + processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, + input_range: Optional[str] = None, + content_type: str = "application/octet-stream", + **kwargs: Any, + ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + """Extract content and fields from input. + + :param analyzer_id: The unique identifier of the analyzer. Required. + :type analyzer_id: str + :param binary_input: The binary content of the document to analyze. Required. + :type binary_input: bytes + :keyword processing_location: The location where the data may be processed. Defaults to + global. Known values are: "geography", "dataZone", and "global". Default value is None. + :paramtype processing_location: str or ~azure.ai.contentunderstanding.models.ProcessingLocation + :keyword input_range: Range of the input to analyze (ex. ``1-3,5,9-``). Document content uses + 1-based page numbers, while audio visual content uses integer milliseconds. Default value is None. + :paramtype input_range: str + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/octet-stream". + :paramtype content_type: str + :return: An instance of AnalyzeAsyncLROPoller that returns AnalyzeResult. The AnalyzeResult is + compatible with MutableMapping. The poller includes an .operation_id property. + :rtype: ~azure.ai.contentunderstanding.aio.models.AnalyzeAsyncLROPoller[~azure.ai.contentunderstanding.models.AnalyzeResult] + :raises ~azure.core.exceptions.HttpResponseError: + + .. note:: + The string_encoding parameter is automatically set to "codePoint" for Python as it + matches Python's native string indexing behavior (len() and str[i] use code points). + This ensures ContentSpan offsets work correctly with Python string slicing. + """ + # Set string_encoding to "codePoint" (matches Python's string indexing) + kwargs["string_encoding"] = "codePoint" + + # Call parent implementation + poller = await super().begin_analyze_binary( + analyzer_id=analyzer_id, + binary_input=binary_input, + processing_location=processing_location, + input_range=input_range, + content_type=content_type, + **kwargs, + ) + + # Wrap in custom poller with .operation_id property + return AnalyzeAsyncLROPoller( + self._client, + poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access + poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access + poller._polling_method, # pylint: disable=protected-access + ) + + async def send_request( + self, request: HttpRequest, *, stream: bool = False, **kwargs: Any + ) -> AsyncHttpResponse: + """Runs the network request through the client's chained policies. + + >>> from azure.core.rest import HttpRequest + >>> request = HttpRequest("GET", "https://www.example.org/") + + >>> response = await client.send_request(request) + + + 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.AsyncHttpResponse + """ + return await super().send_request(request, stream=stream, **kwargs) + + async def close(self) -> None: + """Close the client session.""" + await super().close() + + async def __aenter__(self) -> Self: + await super().__aenter__() + return self + + async def __aexit__(self, *exc_details: Any) -> None: + await super().__aexit__(*exc_details) def patch_sdk(): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/__init__.py new file mode 100644 index 000000000000..a9093967c884 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/__init__.py @@ -0,0 +1,11 @@ +# 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. +# -------------------------------------------------------------------------- +"""Async models for Azure Content Understanding.""" + +from ._patch import AnalyzeAsyncLROPoller + +__all__ = ["AnalyzeAsyncLROPoller"] + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py new file mode 100644 index 000000000000..e58438817384 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py @@ -0,0 +1,97 @@ +# 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. +# -------------------------------------------------------------------------- +"""Customize generated code here. + +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +""" +import re +from typing import Any, Mapping, TypeVar +from azure.core.polling import AsyncLROPoller, AsyncPollingMethod + +PollingReturnType_co = TypeVar("PollingReturnType_co", covariant=True) + +__all__ = ["AnalyzeAsyncLROPoller"] + + +def _parse_operation_id(operation_location_header: str) -> str: + """Parse operation ID from Operation-Location header for analyze operations. + + :param operation_location_header: The Operation-Location header value + :type operation_location_header: str + :return: The extracted operation ID + :rtype: str + :raises ValueError: If operation ID cannot be extracted + """ + # Pattern: https://endpoint/.../analyzerResults/{operation_id}?api-version=... + regex = r".*/analyzerResults/([^?/]+)" + + match = re.search(regex, operation_location_header) + if not match: + raise ValueError(f"Could not extract operation ID from: {operation_location_header}") + + return match.group(1) + + +class AnalyzeAsyncLROPoller(AsyncLROPoller[PollingReturnType_co]): + """Custom AsyncLROPoller for Content Understanding analyze operations. + + Provides access to the operation ID for tracking and diagnostics. + """ + + @property + def operation_id(self) -> str: + """Returns the operation ID for this long-running operation. + + The operation ID can be used with get_result_file() to retrieve + intermediate or final result files from the service. + + :return: The operation ID + :rtype: str + :raises ValueError: If the operation ID cannot be extracted + """ + try: + operation_location = self._polling_method._initial_response.http_response.headers["Operation-Location"] # type: ignore # pylint: disable=protected-access + return _parse_operation_id(operation_location) + except (KeyError, ValueError) as e: + raise ValueError(f"Could not extract operation ID: {str(e)}") from e + + @classmethod + async def from_continuation_token( + cls, + polling_method: AsyncPollingMethod[PollingReturnType_co], + continuation_token: str, + **kwargs: Any, + ) -> "AnalyzeAsyncLROPoller": + """Create a poller from a continuation token. + + :param polling_method: The polling strategy to adopt + :type polling_method: ~azure.core.polling.AsyncPollingMethod + :param continuation_token: An opaque continuation token + :type continuation_token: str + :return: An instance of AnalyzeAsyncLROPoller + :rtype: AnalyzeAsyncLROPoller + :raises ~azure.core.exceptions.HttpResponseError: If the continuation token is invalid. + """ + ( + client, + initial_response, + deserialization_callback, + ) = await polling_method.from_continuation_token(continuation_token, **kwargs) + + return cls(client, initial_response, deserialization_callback, polling_method) + + +def patch_sdk(): + """Do not remove from this file. + + `patch_sdk` is a last resort escape hatch that allows you to do customizations + you can't accomplish using the techniques described in + https://aka.ms/azsdk/python/dpcodegen/python/customize + + :return: None + :rtype: None + """ + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py index fd918326d1af..cc86db4005cf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/operations/_patch.py @@ -8,74 +8,8 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -import re -from typing import Any -from azure.core.polling import AsyncLROPoller -from ... import models as _models -__all__ = ["AnalyzeAsyncLROPoller"] - - -def _parse_operation_id(operation_location_header: str) -> str: - """Parse operation ID from Operation-Location header for analyze operations. - - :param operation_location_header: The Operation-Location header value - :type operation_location_header: str - :return: The extracted operation ID - :rtype: str - :raises ValueError: If operation ID cannot be extracted - """ - # Pattern: https://endpoint/.../analyzerResults/{operation_id}?api-version=... - regex = r".*/analyzerResults/([^?/]+)" - - match = re.search(regex, operation_location_header) - if not match: - raise ValueError(f"Could not extract operation ID from: {operation_location_header}") - - return match.group(1) - - -class AnalyzeAsyncLROPoller(AsyncLROPoller[_models.AnalyzeResult]): - """Custom AsyncLROPoller for Content Understanding analyze operations with details property.""" - - @property - def details(self) -> dict[str, Any]: - """Get operation details including operation ID. - - :return: Dictionary containing operation details - :rtype: dict[str, Any] - :raises ValueError: If operation details cannot be extracted - """ - try: - initial_response = self._polling_method._initial_response # type: ignore[attr-defined] # pylint: disable=protected-access - operation_location = initial_response.http_response.headers.get("Operation-Location") - if not operation_location: - raise ValueError("No Operation-Location header found in initial response") - - operation_id = _parse_operation_id(operation_location) - return { - "operation_id": operation_id, - } - except Exception as e: - raise ValueError(f"Could not extract operation details: {e}") from e - - @classmethod - async def from_continuation_token( - cls, polling_method: Any, continuation_token: str, **kwargs: Any - ) -> "AnalyzeAsyncLROPoller": - """Create a new poller from a continuation token. - - :param polling_method: The polling method to use - :type polling_method: Any - :param continuation_token: The continuation token - :type continuation_token: str - :return: A new AnalyzeAsyncLROPoller instance - :rtype: AnalyzeAsyncLROPoller - """ - client, initial_response, deserialization_callback = await polling_method.from_continuation_token( - continuation_token, **kwargs - ) - return cls(client, initial_response, deserialization_callback, polling_method) +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index 0fe7f0099331..72451ccdb4eb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -7,7 +7,9 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import Optional, Any, Dict, List, Union, TYPE_CHECKING +import re +from typing import Optional, Any, Dict, List, Union, TYPE_CHECKING, Mapping, TypeVar +from azure.core.polling import LROPoller, PollingMethod from ._models import ( StringField, IntegerField, @@ -21,6 +23,8 @@ ContentField, ) +PollingReturnType_co = TypeVar("PollingReturnType_co", covariant=True) + # Type stub to help mypy and pyright understand that ContentField has a .value property if TYPE_CHECKING: @@ -45,6 +49,7 @@ def value( __all__ = [ "RecordMergePatchUpdate", + "AnalyzeLROPoller", "StringField", "IntegerField", "NumberField", @@ -61,6 +66,71 @@ def value( RecordMergePatchUpdate = Dict[str, str] +def _parse_operation_id(operation_location_header: str) -> str: + """Parse operation ID from Operation-Location header for analyze operations. + + :param operation_location_header: The Operation-Location header value + :type operation_location_header: str + :return: The extracted operation ID + :rtype: str + :raises ValueError: If operation ID cannot be extracted + """ + # Pattern: https://endpoint/.../analyzerResults/{operation_id}?api-version=... + regex = r".*/analyzerResults/([^?/]+)" + + match = re.search(regex, operation_location_header) + if not match: + raise ValueError(f"Could not extract operation ID from: {operation_location_header}") + + return match.group(1) + + +class AnalyzeLROPoller(LROPoller[PollingReturnType_co]): + """Custom LROPoller for Content Understanding analyze operations. + + Provides access to the operation ID for tracking and diagnostics. + """ + + @property + def operation_id(self) -> str: + """Returns the operation ID for this long-running operation. + + The operation ID can be used with get_result_file() to retrieve + intermediate or final result files from the service. + + :return: The operation ID + :rtype: str + :raises ValueError: If the operation ID cannot be extracted + """ + try: + operation_location = self.polling_method()._initial_response.http_response.headers["Operation-Location"] # type: ignore # pylint: disable=protected-access + return _parse_operation_id(operation_location) + except (KeyError, ValueError) as e: + raise ValueError(f"Could not extract operation ID: {str(e)}") from e + + @classmethod + def from_continuation_token( + cls, polling_method: PollingMethod[PollingReturnType_co], continuation_token: str, **kwargs: Any + ) -> "AnalyzeLROPoller": + """Create a poller from a continuation token. + + :param polling_method: The polling strategy to adopt + :type polling_method: ~azure.core.polling.PollingMethod + :param continuation_token: An opaque continuation token + :type continuation_token: str + :return: An instance of AnalyzeLROPoller + :rtype: AnalyzeLROPoller + :raises ~azure.core.exceptions.HttpResponseError: If the continuation token is invalid. + """ + ( + client, + initial_response, + deserialization_callback, + ) = polling_method.from_continuation_token(continuation_token, **kwargs) + + return cls(client, initial_response, deserialization_callback, polling_method) + + def _add_value_property_to_field(field_class: type, value_attr: str) -> None: """Add a .value property to a field class that returns the appropriate attribute.""" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py index e8c6a10759f6..cc86db4005cf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/operations/_patch.py @@ -8,79 +8,8 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -import re -from typing import Any, Mapping, TypeVar -from azure.core.polling import LROPoller, PollingMethod -PollingReturnType_co = TypeVar("PollingReturnType_co", covariant=True) - -__all__ = ["AnalyzeLROPoller"] - - -def _parse_operation_id(operation_location_header: str) -> str: - """Parse operation ID from Operation-Location header for analyze operations. - - :param operation_location_header: The Operation-Location header value - :type operation_location_header: str - :return: The extracted operation ID - :rtype: str - :raises ValueError: If operation ID cannot be extracted - """ - # Pattern: https://endpoint/.../analyzerResults/{operation_id}?api-version=... - regex = r".*/analyzerResults/([^?/]+)" - - match = re.search(regex, operation_location_header) - if not match: - raise ValueError(f"Could not extract operation ID from: {operation_location_header}") - - return match.group(1) - - -class AnalyzeLROPoller(LROPoller[PollingReturnType_co]): - """Custom LROPoller for Content Understanding analyze operations. - - Provides access to operation details including the operation ID. - """ - - @property - def details(self) -> Mapping[str, Any]: - """Returns metadata associated with the long-running operation. - - :return: Returns metadata associated with the long-running operation. - :rtype: Mapping[str, Any] - """ - try: - operation_location = self.polling_method()._initial_response.http_response.headers["Operation-Location"] # type: ignore # pylint: disable=protected-access - operation_id = _parse_operation_id(operation_location) - return {"operation_id": operation_id, "operation_type": "analyze"} - except (KeyError, ValueError) as e: - return { - "operation_id": None, - "operation_type": "analyze", - "error": f"Could not extract operation details: {str(e)}", - } - - @classmethod - def from_continuation_token( - cls, polling_method: PollingMethod[PollingReturnType_co], continuation_token: str, **kwargs: Any - ) -> "AnalyzeLROPoller": - """Create a poller from a continuation token. - - :param polling_method: The polling strategy to adopt - :type polling_method: ~azure.core.polling.PollingMethod - :param continuation_token: An opaque continuation token - :type continuation_token: str - :return: An instance of AnalyzeLROPoller - :rtype: AnalyzeLROPoller - :raises ~azure.core.exceptions.HttpResponseError: If the continuation token is invalid. - """ - ( - client, - initial_response, - deserialization_callback, - ) = polling_method.from_continuation_token(continuation_token, **kwargs) - - return cls(client, initial_response, deserialization_callback, polling_method) +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): From f994805ee32444b2a409f732309b21554c0d6d70 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 20:57:08 +0000 Subject: [PATCH 008/105] SAMPLE: Add new sample for analyzing PDF documents using prebuilt-documentSearch - Introduced `analyze_binary.py` to demonstrate asynchronous content extraction from PDF files. - Added multiple sample PDF files for testing, including IRS forms and bank statements. - Created README.md files in sample directories to guide users on file requirements and usage for training custom models. --- .../samples/analyze_binary.py | 131 + .../samples/sample_files/IRS_1040_test.pdf | Bin 0 -> 137588 bytes .../samples/sample_files/README.md | 19 + .../sample_files/mixed_financial_docs.pdf | Bin 0 -> 266116 bytes .../sample_files/sample_bank_statement.pdf | Bin 0 -> 91324 bytes .../samples/sample_files/sample_invoice.pdf | Bin 0 -> 151363 bytes .../sample_files/sample_loan_application.pdf | Bin 0 -> 25428 bytes .../training_samples/IRS_1040_1_09.pdf | Bin 0 -> 72306 bytes .../IRS_1040_1_09.pdf.labels.json | 271 + .../IRS_1040_1_09.pdf.result.json | 23555 ++++++++++++++++ .../training_samples/IRS_1040_1_10.pdf | Bin 0 -> 72080 bytes .../IRS_1040_1_10.pdf.labels.json | 184 + .../IRS_1040_1_10.pdf.result.json | 23507 +++++++++++++++ .../sample_files/training_samples/README.md | 53 + 14 files changed, 47720 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/IRS_1040_test.pdf create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/README.md create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/mixed_financial_docs.pdf create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_bank_statement.pdf create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_invoice.pdf create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_loan_application.pdf create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf.labels.json create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf.result.json create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf.labels.json create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf.result.json create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/README.md diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary.py new file mode 100644 index 000000000000..c3a88a3de588 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary.py @@ -0,0 +1,131 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: use the prebuilt-documentSearch to extract content from a PDF. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python analyze_binary.py +""" + +from __future__ import annotations + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeResult, + MediaContent, + DocumentContent, + MediaContentKind, +) +from sample_helper import save_json_to_file +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Extract content from PDF using begin_analyze_binary API +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Read a PDF file from disk +# 3. Analyze the document using begin_analyze_binary with prebuilt-documentSearch +# 4. Print the markdown content from the analysis result +# +# prebuilt-documentSearch is an AI-enhanced analyzer that extends prebuilt-document with: +# - Document summarization: Returns a "Summary" field with AI-generated document summaries +# - Figure analysis: Extracts descriptions and analyzes figures in documents (enableFigureDescription, enableFigureAnalysis) +# - Enhanced output: Provides more detailed analysis results (returnDetails: true) +# - AI completion model: Uses gpt-4.1-mini for intelligent content extraction + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + with open("sample_files/sample_invoice.pdf", "rb") as f: + pdf_bytes: bytes = f.read() + + print("Analyzing sample_files/sample_invoice.pdf with prebuilt-documentSearch...") + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=pdf_bytes, + ) + result: AnalyzeResult = await poller.result() + + # AnalyzeResult contains the full analysis result and can be used to access various properties + # We are using markdown content as an example of what can be extracted + print("\nMarkdown Content:") + print("=" * 50) + # A PDF file has only one content element even if it contains multiple pages + content: MediaContent = result.contents[0] + print(content.markdown) + print("=" * 50) + + # Check if this is document content to access document-specific properties + if content.kind == MediaContentKind.DOCUMENT: + # Type assertion: we know this is DocumentContent for PDF files + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f"Start page: {document_content.start_page_number}") + print(f"End page: {document_content.end_page_number}") + print(f"Total pages: {document_content.end_page_number - document_content.start_page_number + 1}") + + # Check for pages + if document_content.pages is not None: + print(f"\nPages ({len(document_content.pages)}):") + for i, page in enumerate(document_content.pages): + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + + # The following code shows how to access DocumentContent properties + # Check if there are tables in the document + if document_content.tables is not None: + print(f"\nTables ({len(document_content.tables)}):") + table_counter = 1 + # Iterate through tables, each table is of type DocumentTable + for table in document_content.tables: + # Type: table is DocumentTable + # Get basic table dimensions + row_count: int = table.row_count + col_count: int = table.column_count + print(f" Table {table_counter}: {row_count} rows x {col_count} columns") + table_counter += 1 + # You can use the table object model to get detailed information + # such as cell content, borders, spans, etc. (not shown to keep code concise) + else: + print("\nDocument Information: Not available for this content type") + + # Uncomment the following line to save the response to a file for object model inspection + # Note: This saves the object model, not the raw JSON response + # To get the full raw JSON response, see the sample: analyze_binary_raw_json.py + # save_json_to_file(result.as_dict(), filename_prefix="analyze_binary") + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/IRS_1040_test.pdf b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/IRS_1040_test.pdf new file mode 100644 index 0000000000000000000000000000000000000000..8f36a000c21f6750e5d239ff07d1fd7e6ccc97d7 GIT binary patch literal 137588 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 R7>vwX4lywe1I@J@{|AmfFkt`y literal 0 HcmV?d00001 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/README.md new file mode 100644 index 000000000000..34b9dbc7c74f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/README.md @@ -0,0 +1,19 @@ +# Sample Files + +This directory should contain sample files for testing: + +- `sample_invoice.pdf` - Sample invoice for document analysis + +## Where to Get Sample Files + +You can use any PDF, image, or video file for testing. For example: +- Download a sample invoice from: https://github.com/Azure-Samples/cognitive-services-REST-api-samples/tree/master/curl/form-recognizer +- Or use your own test files + +## Usage + +Samples expect files in this directory: +- `content_analyzers_analyze_binary.py` - Uses `sample_invoice.pdf` +- `content_analyzers_analyze_binary_raw_json.py` - Uses `sample_invoice.pdf` + +Place your test files here and update the sample code if needed. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/mixed_financial_docs.pdf b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/mixed_financial_docs.pdf new file mode 100644 index 0000000000000000000000000000000000000000..2c6d57818e11daea3fcd4731f081ae4b30419e97 GIT binary patch literal 266116 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 HB>MjViMOv9 literal 0 HcmV?d00001 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_bank_statement.pdf b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_bank_statement.pdf new file mode 100644 index 0000000000000000000000000000000000000000..d9f42cded0bcade4a94229ed1375db74601928b8 GIT binary patch literal 91324 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 X1mO1HEs2wbodbkPO)VlPiur#4?g9K) literal 0 HcmV?d00001 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_invoice.pdf b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_invoice.pdf new file mode 100644 index 0000000000000000000000000000000000000000..812bcd9b30f3bce77b4e68fbd66d43a7cbba6bd4 GIT binary patch literal 151363 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 literal 0 HcmV?d00001 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf new file mode 100644 index 0000000000000000000000000000000000000000..5bf91c29d102a65f5c8b5144437cbc6831044c49 GIT binary patch literal 72306 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 A00000 literal 0 HcmV?d00001 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf.labels.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf.labels.json new file mode 100644 index 000000000000..4c6f5a43827a --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf.labels.json @@ -0,0 +1,271 @@ +{ + "$schema": "https://schema.ai.azure.com/mmi/2025-11-01/labels.json", + "fileId": "", + "fieldLabels": { + "FieldYourFirstNameAndMiddleInitial": { + "type": "string", + "valueString": "Robert", + "spans": [ + { + "offset": 643, + "length": 6 + } + ], + "confidence": null, + "source": "D(1,0.5209,1.5946,0.891,1.5951,0.891,1.7131,0.5208,1.7126)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"Robert\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[0.5378,1.6136,0.894,1.6136,0.894,1.6947,0.5378,1.6947]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "FieldYourFirstNameAndMiddleInitialLastName": { + "type": "string", + "valueString": "Morgan", + "spans": [ + { + "offset": 659, + "length": 6 + } + ], + "confidence": null, + "source": "D(1,3.3307,1.5988,3.7464,1.5995,3.7464,1.7258,3.3304,1.7251)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"Morgan\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[3.3517,1.6148000000000002,3.7348,1.6148000000000002,3.7348,1.7195,3.3517,1.7195]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "FieldWagesSalariesTipsEtcAttachFormSW2": { + "type": "string", + "valueString": "200", + "spans": [ + { + "offset": 3111, + "length": 3 + } + ], + "confidence": null, + "source": "D(1,7.7811,4.9491,7.9743,4.9498,7.9743,5.0562,7.7808,5.0561)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"200\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[7.7956,4.9625,7.9834,4.9625,7.9834,5.042,7.7956,5.042]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "CheckboxYouAsADependent": { + "type": "boolean", + "valueBoolean": false, + "spans": [ + { + "offset": 1682, + "length": 1 + } + ], + "confidence": null, + "source": "D(1,2.5194,3.3517,2.6496,3.3513,2.6499,3.4789,2.5199,3.4801)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"selectionMark\",\"content\":\"unselected\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[2.5167,3.3476999999999997,2.646,3.3476999999999997,2.646,3.4743999999999997,2.5167,3.4743999999999997]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "TableDependents": { + "type": "array", + "kind": "confirmed", + "valueArray": [ + { + "type": "object", + "kind": "confirmed", + "valueObject": { + "FirstNameLastName": { + "type": "string", + "valueString": "Milsa Hill", + "spans": [ + { + "offset": 2308, + "length": 5 + }, + { + "offset": 2323, + "length": 4 + } + ], + "confidence": null, + "source": "D(1,1.6571,4.2795,1.9479,4.281,1.9479,4.39,1.657,4.39);D(1,2.4014,4.2759,2.5788,4.2748,2.5788,4.3882,2.4012,4.3885)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"Milsa Hill\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[1.6776,4.2943,1.9401,4.2943,1.9401,4.3752,1.6776,4.3752]},{\"pageNumber\":1,\"polygon\":[2.4188,4.2943,2.5691,4.2943,2.5691,4.3742,2.4188,4.3742]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "SocialSecurityNumber": { + "type": "string", + "valueString": "052000520", + "spans": [ + { + "offset": 2369, + "length": 9 + } + ], + "confidence": null, + "source": "D(1,3.7242,4.2691,4.8753,4.2682,4.8753,4.3964,3.7245,4.3968)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"052000520\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[3.7412,4.2948,4.8754,4.2948,4.8754,4.3744,3.7412,4.3744]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "RelationshipToYou": { + "type": "string", + "valueString": "friend", + "spans": [ + { + "offset": 2400, + "length": 6 + } + ], + "confidence": null, + "source": "D(1,5.1475,4.2727,5.473,4.2735,5.473,4.3928,5.1471,4.3932)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"friend\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[5.1619,4.2942,5.4573,4.2942,5.4573,4.3753,5.1619,4.3753]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "CheckboxChildTaxCredit": { + "type": "boolean", + "valueBoolean": false, + "spans": [ + { + "offset": 2416, + "length": 1 + } + ], + "confidence": null, + "source": "D(1,6.2857,4.2707,6.4116,4.2711,6.4118,4.3937,6.2861,4.3938)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"selectionMark\",\"content\":\"unselected\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[6.2821,4.2707,6.4092,4.2707,6.4092,4.3918,6.2821,4.3918]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "CheckboxCreditForOtherDependents": { + "type": "boolean", + "valueBoolean": false, + "spans": [ + { + "offset": 2437, + "length": 1 + } + ], + "confidence": null, + "source": "D(1,7.3876,4.2704,7.512,4.2713,7.5122,4.3957,7.3879,4.3952)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"selectionMark\",\"content\":\"unselected\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[7.383,4.2673,7.5211,4.2673,7.5211,4.3988,7.383,4.3988]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + } + } + }, + { + "type": "object", + "kind": "confirmed", + "valueObject": { + "FirstNameLastName": { + "type": "string", + "valueString": "Amanda Hill", + "spans": [ + { + "offset": 2505, + "length": 6 + }, + { + "offset": 2533, + "length": 4 + } + ], + "confidence": null, + "source": "D(1,1.6252,4.4411,2.0752,4.4436,2.0752,4.5598,1.6249,4.5594);D(1,2.4055,4.4425,2.5889,4.4404,2.5884,4.5529,2.4053,4.554)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"Amanda Hill\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[1.6384,4.4608,2.0697,4.4608,2.0697,4.5419,1.6384,4.5419]},{\"pageNumber\":1,\"polygon\":[2.4248,4.4609,2.5751,4.4609,2.5751,4.5408,2.4248,4.5408]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "SocialSecurityNumber": { + "type": "string", + "valueString": "520852000", + "spans": [ + { + "offset": 2569, + "length": 9 + } + ], + "confidence": null, + "source": "D(1,3.7255,4.4367,4.8753,4.4373,4.8753,4.5625,3.7256,4.5631)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"520852000\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[3.7448,4.4612,4.8754,4.4612,4.8754,4.5411,3.7448,4.5411]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "RelationshipToYou": { + "type": "string", + "valueString": "friend", + "spans": [ + { + "offset": 2600, + "length": 6 + } + ], + "confidence": null, + "source": "D(1,5.1753,4.4387,5.5007,4.4393,5.5007,4.5588,5.175,4.5587)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"friend\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[5.1928,4.4608,5.4882,4.4608,5.4882,4.5419,5.1928,4.5419]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "CheckboxChildTaxCredit": { + "type": "boolean", + "valueBoolean": false, + "spans": [ + { + "offset": 2616, + "length": 1 + } + ], + "confidence": null, + "source": "D(1,6.285,4.4367,6.4112,4.4374,6.4112,4.5605,6.2854,4.5601)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"selectionMark\",\"content\":\"unselected\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[6.2811,4.4349,6.4104,4.4349,6.4104,4.5622,6.2811,4.5622]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "CheckboxCreditForOtherDependents": { + "type": "boolean", + "valueBoolean": false, + "spans": [ + { + "offset": 2637, + "length": 1 + } + ], + "confidence": null, + "source": "D(1,7.3868,4.4371,7.5112,4.4376,7.5109,4.5625,7.3871,4.5611)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"selectionMark\",\"content\":\"unselected\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[7.3834,4.4318,7.5172,4.4318,7.5172,4.5631,7.3834,4.5631]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + } + } + } + ] + } + }, + "metadata": {} +} \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf.result.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf.result.json new file mode 100644 index 000000000000..e63b5be7ca9d --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_09.pdf.result.json @@ -0,0 +1,23555 @@ +{ + "id": "935b72c5-26e8-463e-a32a-0286dc9e1fbb", + "status": "Succeeded", + "result": { + "analyzerId": "prebuilt-documentSearch", + "apiVersion": "2025-11-01", + "createdAt": "2025-11-17T05:30:52Z", + "warnings": [], + "contents": [ + { + "path": "input1", + "markdown": "\n\n\n\n\n\n\nFiling Status\nCheck only\none box.\n\n☑\nSingle\n☐\nMarried filing jointly\n☐\nMarried filing separately (MFS)\n☐\nHead of household (HOH)\n☐\nQualifying widow(er) (QW)\n\nIf you checked the MFS box, enter the name of your spouse. If you checked the HOH or QW box, enter the child's name if the qualifying\nperson is a child but not your dependent\n\nYour first name and middle initial\nRobert\n\nLast name\nMorgan\n\nYour social security number\n0 8 5 5 0 6 1 1 0\n\nIf joint return, spouse's first name and middle initial\n\nLast name\n\nSpouse's social security number\n\nHome address (number and street). If you have a P.O. box, see instructions.\n254 W 78TH LOS ANGELES CA 90003-2459 USA\n\nApt. no.\n254\n\nCity, town, or post office. If you have a foreign address, also complete spaces below.\n10107 1/4 WILMINGTON LOS ANGELES CA 90002-2984 USA\n\nState\nLA\n\nZIP code\n10107\n\nForeign country name\nN/A\n\nForeign province/state/county\nN/A\n\nForeign postal code\nN/A\n\nPresidential Election Campaign\nCheck here if you, or your\nspouse if filing jointly, want $3\nto go to this fund. Checking a\nbox below will not change\nyour tax or refund.\n\n☐\nYou\n☐\nSpouse\n\nAt any time during 2020, did you receive, sell, send, exchange, or otherwise acquire any financial interest in any virtual currency?\n\n☑\nYes\n☐\nNo\n\nStandard\nDeduction\n\nSomeone can claim:\n\n☐\nYou as a dependent\n☐\nYour spouse as a dependent\n☐\nSpouse itemizes on a separate return or you were a dual-status alien\n\nAge/Blindness\n\nYou:\n\n☐\nWere born before January 2, 1956\n☑\nAre blind\n\nSpouse:\n\n☐\nWas born before January 2, 1956\n☐\nIs blind\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Dependents If more than four dependents, see instructions and check here ☐(see instructions): (1) First nameLast name(2) Social security number(3) Relationship to you(4) ✓ if qualifies for Child tax credit(see instructions): Credit for other dependents
MilsaHill052000520friend☐☐
AmandaHill5 2 08 52 0 0 0friend☐☐
☐☐
☐☐
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Attach Sch. B if required.1 Wages, salaries, tips, etc. Attach Form(s) W-21200
2a Tax-exempt interest . .2a100b Taxable interest2b300
3a Qualified dividends . . .3a200b Ordinary dividends3b200
4a IRA distributions4a300b Taxable amount4b100
5a Pensions and annuities . .5a200b Taxable amount5b400
Standard Deduction for- . Single or Married filing separately, $12,400 . Married filing jointly or Qualifying widow(er), $24,800 . Head of household, $18,650 . If you checked any box under Standard Deduction, see instructions.6a Social security benefits .6a100 b Taxable amount6b500
7 Capital gain or (loss). Attach Schedule D if required. If not required, check here ☐7100
8 Other income from Schedule 1, line 98180
9 Add lines 1, 2b, 3b, 4b, 5b, 6b, 7, and 8. This is your total income91980
10 Adjustments to income:400
a From Schedule 1, line 2210a200
b Charitable contributions if you take the standard deduction. See instructions10b200
c Add lines 10a and 10b. These are your total adjustments to income10c
11 Subtract line 10c from line 9. This is your adjusted gross income111880
12 Standard deduction or itemized deductions (from Schedule A)12100
13 Qualified business income deduction. Attach Form 8995 or Form 8995-A13200
14 Add lines 12 and 1314500
15 Taxable income. Subtract line 14 from line 11. If zero or less, enter -0-15510
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
16 Tax (see instructions). Check if any from Form(s): 1 ☐ 8814 2 ☑ 4972 3 ☐ . .16100
17 Amount from Schedule 2, line 317100
18 Add lines 16 and 1718100
19 Child tax credit or credit for other dependents19100
20 Amount from Schedule 3, line 720100
21 Add lines 19 and 2021110
22 Subtract line 21 from line 18. If zero or less, enter -0-221100
23 Other taxes, including self-employment tax, from Schedule 2, line 1023110
24 Add lines 22 and 23. This is your total tax24100
25 Federal income tax withheld from:300
a Form(s) W-225a100
b Form(s) 109925b100
c Other forms (see instructions)25c100
d Add lines 25a through 25c25d
. If you have a qualifying child, attach Sch. EIC. . If you have nontaxable combat pay, see instructions.26 2020 estimated tax payments and amount applied from 2019 return26100
27 Earned income credit (EIC)272001600
28 Additional child tax credit. Attach Schedule 881228300
29 American opportunity credit from Form 8863, line 829400
30 Recovery rebate credit. See instructions30500
31 Amount from Schedule 3, line 1331200
32 Add lines 27 through 31. These are your total other payments and refundable credits32
33 Add lines 25d, 26, and 32. These are your total payments332000
Refund Direct deposit? See instructions.34 If line 33 is more than line 24, subtract line 24 from line 33. This is the amount you overpaid . .34200
35a a Amount of line 34 you want refunded to you. If Form 8888 is attached, check here ☐ . . .35a300
b Routing number 520555555 c Type: ☑ Checking ☐ Savings
d Account number 12333365478901200
36 6 Amount of line 34 you want applied to your 2021 estimated tax361200
Amount You Owe For details on how to pay, see instructions.37 Subtract line 33 from line 24. This is the amount you owe now . . . . . . . . .37230
Note: Schedule H and Schedule SE filers, line 37 may not represent all of the taxes you owe for
2020. See Schedule 3, line 12e, and its instructions for details.
38 Estimated tax penalty (see instructions)38231
\n\n\n# Third Party Designee\n\nDo you want to allow another person to discuss this return with the IRS? See\ninstructions\n\n☑\nYes. Complete below.\n☐\nNo\n\nDesignee's\nname\nJoy Morgan\n\nPhone\nno.\n321875280\n\nPersonal identification\nnumber (PIN)\n35480\n\n\n## Sign Here\n\nUnder penalties of perjury, I declare that I have examined this return and accompanying schedules and statements, and to the best of my knowledge and\nbelief, they are true, correct, and complete. Declaration of preparer (other than taxpayer) is based on all information of which preparer has any knowledge.\n\nYour signature\nRobert morgan\n\nDate\n12/10/1986\n\nYour occupation\nJudge\n\nIf the IRS sent you an Identity\nProtection PIN, enter it here\n(see inst.)\n520000\n\nJoint return?\nSee instructions.\nKeep a copy for\nyour records.\n\nSpouse's signature. If a joint return, both must sign.\n\nDate\n\nSpouse's occupation\n\nIf the IRS sent your spouse an\nIdentity Protection PIN, enter it here\n(see inst.)\n\nPhone no.\n00141386305445\n\nEmail address robert99@gmail.com.us\n\n\n# Paid Preparer Use Only\n\nPreparer's name\nMark Kelly\n\nPreparer's signature\nmark Kelly\n\nDate\n10/20/1990\n\nPTIN\n09870\n\nCheck if:\n\n☐\nSelf-employed\n\nFirm's name\nANM company\n\nPhone no.\n8760765000876\n\nFirm's address\n9220 BELHAVEN LOS ANGELES CA 90002-2009 USA\n\nFirm's EIN\n080686\n\n\n\n", + "fields": { + "Summary": { + "type": "string", + "valueString": "This document is a completed 2020 U.S. Individual Income Tax Return Form 1040 for Robert Morgan, filing as Single. It includes personal information, filing status, dependents, income details, tax calculations, payments, refund and amount owed, third party designee authorization, and preparer information. The form shows Robert is blind, received virtual currency, and has wages, interest, dividends, IRA distributions, pensions, and other income. Tax, credits, payments, and refund details are provided along with direct deposit information. The form is signed by Robert Morgan and prepared by Mark Kelly.", + "spans": [ + { + "offset": 17, + "length": 4 + }, + { + "offset": 22, + "length": 4 + }, + { + "offset": 308, + "length": 13 + }, + { + "offset": 322, + "length": 10 + }, + { + "offset": 333, + "length": 8 + }, + { + "offset": 343, + "length": 1 + }, + { + "offset": 345, + "length": 6 + }, + { + "offset": 352, + "length": 1 + }, + { + "offset": 354, + "length": 22 + }, + { + "offset": 377, + "length": 1 + }, + { + "offset": 379, + "length": 31 + }, + { + "offset": 411, + "length": 1 + }, + { + "offset": 413, + "length": 23 + }, + { + "offset": 437, + "length": 1 + }, + { + "offset": 439, + "length": 25 + }, + { + "offset": 642, + "length": 34 + }, + { + "offset": 677, + "length": 6 + }, + { + "offset": 685, + "length": 9 + }, + { + "offset": 695, + "length": 6 + }, + { + "offset": 703, + "length": 27 + }, + { + "offset": 731, + "length": 17 + }, + { + "offset": 1554, + "length": 1 + }, + { + "offset": 1556, + "length": 3 + }, + { + "offset": 1560, + "length": 1 + }, + { + "offset": 1562, + "length": 2 + }, + { + "offset": 1743, + "length": 4 + }, + { + "offset": 1749, + "length": 1 + }, + { + "offset": 1751, + "length": 32 + }, + { + "offset": 1784, + "length": 1 + }, + { + "offset": 1786, + "length": 9 + }, + { + "offset": 1882, + "length": 10 + }, + { + "offset": 1893, + "length": 7 + }, + { + "offset": 1901, + "length": 9 + }, + { + "offset": 1911, + "length": 11 + }, + { + "offset": 1923, + "length": 16 + }, + { + "offset": 1940, + "length": 9 + }, + { + "offset": 1950, + "length": 4 + }, + { + "offset": 1955, + "length": 1 + }, + { + "offset": 2227, + "length": 5 + }, + { + "offset": 2242, + "length": 4 + }, + { + "offset": 2276, + "length": 9 + }, + { + "offset": 2344, + "length": 6 + }, + { + "offset": 2360, + "length": 4 + }, + { + "offset": 2374, + "length": 5 + }, + { + "offset": 2389, + "length": 3 + }, + { + "offset": 2402, + "length": 7 + }, + { + "offset": 2419, + "length": 6 + }, + { + "offset": 2685, + "length": 6 + }, + { + "offset": 2692, + "length": 9 + }, + { + "offset": 2702, + "length": 9 + }, + { + "offset": 2733, + "length": 1 + }, + { + "offset": 2735, + "length": 46 + }, + { + "offset": 2802, + "length": 3 + }, + { + "offset": 2862, + "length": 2 + }, + { + "offset": 2939, + "length": 3 + }, + { + "offset": 3001, + "length": 2 + }, + { + "offset": 3080, + "length": 3 + }, + { + "offset": 3146, + "length": 3 + }, + { + "offset": 3209, + "length": 3 + }, + { + "offset": 3284, + "length": 3 + }, + { + "offset": 3347, + "length": 3 + }, + { + "offset": 3620, + "length": 2 + }, + { + "offset": 3623, + "length": 24 + }, + { + "offset": 3648, + "length": 1 + }, + { + "offset": 3683, + "length": 3 + }, + { + "offset": 3687, + "length": 16 + }, + { + "offset": 3725, + "length": 3 + }, + { + "offset": 3761, + "length": 1 + }, + { + "offset": 3763, + "length": 82 + }, + { + "offset": 3846, + "length": 1 + }, + { + "offset": 3868, + "length": 3 + }, + { + "offset": 3904, + "length": 1 + }, + { + "offset": 3906, + "length": 36 + }, + { + "offset": 3963, + "length": 3 + }, + { + "offset": 3999, + "length": 1 + }, + { + "offset": 4001, + "length": 68 + }, + { + "offset": 4090, + "length": 4 + }, + { + "offset": 4127, + "length": 2 + }, + { + "offset": 4130, + "length": 22 + }, + { + "offset": 4232, + "length": 1 + }, + { + "offset": 4234, + "length": 24 + }, + { + "offset": 4281, + "length": 3 + }, + { + "offset": 4317, + "length": 1 + }, + { + "offset": 4319, + "length": 77 + }, + { + "offset": 4455, + "length": 1 + }, + { + "offset": 4457, + "length": 65 + }, + { + "offset": 4568, + "length": 2 + }, + { + "offset": 4571, + "length": 65 + }, + { + "offset": 4695, + "length": 2 + }, + { + "offset": 4698, + "length": 59 + }, + { + "offset": 4908, + "length": 3 + }, + { + "offset": 4988, + "length": 3 + }, + { + "offset": 5122, + "length": 3 + }, + { + "offset": 5481, + "length": 2 + }, + { + "offset": 5484, + "length": 52 + }, + { + "offset": 5537, + "length": 1 + }, + { + "offset": 5539, + "length": 4 + }, + { + "offset": 5544, + "length": 1 + }, + { + "offset": 5546, + "length": 1 + }, + { + "offset": 5548, + "length": 4 + }, + { + "offset": 5553, + "length": 1 + }, + { + "offset": 5555, + "length": 1 + }, + { + "offset": 5557, + "length": 1 + }, + { + "offset": 5559, + "length": 1 + }, + { + "offset": 5618, + "length": 2 + }, + { + "offset": 5621, + "length": 30 + }, + { + "offset": 5673, + "length": 3 + }, + { + "offset": 5709, + "length": 2 + }, + { + "offset": 5712, + "length": 19 + }, + { + "offset": 5753, + "length": 3 + }, + { + "offset": 5789, + "length": 2 + }, + { + "offset": 5792, + "length": 47 + }, + { + "offset": 5861, + "length": 3 + }, + { + "offset": 5897, + "length": 2 + }, + { + "offset": 5900, + "length": 30 + }, + { + "offset": 5952, + "length": 3 + }, + { + "offset": 5988, + "length": 2 + }, + { + "offset": 5991, + "length": 19 + }, + { + "offset": 6032, + "length": 3 + }, + { + "offset": 6068, + "length": 2 + }, + { + "offset": 6071, + "length": 57 + }, + { + "offset": 6187, + "length": 2 + }, + { + "offset": 6190, + "length": 68 + }, + { + "offset": 6280, + "length": 3 + }, + { + "offset": 6316, + "length": 2 + }, + { + "offset": 6319, + "length": 43 + }, + { + "offset": 6384, + "length": 3 + }, + { + "offset": 6524, + "length": 1 + }, + { + "offset": 6526, + "length": 11 + }, + { + "offset": 6560, + "length": 3 + }, + { + "offset": 6584, + "length": 1 + }, + { + "offset": 6586, + "length": 12 + }, + { + "offset": 6621, + "length": 3 + }, + { + "offset": 6645, + "length": 1 + }, + { + "offset": 6647, + "length": 30 + }, + { + "offset": 6700, + "length": 3 + }, + { + "offset": 6936, + "length": 2 + }, + { + "offset": 6939, + "length": 63 + }, + { + "offset": 7099, + "length": 3 + }, + { + "offset": 7221, + "length": 2 + }, + { + "offset": 7354, + "length": 3 + }, + { + "offset": 7443, + "length": 3 + }, + { + "offset": 7523, + "length": 3 + }, + { + "offset": 7559, + "length": 2 + }, + { + "offset": 7562, + "length": 83 + }, + { + "offset": 7771, + "length": 4 + }, + { + "offset": 7870, + "length": 2 + }, + { + "offset": 7873, + "length": 95 + }, + { + "offset": 7969, + "length": 1 + }, + { + "offset": 7971, + "length": 1 + }, + { + "offset": 8147, + "length": 3 + }, + { + "offset": 8183, + "length": 16 + }, + { + "offset": 8200, + "length": 9 + }, + { + "offset": 8210, + "length": 7 + }, + { + "offset": 8218, + "length": 1 + }, + { + "offset": 8220, + "length": 8 + }, + { + "offset": 8229, + "length": 1 + }, + { + "offset": 8231, + "length": 7 + }, + { + "offset": 8315, + "length": 16 + }, + { + "offset": 8332, + "length": 17 + }, + { + "offset": 8446, + "length": 2 + }, + { + "offset": 8576, + "length": 2 + }, + { + "offset": 8579, + "length": 61 + }, + { + "offset": 8641, + "length": 1 + }, + { + "offset": 8643, + "length": 1 + }, + { + "offset": 8645, + "length": 1 + }, + { + "offset": 8647, + "length": 1 + }, + { + "offset": 8649, + "length": 1 + }, + { + "offset": 8651, + "length": 1 + }, + { + "offset": 8653, + "length": 1 + }, + { + "offset": 8655, + "length": 1 + }, + { + "offset": 8657, + "length": 1 + }, + { + "offset": 8680, + "length": 3 + }, + { + "offset": 9027, + "length": 2 + }, + { + "offset": 9180, + "length": 1 + }, + { + "offset": 9182, + "length": 20 + }, + { + "offset": 9203, + "length": 1 + }, + { + "offset": 9205, + "length": 2 + }, + { + "offset": 9209, + "length": 10 + }, + { + "offset": 9220, + "length": 4 + }, + { + "offset": 9225, + "length": 10 + }, + { + "offset": 9237, + "length": 5 + }, + { + "offset": 9243, + "length": 3 + }, + { + "offset": 9247, + "length": 9 + }, + { + "offset": 9258, + "length": 23 + }, + { + "offset": 9282, + "length": 12 + }, + { + "offset": 9295, + "length": 5 + }, + { + "offset": 9625, + "length": 14 + }, + { + "offset": 9640, + "length": 13 + }, + { + "offset": 9655, + "length": 4 + }, + { + "offset": 9660, + "length": 10 + }, + { + "offset": 9672, + "length": 15 + }, + { + "offset": 9688, + "length": 5 + }, + { + "offset": 9695, + "length": 31 + }, + { + "offset": 9727, + "length": 29 + }, + { + "offset": 9757, + "length": 11 + }, + { + "offset": 9769, + "length": 6 + }, + { + "offset": 10032, + "length": 35 + }, + { + "offset": 10096, + "length": 15 + }, + { + "offset": 10112, + "length": 10 + }, + { + "offset": 10124, + "length": 20 + }, + { + "offset": 10145, + "length": 10 + }, + { + "offset": 10157, + "length": 4 + }, + { + "offset": 10162, + "length": 10 + }, + { + "offset": 10174, + "length": 4 + }, + { + "offset": 10179, + "length": 5 + }, + { + "offset": 10214, + "length": 11 + }, + { + "offset": 10226, + "length": 11 + }, + { + "offset": 10239, + "length": 9 + }, + { + "offset": 10249, + "length": 13 + }, + { + "offset": 10264, + "length": 14 + }, + { + "offset": 10279, + "length": 43 + }, + { + "offset": 10324, + "length": 10 + }, + { + "offset": 10335, + "length": 6 + } + ], + "confidence": 0.011, + "source": "D(1,0.5004,0.7733,0.5083,0.5317,0.5945,0.5291,0.5894,0.7712);D(1,0.6023,0.5032,1.2545,0.5046,1.2545,0.7684,0.6023,0.7686);D(1,0.4923,0.9121,1.2538,0.9142,1.2534,1.0547,0.4919,1.0526);D(1,0.4926,1.0759,1.0547,1.0794,1.0540,1.1971,0.4919,1.1936);D(1,0.4900,1.2045,0.9323,1.2007,0.9331,1.3003,0.4909,1.3041);D(1,1.3209,0.9393,1.4495,0.9393,1.4495,1.0641,1.3209,1.0635);D(1,1.4858,0.9399,1.8137,0.9421,1.8137,1.0617,1.4858,1.0596);D(1,1.9227,0.9399,2.0430,0.9379,2.0430,1.0615,1.9227,1.0628);D(1,2.0866,0.9321,3.0724,0.9403,3.0713,1.0689,2.0855,1.0607);D(1,3.2207,0.9393,3.3452,0.9393,3.3452,1.0635,3.2207,1.0635);D(1,3.3867,0.9349,4.8977,0.9369,4.8975,1.0656,3.3865,1.0636);D(1,5.0178,0.9379,5.1423,0.9379,5.1423,1.0648,5.0178,1.0648);D(1,5.1880,0.9344,6.4000,0.9357,6.3999,1.0602,5.1879,1.0589);D(1,6.5203,0.9386,6.6448,0.9386,6.6448,1.0648,6.5203,1.0648);D(1,6.6863,0.9346,7.9687,0.9343,7.9687,1.0686,6.6863,1.0690);D(1,0.5432,1.4439,1.9850,1.4448,1.9849,1.5527,0.5431,1.5518);D(1,0.5227,1.5986,0.8923,1.5981,0.8923,1.7083,0.5232,1.7085);D(1,3.3452,1.4483,3.8107,1.4514,3.8101,1.5492,3.3446,1.5461);D(1,3.3265,1.6012,3.7457,1.6076,3.7457,1.7308,3.3265,1.7246);D(1,6.5451,1.4453,7.8567,1.4443,7.8568,1.5533,6.5452,1.5544);D(1,6.5493,1.5805,7.9647,1.5815,7.9646,1.7255,6.5492,1.7246);D(1,6.9976,3.1501,7.1221,3.1501,7.1221,3.2737,6.9976,3.2737);D(1,7.1345,3.1501,7.3379,3.1506,7.3379,3.2520,7.1345,3.2521);D(1,7.4956,3.1394,7.6201,3.1475,7.6201,3.2764,7.4956,3.2656);D(1,7.6409,3.1543,7.7986,3.1534,7.7986,3.2517,7.6409,3.2570);D(1,1.2949,3.7796,1.5444,3.7809,1.5439,3.8897,1.2943,3.8884);D(1,1.6228,3.7598,1.7463,3.7625,1.7463,3.8914,1.6228,3.8887);D(1,1.7863,3.7707,3.4760,3.7645,3.4765,3.8966,1.7867,3.9028);D(1,3.6108,3.7490,3.7520,3.7544,3.7520,3.8914,3.6108,3.8833);D(1,3.7855,3.7668,4.2488,3.7798,4.2455,3.8996,3.7821,3.8866);D(1,0.4947,3.9619,1.2545,3.9584,1.2545,4.0896,0.4949,4.0936);D(1,0.4910,4.1530,0.8518,4.1548,0.8513,4.2604,0.4905,4.2586);D(1,0.4890,4.2769,0.9510,4.2768,0.9510,4.3826,0.4890,4.3827);D(1,0.4923,4.4016,1.1144,4.4016,1.1144,4.5090,0.4923,4.5090);D(1,0.4903,4.5247,1.2577,4.5257,1.2576,4.6309,0.4902,4.6299);D(1,0.4916,4.6427,1.0208,4.6444,1.0205,4.7517,0.4913,4.7500);D(1,0.4923,4.7642,0.7248,4.7642,0.7248,4.8608,0.4923,4.8608);D(1,0.8923,4.7507,1.0236,4.7507,1.0236,4.8743,0.8923,4.8743);D(1,1.6602,4.2820,1.9476,4.2811,1.9476,4.3858,1.6602,4.3867);D(1,2.3969,4.2810,2.5836,4.2784,2.5836,4.3851,2.3969,4.3826);D(1,3.7271,4.2735,4.8684,4.2736,4.8684,4.3879,3.7271,4.3914);D(1,1.6301,4.4446,2.0742,4.4446,2.0742,4.5520,1.6301,4.5520);D(1,2.4072,4.4446,2.5898,4.4446,2.5898,4.5509,2.4072,4.5494);D(1,3.7264,4.4395,4.0461,4.4377,4.0468,4.5569,3.7271,4.5587);D(1,4.1115,4.4372,4.3101,4.4380,4.3096,4.5575,4.1110,4.5567);D(1,4.3790,4.4376,4.8701,4.4449,4.8684,4.5648,4.3772,4.5575);D(1,5.1755,4.4446,5.5034,4.4446,5.5034,4.5520,5.1755,4.5520);D(1,0.5149,5.0784,0.8327,5.0784,0.8327,5.1804,0.5154,5.1804);D(1,0.5185,5.2182,0.9298,5.2207,0.9292,5.3288,0.5179,5.3263);D(1,0.5159,5.3599,0.9434,5.3607,0.9432,5.4685,0.5157,5.4678);D(1,1.3395,4.9629,1.3956,4.9629,1.3956,5.0572,1.3395,5.0565);D(1,1.5844,4.9492,3.8682,4.9492,3.8682,5.0755,1.5844,5.0755);D(1,7.7861,4.9521,7.9646,4.9521,7.9646,5.0515,7.7861,5.0515);D(1,3.2788,5.1281,3.4158,5.1393,3.4158,5.2360,3.2788,5.2248);D(1,7.7861,5.1248,7.9646,5.1141,7.9646,5.2200,7.7861,5.2295);D(1,3.2788,5.3056,3.4158,5.3050,3.4158,5.4013,3.2788,5.4021);D(1,7.7861,5.2825,7.9646,5.2825,7.9646,5.3845,7.7861,5.3845);D(1,4.2666,5.4513,4.4700,5.4454,4.4700,5.5534,4.2666,5.5584);D(1,7.7903,5.4525,7.9687,5.4516,7.9687,5.5594,7.7903,5.5598);D(1,4.2666,5.6128,4.4617,5.6128,4.4617,5.7202,4.2666,5.7202);D(1,7.7861,5.6147,7.9687,5.6131,7.9687,5.7202,7.7861,5.7202);D(1,1.3292,5.7954,1.4661,5.7954,1.4661,5.8975,1.3292,5.8975);D(1,1.5875,5.7888,2.7517,5.7886,2.7517,5.9088,1.5875,5.9090);D(1,3.0093,5.8725,3.0216,5.8725,3.0216,5.8849,3.0093,5.8849);D(1,4.2749,5.7840,4.4617,5.7701,4.4617,5.8775,4.2749,5.8914);D(1,4.6899,5.7899,5.6531,5.7930,5.6528,5.9059,4.6895,5.9028);D(1,7.7861,5.7865,7.9646,5.7862,7.9646,5.8936,7.7861,5.8939);D(1,1.3312,5.9565,1.4028,5.9565,1.4028,6.0532,1.3312,6.0532);D(1,1.5906,5.9454,5.5036,5.9517,5.5034,6.0828,1.5904,6.0764);D(1,6.4580,5.9351,6.5825,5.9404,6.5825,6.0586,6.4580,6.0586);D(1,7.7903,5.9512,7.9687,5.9512,7.9687,6.0527,7.7903,6.0530);D(1,1.3271,6.1284,1.4080,6.1284,1.4080,6.2251,1.3271,6.2251);D(1,1.5888,6.1019,3.4607,6.1215,3.4592,6.2626,1.5874,6.2431);D(1,7.7861,6.1131,7.9687,6.1163,7.9687,6.2126,7.7861,6.2165);D(1,1.3292,6.2949,1.4018,6.2949,1.4018,6.3916,1.3292,6.3916);D(1,1.5875,6.2785,4.8894,6.2839,4.8892,6.4132,1.5873,6.4078);D(1,7.7239,6.2796,7.9646,6.2794,7.9646,6.3869,7.7239,6.3870);D(1,1.2752,6.4614,1.4008,6.4614,1.4008,6.5581,1.2752,6.5581);D(1,1.5854,6.4470,2.7768,6.4488,2.7766,6.5792,1.5852,6.5774);D(1,1.3935,6.6423,1.4672,6.6438,1.4672,6.7298,1.3935,6.7283);D(1,1.5865,6.6226,2.8409,6.6226,2.8409,6.7407,1.5865,6.7407);D(1,6.4663,6.6172,6.6655,6.6172,6.6655,6.7246,6.4663,6.7246);D(1,1.3893,6.8052,1.4661,6.8052,1.4661,6.9019,1.3893,6.9019);D(1,1.5875,6.7937,5.2668,6.7937,5.2668,6.9133,1.5875,6.9133);D(1,1.4042,6.9925,1.4609,6.9925,1.4609,7.0530,1.4042,7.0530);D(1,1.5834,6.9517,5.0305,6.9573,5.0303,7.0821,1.5832,7.0766);D(1,1.2711,7.1328,1.3987,7.1328,1.3987,7.2295,1.2711,7.2295);D(1,1.5875,7.1157,4.8685,7.1171,4.8684,7.2466,1.5874,7.2452);D(1,1.2794,7.2939,1.4080,7.2939,1.4080,7.3906,1.2794,7.3906);D(1,1.5854,7.2826,4.8103,7.2804,4.8104,7.4102,1.5855,7.4124);D(1,7.7861,7.4488,7.9646,7.4454,7.9646,7.5507,7.7861,7.5473);D(1,7.7778,7.6155,7.9646,7.6142,7.9646,7.7183,7.7778,7.7183);D(1,7.7778,7.7765,7.9687,7.7734,7.9687,7.8754,7.7778,7.8786);D(2,1.2700,0.5455,1.4039,0.5453,1.4039,0.6479,1.2700,0.6473);D(2,1.5823,0.5340,4.0592,0.5361,4.0591,0.6689,1.5822,0.6667);D(2,4.1213,0.5358,4.2417,0.5334,4.2417,0.6590,4.1213,0.6630);D(2,4.2957,0.5457,4.5488,0.5442,4.5488,0.6481,4.2957,0.6487);D(2,4.6899,0.5530,4.7605,0.5522,4.7605,0.6468,4.6899,0.6470);D(2,4.8269,0.5351,4.9431,0.5354,4.9431,0.6590,4.8269,0.6586);D(2,4.9888,0.5450,5.2502,0.5441,5.2502,0.6483,4.9888,0.6479);D(2,5.4038,0.5525,5.4619,0.5519,5.4619,0.6431,5.4038,0.6439);D(2,5.5242,0.5358,5.6487,0.5344,5.6487,0.6583,5.5242,0.6610);D(2,6.3414,0.6281,6.3522,0.6281,6.3522,0.6389,6.3414,0.6389);D(2,6.5081,0.6281,6.5189,0.6281,6.5189,0.6389,6.5081,0.6389);D(2,1.2721,0.7130,1.4039,0.7127,1.4039,0.8144,1.2721,0.8144);D(2,1.5823,0.6992,3.1631,0.7057,3.1626,0.8321,1.5818,0.8256);D(2,7.7861,0.7007,7.9646,0.7011,7.9646,0.8012,7.7861,0.8003);D(2,1.2742,0.8805,1.4039,0.8799,1.4039,0.9786,1.2742,0.9792);D(2,1.5823,0.8697,2.5920,0.8710,2.5919,0.9872,1.5822,0.9859);D(2,7.7861,0.8632,7.9646,0.8677,7.9646,0.9694,7.7861,0.9646);D(2,1.2742,1.0462,1.4018,1.0445,1.4018,1.1427,1.2742,1.1457);D(2,1.5823,1.0332,3.8747,1.0387,3.8744,1.1610,1.5820,1.1555);D(2,7.7861,1.0312,7.9687,1.0312,7.9687,1.1347,7.7861,1.1341);D(2,1.2669,1.2083,1.4018,1.2094,1.4018,1.3112,1.2669,1.3119);D(2,1.5792,1.1988,3.1626,1.1988,3.1626,1.3202,1.5792,1.3202);D(2,7.7861,1.2003,7.9687,1.2007,7.9687,1.3051,7.7861,1.3039);D(2,1.2669,1.3767,1.3956,1.3780,1.3956,1.4811,1.2669,1.4801);D(2,1.5822,1.3688,2.5919,1.3677,2.5920,1.4859,1.5823,1.4870);D(2,7.7861,1.3653,7.9687,1.3655,7.9687,1.4680,7.7861,1.4674);D(2,1.2679,1.5411,1.4080,1.5431,1.4080,1.6439,1.2679,1.6423);D(2,1.5803,1.5326,4.2085,1.5381,4.2082,1.6623,1.5800,1.6568);D(2,1.2700,1.7107,1.4080,1.7090,1.4080,1.8111,1.2700,1.8097);D(2,1.5863,1.7021,5.0012,1.6969,5.0014,1.8237,1.5865,1.8289);D(2,7.7861,1.7010,7.9687,1.6967,7.9687,1.7961,7.7861,1.8004);D(2,1.2700,1.8779,1.4059,1.8839,1.4059,1.9847,1.2700,1.9786);D(2,1.5792,1.8688,3.6815,1.8703,3.6814,1.9974,1.5791,1.9959);D(2,7.7861,1.8679,7.9687,1.8726,7.9687,1.9747,7.7861,1.9704);D(2,1.3904,2.2393,1.4641,2.2328,1.4641,2.3149,1.3904,2.3200);D(2,1.5884,2.2072,2.2142,2.2064,2.2144,2.3310,1.5886,2.3319);D(2,6.4871,2.1995,6.6655,2.1997,6.6655,2.3015,6.4871,2.3015);D(2,1.3893,2.3837,1.4641,2.3835,1.4641,2.4782,1.3893,2.4783);D(2,1.5875,2.3727,2.2496,2.3730,2.2495,2.4979,1.5874,2.4976);D(2,6.4871,2.3673,6.6655,2.3673,6.6655,2.4724,6.4871,2.4707);D(2,1.4042,2.5759,1.4609,2.5759,1.4609,2.6363,1.4042,2.6363);D(2,1.5865,2.5357,3.0632,2.5379,3.0630,2.6651,1.5863,2.6629);D(2,6.4871,2.5266,6.6738,2.5263,6.6738,2.6299,6.4871,2.6303);D(2,1.2659,2.8762,1.4039,2.8762,1.4039,2.9836,1.2659,2.9836);D(2,1.5864,2.8701,4.9639,2.8674,4.9640,2.9962,1.5865,2.9989);D(2,6.4663,3.0308,6.6655,3.0317,6.6655,3.1337,6.4663,3.1329);D(2,5.4744,3.2115,5.6155,3.2099,5.6155,3.3086,5.4744,3.3086);D(2,6.4705,3.3690,6.6655,3.3681,6.6655,3.4701,6.4705,3.4710);D(2,6.4746,3.5353,6.6655,3.5369,6.6655,3.6389,6.4746,3.6374);D(2,6.4663,3.6933,6.6655,3.6999,6.6655,3.8019,6.4663,3.7953);D(2,1.2679,3.8752,1.4039,3.8752,1.4039,3.9773,1.2679,3.9773);D(2,1.5813,3.8614,5.9435,3.8633,5.9434,3.9936,1.5812,3.9917);D(2,7.7156,4.0337,7.9646,4.0337,7.9646,4.1411,7.7156,4.1411);D(2,1.2648,4.2020,1.4080,4.2180,1.4080,4.3206,1.2648,4.3017);D(2,1.5813,4.2021,6.1468,4.2049,6.1467,4.3327,1.5812,4.3299);D(2,6.3426,4.2892,6.3549,4.2892,6.3549,4.3016,6.3426,4.3016);D(2,6.5092,4.2892,6.5216,4.2892,6.5216,4.3016,6.5092,4.3016);D(2,7.7778,4.3612,7.9646,4.3618,7.9646,4.4692,7.7778,4.4686);D(2,1.2918,4.5349,2.3641,4.5395,2.3636,4.6649,1.2913,4.6603);D(2,2.4010,4.5037,4.2002,4.5037,4.2002,4.6513,2.4010,4.6511);D(2,4.6070,4.5377,5.0916,4.5507,5.0883,4.6716,4.6037,4.6586);D(2,5.2336,4.5386,5.3582,4.5359,5.3582,4.6567,5.2336,4.6594);D(2,5.3914,4.5417,5.8728,4.5479,5.8728,4.6608,5.3914,4.6566);D(2,6.0347,4.5359,6.1633,4.5359,6.1633,4.6594,6.0347,4.6567);D(2,6.1924,4.5401,6.5950,4.5410,6.5950,4.6604,6.1924,4.6585);D(2,1.2918,4.7012,2.3663,4.7071,2.3657,4.8232,1.2912,4.8173);D(2,2.3969,4.6525,5.8022,4.6629,5.8022,4.8278,2.3969,4.8234);D(2,5.4744,4.8689,5.6238,4.8689,5.6238,4.9763,5.4744,4.9763);D(2,1.2679,5.0596,1.4008,5.0596,1.4008,5.1616,1.2679,5.1616);D(2,1.5875,5.0563,4.7357,5.0588,4.7356,5.1861,1.5874,5.1836);D(2,5.0092,5.1424,5.0216,5.1424,5.0216,5.1547,5.0092,5.1547);D(2,5.1759,5.1424,5.1882,5.1424,5.1882,5.1547,5.1759,5.1547);D(2,5.3426,5.1424,5.3549,5.1424,5.3549,5.1547,5.3426,5.1547);D(2,5.5092,5.1424,5.5216,5.1424,5.5216,5.1547,5.5092,5.1547);D(2,5.6759,5.1424,5.6882,5.1424,5.6882,5.1547,5.6759,5.1547);D(2,5.8426,5.1424,5.8549,5.1424,5.8549,5.1547,5.8426,5.1547);D(2,6.0092,5.1424,6.0216,5.1424,6.0216,5.1547,6.0092,5.1547);D(2,6.1759,5.1424,6.1882,5.1424,6.1882,5.1547,6.1759,5.1547);D(2,6.3426,5.1424,6.3549,5.1424,6.3549,5.1547,6.3426,5.1547);D(2,7.7861,5.0328,7.9646,5.0315,7.9646,5.1362,7.7861,5.1375);D(2,5.4827,5.5430,5.6155,5.5430,5.6155,5.6464,5.4827,5.6447);D(2,5.6902,5.8223,5.8105,5.8223,5.8105,5.9512,5.6902,5.9512);D(2,5.8396,5.8438,6.9519,5.8438,6.9519,5.9619,5.8396,5.9619);D(2,7.0930,5.8384,7.2175,5.8384,7.2175,5.9673,7.0930,5.9673);D(2,7.2466,5.8491,7.3960,5.8491,7.3960,5.9565,7.2466,5.9565);D(2,1.3914,6.0141,1.8843,6.0133,1.8843,6.1208,1.3914,6.1215);D(2,1.3873,6.1582,1.6456,6.1549,1.6456,6.2409,1.3873,6.2441);D(2,2.4467,6.0641,2.9182,6.0660,2.9177,6.1787,2.4462,6.1768);D(2,4.1877,6.0164,4.4824,6.0213,4.4824,6.1179,4.1877,6.1131);D(2,4.1920,6.1511,4.3397,6.1554,4.3372,6.2420,4.1895,6.2377);D(2,4.7563,6.0785,5.1797,6.0791,5.1797,6.1758,4.7563,6.1752);D(2,5.9890,6.0086,6.9648,6.0122,6.9644,6.1183,5.9886,6.1147);D(2,5.9850,6.1284,6.5673,6.1364,6.5658,6.2437,5.9836,6.2358);D(2,6.9976,6.0803,8.0020,6.0755,8.0020,6.2474,6.9976,6.2522);D(2,1.3905,6.5997,2.0403,6.6073,2.0389,6.7265,1.3891,6.7189);D(2,2.4273,6.6777,3.3569,6.6901,3.3534,6.9536,2.4238,6.9412);D(2,3.8453,6.6049,4.0591,6.6074,4.0591,6.7041,3.8453,6.7015);D(2,3.8267,6.7783,4.4326,6.7783,4.4326,6.8965,3.8267,6.8965);D(2,4.5482,6.5976,5.2793,6.5943,5.2799,6.7194,4.5488,6.7226);D(2,4.8352,6.8030,5.1755,6.8092,5.1755,6.9381,4.8352,6.9319);D(2,6.4414,6.5904,7.7158,6.5921,7.7156,6.7147,6.4412,6.7130);D(2,6.4414,6.7139,7.6533,6.7139,7.6533,6.8213,6.4414,6.8213);D(2,6.4373,6.8481,6.8647,6.8481,6.8647,6.9556,6.4373,6.9556);D(2,6.9976,6.8357,7.9937,6.8258,7.9937,7.0005,6.9976,7.0010);D(2,3.8451,7.4439,5.7939,7.4412,5.7941,7.5634,3.8453,7.5660);D(2,1.3874,7.5968,2.1256,7.6072,2.1239,7.7270,1.3857,7.7166);D(2,1.2877,7.7559,1.8625,7.7559,1.8625,7.8848,1.2877,7.8848);D(2,3.0382,7.6029,3.9365,7.6171,3.9345,7.7384,3.0363,7.7242);D(2,4.2044,7.6105,4.9947,7.6283,4.9888,7.8907,4.1984,7.8729);D(2,5.4453,7.6153,5.6611,7.6184,5.6611,7.7151,5.4453,7.7119);D(2,5.4744,7.7290,6.0720,7.7290,6.0720,7.8472,5.4744,7.8472);D(2,6.2754,7.6055,6.4995,7.6055,6.4995,7.7021,6.2754,7.7021);D(2,6.4373,7.7636,6.7527,7.7644,6.7527,7.8839,6.4373,7.8788);D(2,1.3893,7.9632,1.9428,7.9715,1.9413,8.0746,1.3878,8.0663);D(2,2.1206,7.9031,2.9150,7.9509,2.9060,8.1002,2.1117,8.0524);D(2,6.4383,7.9636,6.9016,7.9493,6.9053,8.0680,6.4419,8.0823);D(2,7.0474,7.9429,7.8691,7.9391,7.8691,8.0567,7.0474,8.0586);D(2,1.3897,8.1127,2.0554,8.1314,2.0522,8.2463,1.3865,8.2276);D(2,2.2306,8.1131,5.0469,8.1078,5.0471,8.2318,2.2308,8.2371);D(2,6.4413,8.1213,6.9062,8.1210,6.9063,8.2285,6.4414,8.2288);D(2,7.3254,8.1191,7.7114,8.1133,7.7114,8.2208,7.3254,8.2265)" + } + }, + "kind": "document", + "startPageNumber": 1, + "endPageNumber": 2, + "unit": "inch", + "pages": [ + { + "pageNumber": 1, + "angle": 0, + "width": 8.5, + "height": 11, + "spans": [ + { + "offset": 0, + "length": 5359 + } + ], + "words": [ + { + "content": "Form", + "span": { + "offset": 17, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,0.5004,0.7733,0.5083,0.5317,0.5945,0.5291,0.5894,0.7712)" + }, + { + "content": "1040", + "span": { + "offset": 22, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,0.6023,0.5032,1.2545,0.5046,1.2545,0.7684,0.6023,0.7686)" + }, + { + "content": "Department", + "span": { + "offset": 49, + "length": 10 + }, + "confidence": 0.992, + "source": "D(1,1.3427,0.5219,1.7899,0.5225,1.7915,0.6241,1.3447,0.623)" + }, + { + "content": "of", + "span": { + "offset": 60, + "length": 2 + }, + "confidence": 0.993, + "source": "D(1,1.8102,0.5226,1.8895,0.5227,1.891,0.6243,1.8118,0.6242)" + }, + { + "content": "the", + "span": { + "offset": 63, + "length": 3 + }, + "confidence": 0.981, + "source": "D(1,1.9047,0.5227,2.0262,0.5229,2.0276,0.6247,1.9062,0.6244)" + }, + { + "content": "Treasury", + "span": { + "offset": 67, + "length": 8 + }, + "confidence": 0.946, + "source": "D(1,2.0448,0.5229,2.3773,0.5232,2.3783,0.6246,2.0461,0.6247)" + }, + { + "content": "-", + "span": { + "offset": 75, + "length": 1 + }, + "confidence": 0.926, + "source": "D(1,2.3773,0.5232,2.4414,0.5232,2.4424,0.6246,2.3783,0.6246)" + }, + { + "content": "Internal", + "span": { + "offset": 76, + "length": 8 + }, + "confidence": 0.932, + "source": "D(1,2.4583,0.5232,2.73,0.5234,2.7307,0.6245,2.4592,0.6246)" + }, + { + "content": "Revenue", + "span": { + "offset": 85, + "length": 7 + }, + "confidence": 0.987, + "source": "D(1,2.7587,0.5234,3.0828,0.5234,3.0831,0.6235,2.7594,0.6244)" + }, + { + "content": "Service", + "span": { + "offset": 93, + "length": 7 + }, + "confidence": 0.987, + "source": "D(1,3.103,0.5234,3.395,0.5233,3.395,0.6226,3.1033,0.6234)" + }, + { + "content": "U", + "span": { + "offset": 101, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,1.3478,0.6452,1.4547,0.6454,1.4547,0.7961,1.3478,0.7958)" + }, + { + "content": ".", + "span": { + "offset": 102, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,1.4647,0.6454,1.4995,0.6454,1.4995,0.7962,1.4647,0.7961)" + }, + { + "content": "S", + "span": { + "offset": 103, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,1.5044,0.6454,1.6039,0.6456,1.6039,0.7964,1.5044,0.7962)" + }, + { + "content": ".", + "span": { + "offset": 104, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,1.6138,0.6456,1.6461,0.6457,1.6461,0.7966,1.6138,0.7965)" + }, + { + "content": "Individual", + "span": { + "offset": 106, + "length": 10 + }, + "confidence": 0.992, + "source": "D(1,1.7157,0.6458,2.4142,0.647,2.4142,0.798,1.7157,0.7967)" + }, + { + "content": "Income", + "span": { + "offset": 117, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,2.4763,0.6471,3.0132,0.6481,3.0132,0.7984,2.4763,0.798)" + }, + { + "content": "Tax", + "span": { + "offset": 124, + "length": 3 + }, + "confidence": 0.993, + "source": "D(1,3.0604,0.6482,3.3363,0.6487,3.3363,0.7981,3.0604,0.7984)" + }, + { + "content": "Return", + "span": { + "offset": 128, + "length": 6 + }, + "confidence": 0.995, + "source": "D(1,3.386,0.6488,3.8931,0.6497,3.8931,0.7975,3.386,0.7981)" + }, + { + "content": "(", + "span": { + "offset": 157, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.7354,0.5157,3.7694,0.5168,3.7695,0.6276,3.7354,0.626)" + }, + { + "content": "99", + "span": { + "offset": 158, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,3.7587,0.5165,3.8717,0.5179,3.8717,0.6296,3.7587,0.6271)" + }, + { + "content": ")", + "span": { + "offset": 160, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.8645,0.518,3.9076,0.5175,3.9076,0.6292,3.8646,0.6297)" + }, + { + "content": "2020", + "span": { + "offset": 184, + "length": 4 + }, + "confidence": 0.988, + "source": "D(1,4.1296,0.5329,4.8643,0.5315,4.8643,0.7722,4.1296,0.7734)" + }, + { + "content": "OMB", + "span": { + "offset": 211, + "length": 3 + }, + "confidence": 0.986, + "source": "D(1,4.939,0.6879,5.1656,0.6879,5.1656,0.7878,4.939,0.7875)" + }, + { + "content": "No", + "span": { + "offset": 215, + "length": 2 + }, + "confidence": 0.972, + "source": "D(1,5.1991,0.6879,5.3217,0.6879,5.3217,0.788,5.1991,0.7878)" + }, + { + "content": ".", + "span": { + "offset": 217, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,5.325,0.6879,5.3452,0.6879,5.3452,0.788,5.325,0.788)" + }, + { + "content": "1545-0074", + "span": { + "offset": 219, + "length": 9 + }, + "confidence": 0.978, + "source": "D(1,5.3787,0.6879,5.8521,0.6877,5.8521,0.7883,5.3787,0.788)" + }, + { + "content": "IRS", + "span": { + "offset": 251, + "length": 3 + }, + "confidence": 0.944, + "source": "D(1,5.9849,0.6988,6.1267,0.699,6.1267,0.8014,5.9849,0.8007)" + }, + { + "content": "Use", + "span": { + "offset": 255, + "length": 3 + }, + "confidence": 0.925, + "source": "D(1,6.1523,0.699,6.3009,0.6992,6.3009,0.8022,6.1523,0.8015)" + }, + { + "content": "Only", + "span": { + "offset": 259, + "length": 4 + }, + "confidence": 0.958, + "source": "D(1,6.3197,0.6993,6.4974,0.6995,6.4974,0.8031,6.3197,0.8023)" + }, + { + "content": "-", + "span": { + "offset": 263, + "length": 1 + }, + "confidence": 0.947, + "source": "D(1,6.5008,0.6995,6.5623,0.6996,6.5623,0.8034,6.5008,0.8031)" + }, + { + "content": "Do", + "span": { + "offset": 264, + "length": 2 + }, + "confidence": 0.971, + "source": "D(1,6.5759,0.6996,6.6853,0.6998,6.6853,0.8039,6.5759,0.8035)" + }, + { + "content": "not", + "span": { + "offset": 267, + "length": 3 + }, + "confidence": 0.939, + "source": "D(1,6.7092,0.6999,6.8322,0.7002,6.8322,0.8042,6.7092,0.8039)" + }, + { + "content": "write", + "span": { + "offset": 271, + "length": 5 + }, + "confidence": 0.935, + "source": "D(1,6.8459,0.7002,7.0321,0.7006,7.0321,0.8048,6.8459,0.8043)" + }, + { + "content": "or", + "span": { + "offset": 277, + "length": 2 + }, + "confidence": 0.939, + "source": "D(1,7.0526,0.7007,7.1346,0.7009,7.1346,0.805,7.0526,0.8048)" + }, + { + "content": "staple", + "span": { + "offset": 280, + "length": 6 + }, + "confidence": 0.716, + "source": "D(1,7.1499,0.7009,7.3789,0.7016,7.3789,0.8055,7.1499,0.8051)" + }, + { + "content": "in", + "span": { + "offset": 287, + "length": 2 + }, + "confidence": 0.878, + "source": "D(1,7.4028,0.7017,7.4643,0.7019,7.4643,0.8055,7.4028,0.8055)" + }, + { + "content": "this", + "span": { + "offset": 290, + "length": 4 + }, + "confidence": 0.721, + "source": "D(1,7.4848,0.702,7.6232,0.7025,7.6232,0.8056,7.4848,0.8055)" + }, + { + "content": "space", + "span": { + "offset": 295, + "length": 5 + }, + "confidence": 0.877, + "source": "D(1,7.6419,0.7026,7.8709,0.7034,7.8709,0.8058,7.6419,0.8056)" + }, + { + "content": ".", + "span": { + "offset": 300, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,7.8709,0.7034,7.8982,0.7035,7.8982,0.8058,7.8709,0.8058)" + }, + { + "content": "Filing", + "span": { + "offset": 308, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,0.4923,0.9132,0.814,0.9138,0.814,1.0535,0.4923,1.0523)" + }, + { + "content": "Status", + "span": { + "offset": 315, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,0.848,0.9139,1.2534,0.9142,1.2534,1.0515,0.848,1.0534)" + }, + { + "content": "Check", + "span": { + "offset": 322, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,0.4926,1.0769,0.8166,1.0789,0.8158,1.1956,0.4921,1.1936)" + }, + { + "content": "only", + "span": { + "offset": 328, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,0.84,1.079,1.0547,1.0794,1.0537,1.1956,0.8392,1.1957)" + }, + { + "content": "one", + "span": { + "offset": 333, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,0.49,1.2045,0.6754,1.2052,0.676,1.3022,0.491,1.3013)" + }, + { + "content": "box", + "span": { + "offset": 337, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,0.7111,1.2051,0.8981,1.2034,0.8982,1.3006,0.7117,1.3021)" + }, + { + "content": ".", + "span": { + "offset": 340, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,0.8998,1.2034,0.9323,1.203,0.9323,1.3002,0.8998,1.3006)" + }, + { + "content": "☑", + "span": { + "offset": 343, + "length": 1 + }, + "confidence": 0.963, + "source": "D(1,1.3209,0.9393,1.4495,0.9393,1.4495,1.0641,1.3209,1.0635)" + }, + { + "content": "Single", + "span": { + "offset": 345, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,1.4858,0.9399,1.8137,0.9421,1.8137,1.0617,1.4858,1.0596)" + }, + { + "content": "☐", + "span": { + "offset": 352, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,1.9227,0.9399,2.043,0.9379,2.043,1.0615,1.9227,1.0628)" + }, + { + "content": "Married", + "span": { + "offset": 354, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,2.0866,0.934,2.4707,0.9376,2.4707,1.0635,2.0866,1.0578)" + }, + { + "content": "filing", + "span": { + "offset": 362, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,2.5047,0.9378,2.7317,0.9393,2.7318,1.0661,2.5047,1.0638)" + }, + { + "content": "jointly", + "span": { + "offset": 369, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,2.7593,0.9394,3.0713,0.9403,3.0713,1.0677,2.7594,1.0663)" + }, + { + "content": "☐", + "span": { + "offset": 377, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,3.2207,0.9393,3.3452,0.9393,3.3452,1.0635,3.2207,1.0635)" + }, + { + "content": "Married", + "span": { + "offset": 379, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,3.3867,0.9369,3.7665,0.9367,3.7665,1.0635,3.3867,1.0617)" + }, + { + "content": "filing", + "span": { + "offset": 387, + "length": 6 + }, + "confidence": 0.992, + "source": "D(1,3.8022,0.9367,4.0267,0.9366,4.0267,1.0644,3.8022,1.0637)" + }, + { + "content": "separately", + "span": { + "offset": 394, + "length": 10 + }, + "confidence": 0.99, + "source": "D(1,4.0624,0.9366,4.5722,0.9367,4.5722,1.065,4.0624,1.0645)" + }, + { + "content": "(", + "span": { + "offset": 405, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.5995,0.9367,4.6352,0.9368,4.6352,1.065,4.5995,1.065)" + }, + { + "content": "MFS", + "span": { + "offset": 406, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,4.6373,0.9368,4.8513,0.9369,4.8513,1.0648,4.6373,1.065)" + }, + { + "content": ")", + "span": { + "offset": 409, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.8513,0.9369,4.8975,0.9369,4.8975,1.0648,4.8513,1.0648)" + }, + { + "content": "☐", + "span": { + "offset": 411, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,5.0178,0.9379,5.1423,0.9379,5.1423,1.0648,5.0178,1.0648)" + }, + { + "content": "Head", + "span": { + "offset": 413, + "length": 4 + }, + "confidence": 0.993, + "source": "D(1,5.188,0.9362,5.4398,0.9364,5.4398,1.0577,5.188,1.0565)" + }, + { + "content": "of", + "span": { + "offset": 418, + "length": 2 + }, + "confidence": 0.963, + "source": "D(1,5.4746,0.9364,5.5708,0.9365,5.5708,1.0583,5.4746,1.0578)" + }, + { + "content": "household", + "span": { + "offset": 421, + "length": 9 + }, + "confidence": 0.973, + "source": "D(1,5.5954,0.9365,6.0765,0.9362,6.0765,1.0597,5.5954,1.0584)" + }, + { + "content": "(", + "span": { + "offset": 431, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.1072,0.9362,6.144,0.9361,6.144,1.0598,6.1072,1.0597)" + }, + { + "content": "HOH", + "span": { + "offset": 432, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,6.142,0.9361,6.3569,0.9358,6.3569,1.0601,6.142,1.0598)" + }, + { + "content": ")", + "span": { + "offset": 435, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.359,0.9358,6.3999,0.9357,6.3999,1.0602,6.359,1.0601)" + }, + { + "content": "☐", + "span": { + "offset": 437, + "length": 1 + }, + "confidence": 0.979, + "source": "D(1,6.5203,0.9386,6.6448,0.9386,6.6448,1.0648,6.5203,1.0648)" + }, + { + "content": "Qualifying", + "span": { + "offset": 439, + "length": 10 + }, + "confidence": 0.995, + "source": "D(1,6.6863,0.9362,7.185,0.9349,7.185,1.0685,6.6863,1.0675)" + }, + { + "content": "widow", + "span": { + "offset": 450, + "length": 5 + }, + "confidence": 0.996, + "source": "D(1,7.2117,0.9349,7.5368,0.9344,7.5368,1.0687,7.2117,1.0685)" + }, + { + "content": "(", + "span": { + "offset": 455, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.5413,0.9344,7.5747,0.9344,7.5747,1.0687,7.5413,1.0687)" + }, + { + "content": "er", + "span": { + "offset": 456, + "length": 2 + }, + "confidence": 0.998, + "source": "D(1,7.5724,0.9344,7.6704,0.9344,7.6704,1.0687,7.5724,1.0687)" + }, + { + "content": ")", + "span": { + "offset": 458, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.6615,0.9344,7.6949,0.9344,7.6949,1.0687,7.6615,1.0687)" + }, + { + "content": "(", + "span": { + "offset": 460, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.7238,0.9344,7.7572,0.9344,7.7572,1.0686,7.7238,1.0687)" + }, + { + "content": "QW", + "span": { + "offset": 461, + "length": 2 + }, + "confidence": 0.997, + "source": "D(1,7.7505,0.9344,7.9354,0.9343,7.9354,1.0686,7.7505,1.0686)" + }, + { + "content": ")", + "span": { + "offset": 463, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.9264,0.9343,7.9687,0.9343,7.9687,1.0685,7.9264,1.0686)" + }, + { + "content": "If", + "span": { + "offset": 466, + "length": 2 + }, + "confidence": 0.944, + "source": "D(1,1.3167,1.1169,1.3893,1.1168,1.3893,1.2381,1.3167,1.2381)" + }, + { + "content": "you", + "span": { + "offset": 469, + "length": 3 + }, + "confidence": 0.99, + "source": "D(1,1.4079,1.1168,1.5863,1.1165,1.5863,1.2382,1.4079,1.2381)" + }, + { + "content": "checked", + "span": { + "offset": 473, + "length": 7 + }, + "confidence": 0.993, + "source": "D(1,1.6215,1.1164,2.0362,1.1157,2.0362,1.2382,1.6215,1.2382)" + }, + { + "content": "the", + "span": { + "offset": 481, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,2.0694,1.1157,2.227,1.1154,2.227,1.2382,2.0694,1.2382)" + }, + { + "content": "MFS", + "span": { + "offset": 485, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,2.2602,1.1154,2.4821,1.115,2.4821,1.2383,2.2602,1.2382)" + }, + { + "content": "box", + "span": { + "offset": 489, + "length": 3 + }, + "confidence": 0.989, + "source": "D(1,2.5194,1.1149,2.6998,1.1146,2.6998,1.2383,2.5194,1.2383)" + }, + { + "content": ",", + "span": { + "offset": 492, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,2.7019,1.1146,2.7267,1.1146,2.7267,1.2383,2.7019,1.2383)" + }, + { + "content": "enter", + "span": { + "offset": 494, + "length": 5 + }, + "confidence": 0.988, + "source": "D(1,2.7558,1.1145,3.017,1.1141,3.017,1.2383,2.7558,1.2383)" + }, + { + "content": "the", + "span": { + "offset": 500, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,3.0399,1.1141,3.1974,1.1138,3.1975,1.2384,3.0399,1.2383)" + }, + { + "content": "name", + "span": { + "offset": 504, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,3.2286,1.1138,3.5002,1.1133,3.5002,1.2384,3.2286,1.2384)" + }, + { + "content": "of", + "span": { + "offset": 509, + "length": 2 + }, + "confidence": 0.994, + "source": "D(1,3.5292,1.1132,3.6329,1.1132,3.6329,1.2384,3.5292,1.2384)" + }, + { + "content": "your", + "span": { + "offset": 512, + "length": 4 + }, + "confidence": 0.984, + "source": "D(1,3.6495,1.1132,3.8797,1.1131,3.8797,1.2384,3.6495,1.2384)" + }, + { + "content": "spouse", + "span": { + "offset": 517, + "length": 6 + }, + "confidence": 0.537, + "source": "D(1,3.9004,1.1131,4.2591,1.1129,4.2591,1.2385,3.9004,1.2384)" + }, + { + "content": ".", + "span": { + "offset": 523, + "length": 1 + }, + "confidence": 0.899, + "source": "D(1,4.2653,1.1129,4.2882,1.1129,4.2882,1.2385,4.2653,1.2385)" + }, + { + "content": "If", + "span": { + "offset": 525, + "length": 2 + }, + "confidence": 0.716, + "source": "D(1,4.3276,1.1129,4.3877,1.1129,4.3877,1.2385,4.3276,1.2385)" + }, + { + "content": "you", + "span": { + "offset": 528, + "length": 3 + }, + "confidence": 0.929, + "source": "D(1,4.4063,1.1128,4.5867,1.1128,4.5868,1.2385,4.4063,1.2385)" + }, + { + "content": "checked", + "span": { + "offset": 532, + "length": 7 + }, + "confidence": 0.97, + "source": "D(1,4.6199,1.1128,5.0346,1.1126,5.0346,1.2385,4.6199,1.2385)" + }, + { + "content": "the", + "span": { + "offset": 540, + "length": 3 + }, + "confidence": 0.991, + "source": "D(1,5.0657,1.1126,5.2233,1.1125,5.2233,1.2386,5.0657,1.2385)" + }, + { + "content": "HOH", + "span": { + "offset": 544, + "length": 3 + }, + "confidence": 0.961, + "source": "D(1,5.2627,1.1125,5.4908,1.1124,5.4908,1.2386,5.2627,1.2386)" + }, + { + "content": "or", + "span": { + "offset": 548, + "length": 2 + }, + "confidence": 0.957, + "source": "D(1,5.524,1.1123,5.6401,1.1123,5.6401,1.2386,5.524,1.2386)" + }, + { + "content": "QW", + "span": { + "offset": 551, + "length": 2 + }, + "confidence": 0.908, + "source": "D(1,5.665,1.1123,5.8454,1.1123,5.8454,1.2386,5.665,1.2386)" + }, + { + "content": "box", + "span": { + "offset": 554, + "length": 3 + }, + "confidence": 0.881, + "source": "D(1,5.8765,1.1123,6.0652,1.1125,6.0652,1.2386,5.8765,1.2386)" + }, + { + "content": ",", + "span": { + "offset": 557, + "length": 1 + }, + "confidence": 0.992, + "source": "D(1,6.059,1.1125,6.0859,1.1125,6.0859,1.2386,6.059,1.2386)" + }, + { + "content": "enter", + "span": { + "offset": 559, + "length": 5 + }, + "confidence": 0.985, + "source": "D(1,6.1129,1.1125,6.3742,1.1127,6.3742,1.2387,6.1129,1.2386)" + }, + { + "content": "the", + "span": { + "offset": 565, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,6.3265,1.1127,6.5629,1.1129,6.5629,1.2387,6.3265,1.2386)" + }, + { + "content": "child's", + "span": { + "offset": 569, + "length": 7 + }, + "confidence": 0.962, + "source": "D(1,6.5732,1.1129,6.8988,1.1131,6.8988,1.2387,6.5732,1.2387)" + }, + { + "content": "name", + "span": { + "offset": 577, + "length": 4 + }, + "confidence": 0.947, + "source": "D(1,6.932,1.1131,7.2078,1.1134,7.2078,1.2387,6.932,1.2387)" + }, + { + "content": "if", + "span": { + "offset": 582, + "length": 2 + }, + "confidence": 0.981, + "source": "D(1,7.2389,1.1134,7.3073,1.1134,7.3073,1.2387,7.2389,1.2387)" + }, + { + "content": "the", + "span": { + "offset": 585, + "length": 3 + }, + "confidence": 0.929, + "source": "D(1,7.3218,1.1134,7.5188,1.1136,7.5188,1.2387,7.3218,1.2387)" + }, + { + "content": "qualifying", + "span": { + "offset": 589, + "length": 10 + }, + "confidence": 0.874, + "source": "D(1,7.5001,1.1136,7.9854,1.114,7.9854,1.2388,7.5001,1.2387)" + }, + { + "content": "person", + "span": { + "offset": 600, + "length": 6 + }, + "confidence": 0.977, + "source": "D(1,1.3146,1.2652,1.6547,1.2631,1.6564,1.3829,1.3167,1.3829)" + }, + { + "content": "is", + "span": { + "offset": 607, + "length": 2 + }, + "confidence": 0.959, + "source": "D(1,1.6951,1.2629,1.77,1.2624,1.7716,1.3829,1.6968,1.3829)" + }, + { + "content": "a", + "span": { + "offset": 610, + "length": 1 + }, + "confidence": 0.948, + "source": "D(1,1.8024,1.2622,1.857,1.2618,1.8586,1.3829,1.804,1.3829)" + }, + { + "content": "child", + "span": { + "offset": 612, + "length": 5 + }, + "confidence": 0.935, + "source": "D(1,1.8915,1.2616,2.1202,1.2607,2.1214,1.3828,1.8929,1.3829)" + }, + { + "content": "but", + "span": { + "offset": 618, + "length": 3 + }, + "confidence": 0.965, + "source": "D(1,2.1586,1.2606,2.3145,1.2602,2.3155,1.3826,2.1598,1.3827)" + }, + { + "content": "not", + "span": { + "offset": 622, + "length": 3 + }, + "confidence": 0.944, + "source": "D(1,2.3468,1.2601,2.5047,1.2597,2.5056,1.3824,2.3479,1.3826)" + }, + { + "content": "your", + "span": { + "offset": 626, + "length": 4 + }, + "confidence": 0.928, + "source": "D(1,2.529,1.2597,2.7557,1.2595,2.7563,1.3821,2.5298,1.3824)" + }, + { + "content": "dependent", + "span": { + "offset": 631, + "length": 9 + }, + "confidence": 0.99, + "source": "D(1,2.7779,1.2595,3.3224,1.2601,3.3224,1.3812,2.7785,1.3821)" + }, + { + "content": "Your", + "span": { + "offset": 642, + "length": 4 + }, + "confidence": 0.983, + "source": "D(1,0.5432,1.445,0.7605,1.4448,0.7614,1.5512,0.5442,1.5506)" + }, + { + "content": "first", + "span": { + "offset": 647, + "length": 5 + }, + "confidence": 0.931, + "source": "D(1,0.7817,1.4448,0.9478,1.4446,0.9485,1.5517,0.7826,1.5513)" + }, + { + "content": "name", + "span": { + "offset": 653, + "length": 4 + }, + "confidence": 0.988, + "source": "D(1,0.9708,1.4446,1.2146,1.4445,1.2151,1.5521,0.9715,1.5517)" + }, + { + "content": "and", + "span": { + "offset": 658, + "length": 3 + }, + "confidence": 0.984, + "source": "D(1,1.2393,1.4445,1.4001,1.4445,1.4005,1.5523,1.2399,1.5521)" + }, + { + "content": "middle", + "span": { + "offset": 662, + "length": 6 + }, + "confidence": 0.972, + "source": "D(1,1.4266,1.4445,1.7252,1.4446,1.7254,1.5522,1.427,1.5523)" + }, + { + "content": "initial", + "span": { + "offset": 669, + "length": 7 + }, + "confidence": 0.977, + "source": "D(1,1.7552,1.4447,1.9849,1.4448,1.9849,1.5521,1.7554,1.5522)" + }, + { + "content": "Robert", + "span": { + "offset": 677, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,0.5227,1.5986,0.8923,1.5981,0.8923,1.7083,0.5232,1.7085)" + }, + { + "content": "Last", + "span": { + "offset": 685, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,3.3452,1.4505,3.5405,1.45,3.5405,1.5459,3.3452,1.5461)" + }, + { + "content": "name", + "span": { + "offset": 690, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,3.5631,1.4501,3.8101,1.4514,3.8101,1.548,3.5631,1.546)" + }, + { + "content": "Morgan", + "span": { + "offset": 695, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,3.3265,1.6012,3.7457,1.6076,3.7457,1.7308,3.3265,1.7246)" + }, + { + "content": "Your", + "span": { + "offset": 703, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,6.5452,1.447,6.7733,1.446,6.7733,1.5534,6.5452,1.5544)" + }, + { + "content": "social", + "span": { + "offset": 708, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,6.7946,1.4459,7.0673,1.4449,7.0673,1.5524,6.7946,1.5533)" + }, + { + "content": "security", + "span": { + "offset": 715, + "length": 8 + }, + "confidence": 0.996, + "source": "D(1,7.0976,1.4449,7.4718,1.4446,7.4718,1.552,7.0976,1.5523)" + }, + { + "content": "number", + "span": { + "offset": 724, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,7.495,1.4446,7.8567,1.4453,7.8567,1.5527,7.495,1.552)" + }, + { + "content": "0", + "span": { + "offset": 731, + "length": 1 + }, + "confidence": 0.832, + "source": "D(1,6.5493,1.5806,6.6258,1.5806,6.6258,1.7242,6.5493,1.7241)" + }, + { + "content": "8", + "span": { + "offset": 733, + "length": 1 + }, + "confidence": 0.873, + "source": "D(1,6.7143,1.5807,6.786,1.5807,6.786,1.7245,6.7143,1.7244)" + }, + { + "content": "5", + "span": { + "offset": 735, + "length": 1 + }, + "confidence": 0.877, + "source": "D(1,6.8768,1.5808,6.9486,1.5808,6.9486,1.7248,6.8768,1.7247)" + }, + { + "content": "5", + "span": { + "offset": 737, + "length": 1 + }, + "confidence": 0.878, + "source": "D(1,7.0442,1.5809,7.1159,1.5811,7.1159,1.7249,7.0442,1.7249)" + }, + { + "content": "0", + "span": { + "offset": 739, + "length": 1 + }, + "confidence": 0.844, + "source": "D(1,7.1996,1.5812,7.2737,1.5814,7.2737,1.7248,7.1996,1.7249)" + }, + { + "content": "6", + "span": { + "offset": 741, + "length": 1 + }, + "confidence": 0.876, + "source": "D(1,7.3693,1.5816,7.4387,1.5817,7.4387,1.7247,7.3693,1.7248)" + }, + { + "content": "1", + "span": { + "offset": 743, + "length": 1 + }, + "confidence": 0.877, + "source": "D(1,7.5438,1.582,7.5964,1.5821,7.5964,1.7244,7.5438,1.7245)" + }, + { + "content": "1", + "span": { + "offset": 745, + "length": 1 + }, + "confidence": 0.842, + "source": "D(1,7.7088,1.5825,7.7662,1.5827,7.7662,1.7239,7.7088,1.724)" + }, + { + "content": "0", + "span": { + "offset": 747, + "length": 1 + }, + "confidence": 0.877, + "source": "D(1,7.869,1.583,7.9646,1.5833,7.9646,1.7233,7.869,1.7236)" + }, + { + "content": "If", + "span": { + "offset": 750, + "length": 2 + }, + "confidence": 0.847, + "source": "D(1,0.5411,1.7729,0.6071,1.7726,0.6081,1.8855,0.5421,1.8855)" + }, + { + "content": "joint", + "span": { + "offset": 753, + "length": 5 + }, + "confidence": 0.818, + "source": "D(1,0.6222,1.7726,0.8127,1.7718,0.8137,1.8854,0.6232,1.8855)" + }, + { + "content": "return", + "span": { + "offset": 759, + "length": 6 + }, + "confidence": 0.983, + "source": "D(1,0.8429,1.7717,1.0919,1.7706,1.0927,1.8853,0.8438,1.8854)" + }, + { + "content": ",", + "span": { + "offset": 765, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,1.0995,1.7706,1.1202,1.7705,1.121,1.8853,1.1002,1.8853)" + }, + { + "content": "spouse's", + "span": { + "offset": 767, + "length": 8 + }, + "confidence": 0.956, + "source": "D(1,1.1523,1.7704,1.539,1.7695,1.5396,1.8848,1.153,1.8853)" + }, + { + "content": "first", + "span": { + "offset": 776, + "length": 5 + }, + "confidence": 0.936, + "source": "D(1,1.5673,1.7695,1.7333,1.7692,1.7338,1.8845,1.5678,1.8848)" + }, + { + "content": "name", + "span": { + "offset": 782, + "length": 4 + }, + "confidence": 0.924, + "source": "D(1,1.7616,1.7692,1.9992,1.7689,1.9996,1.8841,1.762,1.8845)" + }, + { + "content": "and", + "span": { + "offset": 787, + "length": 3 + }, + "confidence": 0.935, + "source": "D(1,2.0257,1.7688,2.1879,1.769,2.1882,1.8836,2.026,1.884)" + }, + { + "content": "middle", + "span": { + "offset": 791, + "length": 6 + }, + "confidence": 0.922, + "source": "D(1,2.2218,1.7691,2.5142,1.7695,2.5143,1.8827,2.2221,1.8835)" + }, + { + "content": "initial", + "span": { + "offset": 798, + "length": 7 + }, + "confidence": 0.8, + "source": "D(1,2.5425,1.7695,2.7745,1.7699,2.7745,1.8819,2.5426,1.8826)" + }, + { + "content": "Last", + "span": { + "offset": 807, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,3.3431,1.7809,3.5409,1.7816,3.5409,1.8783,3.3431,1.8776)" + }, + { + "content": "name", + "span": { + "offset": 812, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,3.5636,1.7817,3.8101,1.7836,3.8101,1.8803,3.5636,1.8784)" + }, + { + "content": "Spouse's", + "span": { + "offset": 818, + "length": 8 + }, + "confidence": 0.984, + "source": "D(1,6.5452,1.7712,6.9588,1.7708,6.9588,1.8836,6.5452,1.884)" + }, + { + "content": "social", + "span": { + "offset": 827, + "length": 6 + }, + "confidence": 0.994, + "source": "D(1,6.9831,1.7707,7.2477,1.7704,7.2477,1.8832,6.9831,1.8835)" + }, + { + "content": "security", + "span": { + "offset": 834, + "length": 8 + }, + "confidence": 0.982, + "source": "D(1,7.2756,1.7704,7.6353,1.77,7.6353,1.8828,7.2756,1.8832)" + }, + { + "content": "number", + "span": { + "offset": 843, + "length": 6 + }, + "confidence": 0.989, + "source": "D(1,7.6576,1.77,8.0061,1.7696,8.0061,1.8824,7.6576,1.8828)" + }, + { + "content": "Home", + "span": { + "offset": 851, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,0.5453,2.1096,0.8074,2.1089,0.8083,2.223,0.5463,2.2231)" + }, + { + "content": "address", + "span": { + "offset": 856, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,0.8342,2.1088,1.1843,2.1079,1.1852,2.2228,0.8351,2.223)" + }, + { + "content": "(", + "span": { + "offset": 864, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.2092,2.1078,1.2398,2.1077,1.2406,2.2227,1.21,2.2228)" + }, + { + "content": "number", + "span": { + "offset": 865, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,1.2398,2.1077,1.5766,2.1068,1.5773,2.2225,1.2406,2.2227)" + }, + { + "content": "and", + "span": { + "offset": 872, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,1.5976,2.1068,1.7583,2.1065,1.759,2.2223,1.5983,2.2225)" + }, + { + "content": "street", + "span": { + "offset": 876, + "length": 6 + }, + "confidence": 0.992, + "source": "D(1,1.7889,2.1065,2.0396,2.1062,2.0402,2.222,1.7896,2.2223)" + }, + { + "content": ")", + "span": { + "offset": 882, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,2.0319,2.1062,2.0626,2.1062,2.0631,2.2219,2.0325,2.222)" + }, + { + "content": ".", + "span": { + "offset": 883, + "length": 1 + }, + "confidence": 0.974, + "source": "D(1,2.0664,2.1062,2.0874,2.1061,2.088,2.2219,2.0669,2.2219)" + }, + { + "content": "If", + "span": { + "offset": 885, + "length": 2 + }, + "confidence": 0.932, + "source": "D(1,2.12,2.1061,2.1754,2.106,2.176,2.2218,2.1205,2.2218)" + }, + { + "content": "you", + "span": { + "offset": 888, + "length": 3 + }, + "confidence": 0.991, + "source": "D(1,2.1908,2.106,2.3515,2.1059,2.3519,2.2215,2.1913,2.2217)" + }, + { + "content": "have", + "span": { + "offset": 892, + "length": 4 + }, + "confidence": 0.983, + "source": "D(1,2.3859,2.1058,2.5887,2.1056,2.5891,2.2212,2.3864,2.2215)" + }, + { + "content": "a", + "span": { + "offset": 897, + "length": 1 + }, + "confidence": 0.973, + "source": "D(1,2.6136,2.1056,2.6653,2.1055,2.6656,2.2211,2.614,2.2212)" + }, + { + "content": "P", + "span": { + "offset": 899, + "length": 1 + }, + "confidence": 0.928, + "source": "D(1,2.6959,2.1055,2.7552,2.1054,2.7555,2.221,2.6962,2.2211)" + }, + { + "content": ".", + "span": { + "offset": 900, + "length": 1 + }, + "confidence": 0.953, + "source": "D(1,2.7609,2.1054,2.7801,2.1054,2.7804,2.2209,2.7613,2.221)" + }, + { + "content": "O", + "span": { + "offset": 901, + "length": 1 + }, + "confidence": 0.895, + "source": "D(1,2.7858,2.1054,2.8585,2.1055,2.8588,2.2208,2.7861,2.2209)" + }, + { + "content": ".", + "span": { + "offset": 902, + "length": 1 + }, + "confidence": 0.916, + "source": "D(1,2.8585,2.1055,2.8796,2.1055,2.8799,2.2207,2.8588,2.2208)" + }, + { + "content": "box", + "span": { + "offset": 904, + "length": 3 + }, + "confidence": 0.716, + "source": "D(1,2.9159,2.1055,3.0766,2.1056,3.0769,2.2203,2.9162,2.2206)" + }, + { + "content": ",", + "span": { + "offset": 907, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,3.0766,2.1056,3.0996,2.1056,3.0998,2.2202,3.0769,2.2203)" + }, + { + "content": "see", + "span": { + "offset": 909, + "length": 3 + }, + "confidence": 0.967, + "source": "D(1,3.1321,2.1056,3.2852,2.1056,3.2854,2.2198,3.1324,2.2202)" + }, + { + "content": "instructions", + "span": { + "offset": 913, + "length": 12 + }, + "confidence": 0.941, + "source": "D(1,3.312,2.1057,3.8171,2.1059,3.8171,2.2187,3.3122,2.2198)" + }, + { + "content": ".", + "span": { + "offset": 925, + "length": 1 + }, + "confidence": 0.995, + "source": "D(1,3.819,2.1059,3.8516,2.1059,3.8516,2.2186,3.819,2.2187)" + }, + { + "content": "254", + "span": { + "offset": 927, + "length": 3 + }, + "confidence": 0.927, + "source": "D(1,0.5204,2.253,0.7072,2.2528,0.7087,2.3717,0.5219,2.3714)" + }, + { + "content": "W", + "span": { + "offset": 931, + "length": 1 + }, + "confidence": 0.958, + "source": "D(1,0.7311,2.2527,0.8424,2.2526,0.8438,2.3719,0.7325,2.3717)" + }, + { + "content": "78TH", + "span": { + "offset": 933, + "length": 4 + }, + "confidence": 0.877, + "source": "D(1,0.8703,2.2525,1.1386,2.2522,1.1398,2.3724,0.8716,2.3719)" + }, + { + "content": "LOS", + "span": { + "offset": 938, + "length": 3 + }, + "confidence": 0.994, + "source": "D(1,1.1804,2.2521,1.4031,2.2519,1.4041,2.3727,1.1815,2.3724)" + }, + { + "content": "ANGELES", + "span": { + "offset": 942, + "length": 7 + }, + "confidence": 0.979, + "source": "D(1,1.4329,2.2519,1.9716,2.252,1.9723,2.3726,1.4339,2.3727)" + }, + { + "content": "CA", + "span": { + "offset": 950, + "length": 2 + }, + "confidence": 0.977, + "source": "D(1,2.0054,2.252,2.1645,2.2521,2.165,2.3726,2.0061,2.3726)" + }, + { + "content": "90003-2459", + "span": { + "offset": 953, + "length": 10 + }, + "confidence": 0.799, + "source": "D(1,2.1963,2.2521,2.7867,2.2531,2.7869,2.3716,2.1968,2.3726)" + }, + { + "content": "USA", + "span": { + "offset": 964, + "length": 3 + }, + "confidence": 0.936, + "source": "D(1,2.8265,2.2531,3.0651,2.2535,3.0651,2.3711,2.8266,2.3715)" + }, + { + "content": "Apt", + "span": { + "offset": 969, + "length": 3 + }, + "confidence": 0.852, + "source": "D(1,5.8396,2.1128,6.0045,2.1152,6.0045,2.2173,5.8396,2.2148)" + }, + { + "content": ".", + "span": { + "offset": 972, + "length": 1 + }, + "confidence": 0.912, + "source": "D(1,6.001,2.1152,6.0219,2.1154,6.0219,2.2175,6.0011,2.2172)" + }, + { + "content": "no", + "span": { + "offset": 974, + "length": 2 + }, + "confidence": 0.888, + "source": "D(1,6.0549,2.1157,6.166,2.1163,6.166,2.2183,6.0549,2.2178)" + }, + { + "content": ".", + "span": { + "offset": 976, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,6.166,2.1163,6.2007,2.1164,6.2007,2.2185,6.166,2.2183)" + }, + { + "content": "254", + "span": { + "offset": 978, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,6.043,2.2653,6.2422,2.2653,6.2422,2.3687,6.043,2.3678)" + }, + { + "content": "City", + "span": { + "offset": 983, + "length": 4 + }, + "confidence": 0.993, + "source": "D(1,0.5453,2.4495,0.7243,2.4492,0.7253,2.562,0.5463,2.562)" + }, + { + "content": ",", + "span": { + "offset": 987, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.7243,2.4492,0.745,2.4492,0.746,2.562,0.7253,2.562)" + }, + { + "content": "town", + "span": { + "offset": 989, + "length": 4 + }, + "confidence": 0.994, + "source": "D(1,0.7733,2.4492,0.9844,2.4489,0.9853,2.5621,0.7743,2.562)" + }, + { + "content": ",", + "span": { + "offset": 993, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.99,2.4489,1.0108,2.4489,1.0117,2.5621,0.9909,2.5621)" + }, + { + "content": "or", + "span": { + "offset": 995, + "length": 2 + }, + "confidence": 0.948, + "source": "D(1,1.0428,2.4489,1.1351,2.4488,1.136,2.5621,1.0437,2.5621)" + }, + { + "content": "post", + "span": { + "offset": 998, + "length": 4 + }, + "confidence": 0.934, + "source": "D(1,1.1596,2.4487,1.35,2.4485,1.3508,2.5622,1.1605,2.5621)" + }, + { + "content": "office", + "span": { + "offset": 1003, + "length": 6 + }, + "confidence": 0.523, + "source": "D(1,1.3783,2.4485,1.6157,2.4482,1.6164,2.5622,1.3791,2.5622)" + }, + { + "content": ".", + "span": { + "offset": 1009, + "length": 1 + }, + "confidence": 0.927, + "source": "D(1,1.6195,2.4482,1.6383,2.4482,1.6391,2.5623,1.6202,2.5623)" + }, + { + "content": "If", + "span": { + "offset": 1011, + "length": 2 + }, + "confidence": 0.771, + "source": "D(1,1.6741,2.4481,1.7326,2.448,1.7333,2.5623,1.6749,2.5623)" + }, + { + "content": "you", + "span": { + "offset": 1014, + "length": 3 + }, + "confidence": 0.896, + "source": "D(1,1.7457,2.448,1.9059,2.448,1.9066,2.5623,1.7464,2.5623)" + }, + { + "content": "have", + "span": { + "offset": 1018, + "length": 4 + }, + "confidence": 0.954, + "source": "D(1,1.9399,2.448,2.1453,2.4481,2.1459,2.5622,1.9405,2.5623)" + }, + { + "content": "a", + "span": { + "offset": 1023, + "length": 1 + }, + "confidence": 0.978, + "source": "D(1,2.1698,2.4481,2.2226,2.4481,2.2231,2.5622,2.1704,2.5622)" + }, + { + "content": "foreign", + "span": { + "offset": 1025, + "length": 7 + }, + "confidence": 0.947, + "source": "D(1,2.2489,2.4481,2.5467,2.4482,2.5472,2.5622,2.2495,2.5622)" + }, + { + "content": "address", + "span": { + "offset": 1033, + "length": 7 + }, + "confidence": 0.99, + "source": "D(1,2.5769,2.4482,2.9255,2.4483,2.9259,2.5621,2.5773,2.5622)" + }, + { + "content": ",", + "span": { + "offset": 1040, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,2.9274,2.4483,2.95,2.4483,2.9504,2.5621,2.9278,2.5621)" + }, + { + "content": "also", + "span": { + "offset": 1042, + "length": 4 + }, + "confidence": 0.979, + "source": "D(1,2.9783,2.4483,3.1592,2.4485,3.1595,2.562,2.9786,2.5621)" + }, + { + "content": "complete", + "span": { + "offset": 1047, + "length": 8 + }, + "confidence": 0.982, + "source": "D(1,3.1856,2.4486,3.5945,2.4493,3.5947,2.5617,3.1859,2.562)" + }, + { + "content": "spaces", + "span": { + "offset": 1056, + "length": 6 + }, + "confidence": 0.983, + "source": "D(1,3.619,2.4493,3.9319,2.4499,3.932,2.5615,3.6192,2.5617)" + }, + { + "content": "below", + "span": { + "offset": 1063, + "length": 5 + }, + "confidence": 0.986, + "source": "D(1,3.9602,2.4499,4.2202,2.4503,4.2202,2.5613,3.9602,2.5615)" + }, + { + "content": ".", + "span": { + "offset": 1068, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,4.2202,2.4503,4.2542,2.4504,4.2542,2.5613,4.2202,2.5613)" + }, + { + "content": "10107", + "span": { + "offset": 1070, + "length": 5 + }, + "confidence": 0.927, + "source": "D(1,0.5284,2.5932,0.828,2.5927,0.8294,2.7119,0.53,2.7116)" + }, + { + "content": "1/4", + "span": { + "offset": 1076, + "length": 3 + }, + "confidence": 0.908, + "source": "D(1,0.8659,2.5926,1.0157,2.5924,1.017,2.7121,0.8673,2.712)" + }, + { + "content": "WILMINGTON", + "span": { + "offset": 1080, + "length": 10 + }, + "confidence": 0.908, + "source": "D(1,1.0396,2.5923,1.7686,2.5913,1.7695,2.7127,1.041,2.7121)" + }, + { + "content": "LOS", + "span": { + "offset": 1091, + "length": 3 + }, + "confidence": 0.993, + "source": "D(1,1.8105,2.5913,2.0322,2.5912,2.033,2.7127,1.8114,2.7127)" + }, + { + "content": "ANGELES", + "span": { + "offset": 1095, + "length": 7 + }, + "confidence": 0.976, + "source": "D(1,2.0582,2.5912,2.5954,2.5911,2.5959,2.7127,2.059,2.7127)" + }, + { + "content": "CA", + "span": { + "offset": 1103, + "length": 2 + }, + "confidence": 0.966, + "source": "D(1,2.6313,2.5911,2.7931,2.5913,2.7935,2.7124,2.6318,2.7127)" + }, + { + "content": "90002-2984", + "span": { + "offset": 1106, + "length": 10 + }, + "confidence": 0.81, + "source": "D(1,2.823,2.5914,3.4222,2.5922,3.4223,2.7116,2.8235,2.7124)" + }, + { + "content": "USA", + "span": { + "offset": 1117, + "length": 3 + }, + "confidence": 0.98, + "source": "D(1,3.4561,2.5922,3.6918,2.5926,3.6918,2.7112,3.4562,2.7116)" + }, + { + "content": "State", + "span": { + "offset": 1122, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,4.7397,2.4532,4.968,2.4536,4.968,2.5449,4.7397,2.5446)" + }, + { + "content": "LA", + "span": { + "offset": 1128, + "length": 2 + }, + "confidence": 0.976, + "source": "D(1,5.0676,2.6001,5.2253,2.5995,5.2253,2.7042,5.0676,2.7049)" + }, + { + "content": "ZIP", + "span": { + "offset": 1132, + "length": 3 + }, + "confidence": 0.986, + "source": "D(1,5.6362,2.4475,5.7826,2.4488,5.7826,2.5466,5.6362,2.5435)" + }, + { + "content": "code", + "span": { + "offset": 1136, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,5.8046,2.449,6.0139,2.4502,6.0139,2.5479,5.8046,2.5469)" + }, + { + "content": "10107", + "span": { + "offset": 1141, + "length": 5 + }, + "confidence": 0.991, + "source": "D(1,5.9268,2.6005,6.2256,2.6007,6.2256,2.707,5.9268,2.7054)" + }, + { + "content": "Foreign", + "span": { + "offset": 1148, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,0.5432,2.7798,0.872,2.7793,0.8727,2.8923,0.5442,2.8923)" + }, + { + "content": "country", + "span": { + "offset": 1156, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,0.9022,2.7793,1.2348,2.7798,1.2351,2.8923,0.9029,2.8923)" + }, + { + "content": "name", + "span": { + "offset": 1164, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,1.2594,2.7799,1.5107,2.7808,1.5107,2.8923,1.2597,2.8923)" + }, + { + "content": "N", + "span": { + "offset": 1169, + "length": 1 + }, + "confidence": 0.944, + "source": "D(1,0.5198,2.9302,0.5939,2.9327,0.5943,3.0401,0.5204,3.0376)" + }, + { + "content": "/", + "span": { + "offset": 1170, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.5921,2.9327,0.6421,2.9328,0.6424,3.0402,0.5924,3.0401)" + }, + { + "content": "A", + "span": { + "offset": 1171, + "length": 1 + }, + "confidence": 0.924, + "source": "D(1,0.631,2.9328,0.7274,2.9309,0.7274,3.0383,0.6313,3.0402)" + }, + { + "content": "Foreign", + "span": { + "offset": 1174, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,3.644,2.7771,3.974,2.7767,3.974,2.8948,3.644,2.8953)" + }, + { + "content": "province", + "span": { + "offset": 1182, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,4.0035,2.7766,4.3766,2.7765,4.3766,2.8947,4.0035,2.8948)" + }, + { + "content": "/", + "span": { + "offset": 1190, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.3747,2.7765,4.4139,2.7765,4.4139,2.8947,4.3747,2.8947)" + }, + { + "content": "state", + "span": { + "offset": 1191, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,4.41,2.7765,4.628,2.7766,4.628,2.8948,4.41,2.8947)" + }, + { + "content": "/", + "span": { + "offset": 1196, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.6221,2.7766,4.6634,2.7766,4.6634,2.8948,4.6221,2.8948)" + }, + { + "content": "county", + "span": { + "offset": 1197, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,4.6575,2.7766,4.9639,2.777,4.9639,2.8951,4.6575,2.8948)" + }, + { + "content": "N", + "span": { + "offset": 1204, + "length": 1 + }, + "confidence": 0.957, + "source": "D(1,3.6357,2.9317,3.7076,2.9336,3.7076,3.0387,3.6357,3.0383)" + }, + { + "content": "/", + "span": { + "offset": 1205, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.7058,2.9336,3.7562,2.9336,3.7562,3.0392,3.7058,3.0387)" + }, + { + "content": "A", + "span": { + "offset": 1206, + "length": 1 + }, + "confidence": 0.933, + "source": "D(1,3.7454,2.9336,3.837,2.9316,3.837,3.0406,3.7454,3.0391)" + }, + { + "content": "Foreign", + "span": { + "offset": 1209, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,5.6445,2.7812,5.9478,2.7823,5.9478,2.8901,5.6445,2.8886)" + }, + { + "content": "postal", + "span": { + "offset": 1217, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,5.975,2.7823,6.222,2.7817,6.222,2.8893,5.975,2.89)" + }, + { + "content": "code", + "span": { + "offset": 1224, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,6.2456,2.7816,6.458,2.78,6.458,2.8872,6.2456,2.8891)" + }, + { + "content": "N", + "span": { + "offset": 1229, + "length": 1 + }, + "confidence": 0.969, + "source": "D(1,5.9434,2.9342,6.0214,2.9353,6.0214,3.0373,5.9434,3.0362)" + }, + { + "content": "/", + "span": { + "offset": 1230, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.016,2.9353,6.0686,2.9355,6.0687,3.0375,6.016,3.0373)" + }, + { + "content": "A", + "span": { + "offset": 1231, + "length": 1 + }, + "confidence": 0.928, + "source": "D(1,6.0559,2.9354,6.1467,2.9351,6.1467,3.0371,6.0559,3.0375)" + }, + { + "content": "Presidential", + "span": { + "offset": 1234, + "length": 12 + }, + "confidence": 0.998, + "source": "D(1,6.5452,2.113,7.093,2.1182,7.093,2.236,6.5452,2.2291)" + }, + { + "content": "Election", + "span": { + "offset": 1247, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,7.1268,2.1184,7.494,2.1213,7.494,2.24,7.1268,2.2363)" + }, + { + "content": "Campaign", + "span": { + "offset": 1256, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,7.5238,2.1215,8.0061,2.1243,8.0061,2.2438,7.5238,2.2403)" + }, + { + "content": "Check", + "span": { + "offset": 1265, + "length": 5 + }, + "confidence": 0.996, + "source": "D(1,6.5452,2.2582,6.852,2.2583,6.852,2.3748,6.5452,2.3735)" + }, + { + "content": "here", + "span": { + "offset": 1271, + "length": 4 + }, + "confidence": 0.992, + "source": "D(1,6.8792,2.2583,7.0812,2.2587,7.0812,2.3756,6.8792,2.375)" + }, + { + "content": "if", + "span": { + "offset": 1276, + "length": 2 + }, + "confidence": 0.994, + "source": "D(1,7.1123,2.2588,7.1705,2.259,7.1705,2.3759,7.1123,2.3757)" + }, + { + "content": "you", + "span": { + "offset": 1279, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,7.19,2.2591,7.3589,2.2597,7.3589,2.3764,7.19,2.3759)" + }, + { + "content": ",", + "span": { + "offset": 1282, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.3667,2.2597,7.39,2.2599,7.39,2.3764,7.3667,2.3764)" + }, + { + "content": "or", + "span": { + "offset": 1284, + "length": 2 + }, + "confidence": 0.971, + "source": "D(1,7.4211,2.2601,7.5221,2.2608,7.5221,2.3766,7.4211,2.3765)" + }, + { + "content": "your", + "span": { + "offset": 1287, + "length": 4 + }, + "confidence": 0.977, + "source": "D(1,7.5396,2.2609,7.7571,2.2623,7.7571,2.3769,7.5396,2.3766)" + }, + { + "content": "spouse", + "span": { + "offset": 1292, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,6.5452,2.3934,6.89,2.393,6.89,2.5099,6.5452,2.508)" + }, + { + "content": "if", + "span": { + "offset": 1299, + "length": 2 + }, + "confidence": 0.994, + "source": "D(1,6.9232,2.393,6.9797,2.3929,6.9796,2.5104,6.9231,2.5101)" + }, + { + "content": "filing", + "span": { + "offset": 1302, + "length": 6 + }, + "confidence": 0.989, + "source": "D(1,6.9992,2.3929,7.2154,2.3915,7.2154,2.5095,6.9991,2.5105)" + }, + { + "content": "jointly", + "span": { + "offset": 1309, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,7.2408,2.3913,7.5252,2.3892,7.5252,2.5075,7.2407,2.5094)" + }, + { + "content": ",", + "span": { + "offset": 1316, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.5233,2.3892,7.5447,2.3889,7.5447,2.5072,7.5232,2.5075)" + }, + { + "content": "want", + "span": { + "offset": 1318, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,7.5759,2.3886,7.8058,2.3858,7.8058,2.5031,7.5758,2.5067)" + }, + { + "content": "$", + "span": { + "offset": 1323, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.8292,2.3855,7.8837,2.3848,7.8837,2.5019,7.8291,2.5028)" + }, + { + "content": "3", + "span": { + "offset": 1324, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.8895,2.3848,7.948,2.384,7.948,2.5009,7.8895,2.5018)" + }, + { + "content": "to", + "span": { + "offset": 1326, + "length": 2 + }, + "confidence": 0.992, + "source": "D(1,6.5327,2.5128,6.6414,2.5124,6.6414,2.6265,6.5327,2.6265)" + }, + { + "content": "go", + "span": { + "offset": 1329, + "length": 2 + }, + "confidence": 0.984, + "source": "D(1,6.668,2.5123,6.7881,2.5119,6.7881,2.6265,6.668,2.6265)" + }, + { + "content": "to", + "span": { + "offset": 1332, + "length": 2 + }, + "confidence": 0.956, + "source": "D(1,6.8148,2.5119,6.9101,2.5115,6.9101,2.6264,6.8148,2.6265)" + }, + { + "content": "this", + "span": { + "offset": 1335, + "length": 4 + }, + "confidence": 0.984, + "source": "D(1,6.9368,2.5115,7.1045,2.5112,7.1045,2.6264,6.9368,2.6264)" + }, + { + "content": "fund", + "span": { + "offset": 1340, + "length": 4 + }, + "confidence": 0.985, + "source": "D(1,7.1312,2.5112,7.3409,2.511,7.3409,2.6265,7.1312,2.6265)" + }, + { + "content": ".", + "span": { + "offset": 1344, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,7.3485,2.511,7.3695,2.511,7.3695,2.6265,7.3485,2.6265)" + }, + { + "content": "Checking", + "span": { + "offset": 1346, + "length": 8 + }, + "confidence": 0.939, + "source": "D(1,7.4019,2.511,7.8422,2.5116,7.8422,2.6268,7.4019,2.6265)" + }, + { + "content": "a", + "span": { + "offset": 1355, + "length": 1 + }, + "confidence": 0.992, + "source": "D(1,7.8726,2.5116,7.9355,2.5117,7.9355,2.6269,7.8726,2.6269)" + }, + { + "content": "box", + "span": { + "offset": 1357, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,6.5452,2.6418,6.7262,2.6416,6.7262,2.7533,6.5452,2.7522)" + }, + { + "content": "below", + "span": { + "offset": 1361, + "length": 5 + }, + "confidence": 0.997, + "source": "D(1,6.7542,2.6416,7.0304,2.6412,7.0304,2.7548,6.7542,2.7534)" + }, + { + "content": "will", + "span": { + "offset": 1367, + "length": 4 + }, + "confidence": 0.994, + "source": "D(1,7.0566,2.6412,7.2133,2.6412,7.2133,2.7552,7.0566,2.7549)" + }, + { + "content": "not", + "span": { + "offset": 1372, + "length": 3 + }, + "confidence": 0.989, + "source": "D(1,7.2451,2.6412,7.3944,2.6411,7.3944,2.7556,7.2451,2.7553)" + }, + { + "content": "change", + "span": { + "offset": 1376, + "length": 6 + }, + "confidence": 0.986, + "source": "D(1,7.4186,2.6412,7.7695,2.6414,7.7695,2.7551,7.4187,2.7555)" + }, + { + "content": "your", + "span": { + "offset": 1383, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,6.5327,2.7761,6.7583,2.7729,6.7583,2.8795,6.5327,2.8848)" + }, + { + "content": "tax", + "span": { + "offset": 1388, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,6.781,2.7726,6.9262,2.7715,6.9262,2.8769,6.7811,2.879)" + }, + { + "content": "or", + "span": { + "offset": 1392, + "length": 2 + }, + "confidence": 0.996, + "source": "D(1,6.9524,2.7714,7.0556,2.7709,7.0557,2.8756,6.9525,2.8767)" + }, + { + "content": "refund", + "span": { + "offset": 1395, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,7.0818,2.7708,7.3722,2.7721,7.3722,2.8757,7.0819,2.8753)" + }, + { + "content": ".", + "span": { + "offset": 1401, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.3792,2.7721,7.4001,2.7722,7.4001,2.8758,7.3792,2.8757)" + }, + { + "content": "☐", + "span": { + "offset": 1404, + "length": 1 + }, + "confidence": 0.988, + "source": "D(1,6.9851,2.9165,7.1096,2.9165,7.1096,3.0454,6.9851,3.0427)" + }, + { + "content": "You", + "span": { + "offset": 1406, + "length": 3 + }, + "confidence": 0.981, + "source": "D(1,7.147,2.9272,7.3337,2.9272,7.3337,3.0185,7.147,3.0183)" + }, + { + "content": "☐", + "span": { + "offset": 1410, + "length": 1 + }, + "confidence": 0.979, + "source": "D(1,7.4956,2.9165,7.6367,2.9192,7.6367,3.0427,7.4956,3.0454)" + }, + { + "content": "Spouse", + "span": { + "offset": 1412, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,7.6492,2.9332,7.9937,2.9357,7.9937,3.0317,7.6492,3.0314)" + }, + { + "content": "At", + "span": { + "offset": 1420, + "length": 2 + }, + "confidence": 0.938, + "source": "D(1,0.4926,3.1488,0.6045,3.1487,0.6055,3.2731,0.4936,3.273)" + }, + { + "content": "any", + "span": { + "offset": 1423, + "length": 3 + }, + "confidence": 0.917, + "source": "D(1,0.6319,3.1487,0.8135,3.1485,0.8145,3.2734,0.633,3.2732)" + }, + { + "content": "time", + "span": { + "offset": 1427, + "length": 4 + }, + "confidence": 0.98, + "source": "D(1,0.8389,3.1485,1.0521,3.1483,1.053,3.2737,0.8398,3.2734)" + }, + { + "content": "during", + "span": { + "offset": 1432, + "length": 6 + }, + "confidence": 0.942, + "source": "D(1,1.0817,3.1483,1.3962,3.148,1.3971,3.2741,1.0826,3.2737)" + }, + { + "content": "2020", + "span": { + "offset": 1439, + "length": 4 + }, + "confidence": 0.711, + "source": "D(1,1.4258,3.148,1.6792,3.1477,1.68,3.2745,1.4267,3.2741)" + }, + { + "content": ",", + "span": { + "offset": 1443, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,1.677,3.1477,1.7024,3.1477,1.7032,3.2745,1.6779,3.2745)" + }, + { + "content": "did", + "span": { + "offset": 1445, + "length": 3 + }, + "confidence": 0.942, + "source": "D(1,1.7383,3.1477,1.8945,3.1475,1.8953,3.2747,1.7391,3.2745)" + }, + { + "content": "you", + "span": { + "offset": 1449, + "length": 3 + }, + "confidence": 0.984, + "source": "D(1,1.9241,3.1475,2.1035,3.1473,2.1043,3.275,1.9249,3.2748)" + }, + { + "content": "receive", + "span": { + "offset": 1453, + "length": 7 + }, + "confidence": 0.974, + "source": "D(1,2.1394,3.1473,2.4941,3.147,2.4948,3.2755,2.1402,3.275)" + }, + { + "content": ",", + "span": { + "offset": 1460, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.492,3.147,2.5173,3.147,2.5181,3.2755,2.4927,3.2755)" + }, + { + "content": "sell", + "span": { + "offset": 1462, + "length": 4 + }, + "confidence": 0.987, + "source": "D(1,2.5553,3.1469,2.7137,3.1469,2.7144,3.2757,2.5561,3.2755)" + }, + { + "content": ",", + "span": { + "offset": 1466, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.72,3.1469,2.7411,3.1469,2.7418,3.2757,2.7207,3.2757)" + }, + { + "content": "send", + "span": { + "offset": 1468, + "length": 4 + }, + "confidence": 0.991, + "source": "D(1,2.7791,3.1469,3.0135,3.1469,3.0141,3.2757,2.7798,3.2757)" + }, + { + "content": ",", + "span": { + "offset": 1472, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.0262,3.1469,3.0494,3.1469,3.05,3.2757,3.0268,3.2757)" + }, + { + "content": "exchange", + "span": { + "offset": 1474, + "length": 8 + }, + "confidence": 0.979, + "source": "D(1,3.0832,3.1469,3.5667,3.1469,3.5672,3.2759,3.0838,3.2758)" + }, + { + "content": ",", + "span": { + "offset": 1482, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.5709,3.1469,3.5962,3.1469,3.5968,3.2759,3.5714,3.2759)" + }, + { + "content": "or", + "span": { + "offset": 1484, + "length": 2 + }, + "confidence": 0.99, + "source": "D(1,3.6321,3.1469,3.7356,3.1469,3.7361,3.2759,3.6326,3.2759)" + }, + { + "content": "otherwise", + "span": { + "offset": 1487, + "length": 9 + }, + "confidence": 0.959, + "source": "D(1,3.763,3.1469,4.2423,3.1469,4.2427,3.2761,3.7635,3.2759)" + }, + { + "content": "acquire", + "span": { + "offset": 1497, + "length": 7 + }, + "confidence": 0.965, + "source": "D(1,4.2761,3.1469,4.6413,3.1469,4.6417,3.2762,4.2765,3.2761)" + }, + { + "content": "any", + "span": { + "offset": 1505, + "length": 3 + }, + "confidence": 0.982, + "source": "D(1,4.6709,3.1469,4.8503,3.147,4.8507,3.2761,4.6712,3.2762)" + }, + { + "content": "financial", + "span": { + "offset": 1509, + "length": 9 + }, + "confidence": 0.942, + "source": "D(1,4.8799,3.147,5.2874,3.1474,5.2876,3.2758,4.8802,3.2761)" + }, + { + "content": "interest", + "span": { + "offset": 1519, + "length": 8 + }, + "confidence": 0.938, + "source": "D(1,5.3275,3.1474,5.6928,3.1477,5.6929,3.2756,5.3277,3.2758)" + }, + { + "content": "in", + "span": { + "offset": 1528, + "length": 2 + }, + "confidence": 0.973, + "source": "D(1,5.7265,3.1478,5.8089,3.1478,5.809,3.2755,5.7267,3.2755)" + }, + { + "content": "any", + "span": { + "offset": 1531, + "length": 3 + }, + "confidence": 0.946, + "source": "D(1,5.8384,3.1479,6.0221,3.148,6.0223,3.2753,5.8386,3.2755)" + }, + { + "content": "virtual", + "span": { + "offset": 1535, + "length": 7 + }, + "confidence": 0.581, + "source": "D(1,6.0496,3.1481,6.3388,3.1483,6.3389,3.2751,6.0497,3.2753)" + }, + { + "content": "currency", + "span": { + "offset": 1543, + "length": 8 + }, + "confidence": 0.476, + "source": "D(1,6.3768,3.1484,6.8117,3.1488,6.8118,3.2748,6.3769,3.2751)" + }, + { + "content": "?", + "span": { + "offset": 1551, + "length": 1 + }, + "confidence": 0.981, + "source": "D(1,6.816,3.1488,6.8772,3.1488,6.8772,3.2747,6.816,3.2748)" + }, + { + "content": "☑", + "span": { + "offset": 1554, + "length": 1 + }, + "confidence": 0.974, + "source": "D(1,6.9976,3.1501,7.1221,3.1501,7.1221,3.2737,6.9976,3.2737)" + }, + { + "content": "Yes", + "span": { + "offset": 1556, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,7.1345,3.1501,7.3379,3.1506,7.3379,3.252,7.1345,3.2521)" + }, + { + "content": "☐", + "span": { + "offset": 1560, + "length": 1 + }, + "confidence": 0.977, + "source": "D(1,7.4956,3.1394,7.6201,3.1475,7.6201,3.2764,7.4956,3.2656)" + }, + { + "content": "No", + "span": { + "offset": 1562, + "length": 2 + }, + "confidence": 0.992, + "source": "D(1,7.6409,3.1543,7.7986,3.1534,7.7986,3.2517,7.6409,3.257)" + }, + { + "content": "Standard", + "span": { + "offset": 1566, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,0.4918,3.373,1.1123,3.373,1.1123,3.502,0.4926,3.502)" + }, + { + "content": "Deduction", + "span": { + "offset": 1575, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,0.4936,3.5154,1.1849,3.5154,1.1849,3.6398,0.4944,3.639)" + }, + { + "content": "Someone", + "span": { + "offset": 1586, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,1.2877,3.3597,1.7931,3.3671,1.7937,3.4804,1.2887,3.4722)" + }, + { + "content": "can", + "span": { + "offset": 1594, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,1.8272,3.3672,2.0184,3.368,2.0188,3.4814,1.8278,3.4806)" + }, + { + "content": "claim", + "span": { + "offset": 1598, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,2.0506,3.3677,2.3308,3.365,2.3309,3.4781,2.051,3.4811)" + }, + { + "content": ":", + "span": { + "offset": 1603, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.3384,3.3649,2.3782,3.3646,2.3782,3.4775,2.3385,3.478)" + }, + { + "content": "☐", + "span": { + "offset": 1606, + "length": 1 + }, + "confidence": 0.988, + "source": "D(1,2.5193,3.3569,2.6438,3.3569,2.6438,3.4805,2.5193,3.4805)" + }, + { + "content": "You", + "span": { + "offset": 1608, + "length": 3 + }, + "confidence": 0.981, + "source": "D(1,2.6874,3.3656,2.8904,3.3664,2.8904,3.4846,2.6874,3.4836)" + }, + { + "content": "as", + "span": { + "offset": 1612, + "length": 2 + }, + "confidence": 0.981, + "source": "D(1,2.9202,3.3665,3.0356,3.367,3.0356,3.4852,2.9202,3.4847)" + }, + { + "content": "a", + "span": { + "offset": 1615, + "length": 1 + }, + "confidence": 0.986, + "source": "D(1,3.0635,3.367,3.1252,3.3671,3.1252,3.4854,3.0635,3.4853)" + }, + { + "content": "dependent", + "span": { + "offset": 1617, + "length": 9 + }, + "confidence": 0.987, + "source": "D(1,3.1531,3.3671,3.7063,3.3672,3.7063,3.4858,3.1531,3.4855)" + }, + { + "content": "☐", + "span": { + "offset": 1627, + "length": 1 + }, + "confidence": 0.979, + "source": "D(1,3.92,3.3569,4.0446,3.3569,4.0446,3.4805,3.92,3.4805)" + }, + { + "content": "Your", + "span": { + "offset": 1629, + "length": 4 + }, + "confidence": 0.992, + "source": "D(1,4.0861,3.365,4.3339,3.365,4.3339,3.4858,4.0861,3.4857)" + }, + { + "content": "spouse", + "span": { + "offset": 1634, + "length": 6 + }, + "confidence": 0.987, + "source": "D(1,4.358,3.365,4.7247,3.365,4.7247,3.486,4.358,3.4858)" + }, + { + "content": "as", + "span": { + "offset": 1641, + "length": 2 + }, + "confidence": 0.978, + "source": "D(1,4.7529,3.365,4.8678,3.365,4.8678,3.4861,4.7529,3.486)" + }, + { + "content": "a", + "span": { + "offset": 1644, + "length": 1 + }, + "confidence": 0.98, + "source": "D(1,4.896,3.365,4.9544,3.365,4.9544,3.4861,4.896,3.4861)" + }, + { + "content": "dependent", + "span": { + "offset": 1646, + "length": 9 + }, + "confidence": 0.989, + "source": "D(1,4.9846,3.365,5.5366,3.365,5.5366,3.4862,4.9846,3.4861)" + }, + { + "content": "☐", + "span": { + "offset": 1656, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,1.3209,3.5208,1.4454,3.5208,1.4454,3.6497,1.3209,3.6497)" + }, + { + "content": "Spouse", + "span": { + "offset": 1658, + "length": 6 + }, + "confidence": 0.995, + "source": "D(1,1.4858,3.5303,1.8694,3.53,1.8703,3.6501,1.4869,3.6495)" + }, + { + "content": "itemizes", + "span": { + "offset": 1665, + "length": 8 + }, + "confidence": 0.99, + "source": "D(1,1.9053,3.53,2.3069,3.5297,2.3076,3.6508,1.9062,3.6501)" + }, + { + "content": "on", + "span": { + "offset": 1674, + "length": 2 + }, + "confidence": 0.937, + "source": "D(1,2.3408,3.5297,2.4647,3.5296,2.4654,3.651,2.3416,3.6508)" + }, + { + "content": "a", + "span": { + "offset": 1677, + "length": 1 + }, + "confidence": 0.929, + "source": "D(1,2.5006,3.5295,2.5566,3.5295,2.5573,3.6512,2.5014,3.6511)" + }, + { + "content": "separate", + "span": { + "offset": 1679, + "length": 8 + }, + "confidence": 0.909, + "source": "D(1,2.5905,3.5295,3.02,3.5294,3.0206,3.651,2.5912,3.6512)" + }, + { + "content": "return", + "span": { + "offset": 1688, + "length": 6 + }, + "confidence": 0.948, + "source": "D(1,3.052,3.5294,3.3396,3.5294,3.3401,3.6507,3.0525,3.6509)" + }, + { + "content": "or", + "span": { + "offset": 1695, + "length": 2 + }, + "confidence": 0.947, + "source": "D(1,3.3736,3.5294,3.4775,3.5294,3.4779,3.6506,3.3741,3.6507)" + }, + { + "content": "you", + "span": { + "offset": 1698, + "length": 3 + }, + "confidence": 0.877, + "source": "D(1,3.5014,3.5294,3.6812,3.5294,3.6816,3.6505,3.5019,3.6506)" + }, + { + "content": "were", + "span": { + "offset": 1702, + "length": 4 + }, + "confidence": 0.711, + "source": "D(1,3.7152,3.5294,3.9589,3.5296,3.9592,3.6498,3.7155,3.6504)" + }, + { + "content": "a", + "span": { + "offset": 1707, + "length": 1 + }, + "confidence": 0.889, + "source": "D(1,3.9869,3.5296,4.0468,3.5297,4.047,3.6495,3.9871,3.6497)" + }, + { + "content": "dual", + "span": { + "offset": 1709, + "length": 4 + }, + "confidence": 0.812, + "source": "D(1,4.0807,3.5297,4.2845,3.5298,4.2847,3.6488,4.081,3.6494)" + }, + { + "content": "-", + "span": { + "offset": 1713, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.2965,3.5298,4.3324,3.5299,4.3326,3.6486,4.2967,3.6487)" + }, + { + "content": "status", + "span": { + "offset": 1714, + "length": 6 + }, + "confidence": 0.941, + "source": "D(1,4.3324,3.5299,4.6361,3.5301,4.6362,3.6477,4.3326,3.6486)" + }, + { + "content": "alien", + "span": { + "offset": 1721, + "length": 5 + }, + "confidence": 0.973, + "source": "D(1,4.666,3.5301,4.9058,3.5303,4.9058,3.6468,4.6661,3.6476)" + }, + { + "content": "Age", + "span": { + "offset": 1728, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,0.4903,3.7781,0.6913,3.7774,0.6916,3.8995,0.4908,3.9029)" + }, + { + "content": "/", + "span": { + "offset": 1731, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.6913,3.7774,0.7405,3.7773,0.7408,3.8987,0.6916,3.8995)" + }, + { + "content": "Blindness", + "span": { + "offset": 1732, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,0.7364,3.7773,1.2451,3.784,1.2451,3.9043,0.7367,3.8987)" + }, + { + "content": "You", + "span": { + "offset": 1743, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,1.2949,3.7796,1.5007,3.7827,1.5007,3.8874,1.2949,3.8884)" + }, + { + "content": ":", + "span": { + "offset": 1746, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.5042,3.7825,1.5439,3.781,1.5439,3.8864,1.5042,3.8874)" + }, + { + "content": "☐", + "span": { + "offset": 1749, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,1.6228,3.7598,1.7463,3.7625,1.7463,3.8914,1.6228,3.8887)" + }, + { + "content": "Were", + "span": { + "offset": 1751, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,1.7867,3.7707,2.0486,3.7732,2.0487,3.8946,1.7867,3.891)" + }, + { + "content": "born", + "span": { + "offset": 1756, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,2.0811,3.7735,2.3045,3.7756,2.3045,3.8982,2.0811,3.8951)" + }, + { + "content": "before", + "span": { + "offset": 1761, + "length": 6 + }, + "confidence": 0.996, + "source": "D(1,2.341,3.776,2.6517,3.7761,2.6517,3.8994,2.341,3.8987)" + }, + { + "content": "January", + "span": { + "offset": 1768, + "length": 7 + }, + "confidence": 0.895, + "source": "D(1,2.6841,3.7761,3.08,3.7745,3.0801,3.8981,2.6841,3.8994)" + }, + { + "content": "2", + "span": { + "offset": 1776, + "length": 1 + }, + "confidence": 0.877, + "source": "D(1,3.1044,3.7743,3.1653,3.7737,3.1653,3.8972,3.1044,3.8979)" + }, + { + "content": ",", + "span": { + "offset": 1777, + "length": 1 + }, + "confidence": 0.943, + "source": "D(1,3.1694,3.7736,3.1937,3.7734,3.1938,3.8969,3.1694,3.8972)" + }, + { + "content": "1956", + "span": { + "offset": 1779, + "length": 4 + }, + "confidence": 0.84, + "source": "D(1,3.2343,3.773,3.476,3.7707,3.476,3.894,3.2344,3.8965)" + }, + { + "content": "☑", + "span": { + "offset": 1784, + "length": 1 + }, + "confidence": 0.963, + "source": "D(1,3.6108,3.749,3.752,3.7544,3.752,3.8914,3.6108,3.8833)" + }, + { + "content": "Are", + "span": { + "offset": 1786, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,3.7852,3.7769,3.9633,3.7833,3.9633,3.8903,3.7852,3.8867)" + }, + { + "content": "blind", + "span": { + "offset": 1790, + "length": 5 + }, + "confidence": 0.999, + "source": "D(1,3.9921,3.7834,4.2458,3.7797,4.2458,3.8876,3.9921,3.8904)" + }, + { + "content": "Spouse", + "span": { + "offset": 1797, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,4.4866,3.7804,4.8888,3.7762,4.8888,3.8977,4.4866,3.9047)" + }, + { + "content": ":", + "span": { + "offset": 1803, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.8908,3.7762,4.9348,3.7766,4.9348,3.8974,4.8908,3.8977)" + }, + { + "content": "☐", + "span": { + "offset": 1806, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,5.022,3.7625,5.1423,3.7625,5.1423,3.8914,5.022,3.8914)" + }, + { + "content": "Was", + "span": { + "offset": 1808, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,5.188,3.7717,5.4095,3.7733,5.4095,3.8929,5.188,3.8899)" + }, + { + "content": "born", + "span": { + "offset": 1812, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,5.4438,3.7736,5.6633,3.7752,5.6633,3.8963,5.4438,3.8933)" + }, + { + "content": "before", + "span": { + "offset": 1817, + "length": 6 + }, + "confidence": 0.996, + "source": "D(1,5.6996,3.7755,6.0098,3.7756,6.0098,3.898,5.6996,3.8968)" + }, + { + "content": "January", + "span": { + "offset": 1824, + "length": 7 + }, + "confidence": 0.935, + "source": "D(1,6.044,3.7755,6.4368,3.7741,6.4368,3.8974,6.044,3.8981)" + }, + { + "content": "2", + "span": { + "offset": 1832, + "length": 1 + }, + "confidence": 0.878, + "source": "D(1,6.4609,3.7739,6.5234,3.7734,6.5234,3.8967,6.461,3.8973)" + }, + { + "content": ",", + "span": { + "offset": 1833, + "length": 1 + }, + "confidence": 0.947, + "source": "D(1,6.5254,3.7734,6.5496,3.7732,6.5496,3.8965,6.5254,3.8967)" + }, + { + "content": "1956", + "span": { + "offset": 1835, + "length": 4 + }, + "confidence": 0.835, + "source": "D(1,6.5898,3.7729,6.8315,3.7708,6.8315,3.8942,6.5899,3.8962)" + }, + { + "content": "☐", + "span": { + "offset": 1840, + "length": 1 + }, + "confidence": 0.988, + "source": "D(1,7.0266,3.7651,7.147,3.7678,7.147,3.8967,7.0266,3.8967)" + }, + { + "content": "Is", + "span": { + "offset": 1842, + "length": 2 + }, + "confidence": 0.938, + "source": "D(1,7.1926,3.7813,7.2777,3.7829,7.2777,3.8899,7.1926,3.8884)" + }, + { + "content": "blind", + "span": { + "offset": 1845, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,7.3089,3.7835,7.5537,3.7787,7.5537,3.8855,7.3089,3.8904)" + }, + { + "content": "Dependents", + "span": { + "offset": 1882, + "length": 10 + }, + "confidence": 0.998, + "source": "D(1,0.4947,3.9619,1.2545,3.9584,1.2545,4.0896,0.4949,4.0936)" + }, + { + "content": "If", + "span": { + "offset": 1893, + "length": 2 + }, + "confidence": 0.944, + "source": "D(1,0.491,4.1537,0.569,4.1542,0.5692,4.2589,0.4913,4.2586)" + }, + { + "content": "more", + "span": { + "offset": 1896, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,0.5863,4.1543,0.8513,4.1548,0.8513,4.2593,0.5865,4.259)" + }, + { + "content": "than", + "span": { + "offset": 1901, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,0.489,4.2791,0.7095,4.2792,0.7104,4.382,0.4903,4.3822)" + }, + { + "content": "four", + "span": { + "offset": 1906, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,0.7401,4.279,0.9504,4.2768,0.951,4.3826,0.7409,4.382)" + }, + { + "content": "dependents", + "span": { + "offset": 1911, + "length": 10 + }, + "confidence": 0.999, + "source": "D(1,0.4923,4.4016,1.0826,4.4016,1.0826,4.509,0.4936,4.509)" + }, + { + "content": ",", + "span": { + "offset": 1921, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.0879,4.4016,1.1144,4.4016,1.1144,4.509,1.0879,4.509)" + }, + { + "content": "see", + "span": { + "offset": 1923, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,0.4903,4.5255,0.6598,4.5251,0.6612,4.6299,0.4921,4.6299)" + }, + { + "content": "instructions", + "span": { + "offset": 1927, + "length": 12 + }, + "confidence": 0.997, + "source": "D(1,0.6941,4.525,1.2576,4.5264,1.2576,4.6299,0.6954,4.6299)" + }, + { + "content": "and", + "span": { + "offset": 1940, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,0.4916,4.6479,0.6777,4.6436,0.6786,4.7457,0.4929,4.75)" + }, + { + "content": "check", + "span": { + "offset": 1944, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,0.7108,4.6434,1.0205,4.6444,1.0205,4.7464,0.7116,4.7454)" + }, + { + "content": "here", + "span": { + "offset": 1950, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,0.4923,4.7642,0.7248,4.7642,0.7248,4.8608,0.4923,4.8608)" + }, + { + "content": "☐", + "span": { + "offset": 1955, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,0.8923,4.7507,1.0236,4.7507,1.0236,4.8743,0.8923,4.8743)" + }, + { + "content": "(", + "span": { + "offset": 1966, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.2949,3.9623,1.3272,3.9624,1.3272,4.0853,1.2949,4.0854)" + }, + { + "content": "see", + "span": { + "offset": 1967, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,1.3232,3.9624,1.4947,3.9632,1.4947,4.0846,1.3232,4.0853)" + }, + { + "content": "instructions", + "span": { + "offset": 1971, + "length": 12 + }, + "confidence": 0.994, + "source": "D(1,1.531,3.9634,2.1019,3.9606,2.1019,4.0849,1.531,4.0845)" + }, + { + "content": ")", + "span": { + "offset": 1983, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.1019,3.9606,2.1342,3.9602,2.1342,4.085,2.1019,4.0849)" + }, + { + "content": ":", + "span": { + "offset": 1984, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.1362,3.9602,2.1665,3.9599,2.1665,4.0851,2.1362,4.085)" + }, + { + "content": "(", + "span": { + "offset": 1986, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3198,4.1116,1.356,4.1116,1.358,4.219,1.3219,4.219)" + }, + { + "content": "1", + "span": { + "offset": 1987, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3524,4.1116,1.394,4.1116,1.3958,4.219,1.3544,4.219)" + }, + { + "content": ")", + "span": { + "offset": 1988, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3976,4.1116,1.432,4.1116,1.4337,4.219,1.3994,4.219)" + }, + { + "content": "First", + "span": { + "offset": 1990, + "length": 5 + }, + "confidence": 0.997, + "source": "D(1,1.4628,4.1116,1.651,4.1116,1.6519,4.219,1.4644,4.219)" + }, + { + "content": "name", + "span": { + "offset": 1996, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,1.6763,4.1116,1.9279,4.1116,1.9279,4.219,1.6772,4.219)" + }, + { + "content": "Last", + "span": { + "offset": 2010, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,2.4757,4.1169,2.6695,4.1169,2.6695,4.2136,2.4757,4.2136)" + }, + { + "content": "name", + "span": { + "offset": 2015, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,2.6923,4.1169,2.9447,4.1169,2.9447,4.2136,2.6923,4.2136)" + }, + { + "content": "(", + "span": { + "offset": 2041, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.8993,3.9691,3.9411,3.9697,3.9411,4.0825,3.8993,4.0819)" + }, + { + "content": "2", + "span": { + "offset": 2042, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.9335,3.9696,3.9905,3.9703,3.9905,4.0831,3.9335,4.0824)" + }, + { + "content": ")", + "span": { + "offset": 2043, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.9829,3.9702,4.0171,3.9707,4.0171,4.0835,3.9829,4.083)" + }, + { + "content": "Social", + "span": { + "offset": 2045, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,4.0456,3.9711,4.3117,3.9719,4.3117,4.0847,4.0456,4.0839)" + }, + { + "content": "security", + "span": { + "offset": 2052, + "length": 8 + }, + "confidence": 0.999, + "source": "D(1,4.3365,3.9717,4.6899,3.9651,4.6899,4.0779,4.3364,4.0845)" + }, + { + "content": "number", + "span": { + "offset": 2061, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,4.1213,4.099,4.47,4.0986,4.47,4.1841,4.1213,4.1841)" + }, + { + "content": "(", + "span": { + "offset": 2077, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,5.0012,3.9698,5.0405,3.97,5.0405,4.0828,5.0012,4.0826)" + }, + { + "content": "3", + "span": { + "offset": 2078, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,5.033,3.97,5.0873,3.9702,5.0873,4.083,5.033,4.0828)" + }, + { + "content": ")", + "span": { + "offset": 2079, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,5.0855,3.9702,5.1173,3.9704,5.1173,4.0831,5.0855,4.083)" + }, + { + "content": "Relationship", + "span": { + "offset": 2081, + "length": 12 + }, + "confidence": 0.998, + "source": "D(1,5.151,3.9705,5.6902,3.9723,5.6902,4.0851,5.151,4.0833)" + }, + { + "content": "to", + "span": { + "offset": 2094, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,5.2004,4.0981,5.2967,4.0981,5.2967,4.1948,5.2004,4.1948)" + }, + { + "content": "you", + "span": { + "offset": 2097, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,5.3143,4.0981,5.4827,4.0981,5.4827,4.1948,5.3143,4.1948)" + }, + { + "content": "(", + "span": { + "offset": 2110, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.0762,3.9795,6.1052,3.9758,6.1054,4.0778,6.0762,4.0817)" + }, + { + "content": "4", + "span": { + "offset": 2111, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.0955,3.9771,6.1539,3.9733,6.1541,4.0757,6.0957,4.0791)" + }, + { + "content": ")", + "span": { + "offset": 2112, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.1474,3.9732,6.1799,3.9736,6.1799,4.0765,6.1477,4.0755)" + }, + { + "content": "✓", + "span": { + "offset": 2114, + "length": 1 + }, + "confidence": 0.64, + "source": "D(1,6.209,3.9585,6.3252,3.9666,6.3252,4.0713,6.209,4.0579)" + }, + { + "content": "if", + "span": { + "offset": 2116, + "length": 2 + }, + "confidence": 0.992, + "source": "D(1,6.3459,3.9632,6.4049,3.9638,6.4049,4.0785,6.3459,4.078)" + }, + { + "content": "qualifies", + "span": { + "offset": 2119, + "length": 9 + }, + "confidence": 0.991, + "source": "D(1,6.4258,3.964,6.7835,3.9679,6.7835,4.0817,6.4258,4.0787)" + }, + { + "content": "for", + "span": { + "offset": 2129, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,6.812,3.9682,6.9337,3.9687,6.9338,4.0825,6.812,4.0819)" + }, + { + "content": "Child", + "span": { + "offset": 2133, + "length": 5 + }, + "confidence": 0.999, + "source": "D(1,6.0098,4.1143,6.2364,4.1143,6.2364,4.2158,6.0098,4.2138)" + }, + { + "content": "tax", + "span": { + "offset": 2139, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,6.2635,4.1143,6.4021,4.1143,6.4021,4.2164,6.2635,4.2159)" + }, + { + "content": "credit", + "span": { + "offset": 2143, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,6.4275,4.1143,6.6863,4.1143,6.6863,4.216,6.4275,4.2164)" + }, + { + "content": "(", + "span": { + "offset": 2159, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.9566,3.9688,6.987,3.9689,6.987,4.0827,6.9566,4.0826)" + }, + { + "content": "see", + "span": { + "offset": 2160, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,6.9851,3.9689,7.1316,3.9695,7.1316,4.0834,6.9851,4.0827)" + }, + { + "content": "instructions", + "span": { + "offset": 2164, + "length": 12 + }, + "confidence": 0.995, + "source": "D(1,7.1639,3.9697,7.6604,3.9691,7.6604,4.0844,7.1639,4.0835)" + }, + { + "content": ")", + "span": { + "offset": 2176, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.6604,3.9691,7.6889,3.969,7.6889,4.0844,7.6604,4.0844)" + }, + { + "content": ":", + "span": { + "offset": 2177, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,7.6908,3.969,7.7156,3.9689,7.7156,4.0844,7.6908,4.0844)" + }, + { + "content": "Credit", + "span": { + "offset": 2179, + "length": 6 + }, + "confidence": 0.995, + "source": "D(1,6.9187,4.1104,7.1603,4.1093,7.1603,4.2217,6.9187,4.2217)" + }, + { + "content": "for", + "span": { + "offset": 2186, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,7.1811,4.1092,7.2925,4.1087,7.2925,4.2217,7.1811,4.2217)" + }, + { + "content": "other", + "span": { + "offset": 2190, + "length": 5 + }, + "confidence": 0.996, + "source": "D(1,7.3114,4.1087,7.5209,4.1087,7.5209,4.2217,7.3114,4.2217)" + }, + { + "content": "dependents", + "span": { + "offset": 2196, + "length": 10 + }, + "confidence": 0.998, + "source": "D(1,7.5379,4.1087,8.0061,4.1104,8.0061,4.2217,7.5379,4.2217)" + }, + { + "content": "Milsa", + "span": { + "offset": 2227, + "length": 5 + }, + "confidence": 0.996, + "source": "D(1,1.6602,4.282,1.9476,4.2811,1.9476,4.3858,1.6602,4.3867)" + }, + { + "content": "Hill", + "span": { + "offset": 2242, + "length": 4 + }, + "confidence": 0.976, + "source": "D(1,2.3969,4.281,2.5836,4.2784,2.5836,4.3851,2.3969,4.3826)" + }, + { + "content": "052000520", + "span": { + "offset": 2276, + "length": 9 + }, + "confidence": 0.329, + "source": "D(1,3.7271,4.2735,4.8684,4.2736,4.8684,4.3879,3.7271,4.3914)" + }, + { + "content": "friend", + "span": { + "offset": 2295, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,5.1423,4.2768,5.4619,4.2778,5.4619,4.3852,5.1423,4.3842)" + }, + { + "content": "☐", + "span": { + "offset": 2311, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,6.2878,4.2673,6.3999,4.27,6.3999,4.3962,6.2878,4.3962)" + }, + { + "content": "☐", + "span": { + "offset": 2322, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,7.3877,4.2673,7.5081,4.27,7.5081,4.3962,7.3877,4.3962)" + }, + { + "content": "Amanda", + "span": { + "offset": 2344, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,1.6301,4.4446,2.0742,4.4446,2.0742,4.552,1.6301,4.552)" + }, + { + "content": "Hill", + "span": { + "offset": 2360, + "length": 4 + }, + "confidence": 0.963, + "source": "D(1,2.4072,4.4446,2.5898,4.4446,2.5898,4.5509,2.4072,4.5494)" + }, + { + "content": "5", + "span": { + "offset": 2374, + "length": 1 + }, + "confidence": 0.716, + "source": "D(1,3.7271,4.4403,3.7845,4.4399,3.7845,4.558,3.7271,4.5582)" + }, + { + "content": "2", + "span": { + "offset": 2376, + "length": 1 + }, + "confidence": 0.694, + "source": "D(1,3.8519,4.4393,3.9133,4.4388,3.9133,4.5575,3.8519,4.5577)" + }, + { + "content": "0", + "span": { + "offset": 2378, + "length": 1 + }, + "confidence": 0.71, + "source": "D(1,3.9807,4.4382,4.0461,4.4377,4.0461,4.5569,3.9807,4.5572)" + }, + { + "content": "8", + "span": { + "offset": 2389, + "length": 1 + }, + "confidence": 0.77, + "source": "D(1,4.1115,4.4372,4.1789,4.4375,4.1788,4.5569,4.1115,4.5567)" + }, + { + "content": "5", + "span": { + "offset": 2391, + "length": 1 + }, + "confidence": 0.714, + "source": "D(1,4.2443,4.4379,4.3096,4.4382,4.3096,4.5573,4.2442,4.5571)" + }, + { + "content": "2", + "span": { + "offset": 2402, + "length": 1 + }, + "confidence": 0.779, + "source": "D(1,4.379,4.4386,4.4464,4.4389,4.4463,4.5577,4.379,4.5575)" + }, + { + "content": "0", + "span": { + "offset": 2404, + "length": 1 + }, + "confidence": 0.776, + "source": "D(1,4.5138,4.4396,4.5811,4.4409,4.5811,4.5588,4.5137,4.5581)" + }, + { + "content": "0", + "span": { + "offset": 2406, + "length": 1 + }, + "confidence": 0.714, + "source": "D(1,4.6524,4.4423,4.7198,4.4435,4.7198,4.5602,4.6524,4.5595)" + }, + { + "content": "0", + "span": { + "offset": 2408, + "length": 1 + }, + "confidence": 0.746, + "source": "D(1,4.7911,4.4449,4.8684,4.4464,4.8684,4.5617,4.7911,4.5609)" + }, + { + "content": "friend", + "span": { + "offset": 2419, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,5.1755,4.4446,5.5034,4.4446,5.5034,4.552,5.1755,4.552)" + }, + { + "content": "☐", + "span": { + "offset": 2435, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,6.2878,4.4338,6.3999,4.4338,6.3999,4.5627,6.2878,4.5627)" + }, + { + "content": "☐", + "span": { + "offset": 2446, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,7.3877,4.4338,7.5081,4.4338,7.5081,4.5627,7.3877,4.5627)" + }, + { + "content": "☐", + "span": { + "offset": 2528, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,6.2878,4.6057,6.3999,4.6057,6.3999,4.7346,6.2878,4.7346)" + }, + { + "content": "☐", + "span": { + "offset": 2539, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,7.3877,4.603,7.5081,4.6057,7.5081,4.7346,7.3877,4.7346)" + }, + { + "content": "☐", + "span": { + "offset": 2621, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,6.2878,4.7722,6.3999,4.7722,6.3999,4.8958,6.2878,4.8958)" + }, + { + "content": "☐", + "span": { + "offset": 2632, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,7.3877,4.7749,7.5081,4.7695,7.5081,4.8984,7.3877,4.9011)" + }, + { + "content": "Attach", + "span": { + "offset": 2685, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,0.5149,5.0784,0.8327,5.0784,0.8327,5.1804,0.5154,5.1804)" + }, + { + "content": "Sch", + "span": { + "offset": 2692, + "length": 3 + }, + "confidence": 0.99, + "source": "D(1,0.5185,5.2207,0.7016,5.2207,0.7022,5.3264,0.5196,5.325)" + }, + { + "content": ".", + "span": { + "offset": 2695, + "length": 1 + }, + "confidence": 0.992, + "source": "D(1,0.705,5.2207,0.729,5.2207,0.7295,5.3267,0.7056,5.3264)" + }, + { + "content": "B", + "span": { + "offset": 2697, + "length": 1 + }, + "confidence": 0.97, + "source": "D(1,0.7615,5.2207,0.8282,5.2207,0.8285,5.3276,0.7619,5.327)" + }, + { + "content": "if", + "span": { + "offset": 2699, + "length": 2 + }, + "confidence": 0.982, + "source": "D(1,0.8624,5.2207,0.9292,5.2207,0.9292,5.3288,0.8626,5.328)" + }, + { + "content": "required", + "span": { + "offset": 2702, + "length": 8 + }, + "confidence": 0.999, + "source": "D(1,0.5159,5.3632,0.9039,5.3606,0.906,5.4678,0.518,5.4678)" + }, + { + "content": ".", + "span": { + "offset": 2710, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.911,5.3606,0.9411,5.3607,0.9432,5.4678,0.9131,5.4678)" + }, + { + "content": "1", + "span": { + "offset": 2733, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3395,4.9629,1.3956,4.9629,1.3956,5.0572,1.3395,5.0565)" + }, + { + "content": "Wages", + "span": { + "offset": 2735, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,1.5844,4.9516,1.9319,4.9508,1.9319,5.0747,1.5844,5.0755)" + }, + { + "content": ",", + "span": { + "offset": 2740, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.9381,4.9507,1.9609,4.9507,1.9609,5.0747,1.9381,5.0747)" + }, + { + "content": "salaries", + "span": { + "offset": 2742, + "length": 8 + }, + "confidence": 0.997, + "source": "D(1,1.9981,4.9506,2.3705,4.9497,2.3705,5.0739,1.9981,5.0746)" + }, + { + "content": ",", + "span": { + "offset": 2750, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.3746,4.9497,2.3974,4.9497,2.3974,5.0738,2.3746,5.0739)" + }, + { + "content": "tips", + "span": { + "offset": 2752, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,2.4346,4.9496,2.6125,4.9495,2.6125,5.0736,2.4346,5.0738)" + }, + { + "content": ",", + "span": { + "offset": 2756, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.6167,4.9495,2.6394,4.9495,2.6394,5.0736,2.6167,5.0736)" + }, + { + "content": "etc", + "span": { + "offset": 2758, + "length": 3 + }, + "confidence": 0.918, + "source": "D(1,2.6766,4.9494,2.8297,4.9493,2.8297,5.0734,2.6766,5.0735)" + }, + { + "content": ".", + "span": { + "offset": 2761, + "length": 1 + }, + "confidence": 0.984, + "source": "D(1,2.8339,4.9493,2.8545,4.9493,2.8545,5.0733,2.8339,5.0734)" + }, + { + "content": "Attach", + "span": { + "offset": 2763, + "length": 6 + }, + "confidence": 0.881, + "source": "D(1,2.8856,4.9493,3.2186,4.9492,3.2186,5.0731,2.8856,5.0733)" + }, + { + "content": "Form", + "span": { + "offset": 2770, + "length": 4 + }, + "confidence": 0.992, + "source": "D(1,3.2517,4.9493,3.4958,4.9495,3.4958,5.0731,3.2517,5.0731)" + }, + { + "content": "(", + "span": { + "offset": 2774, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.5062,4.9495,3.5413,4.9496,3.5413,5.0731,3.5062,5.0731)" + }, + { + "content": "s", + "span": { + "offset": 2775, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.5393,4.9496,3.591,4.9496,3.591,5.0731,3.5393,5.0731)" + }, + { + "content": ")", + "span": { + "offset": 2776, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.591,4.9496,3.6241,4.9496,3.6241,5.0731,3.591,5.0731)" + }, + { + "content": "W", + "span": { + "offset": 2778, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,3.6468,4.9497,3.7565,4.9498,3.7565,5.0731,3.6468,5.0731)" + }, + { + "content": "-", + "span": { + "offset": 2779, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.7544,4.9498,3.7937,4.9498,3.7937,5.073,3.7544,5.0731)" + }, + { + "content": "2", + "span": { + "offset": 2780, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,3.7937,4.9498,3.8682,4.9499,3.8682,5.073,3.7937,5.073)" + }, + { + "content": "1", + "span": { + "offset": 2791, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.8232,4.9629,6.8772,4.9629,6.8772,5.0595,6.8232,5.0576)" + }, + { + "content": "200", + "span": { + "offset": 2802, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,7.7861,4.9521,7.9646,4.9521,7.9646,5.0515,7.7861,5.0515)" + }, + { + "content": "2a", + "span": { + "offset": 2826, + "length": 2 + }, + "confidence": 0.927, + "source": "D(1,1.3292,5.1352,1.4682,5.128,1.4682,5.23,1.3292,5.2373)" + }, + { + "content": "Tax", + "span": { + "offset": 2829, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,1.5865,5.1271,1.7735,5.1267,1.7735,5.2449,1.5865,5.2445)" + }, + { + "content": "-", + "span": { + "offset": 2832, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.7773,5.1267,1.814,5.1266,1.814,5.245,1.7773,5.2449)" + }, + { + "content": "exempt", + "span": { + "offset": 2833, + "length": 6 + }, + "confidence": 0.994, + "source": "D(1,1.814,5.1266,2.1918,5.1268,2.1918,5.2446,1.814,5.245)" + }, + { + "content": "interest", + "span": { + "offset": 2840, + "length": 8 + }, + "confidence": 0.988, + "source": "D(1,2.2246,5.1269,2.6044,5.1289,2.6044,5.2421,2.2246,5.2445)" + }, + { + "content": ".", + "span": { + "offset": 2849, + "length": 1 + }, + "confidence": 1, + "source": "D(1,2.8426,5.2059,2.8549,5.2059,2.8549,5.2182,2.8426,5.2182)" + }, + { + "content": ".", + "span": { + "offset": 2851, + "length": 1 + }, + "confidence": 1, + "source": "D(1,3.0093,5.2059,3.0216,5.2059,3.0216,5.2182,3.0093,5.2182)" + }, + { + "content": "2a", + "span": { + "offset": 2862, + "length": 2 + }, + "confidence": 0.915, + "source": "D(1,3.2788,5.1281,3.4158,5.1393,3.4158,5.236,3.2788,5.2248)" + }, + { + "content": "100", + "span": { + "offset": 2874, + "length": 3 + }, + "confidence": 0.993, + "source": "D(1,4.2749,5.126,4.4617,5.1161,4.4617,5.2182,4.2749,5.2314)" + }, + { + "content": "b", + "span": { + "offset": 2899, + "length": 1 + }, + "confidence": 0.986, + "source": "D(1,4.6858,5.1396,4.7609,5.1401,4.7609,5.2499,4.6858,5.2493)" + }, + { + "content": "Taxable", + "span": { + "offset": 2901, + "length": 7 + }, + "confidence": 0.996, + "source": "D(1,4.8195,5.1404,5.2097,5.1422,5.2097,5.2522,4.8195,5.2505)" + }, + { + "content": "interest", + "span": { + "offset": 2909, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,5.2427,5.1423,5.6238,5.1424,5.6238,5.2497,5.2427,5.2522)" + }, + { + "content": "2b", + "span": { + "offset": 2927, + "length": 2 + }, + "confidence": 0.963, + "source": "D(1,6.7776,5.1271,6.9146,5.1282,6.9146,5.2288,6.7776,5.2288)" + }, + { + "content": "300", + "span": { + "offset": 2939, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,7.7861,5.1248,7.9646,5.1141,7.9646,5.22,7.7861,5.2295)" + }, + { + "content": "3a", + "span": { + "offset": 2963, + "length": 2 + }, + "confidence": 0.919, + "source": "D(1,1.3281,5.3015,1.4682,5.302,1.4682,5.4041,1.3281,5.4036)" + }, + { + "content": "Qualified", + "span": { + "offset": 2966, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,1.5875,5.2917,2.0263,5.2895,2.0262,5.4057,1.5875,5.4071)" + }, + { + "content": "dividends", + "span": { + "offset": 2976, + "length": 9 + }, + "confidence": 0.999, + "source": "D(1,2.0593,5.2894,2.5504,5.2878,2.5504,5.3996,2.0592,5.4055)" + }, + { + "content": ".", + "span": { + "offset": 2986, + "length": 1 + }, + "confidence": 1, + "source": "D(1,2.6759,5.3725,2.6883,5.3725,2.6883,5.3849,2.6759,5.3849)" + }, + { + "content": ".", + "span": { + "offset": 2988, + "length": 1 + }, + "confidence": 1, + "source": "D(1,2.8426,5.3725,2.8549,5.3725,2.8549,5.3849,2.8426,5.3849)" + }, + { + "content": ".", + "span": { + "offset": 2990, + "length": 1 + }, + "confidence": 1, + "source": "D(1,3.0093,5.3725,3.0216,5.3725,3.0216,5.3849,3.0093,5.3849)" + }, + { + "content": "3a", + "span": { + "offset": 3001, + "length": 2 + }, + "confidence": 0.878, + "source": "D(1,3.2788,5.3056,3.4158,5.305,3.4158,5.4013,3.2788,5.4021)" + }, + { + "content": "200", + "span": { + "offset": 3013, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,4.2666,5.2825,4.4617,5.2825,4.4617,5.3879,4.2666,5.3846)" + }, + { + "content": "b", + "span": { + "offset": 3038, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,4.6899,5.3024,4.7631,5.303,4.763,5.4209,4.6899,5.4201)" + }, + { + "content": "Ordinary", + "span": { + "offset": 3040, + "length": 8 + }, + "confidence": 0.997, + "source": "D(1,4.8204,5.3034,5.2531,5.3041,5.2531,5.4223,4.8203,5.4215)" + }, + { + "content": "dividends", + "span": { + "offset": 3049, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,5.2808,5.3039,5.7649,5.2962,5.7649,5.4122,5.2807,5.4221)" + }, + { + "content": "3b", + "span": { + "offset": 3068, + "length": 2 + }, + "confidence": 0.907, + "source": "D(1,6.7734,5.2932,6.9146,5.2932,6.9146,5.3953,6.7734,5.3953)" + }, + { + "content": "200", + "span": { + "offset": 3080, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,7.7861,5.2825,7.9646,5.2825,7.9646,5.3845,7.7861,5.3845)" + }, + { + "content": "4a", + "span": { + "offset": 3104, + "length": 2 + }, + "confidence": 0.943, + "source": "D(1,1.3302,5.4651,1.4672,5.4651,1.4672,5.5645,1.3302,5.5645)" + }, + { + "content": "IRA", + "span": { + "offset": 3107, + "length": 3 + }, + "confidence": 0.994, + "source": "D(1,1.5896,5.4597,1.7702,5.4597,1.7702,5.5698,1.5896,5.5698)" + }, + { + "content": "distributions", + "span": { + "offset": 3111, + "length": 13 + }, + "confidence": 0.995, + "source": "D(1,1.8,5.4597,2.4238,5.4597,2.4238,5.5698,1.8,5.5698)" + }, + { + "content": "4a", + "span": { + "offset": 3134, + "length": 2 + }, + "confidence": 0.947, + "source": "D(1,3.2747,5.4678,3.4158,5.4678,3.4158,5.5645,3.2747,5.5645)" + }, + { + "content": "300", + "span": { + "offset": 3146, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,4.2666,5.4513,4.47,5.4454,4.47,5.5534,4.2666,5.5584)" + }, + { + "content": "b", + "span": { + "offset": 3171, + "length": 1 + }, + "confidence": 0.985, + "source": "D(1,4.6858,5.4597,4.7612,5.4597,4.7612,5.5698,4.6858,5.5698)" + }, + { + "content": "Taxable", + "span": { + "offset": 3173, + "length": 7 + }, + "confidence": 0.996, + "source": "D(1,4.8201,5.4597,5.2137,5.4597,5.2137,5.5698,4.8201,5.5698)" + }, + { + "content": "amount", + "span": { + "offset": 3181, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,5.2431,5.4597,5.657,5.4597,5.657,5.5698,5.2431,5.5698)" + }, + { + "content": "4b", + "span": { + "offset": 3197, + "length": 2 + }, + "confidence": 0.981, + "source": "D(1,6.7776,5.4598,6.9146,5.4624,6.9146,5.5583,6.7776,5.5582)" + }, + { + "content": "100", + "span": { + "offset": 3209, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,7.7903,5.4525,7.9687,5.4516,7.9687,5.5594,7.7903,5.5598)" + }, + { + "content": "5a", + "span": { + "offset": 3233, + "length": 2 + }, + "confidence": 0.716, + "source": "D(1,1.3302,5.6279,1.4672,5.6253,1.4672,5.7274,1.3302,5.73)" + }, + { + "content": "Pensions", + "span": { + "offset": 3236, + "length": 8 + }, + "confidence": 0.995, + "source": "D(1,1.5875,5.6235,2.0454,5.6204,2.0454,5.7384,1.5875,5.7389)" + }, + { + "content": "and", + "span": { + "offset": 3245, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,2.0779,5.6203,2.261,5.6196,2.261,5.7369,2.0778,5.7382)" + }, + { + "content": "annuities", + "span": { + "offset": 3249, + "length": 9 + }, + "confidence": 0.991, + "source": "D(1,2.2973,5.6194,2.7476,5.6189,2.7476,5.7306,2.2973,5.7366)" + }, + { + "content": ".", + "span": { + "offset": 3259, + "length": 1 + }, + "confidence": 1, + "source": "D(1,2.8426,5.7059,2.8549,5.7059,2.8549,5.7182,2.8426,5.7182)" + }, + { + "content": ".", + "span": { + "offset": 3261, + "length": 1 + }, + "confidence": 1, + "source": "D(1,3.0093,5.7059,3.0216,5.7059,3.0216,5.7182,3.0093,5.7182)" + }, + { + "content": "5a", + "span": { + "offset": 3272, + "length": 2 + }, + "confidence": 0.531, + "source": "D(1,3.2788,5.628,3.4116,5.6253,3.4116,5.7219,3.2788,5.7247)" + }, + { + "content": "200", + "span": { + "offset": 3284, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,4.2666,5.6128,4.4617,5.6128,4.4617,5.7202,4.2666,5.7202)" + }, + { + "content": "b", + "span": { + "offset": 3309, + "length": 1 + }, + "confidence": 0.987, + "source": "D(1,4.6899,5.6234,4.7607,5.6238,4.7607,5.7316,4.6899,5.7308)" + }, + { + "content": "Taxable", + "span": { + "offset": 3311, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,4.8192,5.6242,5.2121,5.6244,5.2121,5.733,4.8191,5.7322)" + }, + { + "content": "amount", + "span": { + "offset": 3319, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,5.2422,5.6243,5.6528,5.6188,5.6528,5.7252,5.2422,5.7329)" + }, + { + "content": "5b", + "span": { + "offset": 3335, + "length": 2 + }, + "confidence": 0.948, + "source": "D(1,6.7776,5.6292,6.9146,5.6303,6.9146,5.727,6.7776,5.7259)" + }, + { + "content": "400", + "span": { + "offset": 3347, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,7.7861,5.6147,7.9687,5.6131,7.9687,5.7202,7.7861,5.7202)" + }, + { + "content": "Standard", + "span": { + "offset": 3384, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,0.4475,5.8071,0.8804,5.8063,0.8804,5.903,0.4485,5.9038)" + }, + { + "content": "Deduction", + "span": { + "offset": 3393, + "length": 9 + }, + "confidence": 0.997, + "source": "D(1,0.4501,5.913,0.9203,5.9149,0.9205,6.0116,0.4508,6.0097)" + }, + { + "content": "for", + "span": { + "offset": 3403, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,0.9492,5.9147,1.0877,5.9135,1.0878,6.0102,0.9495,6.0114)" + }, + { + "content": "-", + "span": { + "offset": 3406, + "length": 1 + }, + "confidence": 0.981, + "source": "D(1,1.0845,5.9135,1.1714,5.9127,1.1714,6.0094,1.0846,6.0102)" + }, + { + "content": ".", + "span": { + "offset": 3408, + "length": 1 + }, + "confidence": 0.929, + "source": "D(1,0.4578,6.0518,0.496,6.0519,0.4966,6.1485,0.4586,6.1485)" + }, + { + "content": "Single", + "span": { + "offset": 3410, + "length": 6 + }, + "confidence": 0.987, + "source": "D(1,0.5198,6.0519,0.7755,6.0485,0.7756,6.1452,0.5204,6.1486)" + }, + { + "content": "or", + "span": { + "offset": 3417, + "length": 2 + }, + "confidence": 0.998, + "source": "D(1,0.7977,6.0477,0.8897,6.0443,0.8897,6.141,0.7978,6.1444)" + }, + { + "content": "Married", + "span": { + "offset": 3420, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,0.5178,6.1507,0.8262,6.1504,0.8258,6.2471,0.5183,6.2474)" + }, + { + "content": "filing", + "span": { + "offset": 3428, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,0.8534,6.1507,1.0547,6.1556,1.0537,6.2523,0.8529,6.2474)" + }, + { + "content": "separately", + "span": { + "offset": 3435, + "length": 10 + }, + "confidence": 0.998, + "source": "D(1,0.5146,6.2596,0.9417,6.2557,0.9418,6.3513,0.5157,6.3426)" + }, + { + "content": ",", + "span": { + "offset": 3445, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,0.9417,6.2557,0.967,6.2564,0.967,6.352,0.9418,6.3513)" + }, + { + "content": "$", + "span": { + "offset": 3447, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,0.5128,6.3433,0.5692,6.3433,0.5696,6.4399,0.5134,6.4399)" + }, + { + "content": "12,400", + "span": { + "offset": 3448, + "length": 6 + }, + "confidence": 0.964, + "source": "D(1,0.5742,6.3433,0.8576,6.3433,0.8576,6.4399,0.5746,6.4399)" + }, + { + "content": ".", + "span": { + "offset": 3455, + "length": 1 + }, + "confidence": 0.891, + "source": "D(1,0.4578,6.4597,0.4966,6.4608,0.4973,6.5575,0.4586,6.5564)" + }, + { + "content": "Married", + "span": { + "offset": 3457, + "length": 7 + }, + "confidence": 0.992, + "source": "D(1,0.5257,6.4616,0.8293,6.4691,0.8296,6.5658,0.5264,6.5582)" + }, + { + "content": "filing", + "span": { + "offset": 3465, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,0.8567,6.4697,1.0521,6.4737,1.0521,6.5704,0.857,6.5664)" + }, + { + "content": "jointly", + "span": { + "offset": 3472, + "length": 7 + }, + "confidence": 0.992, + "source": "D(1,0.5113,6.5704,0.7627,6.566,0.7629,6.6594,0.5121,6.6593)" + }, + { + "content": "or", + "span": { + "offset": 3480, + "length": 2 + }, + "confidence": 0.998, + "source": "D(1,0.7808,6.5667,0.8726,6.5703,0.8726,6.6559,0.781,6.6588)" + }, + { + "content": "Qualifying", + "span": { + "offset": 3483, + "length": 10 + }, + "confidence": 0.996, + "source": "D(1,0.5162,6.6655,0.9312,6.6655,0.9302,6.7622,0.5162,6.7622)" + }, + { + "content": "widow", + "span": { + "offset": 3494, + "length": 5 + }, + "confidence": 0.999, + "source": "D(1,0.5159,6.7622,0.7817,6.7622,0.7819,6.8589,0.5165,6.8589)" + }, + { + "content": "(", + "span": { + "offset": 3499, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.785,6.7622,0.8147,6.7622,0.8149,6.8589,0.7852,6.8589)" + }, + { + "content": "er", + "span": { + "offset": 3500, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,0.8065,6.7622,0.8873,6.7622,0.8874,6.8589,0.8066,6.8589)" + }, + { + "content": ")", + "span": { + "offset": 3502, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.8824,6.7622,0.9104,6.7622,0.9105,6.8589,0.8825,6.8589)" + }, + { + "content": ",", + "span": { + "offset": 3503, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,0.9121,6.7622,0.9385,6.7622,0.9385,6.8589,0.9121,6.8589)" + }, + { + "content": "$", + "span": { + "offset": 3505, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.5136,6.8649,0.5683,6.8627,0.569,6.9594,0.5144,6.9616)" + }, + { + "content": "24,800", + "span": { + "offset": 3506, + "length": 6 + }, + "confidence": 0.984, + "source": "D(1,0.5683,6.8627,0.8586,6.8665,0.8586,6.9631,0.569,6.9594)" + }, + { + "content": ".", + "span": { + "offset": 3513, + "length": 1 + }, + "confidence": 0.933, + "source": "D(1,0.4589,6.9786,0.4961,6.9772,0.4966,7.0651,0.4594,7.064)" + }, + { + "content": "Head", + "span": { + "offset": 3515, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,0.524,6.9762,0.7366,6.9743,0.7368,7.0689,0.5245,7.0659)" + }, + { + "content": "of", + "span": { + "offset": 3520, + "length": 2 + }, + "confidence": 0.998, + "source": "D(1,0.7614,6.9751,0.856,6.9785,0.856,7.0675,0.7615,7.0686)" + }, + { + "content": "household", + "span": { + "offset": 3523, + "length": 9 + }, + "confidence": 0.999, + "source": "D(1,0.5126,7.0791,0.9419,7.0791,0.942,7.1758,0.5136,7.1758)" + }, + { + "content": ",", + "span": { + "offset": 3532, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,0.9451,7.0791,0.9722,7.0791,0.9722,7.1758,0.9452,7.1758)" + }, + { + "content": "$", + "span": { + "offset": 3534, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,0.5167,7.1702,0.5677,7.1697,0.5681,7.2664,0.5172,7.2669)" + }, + { + "content": "18,650", + "span": { + "offset": 3535, + "length": 6 + }, + "confidence": 0.977, + "source": "D(1,0.5743,7.1696,0.8586,7.1713,0.8586,7.268,0.5747,7.2663)" + }, + { + "content": ".", + "span": { + "offset": 3542, + "length": 1 + }, + "confidence": 0.791, + "source": "D(1,0.4576,7.306,0.4953,7.3051,0.4966,7.3997,0.4589,7.4002)" + }, + { + "content": "If", + "span": { + "offset": 3544, + "length": 2 + }, + "confidence": 0.839, + "source": "D(1,0.5221,7.3044,0.5756,7.3031,0.5767,7.3986,0.5233,7.3993)" + }, + { + "content": "you", + "span": { + "offset": 3547, + "length": 3 + }, + "confidence": 0.987, + "source": "D(1,0.5882,7.3028,0.733,7.3,0.7338,7.3967,0.5893,7.3984)" + }, + { + "content": "checked", + "span": { + "offset": 3551, + "length": 7 + }, + "confidence": 0.993, + "source": "D(1,0.7597,7.2997,1.1123,7.299,1.1123,7.3951,0.7605,7.3965)" + }, + { + "content": "any", + "span": { + "offset": 3559, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,0.5162,7.4011,0.6643,7.3964,0.6655,7.4869,0.5178,7.4854)" + }, + { + "content": "box", + "span": { + "offset": 3563, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,0.6878,7.3956,0.836,7.3945,0.8367,7.4872,0.6889,7.4871)" + }, + { + "content": "under", + "span": { + "offset": 3567, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,0.8595,7.3945,1.103,7.3996,1.103,7.4848,0.8601,7.4872)" + }, + { + "content": "Standard", + "span": { + "offset": 3573, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,0.5157,7.4975,0.8939,7.4981,0.8939,7.5841,0.5165,7.583)" + }, + { + "content": "Deduction", + "span": { + "offset": 3582, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,0.5162,7.5947,0.9239,7.5843,0.9239,7.681,0.5162,7.6914)" + }, + { + "content": ",", + "span": { + "offset": 3591, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,0.9271,7.5841,0.9494,7.5831,0.9494,7.6798,0.9271,7.6808)" + }, + { + "content": "see", + "span": { + "offset": 3593, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,0.5136,7.6916,0.659,7.6896,0.6598,7.7796,0.5146,7.7758)" + }, + { + "content": "instructions", + "span": { + "offset": 3597, + "length": 12 + }, + "confidence": 0.997, + "source": "D(1,0.6854,7.6893,1.145,7.6927,1.1451,7.7765,0.6862,7.7803)" + }, + { + "content": ".", + "span": { + "offset": 3609, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.148,7.6927,1.1714,7.6932,1.1714,7.7758,1.148,7.7764)" + }, + { + "content": "6a", + "span": { + "offset": 3620, + "length": 2 + }, + "confidence": 0.86, + "source": "D(1,1.3292,5.7954,1.4661,5.7954,1.4661,5.8975,1.3292,5.8975)" + }, + { + "content": "Social", + "span": { + "offset": 3623, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,1.5875,5.7906,1.8982,5.789,1.8982,5.9087,1.5875,5.9078)" + }, + { + "content": "security", + "span": { + "offset": 3630, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,1.9297,5.7889,2.323,5.7887,2.323,5.9089,1.9297,5.9088)" + }, + { + "content": "benefits", + "span": { + "offset": 3639, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,2.3505,5.7887,2.7517,5.7909,2.7517,5.9078,2.3505,5.9089)" + }, + { + "content": ".", + "span": { + "offset": 3648, + "length": 1 + }, + "confidence": 1, + "source": "D(1,3.0093,5.8725,3.0216,5.8725,3.0216,5.8849,3.0093,5.8849)" + }, + { + "content": "6a", + "span": { + "offset": 3659, + "length": 2 + }, + "confidence": 0.949, + "source": "D(1,3.2788,5.8008,3.422,5.8008,3.422,5.8975,3.2788,5.8975)" + }, + { + "content": "100", + "span": { + "offset": 3683, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,4.2749,5.784,4.4617,5.7701,4.4617,5.8775,4.2749,5.8914)" + }, + { + "content": "b", + "span": { + "offset": 3687, + "length": 1 + }, + "confidence": 0.985, + "source": "D(1,4.6899,5.7899,4.7611,5.7903,4.7611,5.9028,4.6899,5.9028)" + }, + { + "content": "Taxable", + "span": { + "offset": 3689, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,4.8194,5.7906,5.2133,5.7931,5.2133,5.9028,4.8194,5.9028)" + }, + { + "content": "amount", + "span": { + "offset": 3697, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,5.2425,5.7933,5.6528,5.7964,5.6528,5.9028,5.2425,5.9028)" + }, + { + "content": "6b", + "span": { + "offset": 3713, + "length": 2 + }, + "confidence": 0.946, + "source": "D(1,6.7776,5.8008,6.9146,5.8008,6.9146,5.8975,6.7776,5.8975)" + }, + { + "content": "500", + "span": { + "offset": 3725, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,7.7861,5.7865,7.9646,5.7862,7.9646,5.8936,7.7861,5.8939)" + }, + { + "content": "7", + "span": { + "offset": 3761, + "length": 1 + }, + "confidence": 0.992, + "source": "D(1,1.3312,5.9565,1.4028,5.9565,1.4028,6.0532,1.3312,6.0532)" + }, + { + "content": "Capital", + "span": { + "offset": 3763, + "length": 7 + }, + "confidence": 0.995, + "source": "D(1,1.5906,5.9454,1.9394,5.9464,1.9394,6.0749,1.5906,6.0735)" + }, + { + "content": "gain", + "span": { + "offset": 3771, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,1.9713,5.9465,2.1797,5.9471,2.1797,6.0758,1.9713,6.075)" + }, + { + "content": "or", + "span": { + "offset": 3776, + "length": 2 + }, + "confidence": 0.994, + "source": "D(1,2.2137,5.9472,2.3179,5.9474,2.3179,6.0764,2.2137,6.0759)" + }, + { + "content": "(", + "span": { + "offset": 3779, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.3413,5.9475,2.3732,5.9476,2.3732,6.0766,2.3413,6.0764)" + }, + { + "content": "loss", + "span": { + "offset": 3780, + "length": 4 + }, + "confidence": 0.989, + "source": "D(1,2.3774,5.9476,2.5646,5.9481,2.5646,6.0773,2.3774,6.0766)" + }, + { + "content": ")", + "span": { + "offset": 3784, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.5688,5.9481,2.6029,5.9482,2.6029,6.0775,2.5688,6.0773)" + }, + { + "content": ".", + "span": { + "offset": 3785, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,2.6071,5.9482,2.6284,5.9483,2.6284,6.0776,2.6071,6.0775)" + }, + { + "content": "Attach", + "span": { + "offset": 3787, + "length": 6 + }, + "confidence": 0.972, + "source": "D(1,2.6603,5.9484,2.9814,5.9492,2.9814,6.0787,2.6603,6.0777)" + }, + { + "content": "Schedule", + "span": { + "offset": 3794, + "length": 8 + }, + "confidence": 0.981, + "source": "D(1,3.0154,5.9493,3.4875,5.9501,3.4875,6.0791,3.0154,6.0787)" + }, + { + "content": "D", + "span": { + "offset": 3803, + "length": 1 + }, + "confidence": 0.977, + "source": "D(1,3.5151,5.9501,3.5896,5.9502,3.5896,6.0792,3.5151,6.0791)" + }, + { + "content": "if", + "span": { + "offset": 3805, + "length": 2 + }, + "confidence": 0.929, + "source": "D(1,3.6257,5.9503,3.6874,5.9504,3.6874,6.0793,3.6257,6.0792)" + }, + { + "content": "required", + "span": { + "offset": 3808, + "length": 8 + }, + "confidence": 0.523, + "source": "D(1,3.715,5.9504,4.1191,5.9511,4.1191,6.0796,3.715,6.0793)" + }, + { + "content": ".", + "span": { + "offset": 3816, + "length": 1 + }, + "confidence": 0.962, + "source": "D(1,4.1254,5.9511,4.1488,5.9512,4.1488,6.0797,4.1254,6.0797)" + }, + { + "content": "If", + "span": { + "offset": 3818, + "length": 2 + }, + "confidence": 0.844, + "source": "D(1,4.1892,5.9513,4.253,5.9513,4.253,6.0796,4.1892,6.0797)" + }, + { + "content": "not", + "span": { + "offset": 3821, + "length": 3 + }, + "confidence": 0.876, + "source": "D(1,4.2785,5.9513,4.4402,5.9514,4.4402,6.0792,4.2786,6.0795)" + }, + { + "content": "required", + "span": { + "offset": 3825, + "length": 8 + }, + "confidence": 0.877, + "source": "D(1,4.4721,5.9515,4.8761,5.9517,4.8761,6.0782,4.4721,6.0791)" + }, + { + "content": ",", + "span": { + "offset": 3833, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,4.8846,5.9517,4.908,5.9517,4.908,6.0781,4.8846,6.0781)" + }, + { + "content": "check", + "span": { + "offset": 3835, + "length": 5 + }, + "confidence": 0.963, + "source": "D(1,4.9399,5.9518,5.2504,5.952,5.2504,6.0773,4.9399,6.078)" + }, + { + "content": "here", + "span": { + "offset": 3841, + "length": 4 + }, + "confidence": 0.945, + "source": "D(1,5.2759,5.952,5.5034,5.9521,5.5034,6.0767,5.2759,6.0772)" + }, + { + "content": "☐", + "span": { + "offset": 3846, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,6.458,5.9351,6.5825,5.9404,6.5825,6.0586,6.458,6.0586)" + }, + { + "content": "7", + "span": { + "offset": 3857, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,6.8149,5.9559,6.8813,5.962,6.8813,6.0527,6.8149,6.0528)" + }, + { + "content": "100", + "span": { + "offset": 3868, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,7.7903,5.9512,7.9687,5.9512,7.9687,6.0527,7.7903,6.053)" + }, + { + "content": "8", + "span": { + "offset": 3904, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3271,6.1284,1.408,6.1284,1.408,6.2251,1.3271,6.2251)" + }, + { + "content": "Other", + "span": { + "offset": 3906, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,1.5886,6.1249,1.8748,6.1202,1.8757,6.2405,1.5896,6.2431)" + }, + { + "content": "income", + "span": { + "offset": 3912, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,1.903,6.1197,2.2659,6.1145,2.2666,6.2373,1.9039,6.2402)" + }, + { + "content": "from", + "span": { + "offset": 3919, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,2.2941,6.1145,2.5199,6.1143,2.5204,6.2373,2.2948,6.2373)" + }, + { + "content": "Schedule", + "span": { + "offset": 3924, + "length": 8 + }, + "confidence": 0.98, + "source": "D(1,2.5562,6.1143,3.0239,6.1169,3.0242,6.239,2.5567,6.2373)" + }, + { + "content": "1", + "span": { + "offset": 3933, + "length": 1 + }, + "confidence": 0.966, + "source": "D(1,3.0602,6.1175,3.0985,6.118,3.0987,6.2397,3.0604,6.2394)" + }, + { + "content": ",", + "span": { + "offset": 3934, + "length": 1 + }, + "confidence": 0.989, + "source": "D(1,3.1167,6.1183,3.1429,6.1187,3.143,6.2401,3.1168,6.2399)" + }, + { + "content": "line", + "span": { + "offset": 3936, + "length": 4 + }, + "confidence": 0.878, + "source": "D(1,3.1791,6.1193,3.3485,6.1218,3.3485,6.242,3.1793,6.2405)" + }, + { + "content": "9", + "span": { + "offset": 3941, + "length": 1 + }, + "confidence": 0.931, + "source": "D(1,3.3747,6.1222,3.4594,6.1235,3.4594,6.2431,3.3747,6.2423)" + }, + { + "content": "8", + "span": { + "offset": 3952, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.8149,6.1284,6.8855,6.1284,6.8855,6.2251,6.8149,6.2251)" + }, + { + "content": "180", + "span": { + "offset": 3963, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,7.7861,6.1131,7.9687,6.1163,7.9687,6.2126,7.7861,6.2165)" + }, + { + "content": "9", + "span": { + "offset": 3999, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3292,6.2949,1.4018,6.2949,1.4018,6.3916,1.3292,6.3916)" + }, + { + "content": "Add", + "span": { + "offset": 4001, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,1.5875,6.2849,1.7918,6.2841,1.7918,6.4047,1.5875,6.4036)" + }, + { + "content": "lines", + "span": { + "offset": 4005, + "length": 5 + }, + "confidence": 0.942, + "source": "D(1,1.8286,6.2839,2.0513,6.283,2.0513,6.4061,1.8286,6.4049)" + }, + { + "content": "1", + "span": { + "offset": 4011, + "length": 1 + }, + "confidence": 0.879, + "source": "D(1,2.0922,6.2828,2.1249,6.2827,2.1249,6.4065,2.0922,6.4064)" + }, + { + "content": ",", + "span": { + "offset": 4012, + "length": 1 + }, + "confidence": 0.937, + "source": "D(1,2.1453,6.2826,2.1678,6.2825,2.1678,6.4068,2.1453,6.4066)" + }, + { + "content": "2b", + "span": { + "offset": 4014, + "length": 2 + }, + "confidence": 0.899, + "source": "D(1,2.2045,6.2824,2.3333,6.2818,2.3333,6.4077,2.2045,6.407)" + }, + { + "content": ",", + "span": { + "offset": 4016, + "length": 1 + }, + "confidence": 0.989, + "source": "D(1,2.3373,6.2818,2.3598,6.2817,2.3598,6.4078,2.3373,6.4077)" + }, + { + "content": "3b", + "span": { + "offset": 4018, + "length": 2 + }, + "confidence": 0.948, + "source": "D(1,2.3966,6.2816,2.5233,6.281,2.5233,6.4087,2.3966,6.408)" + }, + { + "content": ",", + "span": { + "offset": 4020, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,2.5253,6.281,2.5498,6.2809,2.5498,6.4089,2.5253,6.4087)" + }, + { + "content": "4b", + "span": { + "offset": 4022, + "length": 2 + }, + "confidence": 0.962, + "source": "D(1,2.5825,6.2808,2.7133,6.2804,2.7133,6.4096,2.5825,6.409)" + }, + { + "content": ",", + "span": { + "offset": 4024, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,2.7174,6.2804,2.7378,6.2804,2.7378,6.4097,2.7174,6.4096)" + }, + { + "content": "5b", + "span": { + "offset": 4026, + "length": 2 + }, + "confidence": 0.956, + "source": "D(1,2.7746,6.2805,2.9012,6.2808,2.9012,6.4099,2.7746,6.4097)" + }, + { + "content": ",", + "span": { + "offset": 4028, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,2.9053,6.2808,2.9278,6.2808,2.9278,6.4099,2.9053,6.4099)" + }, + { + "content": "6b", + "span": { + "offset": 4030, + "length": 2 + }, + "confidence": 0.944, + "source": "D(1,2.9646,6.2809,3.0913,6.2811,3.0912,6.4101,2.9646,6.4099)" + }, + { + "content": ",", + "span": { + "offset": 4032, + "length": 1 + }, + "confidence": 0.984, + "source": "D(1,3.0953,6.2811,3.1199,6.2812,3.1198,6.4101,3.0953,6.4101)" + }, + { + "content": "7", + "span": { + "offset": 4034, + "length": 1 + }, + "confidence": 0.945, + "source": "D(1,3.1546,6.2813,3.2118,6.2814,3.2118,6.4102,3.1546,6.4101)" + }, + { + "content": ",", + "span": { + "offset": 4035, + "length": 1 + }, + "confidence": 0.983, + "source": "D(1,3.2159,6.2814,3.2404,6.2814,3.2404,6.4102,3.2159,6.4102)" + }, + { + "content": "and", + "span": { + "offset": 4037, + "length": 3 + }, + "confidence": 0.846, + "source": "D(1,3.2772,6.2815,3.4611,6.2819,3.461,6.4105,3.2772,6.4103)" + }, + { + "content": "8", + "span": { + "offset": 4041, + "length": 1 + }, + "confidence": 0.854, + "source": "D(1,3.4958,6.2819,3.555,6.282,3.555,6.4106,3.4958,6.4105)" + }, + { + "content": ".", + "span": { + "offset": 4042, + "length": 1 + }, + "confidence": 0.959, + "source": "D(1,3.5632,6.2821,3.5857,6.2821,3.5857,6.4106,3.5632,6.4106)" + }, + { + "content": "This", + "span": { + "offset": 4044, + "length": 4 + }, + "confidence": 0.697, + "source": "D(1,3.6204,6.2822,3.8268,6.2828,3.8268,6.4107,3.6204,6.4107)" + }, + { + "content": "is", + "span": { + "offset": 4049, + "length": 2 + }, + "confidence": 0.991, + "source": "D(1,3.8615,6.2831,3.9391,6.2837,3.9391,6.4104,3.8615,6.4106)" + }, + { + "content": "your", + "span": { + "offset": 4052, + "length": 4 + }, + "confidence": 0.975, + "source": "D(1,3.9657,6.2839,4.1925,6.2858,4.1925,6.4096,3.9657,6.4103)" + }, + { + "content": "total", + "span": { + "offset": 4057, + "length": 5 + }, + "confidence": 0.943, + "source": "D(1,4.217,6.286,4.454,6.2879,4.454,6.4087,4.217,6.4095)" + }, + { + "content": "income", + "span": { + "offset": 4063, + "length": 6 + }, + "confidence": 0.835, + "source": "D(1,4.4887,6.2882,4.8892,6.2914,4.8892,6.4073,4.4887,6.4086)" + }, + { + "content": "9", + "span": { + "offset": 4079, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.8232,6.2949,6.8772,6.2949,6.8772,6.3916,6.8232,6.3916)" + }, + { + "content": "1980", + "span": { + "offset": 4090, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,7.7239,6.2796,7.9646,6.2794,7.9646,6.3869,7.7239,6.387)" + }, + { + "content": "10", + "span": { + "offset": 4127, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2752,6.4614,1.4008,6.4614,1.4008,6.5581,1.2752,6.5581)" + }, + { + "content": "Adjustments", + "span": { + "offset": 4130, + "length": 11 + }, + "confidence": 0.994, + "source": "D(1,1.5854,6.447,2.2182,6.4601,2.2188,6.5783,1.5865,6.5652)" + }, + { + "content": "to", + "span": { + "offset": 4142, + "length": 2 + }, + "confidence": 0.996, + "source": "D(1,2.2457,6.4602,2.3456,6.4604,2.346,6.5785,2.2462,6.5784)" + }, + { + "content": "income", + "span": { + "offset": 4145, + "length": 6 + }, + "confidence": 0.994, + "source": "D(1,2.3789,6.4605,2.7414,6.4502,2.7414,6.5684,2.3793,6.5786)" + }, + { + "content": ":", + "span": { + "offset": 4151, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.7433,6.4502,2.7766,6.4492,2.7766,6.5674,2.7433,6.5683)" + }, + { + "content": "400", + "span": { + "offset": 4196, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,7.7861,6.9556,7.9646,6.9556,7.9646,7.0522,7.7861,7.0522)" + }, + { + "content": "a", + "span": { + "offset": 4232, + "length": 1 + }, + "confidence": 0.953, + "source": "D(1,1.3935,6.6423,1.4672,6.6438,1.4672,6.7298,1.3935,6.7283)" + }, + { + "content": "From", + "span": { + "offset": 4234, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,1.5865,6.6226,1.8433,6.6226,1.8433,6.7407,1.5865,6.7407)" + }, + { + "content": "Schedule", + "span": { + "offset": 4239, + "length": 8 + }, + "confidence": 0.991, + "source": "D(1,1.8766,6.6226,2.347,6.6226,2.347,6.7407,1.8766,6.7407)" + }, + { + "content": "1", + "span": { + "offset": 4248, + "length": 1 + }, + "confidence": 0.974, + "source": "D(1,2.3823,6.6226,2.4215,6.6226,2.4215,6.7407,2.3823,6.7407)" + }, + { + "content": ",", + "span": { + "offset": 4249, + "length": 1 + }, + "confidence": 0.992, + "source": "D(1,2.4372,6.6226,2.4626,6.6226,2.4626,6.7407,2.4372,6.7407)" + }, + { + "content": "line", + "span": { + "offset": 4251, + "length": 4 + }, + "confidence": 0.953, + "source": "D(1,2.4999,6.6226,2.6704,6.6226,2.6704,6.7407,2.4999,6.7407)" + }, + { + "content": "22", + "span": { + "offset": 4256, + "length": 2 + }, + "confidence": 0.977, + "source": "D(1,2.6959,6.6226,2.8409,6.6226,2.8409,6.7407,2.6959,6.7407)" + }, + { + "content": "10a", + "span": { + "offset": 4268, + "length": 3 + }, + "confidence": 0.989, + "source": "D(1,5.4536,6.6333,5.6445,6.6333,5.6445,6.73,5.4536,6.73)" + }, + { + "content": "200", + "span": { + "offset": 4281, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,6.4663,6.6172,6.6655,6.6172,6.6655,6.7246,6.4663,6.7246)" + }, + { + "content": "b", + "span": { + "offset": 4317, + "length": 1 + }, + "confidence": 0.979, + "source": "D(1,1.3893,6.8052,1.4661,6.8052,1.4661,6.9019,1.3893,6.9019)" + }, + { + "content": "Charitable", + "span": { + "offset": 4319, + "length": 10 + }, + "confidence": 0.996, + "source": "D(1,1.5875,6.7944,2.0871,6.7941,2.088,6.9129,1.5886,6.9127)" + }, + { + "content": "contributions", + "span": { + "offset": 4330, + "length": 13 + }, + "confidence": 0.996, + "source": "D(1,2.1148,6.7941,2.7452,6.7938,2.746,6.9133,2.1157,6.9129)" + }, + { + "content": "if", + "span": { + "offset": 4344, + "length": 2 + }, + "confidence": 0.997, + "source": "D(1,2.7789,6.7938,2.8424,6.7937,2.8431,6.9133,2.7796,6.9133)" + }, + { + "content": "you", + "span": { + "offset": 4347, + "length": 3 + }, + "confidence": 0.974, + "source": "D(1,2.8582,6.7937,3.0347,6.7938,3.0353,6.9133,2.8589,6.9133)" + }, + { + "content": "take", + "span": { + "offset": 4351, + "length": 4 + }, + "confidence": 0.972, + "source": "D(1,3.0704,6.7938,3.2765,6.7938,3.2771,6.9132,3.071,6.9133)" + }, + { + "content": "the", + "span": { + "offset": 4356, + "length": 3 + }, + "confidence": 0.985, + "source": "D(1,3.3043,6.7938,3.4569,6.7938,3.4574,6.9132,3.3048,6.9132)" + }, + { + "content": "standard", + "span": { + "offset": 4360, + "length": 8 + }, + "confidence": 0.982, + "source": "D(1,3.4867,6.7938,3.9089,6.7939,3.9093,6.9131,3.4872,6.9132)" + }, + { + "content": "deduction", + "span": { + "offset": 4369, + "length": 9 + }, + "confidence": 0.837, + "source": "D(1,3.9406,6.7939,4.4223,6.7942,4.4226,6.9128,3.941,6.9131)" + }, + { + "content": ".", + "span": { + "offset": 4378, + "length": 1 + }, + "confidence": 0.977, + "source": "D(1,4.4283,6.7942,4.4501,6.7943,4.4503,6.9128,4.4285,6.9128)" + }, + { + "content": "See", + "span": { + "offset": 4380, + "length": 3 + }, + "confidence": 0.836, + "source": "D(1,4.4838,6.7943,4.6721,6.7944,4.6723,6.9126,4.484,6.9128)" + }, + { + "content": "instructions", + "span": { + "offset": 4384, + "length": 12 + }, + "confidence": 0.932, + "source": "D(1,4.7058,6.7945,5.2668,6.7949,5.2668,6.9121,4.706,6.9126)" + }, + { + "content": "10b", + "span": { + "offset": 4406, + "length": 3 + }, + "confidence": 0.965, + "source": "D(1,5.4453,6.8013,5.6445,6.788,5.6445,6.8954,5.4453,6.9088)" + }, + { + "content": "200", + "span": { + "offset": 4419, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,6.4705,6.7837,6.6655,6.7837,6.6655,6.8911,6.4705,6.8911)" + }, + { + "content": "c", + "span": { + "offset": 4455, + "length": 1 + }, + "confidence": 1, + "source": "D(1,1.4042,6.9925,1.4609,6.9925,1.4609,7.053,1.4042,7.053)" + }, + { + "content": "Add", + "span": { + "offset": 4457, + "length": 3 + }, + "confidence": 0.978, + "source": "D(1,1.5834,6.9563,1.7928,6.9558,1.7938,7.0742,1.5844,7.0732)" + }, + { + "content": "lines", + "span": { + "offset": 4461, + "length": 5 + }, + "confidence": 0.904, + "source": "D(1,1.8267,6.9557,2.0462,6.9552,2.0471,7.0753,1.8277,7.0743)" + }, + { + "content": "10a", + "span": { + "offset": 4467, + "length": 3 + }, + "confidence": 0.871, + "source": "D(1,2.088,6.9551,2.2636,6.9547,2.2644,7.0763,2.0889,7.0755)" + }, + { + "content": "and", + "span": { + "offset": 4471, + "length": 3 + }, + "confidence": 0.899, + "source": "D(1,2.2935,6.9546,2.473,6.9542,2.4738,7.0772,2.2943,7.0764)" + }, + { + "content": "10b", + "span": { + "offset": 4475, + "length": 3 + }, + "confidence": 0.688, + "source": "D(1,2.5189,6.9541,2.7004,6.9537,2.7011,7.0783,2.5197,7.0774)" + }, + { + "content": ".", + "span": { + "offset": 4478, + "length": 1 + }, + "confidence": 0.947, + "source": "D(1,2.7024,6.9537,2.7244,6.9536,2.7251,7.0784,2.7031,7.0783)" + }, + { + "content": "These", + "span": { + "offset": 4480, + "length": 5 + }, + "confidence": 0.83, + "source": "D(1,2.7583,6.9536,3.0655,6.9543,3.0661,7.0788,2.759,7.0784)" + }, + { + "content": "are", + "span": { + "offset": 4486, + "length": 3 + }, + "confidence": 0.986, + "source": "D(1,3.0934,6.9543,3.249,6.9546,3.2495,7.0791,3.094,7.0789)" + }, + { + "content": "your", + "span": { + "offset": 4490, + "length": 4 + }, + "confidence": 0.974, + "source": "D(1,3.2789,6.9547,3.5083,6.9552,3.5088,7.0794,3.2794,7.0791)" + }, + { + "content": "total", + "span": { + "offset": 4495, + "length": 5 + }, + "confidence": 0.975, + "source": "D(1,3.5322,6.9552,3.7656,6.9557,3.766,7.0798,3.5327,7.0795)" + }, + { + "content": "adjustments", + "span": { + "offset": 4501, + "length": 11 + }, + "confidence": 0.909, + "source": "D(1,3.7995,6.9558,4.4558,6.9596,4.456,7.0788,3.7999,7.0798)" + }, + { + "content": "to", + "span": { + "offset": 4513, + "length": 2 + }, + "confidence": 0.963, + "source": "D(1,4.4837,6.9598,4.5934,6.9605,4.5936,7.0786,4.4839,7.0788)" + }, + { + "content": "income", + "span": { + "offset": 4516, + "length": 6 + }, + "confidence": 0.878, + "source": "D(1,4.6293,6.9607,5.0303,6.9633,5.0303,7.0777,4.6295,7.0785)" + }, + { + "content": "10c", + "span": { + "offset": 4532, + "length": 3 + }, + "confidence": 0.991, + "source": "D(1,6.7568,6.9663,6.9478,6.9663,6.9478,7.063,6.7568,7.063)" + }, + { + "content": "11", + "span": { + "offset": 4568, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2711,7.1328,1.3987,7.1328,1.3987,7.2295,1.2711,7.2295)" + }, + { + "content": "Subtract", + "span": { + "offset": 4571, + "length": 8 + }, + "confidence": 0.992, + "source": "D(1,1.5875,7.1232,2.0204,7.1207,2.0222,7.2418,1.5896,7.24)" + }, + { + "content": "line", + "span": { + "offset": 4580, + "length": 4 + }, + "confidence": 0.978, + "source": "D(1,2.0515,7.1205,2.2213,7.1196,2.223,7.2427,2.0533,7.242)" + }, + { + "content": "10c", + "span": { + "offset": 4585, + "length": 3 + }, + "confidence": 0.938, + "source": "D(1,2.2586,7.1194,2.4347,7.1184,2.4362,7.2436,2.2603,7.2429)" + }, + { + "content": "from", + "span": { + "offset": 4589, + "length": 4 + }, + "confidence": 0.952, + "source": "D(1,2.4637,7.1182,2.6915,7.117,2.6929,7.2447,2.4652,7.2437)" + }, + { + "content": "line", + "span": { + "offset": 4594, + "length": 4 + }, + "confidence": 0.879, + "source": "D(1,2.7288,7.1169,2.8966,7.1169,2.8978,7.245,2.7301,7.2447)" + }, + { + "content": "9", + "span": { + "offset": 4599, + "length": 1 + }, + "confidence": 0.822, + "source": "D(1,2.9276,7.1169,2.9836,7.1168,2.9848,7.2451,2.9289,7.245)" + }, + { + "content": ".", + "span": { + "offset": 4600, + "length": 1 + }, + "confidence": 0.948, + "source": "D(1,2.9918,7.1168,3.0146,7.1168,3.0158,7.2451,2.993,7.2451)" + }, + { + "content": "This", + "span": { + "offset": 4602, + "length": 4 + }, + "confidence": 0.778, + "source": "D(1,3.0478,7.1168,3.257,7.1167,3.258,7.2455,3.0489,7.2452)" + }, + { + "content": "is", + "span": { + "offset": 4607, + "length": 2 + }, + "confidence": 0.99, + "source": "D(1,3.288,7.1167,3.3709,7.1167,3.3718,7.2457,3.289,7.2456)" + }, + { + "content": "your", + "span": { + "offset": 4610, + "length": 4 + }, + "confidence": 0.985, + "source": "D(1,3.3957,7.1167,3.6277,7.1166,3.6285,7.246,3.3967,7.2457)" + }, + { + "content": "adjusted", + "span": { + "offset": 4615, + "length": 8 + }, + "confidence": 0.983, + "source": "D(1,3.6484,7.1166,4.1041,7.1181,4.1046,7.2458,3.6492,7.2461)" + }, + { + "content": "gross", + "span": { + "offset": 4624, + "length": 5 + }, + "confidence": 0.969, + "source": "D(1,4.1373,7.1183,4.4334,7.1197,4.4337,7.2454,4.1377,7.2458)" + }, + { + "content": "income", + "span": { + "offset": 4630, + "length": 6 + }, + "confidence": 0.892, + "source": "D(1,4.4666,7.1199,4.8684,7.1218,4.8684,7.2448,4.4668,7.2453)" + }, + { + "content": "11", + "span": { + "offset": 4646, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.1263,6.8979,7.134,6.8979,7.2306,6.79,7.223)" + }, + { + "content": "1880", + "span": { + "offset": 4658, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,7.7239,7.1109,7.9646,7.1131,7.9646,7.2188,7.7239,7.2188)" + }, + { + "content": "12", + "span": { + "offset": 4695, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2794,7.2939,1.408,7.2939,1.408,7.3906,1.2794,7.3906)" + }, + { + "content": "Standard", + "span": { + "offset": 4698, + "length": 8 + }, + "confidence": 0.994, + "source": "D(1,1.5854,7.2826,2.0704,7.2823,2.0713,7.4071,1.5865,7.4041)" + }, + { + "content": "deduction", + "span": { + "offset": 4707, + "length": 9 + }, + "confidence": 0.996, + "source": "D(1,2.104,7.2823,2.6373,7.282,2.638,7.4106,2.1049,7.4073)" + }, + { + "content": "or", + "span": { + "offset": 4717, + "length": 2 + }, + "confidence": 0.99, + "source": "D(1,2.6709,7.282,2.7843,7.282,2.7849,7.4109,2.6716,7.4108)" + }, + { + "content": "itemized", + "span": { + "offset": 4720, + "length": 8 + }, + "confidence": 0.947, + "source": "D(1,2.8137,7.282,3.2588,7.2817,3.2593,7.4111,2.8143,7.4109)" + }, + { + "content": "deductions", + "span": { + "offset": 4729, + "length": 10 + }, + "confidence": 0.986, + "source": "D(1,3.2903,7.2817,3.8781,7.2814,3.8784,7.4107,3.2907,7.4112)" + }, + { + "content": "(", + "span": { + "offset": 4740, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.9096,7.2814,3.9453,7.2814,3.9456,7.4103,3.9099,7.4105)" + }, + { + "content": "from", + "span": { + "offset": 4741, + "length": 4 + }, + "confidence": 0.977, + "source": "D(1,3.9369,7.2814,4.17,7.2813,4.1702,7.4092,3.9372,7.4104)" + }, + { + "content": "Schedule", + "span": { + "offset": 4746, + "length": 8 + }, + "confidence": 0.6, + "source": "D(1,4.1993,7.2813,4.6738,7.281,4.6739,7.4066,4.1995,7.4091)" + }, + { + "content": "A", + "span": { + "offset": 4755, + "length": 1 + }, + "confidence": 0.982, + "source": "D(1,4.6906,7.281,4.7746,7.281,4.7746,7.4061,4.6907,7.4065)" + }, + { + "content": ")", + "span": { + "offset": 4756, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,4.7599,7.281,4.8103,7.281,4.8103,7.4059,4.7599,7.4062)" + }, + { + "content": "12", + "span": { + "offset": 4767, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.2939,6.9146,7.2939,6.9146,7.3906,6.79,7.3906)" + }, + { + "content": "100", + "span": { + "offset": 4779, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,7.7861,7.2764,7.9687,7.2774,7.9687,7.3853,7.7861,7.3853)" + }, + { + "content": "13", + "span": { + "offset": 4815, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2721,7.4613,1.408,7.4621,1.408,7.5588,1.2721,7.558)" + }, + { + "content": "Qualified", + "span": { + "offset": 4818, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,1.5875,7.4471,2.022,7.4502,2.0238,7.5683,1.5896,7.5652)" + }, + { + "content": "business", + "span": { + "offset": 4828, + "length": 8 + }, + "confidence": 0.999, + "source": "D(1,2.0613,7.4504,2.4977,7.4535,2.4992,7.5717,2.0631,7.5686)" + }, + { + "content": "income", + "span": { + "offset": 4837, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,2.5331,7.4538,2.9007,7.4555,2.902,7.5737,2.5346,7.5719)" + }, + { + "content": "deduction", + "span": { + "offset": 4844, + "length": 9 + }, + "confidence": 0.984, + "source": "D(1,2.9302,7.4555,3.4275,7.4551,3.4285,7.5732,2.9315,7.5737)" + }, + { + "content": ".", + "span": { + "offset": 4853, + "length": 1 + }, + "confidence": 0.992, + "source": "D(1,3.4334,7.4551,3.455,7.4551,3.456,7.5732,3.4344,7.5732)" + }, + { + "content": "Attach", + "span": { + "offset": 4855, + "length": 6 + }, + "confidence": 0.964, + "source": "D(1,3.4826,7.455,3.805,7.4548,3.8057,7.5729,3.4835,7.5732)" + }, + { + "content": "Form", + "span": { + "offset": 4862, + "length": 4 + }, + "confidence": 0.966, + "source": "D(1,3.8403,7.4547,4.0979,7.4537,4.0985,7.5719,3.8411,7.5729)" + }, + { + "content": "8995", + "span": { + "offset": 4867, + "length": 4 + }, + "confidence": 0.528, + "source": "D(1,4.1332,7.4534,4.379,7.4513,4.3794,7.5695,4.1338,7.5716)" + }, + { + "content": "or", + "span": { + "offset": 4872, + "length": 2 + }, + "confidence": 0.781, + "source": "D(1,4.4085,7.451,4.5166,7.4501,4.517,7.5683,4.4089,7.5692)" + }, + { + "content": "Form", + "span": { + "offset": 4875, + "length": 4 + }, + "confidence": 0.522, + "source": "D(1,4.5441,7.4499,4.7977,7.4477,4.7979,7.5658,4.5445,7.568)" + }, + { + "content": "8995", + "span": { + "offset": 4880, + "length": 4 + }, + "confidence": 0.774, + "source": "D(1,4.8311,7.4474,5.0827,7.4452,5.0828,7.5633,4.8313,7.5655)" + }, + { + "content": "-", + "span": { + "offset": 4884, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,5.0827,7.4452,5.122,7.4448,5.1221,7.563,5.0828,7.5633)" + }, + { + "content": "A", + "span": { + "offset": 4885, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,5.1161,7.4449,5.2046,7.4441,5.2046,7.5623,5.1162,7.563)" + }, + { + "content": "13", + "span": { + "offset": 4896, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.4604,6.9146,7.4604,6.9146,7.5571,6.79,7.5571)" + }, + { + "content": "200", + "span": { + "offset": 4908, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,7.7861,7.4488,7.9646,7.4454,7.9646,7.5507,7.7861,7.5473)" + }, + { + "content": "14", + "span": { + "offset": 4944, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2742,7.6402,1.408,7.6383,1.408,7.7344,1.2742,7.7344)" + }, + { + "content": "Add", + "span": { + "offset": 4947, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,1.5865,7.6254,1.7986,7.6272,1.7985,7.7444,1.5865,7.7411)" + }, + { + "content": "lines", + "span": { + "offset": 4951, + "length": 5 + }, + "confidence": 0.984, + "source": "D(1,1.8339,7.6275,2.0519,7.627,2.0518,7.7453,1.8339,7.7449)" + }, + { + "content": "12", + "span": { + "offset": 4957, + "length": 2 + }, + "confidence": 0.98, + "source": "D(1,2.0912,7.6266,2.2051,7.6255,2.205,7.7441,2.0911,7.745)" + }, + { + "content": "and", + "span": { + "offset": 4960, + "length": 3 + }, + "confidence": 0.953, + "source": "D(1,2.2366,7.6252,2.4231,7.6204,2.423,7.7385,2.2364,7.7438)" + }, + { + "content": "13", + "span": { + "offset": 4964, + "length": 2 + }, + "confidence": 0.991, + "source": "D(1,2.4643,7.6192,2.5919,7.6157,2.5919,7.7332,2.4643,7.7372)" + }, + { + "content": "14", + "span": { + "offset": 4976, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.625,6.9146,7.6248,6.9146,7.7215,6.79,7.7217)" + }, + { + "content": "500", + "span": { + "offset": 4988, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,7.7778,7.6155,7.9646,7.6142,7.9646,7.7183,7.7778,7.7183)" + }, + { + "content": "15", + "span": { + "offset": 5024, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2752,7.7778,1.408,7.7839,1.408,7.8827,1.2752,7.8736)" + }, + { + "content": "Taxable", + "span": { + "offset": 5027, + "length": 7 + }, + "confidence": 0.995, + "source": "D(1,1.5865,7.7749,2.0073,7.7738,2.0073,7.8901,1.5865,7.89)" + }, + { + "content": "income", + "span": { + "offset": 5035, + "length": 6 + }, + "confidence": 0.968, + "source": "D(1,2.0424,7.7737,2.4223,7.7726,2.4223,7.8901,2.0424,7.8901)" + }, + { + "content": ".", + "span": { + "offset": 5041, + "length": 1 + }, + "confidence": 0.954, + "source": "D(1,2.4301,7.7726,2.4555,7.7725,2.4555,7.8901,2.4301,7.8901)" + }, + { + "content": "Subtract", + "span": { + "offset": 5043, + "length": 8 + }, + "confidence": 0.933, + "source": "D(1,2.4905,7.7724,2.9192,7.7718,2.9192,7.8903,2.4905,7.8902)" + }, + { + "content": "line", + "span": { + "offset": 5052, + "length": 4 + }, + "confidence": 0.985, + "source": "D(1,2.9523,7.7718,3.1199,7.772,3.1198,7.8905,2.9523,7.8903)" + }, + { + "content": "14", + "span": { + "offset": 5057, + "length": 2 + }, + "confidence": 0.945, + "source": "D(1,3.1588,7.772,3.2757,7.7721,3.2757,7.8906,3.1588,7.8905)" + }, + { + "content": "from", + "span": { + "offset": 5060, + "length": 4 + }, + "confidence": 0.942, + "source": "D(1,3.303,7.7721,3.5271,7.7723,3.5271,7.8908,3.303,7.8906)" + }, + { + "content": "line", + "span": { + "offset": 5065, + "length": 4 + }, + "confidence": 0.948, + "source": "D(1,3.5641,7.7723,3.7336,7.7724,3.7336,7.8909,3.5641,7.8908)" + }, + { + "content": "11", + "span": { + "offset": 5070, + "length": 2 + }, + "confidence": 0.813, + "source": "D(1,3.7726,7.7725,3.8719,7.7726,3.8719,7.891,3.7726,7.891)" + }, + { + "content": ".", + "span": { + "offset": 5072, + "length": 1 + }, + "confidence": 0.921, + "source": "D(1,3.8895,7.7726,3.9148,7.7726,3.9148,7.8911,3.8895,7.8911)" + }, + { + "content": "If", + "span": { + "offset": 5074, + "length": 2 + }, + "confidence": 0.789, + "source": "D(1,3.9557,7.7727,4.0219,7.773,4.0219,7.8912,3.9557,7.8911)" + }, + { + "content": "zero", + "span": { + "offset": 5077, + "length": 4 + }, + "confidence": 0.833, + "source": "D(1,4.0434,7.7731,4.2577,7.774,4.2577,7.8915,4.0434,7.8912)" + }, + { + "content": "or", + "span": { + "offset": 5082, + "length": 2 + }, + "confidence": 0.934, + "source": "D(1,4.2889,7.7741,4.396,7.7746,4.396,7.8917,4.2889,7.8916)" + }, + { + "content": "less", + "span": { + "offset": 5085, + "length": 4 + }, + "confidence": 0.878, + "source": "D(1,4.4233,7.7747,4.6104,7.7755,4.6103,7.892,4.4233,7.8917)" + }, + { + "content": ",", + "span": { + "offset": 5089, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,4.6123,7.7755,4.6376,7.7756,4.6376,7.892,4.6123,7.892)" + }, + { + "content": "enter", + "span": { + "offset": 5091, + "length": 5 + }, + "confidence": 0.961, + "source": "D(1,4.6727,7.7758,4.9377,7.7769,4.9377,7.8924,4.6727,7.8921)" + }, + { + "content": "-", + "span": { + "offset": 5097, + "length": 1 + }, + "confidence": 0.987, + "source": "D(1,4.9591,7.777,5,7.7772,5,7.8925,4.9591,7.8925)" + }, + { + "content": "0", + "span": { + "offset": 5098, + "length": 1 + }, + "confidence": 0.963, + "source": "D(1,5.002,7.7772,5.0624,7.7775,5.0624,7.8926,5.002,7.8925)" + }, + { + "content": "-", + "span": { + "offset": 5099, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,5.0663,7.7775,5.1091,7.7777,5.1091,7.8927,5.0663,7.8926)" + }, + { + "content": "15", + "span": { + "offset": 5110, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.7827,6.9062,7.7827,6.9062,7.8794,6.79,7.8794)" + }, + { + "content": "510", + "span": { + "offset": 5122, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,7.7778,7.7765,7.9687,7.7734,7.9687,7.8754,7.7778,7.8786)" + }, + { + "content": "For", + "span": { + "offset": 5165, + "length": 3 + }, + "confidence": 0.984, + "source": "D(1,0.4879,7.9662,0.6516,7.966,0.6528,8.0815,0.4892,8.0812)" + }, + { + "content": "Disclosure", + "span": { + "offset": 5169, + "length": 10 + }, + "confidence": 0.989, + "source": "D(1,0.675,7.966,1.164,7.9655,1.165,8.0821,0.6762,8.0815)" + }, + { + "content": ",", + "span": { + "offset": 5179, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.1659,7.9655,1.1893,7.9654,1.1904,8.0822,1.167,8.0821)" + }, + { + "content": "Privacy", + "span": { + "offset": 5181, + "length": 7 + }, + "confidence": 0.968, + "source": "D(1,1.2205,7.9654,1.5672,7.965,1.5682,8.0827,1.2215,8.0822)" + }, + { + "content": "Act", + "span": { + "offset": 5189, + "length": 3 + }, + "confidence": 0.954, + "source": "D(1,1.5828,7.965,1.7484,7.9648,1.7493,8.0829,1.5838,8.0827)" + }, + { + "content": ",", + "span": { + "offset": 5192, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.7465,7.9648,1.7698,7.9648,1.7708,8.0829,1.7474,8.0829)" + }, + { + "content": "and", + "span": { + "offset": 5194, + "length": 3 + }, + "confidence": 0.993, + "source": "D(1,1.7971,7.9648,1.9686,7.9647,1.9694,8.0832,1.798,8.083)" + }, + { + "content": "Paperwork", + "span": { + "offset": 5198, + "length": 9 + }, + "confidence": 0.974, + "source": "D(1,2.0017,7.9647,2.5141,7.9651,2.5147,8.0836,2.0025,8.0832)" + }, + { + "content": "Reduction", + "span": { + "offset": 5208, + "length": 9 + }, + "confidence": 0.911, + "source": "D(1,2.5374,7.9651,3.0031,7.9655,3.0036,8.084,2.5381,8.0836)" + }, + { + "content": "Act", + "span": { + "offset": 5218, + "length": 3 + }, + "confidence": 0.81, + "source": "D(1,3.0284,7.9655,3.1979,7.9657,3.1984,8.0842,3.0289,8.084)" + }, + { + "content": "Notice", + "span": { + "offset": 5222, + "length": 6 + }, + "confidence": 0.842, + "source": "D(1,3.2213,7.9657,3.5193,7.9663,3.5197,8.0844,3.2217,8.0842)" + }, + { + "content": ",", + "span": { + "offset": 5228, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.5213,7.9663,3.5447,7.9663,3.545,8.0844,3.5217,8.0844)" + }, + { + "content": "see", + "span": { + "offset": 5230, + "length": 3 + }, + "confidence": 0.953, + "source": "D(1,3.5758,7.9664,3.7414,7.9669,3.7417,8.0844,3.5762,8.0844)" + }, + { + "content": "separate", + "span": { + "offset": 5234, + "length": 8 + }, + "confidence": 0.94, + "source": "D(1,3.7667,7.9669,4.1759,7.968,4.1761,8.0845,3.7671,8.0844)" + }, + { + "content": "instructions", + "span": { + "offset": 5243, + "length": 12 + }, + "confidence": 0.894, + "source": "D(1,4.207,7.9681,4.7525,7.9696,4.7525,8.0847,4.2072,8.0846)" + }, + { + "content": ".", + "span": { + "offset": 5255, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,4.7525,7.9696,4.7896,7.9697,4.7896,8.0847,4.7525,8.0847)" + }, + { + "content": "Cat", + "span": { + "offset": 5279, + "length": 3 + }, + "confidence": 0.914, + "source": "D(1,5.6777,7.9761,5.8191,7.9761,5.8191,8.0678,5.6777,8.0665)" + }, + { + "content": ".", + "span": { + "offset": 5282, + "length": 1 + }, + "confidence": 0.956, + "source": "D(1,5.816,7.9761,5.8345,7.9761,5.8345,8.068,5.816,8.0678)" + }, + { + "content": "No", + "span": { + "offset": 5284, + "length": 2 + }, + "confidence": 0.913, + "source": "D(1,5.8606,7.9761,5.965,7.9761,5.9651,8.0688,5.8606,8.0682)" + }, + { + "content": ".", + "span": { + "offset": 5286, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,5.9681,7.9761,5.9866,7.9761,5.9866,8.0688,5.9681,8.0688)" + }, + { + "content": "11320B", + "span": { + "offset": 5288, + "length": 6 + }, + "confidence": 0.923, + "source": "D(1,6.0142,7.9761,6.3169,7.9761,6.3169,8.0686,6.0142,8.0689)" + }, + { + "content": "Form", + "span": { + "offset": 5317, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,7.2092,7.9609,7.4144,7.9593,7.4144,8.0781,7.2092,8.0781)" + }, + { + "content": "1040", + "span": { + "offset": 5322, + "length": 4 + }, + "confidence": 0.986, + "source": "D(1,7.4582,7.959,7.7232,7.9586,7.7232,8.0781,7.4583,8.0781)" + }, + { + "content": "(", + "span": { + "offset": 5327, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.7531,7.9586,7.789,7.9588,7.789,8.0781,7.7531,8.0781)" + }, + { + "content": "2020", + "span": { + "offset": 5328, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,7.777,7.9588,7.9722,7.9599,7.9722,8.0781,7.777,8.0781)" + }, + { + "content": ")", + "span": { + "offset": 5332, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.9623,7.9599,8.0061,7.9601,8.0061,8.0781,7.9623,8.0781)" + } + ], + "lines": [ + { + "content": "Form", + "source": "D(1,0.5004,0.7748,0.508,0.5264,0.5976,0.5291,0.5899,0.775)", + "span": { + "offset": 17, + "length": 4 + } + }, + { + "content": "1040", + "source": "D(1,0.6022,0.5021,1.2545,0.5019,1.2545,0.7684,0.6023,0.7686)", + "span": { + "offset": 22, + "length": 4 + } + }, + { + "content": "Department of the Treasury-Internal Revenue Service", + "source": "D(1,1.3427,0.5219,3.3951,0.5233,3.395,0.6256,1.3426,0.6242)", + "span": { + "offset": 49, + "length": 51 + } + }, + { + "content": "U.S. Individual Income Tax Return", + "source": "D(1,1.3478,0.6452,3.8933,0.6495,3.8931,0.8008,1.3476,0.7964)", + "span": { + "offset": 101, + "length": 33 + } + }, + { + "content": "(99)", + "source": "D(1,3.7354,0.5157,3.9087,0.5175,3.9076,0.6304,3.7354,0.6286)", + "span": { + "offset": 157, + "length": 4 + } + }, + { + "content": "2020", + "source": "D(1,4.1292,0.5327,4.8643,0.5315,4.8643,0.7722,4.1296,0.7734)", + "span": { + "offset": 184, + "length": 4 + } + }, + { + "content": "OMB No. 1545-0074", + "source": "D(1,4.939,0.6877,5.8521,0.6877,5.8521,0.7883,4.939,0.7883)", + "span": { + "offset": 211, + "length": 17 + } + }, + { + "content": "IRS Use Only-Do not write or staple in this space.", + "source": "D(1,5.9849,0.6981,7.8984,0.7028,7.8982,0.8069,5.9846,0.8023)", + "span": { + "offset": 251, + "length": 50 + } + }, + { + "content": "Filing Status", + "source": "D(1,0.4923,0.9132,1.2536,0.9142,1.2534,1.0542,0.4922,1.0532)", + "span": { + "offset": 308, + "length": 13 + } + }, + { + "content": "Check only", + "source": "D(1,0.4926,1.0769,1.0547,1.0794,1.0542,1.1968,0.4921,1.1943)", + "span": { + "offset": 322, + "length": 10 + } + }, + { + "content": "one box.", + "source": "D(1,0.49,1.2045,0.9323,1.203,0.9326,1.3014,0.4904,1.3029)", + "span": { + "offset": 333, + "length": 8 + } + }, + { + "content": "☑", + "source": "D(1,1.3209,0.9393,1.4495,0.9393,1.4495,1.0641,1.3209,1.0635)", + "span": { + "offset": 343, + "length": 1 + } + }, + { + "content": "Single", + "source": "D(1,1.4858,0.9399,1.8145,0.9421,1.8137,1.0624,1.485,1.0602)", + "span": { + "offset": 345, + "length": 6 + } + }, + { + "content": "☐", + "source": "D(1,1.9227,0.9399,2.043,0.9379,2.043,1.0615,1.9227,1.0628)", + "span": { + "offset": 352, + "length": 1 + } + }, + { + "content": "Married filing jointly", + "source": "D(1,2.0866,0.934,3.0713,0.9403,3.0713,1.0683,2.0863,1.062)", + "span": { + "offset": 354, + "length": 22 + } + }, + { + "content": "☐", + "source": "D(1,3.2207,0.9393,3.3452,0.9393,3.3452,1.0635,3.2207,1.0635)", + "span": { + "offset": 377, + "length": 1 + } + }, + { + "content": "Married filing separately (MFS)", + "source": "D(1,3.3867,0.9366,4.8975,0.9366,4.8975,1.0651,3.3867,1.0651)", + "span": { + "offset": 379, + "length": 31 + } + }, + { + "content": "☐", + "source": "D(1,5.0178,0.9379,5.1423,0.9379,5.1423,1.0648,5.0178,1.0648)", + "span": { + "offset": 411, + "length": 1 + } + }, + { + "content": "Head of household (HOH)", + "source": "D(1,5.188,0.9357,6.3999,0.9357,6.3999,1.0602,5.188,1.0602)", + "span": { + "offset": 413, + "length": 23 + } + }, + { + "content": "☐", + "source": "D(1,6.5203,0.9386,6.6448,0.9386,6.6448,1.0648,6.5203,1.0648)", + "span": { + "offset": 437, + "length": 1 + } + }, + { + "content": "Qualifying widow(er) (QW)", + "source": "D(1,6.6863,0.9346,7.9687,0.9343,7.9687,1.0686,6.6863,1.0689)", + "span": { + "offset": 439, + "length": 25 + } + }, + { + "content": "If you checked the MFS box, enter the name of your spouse. If you checked the HOH or QW box, enter the child's name if the qualifying", + "source": "D(1,1.3167,1.1119,7.9854,1.1124,7.9854,1.2388,1.3167,1.2383)", + "span": { + "offset": 466, + "length": 133 + } + }, + { + "content": "person is a child but not your dependent", + "source": "D(1,1.3146,1.2605,3.3224,1.2588,3.3225,1.3817,1.3147,1.3835)", + "span": { + "offset": 600, + "length": 40 + } + }, + { + "content": "Your first name and middle initial", + "source": "D(1,0.5432,1.4445,1.9849,1.4445,1.9849,1.5524,0.5432,1.5524)", + "span": { + "offset": 642, + "length": 34 + } + }, + { + "content": "Robert", + "source": "D(1,0.5227,1.597,0.8923,1.5968,0.8924,1.7083,0.5227,1.7085)", + "span": { + "offset": 677, + "length": 6 + } + }, + { + "content": "Last name", + "source": "D(1,3.3452,1.449,3.8105,1.4509,3.8101,1.548,3.3448,1.5461)", + "span": { + "offset": 685, + "length": 9 + } + }, + { + "content": "Morgan", + "source": "D(1,3.3266,1.5999,3.7464,1.6054,3.7457,1.7308,3.3258,1.7246)", + "span": { + "offset": 695, + "length": 6 + } + }, + { + "content": "Your social security number", + "source": "D(1,6.545,1.4456,7.8567,1.4439,7.8568,1.5527,6.5452,1.5544)", + "span": { + "offset": 703, + "length": 27 + } + }, + { + "content": "0 8 5 5 0 6 1 1 0", + "source": "D(1,6.5493,1.5806,7.9647,1.5815,7.9646,1.7256,6.5492,1.7247)", + "span": { + "offset": 731, + "length": 17 + } + }, + { + "content": "If joint return, spouse's first name and middle initial", + "source": "D(1,0.5411,1.7708,2.7745,1.7678,2.7747,1.8832,0.5413,1.8862)", + "span": { + "offset": 750, + "length": 55 + } + }, + { + "content": "Last name", + "source": "D(1,3.3431,1.7805,3.8106,1.7832,3.8101,1.8803,3.3426,1.8776)", + "span": { + "offset": 807, + "length": 9 + } + }, + { + "content": "Spouse's social security number", + "source": "D(1,6.545,1.7712,8.0061,1.7696,8.0062,1.8824,6.5452,1.884)", + "span": { + "offset": 818, + "length": 31 + } + }, + { + "content": "Home address (number and street). If you have a P.O. box, see instructions.", + "source": "D(1,0.5453,2.1079,3.8516,2.1042,3.8516,2.22,0.5454,2.2237)", + "span": { + "offset": 851, + "length": 75 + } + }, + { + "content": "254 W 78TH LOS ANGELES CA 90003-2459 USA", + "source": "D(1,0.5204,2.2519,3.0651,2.2519,3.0651,2.3727,0.5204,2.3727)", + "span": { + "offset": 927, + "length": 40 + } + }, + { + "content": "Apt. no.", + "source": "D(1,5.8396,2.1128,6.2017,2.1164,6.2007,2.2192,5.8386,2.2156)", + "span": { + "offset": 969, + "length": 8 + } + }, + { + "content": "254", + "source": "D(1,6.043,2.2653,6.2422,2.2653,6.2422,2.3687,6.043,2.3687)", + "span": { + "offset": 978, + "length": 3 + } + }, + { + "content": "City, town, or post office. If you have a foreign address, also complete spaces below.", + "source": "D(1,0.5453,2.448,4.2542,2.448,4.2542,2.5623,0.5453,2.5623)", + "span": { + "offset": 983, + "length": 86 + } + }, + { + "content": "10107 1/4 WILMINGTON LOS ANGELES CA 90002-2984 USA", + "source": "D(1,0.5284,2.5913,3.6918,2.591,3.6918,2.7125,0.5284,2.7129)", + "span": { + "offset": 1070, + "length": 50 + } + }, + { + "content": "State", + "source": "D(1,4.7397,2.4531,4.9682,2.4535,4.968,2.5449,4.7396,2.5446)", + "span": { + "offset": 1122, + "length": 5 + } + }, + { + "content": "LA", + "source": "D(1,5.0672,2.6001,5.2253,2.5995,5.2258,2.705,5.0676,2.7057)", + "span": { + "offset": 1128, + "length": 2 + } + }, + { + "content": "ZIP code", + "source": "D(1,5.6362,2.4475,6.0146,2.4502,6.0139,2.5487,5.6355,2.5461)", + "span": { + "offset": 1132, + "length": 8 + } + }, + { + "content": "10107", + "source": "D(1,5.9268,2.6005,6.2256,2.6007,6.2256,2.707,5.9268,2.7068)", + "span": { + "offset": 1141, + "length": 5 + } + }, + { + "content": "Foreign country name", + "source": "D(1,0.5432,2.7793,1.5107,2.7793,1.5107,2.8923,0.5432,2.8923)", + "span": { + "offset": 1148, + "length": 20 + } + }, + { + "content": "N/A", + "source": "D(1,0.5198,2.9302,0.7277,2.9309,0.7273,3.0405,0.5195,3.0398)", + "span": { + "offset": 1169, + "length": 3 + } + }, + { + "content": "Foreign province/state/county", + "source": "D(1,3.644,2.7766,4.9639,2.7765,4.9639,2.8951,3.644,2.8953)", + "span": { + "offset": 1174, + "length": 29 + } + }, + { + "content": "N/A", + "source": "D(1,3.6357,2.9316,3.837,2.9316,3.837,3.0406,3.6357,3.0406)", + "span": { + "offset": 1204, + "length": 3 + } + }, + { + "content": "Foreign postal code", + "source": "D(1,5.6445,2.7812,6.458,2.78,6.458,2.8894,5.6445,2.8905)", + "span": { + "offset": 1209, + "length": 19 + } + }, + { + "content": "N/A", + "source": "D(1,5.9434,2.9342,6.1472,2.9351,6.1467,3.0379,5.9434,3.037)", + "span": { + "offset": 1229, + "length": 3 + } + }, + { + "content": "Presidential Election Campaign", + "source": "D(1,6.5452,2.113,8.007,2.1243,8.0061,2.244,6.5442,2.2327)", + "span": { + "offset": 1234, + "length": 30 + } + }, + { + "content": "Check here if you, or your", + "source": "D(1,6.5452,2.2571,7.7574,2.2605,7.7571,2.3775,6.5448,2.3741)", + "span": { + "offset": 1265, + "length": 26 + } + }, + { + "content": "spouse if filing jointly, want $3", + "source": "D(1,6.5444,2.3934,7.948,2.384,7.9488,2.505,6.5452,2.5133)", + "span": { + "offset": 1292, + "length": 33 + } + }, + { + "content": "to go to this fund. Checking a", + "source": "D(1,6.5327,2.5106,7.9355,2.511,7.9355,2.6269,6.5327,2.6265)", + "span": { + "offset": 1326, + "length": 30 + } + }, + { + "content": "box below will not change", + "source": "D(1,6.5452,2.6411,7.7695,2.6411,7.7695,2.7556,6.5452,2.7556)", + "span": { + "offset": 1357, + "length": 25 + } + }, + { + "content": "your tax or refund.", + "source": "D(1,6.5316,2.775,7.4001,2.768,7.4012,2.8758,6.5327,2.8848)", + "span": { + "offset": 1383, + "length": 19 + } + }, + { + "content": "☐", + "source": "D(1,6.9851,2.9165,7.1096,2.9165,7.1096,3.0454,6.9851,3.0427)", + "span": { + "offset": 1404, + "length": 1 + } + }, + { + "content": "You", + "source": "D(1,7.147,2.9272,7.3337,2.9272,7.3337,3.0189,7.147,3.0189)", + "span": { + "offset": 1406, + "length": 3 + } + }, + { + "content": "☐", + "source": "D(1,7.4956,2.9165,7.6367,2.9192,7.6367,3.0427,7.4956,3.0454)", + "span": { + "offset": 1410, + "length": 1 + } + }, + { + "content": "Spouse", + "source": "D(1,7.6492,2.9332,7.9944,2.9357,7.9936,3.0359,7.6484,3.0333)", + "span": { + "offset": 1412, + "length": 6 + } + }, + { + "content": "At any time during 2020, did you receive, sell, send, exchange, or otherwise acquire any financial interest in any virtual currency?", + "source": "D(1,0.4926,3.1469,6.8772,3.1469,6.8772,3.2762,0.4926,3.2762)", + "span": { + "offset": 1420, + "length": 132 + } + }, + { + "content": "☑", + "source": "D(1,6.9976,3.1501,7.1221,3.1501,7.1221,3.2737,6.9976,3.2737)", + "span": { + "offset": 1554, + "length": 1 + } + }, + { + "content": "Yes", + "source": "D(1,7.1345,3.1501,7.3379,3.1506,7.3379,3.2529,7.1343,3.2524)", + "span": { + "offset": 1556, + "length": 3 + } + }, + { + "content": "☐", + "source": "D(1,7.4956,3.1394,7.6201,3.1475,7.6201,3.2764,7.4956,3.2656)", + "span": { + "offset": 1560, + "length": 1 + } + }, + { + "content": "No", + "source": "D(1,7.6403,3.1541,7.7986,3.1532,7.7992,3.256,7.6409,3.257)", + "span": { + "offset": 1562, + "length": 2 + } + }, + { + "content": "Standard", + "source": "D(1,0.4918,3.373,1.1123,3.373,1.1123,3.502,0.4918,3.502)", + "span": { + "offset": 1566, + "length": 8 + } + }, + { + "content": "Deduction", + "source": "D(1,0.4936,3.5154,1.1849,3.5154,1.1849,3.6398,0.4936,3.6398)", + "span": { + "offset": 1575, + "length": 9 + } + }, + { + "content": "Someone can claim:", + "source": "D(1,1.2877,3.3597,2.3787,3.3646,2.3781,3.4821,1.2871,3.4783)", + "span": { + "offset": 1586, + "length": 18 + } + }, + { + "content": "☐", + "source": "D(1,2.5193,3.3569,2.6438,3.3569,2.6438,3.4805,2.5193,3.4805)", + "span": { + "offset": 1606, + "length": 1 + } + }, + { + "content": "You as a dependent", + "source": "D(1,2.6874,3.3656,3.7065,3.3672,3.7063,3.4865,2.6872,3.4849)", + "span": { + "offset": 1608, + "length": 18 + } + }, + { + "content": "☐", + "source": "D(1,3.92,3.3569,4.0446,3.3569,4.0446,3.4805,3.92,3.4805)", + "span": { + "offset": 1627, + "length": 1 + } + }, + { + "content": "Your spouse as a dependent", + "source": "D(1,4.0861,3.365,5.5366,3.365,5.5366,3.4862,4.0861,3.4862)", + "span": { + "offset": 1629, + "length": 26 + } + }, + { + "content": "☐", + "source": "D(1,1.3209,3.5208,1.4454,3.5208,1.4454,3.6497,1.3209,3.6497)", + "span": { + "offset": 1656, + "length": 1 + } + }, + { + "content": "Spouse itemizes on a separate return or you were a dual-status alien", + "source": "D(1,1.4858,3.5294,4.9058,3.5294,4.9058,3.6513,1.4858,3.6513)", + "span": { + "offset": 1658, + "length": 68 + } + }, + { + "content": "Age/Blindness", + "source": "D(1,0.4903,3.7768,1.2451,3.7781,1.2451,3.9043,0.49,3.9029)", + "span": { + "offset": 1728, + "length": 13 + } + }, + { + "content": "You:", + "source": "D(1,1.2949,3.7796,1.5439,3.781,1.5439,3.89,1.2949,3.8886)", + "span": { + "offset": 1743, + "length": 4 + } + }, + { + "content": "☐", + "source": "D(1,1.6228,3.7598,1.7463,3.7625,1.7463,3.8914,1.6228,3.8887)", + "span": { + "offset": 1749, + "length": 1 + } + }, + { + "content": "Were born before January 2, 1956", + "source": "D(1,1.7867,3.7707,3.476,3.7707,3.476,3.8998,1.7867,3.8998)", + "span": { + "offset": 1751, + "length": 32 + } + }, + { + "content": "☑", + "source": "D(1,3.6108,3.749,3.752,3.7544,3.752,3.8914,3.6108,3.8833)", + "span": { + "offset": 1784, + "length": 1 + } + }, + { + "content": "Are blind", + "source": "D(1,3.7852,3.7769,4.2465,3.7797,4.2458,3.8918,3.7852,3.8893)", + "span": { + "offset": 1786, + "length": 9 + } + }, + { + "content": "Spouse:", + "source": "D(1,4.4845,3.7789,4.9347,3.7716,4.9362,3.8974,4.4866,3.9047)", + "span": { + "offset": 1797, + "length": 7 + } + }, + { + "content": "☐", + "source": "D(1,5.022,3.7625,5.1423,3.7625,5.1423,3.8914,5.022,3.8914)", + "span": { + "offset": 1806, + "length": 1 + } + }, + { + "content": "Was born before January 2, 1956", + "source": "D(1,5.1879,3.7717,6.8315,3.7708,6.8316,3.8984,5.188,3.8993)", + "span": { + "offset": 1808, + "length": 31 + } + }, + { + "content": "☐", + "source": "D(1,7.0266,3.7651,7.147,3.7678,7.147,3.8967,7.0266,3.8967)", + "span": { + "offset": 1840, + "length": 1 + } + }, + { + "content": "Is blind", + "source": "D(1,7.1919,3.7813,7.5537,3.7787,7.5537,3.8887,7.1926,3.8913)", + "span": { + "offset": 1842, + "length": 8 + } + }, + { + "content": "Dependents", + "source": "D(1,0.4943,3.9619,1.2545,3.9584,1.2551,4.0916,0.4949,4.0951)", + "span": { + "offset": 1882, + "length": 10 + } + }, + { + "content": "If more", + "source": "D(1,0.491,4.1537,0.8517,4.1548,0.8513,4.2598,0.4907,4.2587)", + "span": { + "offset": 1893, + "length": 7 + } + }, + { + "content": "than four", + "source": "D(1,0.489,4.2791,0.9504,4.2768,0.951,4.3826,0.4895,4.3845)", + "span": { + "offset": 1901, + "length": 9 + } + }, + { + "content": "dependents,", + "source": "D(1,0.4923,4.4016,1.1144,4.4016,1.1144,4.509,0.4923,4.509)", + "span": { + "offset": 1911, + "length": 11 + } + }, + { + "content": "see instructions", + "source": "D(1,0.4903,4.5249,1.2576,4.5249,1.2576,4.6299,0.4903,4.6299)", + "span": { + "offset": 1923, + "length": 16 + } + }, + { + "content": "and check", + "source": "D(1,0.4915,4.6449,1.0205,4.6413,1.0212,4.7464,0.4923,4.75)", + "span": { + "offset": 1940, + "length": 9 + } + }, + { + "content": "here", + "source": "D(1,0.4923,4.7642,0.7248,4.7642,0.7248,4.8608,0.4923,4.8608)", + "span": { + "offset": 1950, + "length": 4 + } + }, + { + "content": "☐", + "source": "D(1,0.8923,4.7507,1.0236,4.7507,1.0236,4.8743,0.8923,4.8743)", + "span": { + "offset": 1955, + "length": 1 + } + }, + { + "content": "(see instructions):", + "source": "D(1,1.2949,3.9602,2.1665,3.9599,2.1665,4.0851,1.2949,4.0854)", + "span": { + "offset": 1966, + "length": 19 + } + }, + { + "content": "(1) First name", + "source": "D(1,1.3198,4.1116,1.9279,4.1116,1.9279,4.219,1.3198,4.219)", + "span": { + "offset": 1986, + "length": 14 + } + }, + { + "content": "Last name", + "source": "D(1,2.4757,4.1169,2.9447,4.1169,2.9447,4.2136,2.4757,4.2136)", + "span": { + "offset": 2010, + "length": 9 + } + }, + { + "content": "(2) Social security", + "source": "D(1,3.8987,3.9691,4.6899,3.9651,4.6905,4.0827,3.8993,4.0856)", + "span": { + "offset": 2041, + "length": 19 + } + }, + { + "content": "number", + "source": "D(1,4.1213,4.0957,4.47,4.0957,4.47,4.1841,4.1213,4.1841)", + "span": { + "offset": 2061, + "length": 6 + } + }, + { + "content": "(3) Relationship", + "source": "D(1,5.0012,3.9698,5.6906,3.9723,5.6902,4.0853,5.0008,4.0829)", + "span": { + "offset": 2077, + "length": 16 + } + }, + { + "content": "to you", + "source": "D(1,5.2004,4.0981,5.4827,4.0981,5.4827,4.1948,5.2004,4.1948)", + "span": { + "offset": 2094, + "length": 6 + } + }, + { + "content": "(4)", + "source": "D(1,6.0762,3.9732,6.1799,3.9732,6.1799,4.0817,6.0762,4.0817)", + "span": { + "offset": 2110, + "length": 3 + } + }, + { + "content": "✓", + "source": "D(1,6.209,3.9585,6.3252,3.9666,6.3252,4.0713,6.209,4.0579)", + "span": { + "offset": 2114, + "length": 1 + } + }, + { + "content": "if qualifies for (see instructions):", + "source": "D(1,6.3459,3.9632,7.7161,3.9689,7.7156,4.0856,6.3455,4.0801)", + "span": { + "offset": 2116, + "length": 62 + } + }, + { + "content": "Child tax credit", + "source": "D(1,6.0098,4.1143,6.6863,4.1143,6.6863,4.2166,6.0098,4.2166)", + "span": { + "offset": 2133, + "length": 16 + } + }, + { + "content": "Credit for other dependents", + "source": "D(1,6.9187,4.1087,8.0061,4.1087,8.0061,4.2217,6.9187,4.2217)", + "span": { + "offset": 2179, + "length": 27 + } + }, + { + "content": "Milsa", + "source": "D(1,1.6602,4.2811,1.9476,4.2802,1.9479,4.3858,1.6602,4.3867)", + "span": { + "offset": 2227, + "length": 5 + } + }, + { + "content": "Hill", + "source": "D(1,2.3969,4.2778,2.5836,4.2778,2.5836,4.3858,2.3969,4.3858)", + "span": { + "offset": 2242, + "length": 4 + } + }, + { + "content": "052000520", + "source": "D(1,3.7271,4.2735,4.8684,4.2736,4.8684,4.3931,3.727,4.393)", + "span": { + "offset": 2276, + "length": 9 + } + }, + { + "content": "friend", + "source": "D(1,5.1423,4.2768,5.4619,4.2778,5.4619,4.3861,5.142,4.3851)", + "span": { + "offset": 2295, + "length": 6 + } + }, + { + "content": "☐", + "source": "D(1,6.2878,4.2673,6.3999,4.27,6.3999,4.3962,6.2878,4.3962)", + "span": { + "offset": 2311, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,7.3877,4.2673,7.5081,4.27,7.5081,4.3962,7.3877,4.3962)", + "span": { + "offset": 2322, + "length": 1 + } + }, + { + "content": "Amanda", + "source": "D(1,1.6301,4.4446,2.0742,4.4446,2.0742,4.552,1.6301,4.552)", + "span": { + "offset": 2344, + "length": 6 + } + }, + { + "content": "Hill", + "source": "D(1,2.4072,4.4446,2.5898,4.4446,2.5898,4.5509,2.4072,4.5509)", + "span": { + "offset": 2360, + "length": 4 + } + }, + { + "content": "5 2 0 8 5 2 0 0 0", + "source": "D(1,3.7271,4.436,4.8688,4.4395,4.8684,4.5617,3.7267,4.5582)", + "span": { + "offset": 2374, + "length": 35 + } + }, + { + "content": "friend", + "source": "D(1,5.1755,4.4446,5.5034,4.4446,5.5034,4.552,5.1755,4.552)", + "span": { + "offset": 2419, + "length": 6 + } + }, + { + "content": "☐", + "source": "D(1,6.2878,4.4338,6.3999,4.4338,6.3999,4.5627,6.2878,4.5627)", + "span": { + "offset": 2435, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,7.3877,4.4338,7.5081,4.4338,7.5081,4.5627,7.3877,4.5627)", + "span": { + "offset": 2446, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.2878,4.6057,6.3999,4.6057,6.3999,4.7346,6.2878,4.7346)", + "span": { + "offset": 2528, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,7.3877,4.603,7.5081,4.6057,7.5081,4.7346,7.3877,4.7346)", + "span": { + "offset": 2539, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.2878,4.7722,6.3999,4.7722,6.3999,4.8958,6.2878,4.8958)", + "span": { + "offset": 2621, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,7.3877,4.7749,7.5081,4.7695,7.5081,4.8984,7.3877,4.9011)", + "span": { + "offset": 2632, + "length": 1 + } + }, + { + "content": "Attach", + "source": "D(1,0.5149,5.0784,0.8327,5.0784,0.8327,5.1804,0.5149,5.1804)", + "span": { + "offset": 2685, + "length": 6 + } + }, + { + "content": "Sch. B if", + "source": "D(1,0.5185,5.2207,0.9292,5.2207,0.9292,5.3288,0.5185,5.3288)", + "span": { + "offset": 2692, + "length": 9 + } + }, + { + "content": "required.", + "source": "D(1,0.5159,5.36,0.9432,5.36,0.9432,5.4678,0.5159,5.4678)", + "span": { + "offset": 2702, + "length": 9 + } + }, + { + "content": "1", + "source": "D(1,1.3395,4.9629,1.3956,4.9629,1.3956,5.0576,1.3395,5.0576)", + "span": { + "offset": 2733, + "length": 1 + } + }, + { + "content": "Wages, salaries, tips, etc. Attach Form(s) W-2", + "source": "D(1,1.5843,4.9505,3.8682,4.9481,3.8682,5.073,1.5844,5.0755)", + "span": { + "offset": 2735, + "length": 46 + } + }, + { + "content": "1", + "source": "D(1,6.8232,4.9629,6.8772,4.9629,6.8772,5.0597,6.8232,5.0597)", + "span": { + "offset": 2791, + "length": 1 + } + }, + { + "content": "200", + "source": "D(1,7.7861,4.9521,7.9646,4.9521,7.9646,5.0515,7.7861,5.0515)", + "span": { + "offset": 2802, + "length": 3 + } + }, + { + "content": "2a", + "source": "D(1,1.3281,5.1308,1.468,5.1233,1.472,5.2298,1.3292,5.2373)", + "span": { + "offset": 2826, + "length": 2 + } + }, + { + "content": "Tax-exempt interest", + "source": "D(1,1.5865,5.1264,2.6044,5.1264,2.6044,5.2452,1.5865,5.2452)", + "span": { + "offset": 2829, + "length": 19 + } + }, + { + "content": ".", + "source": "D(1,2.8426,5.2059,2.8549,5.2059,2.8549,5.2182,2.8426,5.2182)", + "span": { + "offset": 2849, + "length": 1 + } + }, + { + "content": ".", + "source": "D(1,3.0093,5.2059,3.0216,5.2059,3.0216,5.2182,3.0093,5.2182)", + "span": { + "offset": 2851, + "length": 1 + } + }, + { + "content": "2a", + "source": "D(1,3.2789,5.1274,3.4199,5.1393,3.4158,5.236,3.276,5.2241)", + "span": { + "offset": 2862, + "length": 2 + } + }, + { + "content": "100", + "source": "D(1,4.2721,5.1242,4.4613,5.1152,4.4658,5.2177,4.2749,5.2314)", + "span": { + "offset": 2874, + "length": 3 + } + }, + { + "content": "b Taxable interest", + "source": "D(1,4.6858,5.1396,5.6241,5.1424,5.6238,5.2536,4.6855,5.2511)", + "span": { + "offset": 2899, + "length": 18 + } + }, + { + "content": "2b", + "source": "D(1,6.7776,5.1264,6.9146,5.1264,6.9146,5.2288,6.7776,5.2288)", + "span": { + "offset": 2927, + "length": 2 + } + }, + { + "content": "300", + "source": "D(1,7.7861,5.124,7.9646,5.1141,7.9687,5.2197,7.7861,5.2295)", + "span": { + "offset": 2939, + "length": 3 + } + }, + { + "content": "3a", + "source": "D(1,1.3281,5.3001,1.4685,5.3005,1.4682,5.4041,1.3281,5.4036)", + "span": { + "offset": 2963, + "length": 2 + } + }, + { + "content": "Qualified dividends", + "source": "D(1,1.5871,5.2913,2.5504,5.2874,2.5509,5.404,1.5875,5.4079)", + "span": { + "offset": 2966, + "length": 19 + } + }, + { + "content": ".", + "source": "D(1,2.6759,5.3725,2.6883,5.3725,2.6883,5.3849,2.6759,5.3849)", + "span": { + "offset": 2986, + "length": 1 + } + }, + { + "content": ".", + "source": "D(1,2.8426,5.3725,2.8549,5.3725,2.8549,5.3849,2.8426,5.3849)", + "span": { + "offset": 2988, + "length": 1 + } + }, + { + "content": ".", + "source": "D(1,3.0093,5.3725,3.0216,5.3725,3.0216,5.3849,3.0093,5.3849)", + "span": { + "offset": 2990, + "length": 1 + } + }, + { + "content": "3a", + "source": "D(1,3.2784,5.3008,3.4158,5.3002,3.4162,5.4015,3.2788,5.4021)", + "span": { + "offset": 3001, + "length": 2 + } + }, + { + "content": "200", + "source": "D(1,4.2666,5.2825,4.4617,5.2825,4.4617,5.3879,4.2666,5.3879)", + "span": { + "offset": 3013, + "length": 3 + } + }, + { + "content": "b Ordinary dividends", + "source": "D(1,4.6893,5.3024,5.7649,5.2962,5.7656,5.4197,4.69,5.4253)", + "span": { + "offset": 3038, + "length": 20 + } + }, + { + "content": "3b", + "source": "D(1,6.7734,5.2932,6.9146,5.2932,6.9146,5.3953,6.7734,5.3953)", + "span": { + "offset": 3068, + "length": 2 + } + }, + { + "content": "200", + "source": "D(1,7.7861,5.2825,7.9646,5.2825,7.9646,5.3845,7.7861,5.3845)", + "span": { + "offset": 3080, + "length": 3 + } + }, + { + "content": "4a", + "source": "D(1,1.3302,5.4651,1.4672,5.4651,1.4672,5.5645,1.3302,5.5645)", + "span": { + "offset": 3104, + "length": 2 + } + }, + { + "content": "IRA distributions", + "source": "D(1,1.5896,5.4597,2.4238,5.4597,2.4238,5.5698,1.5896,5.5698)", + "span": { + "offset": 3107, + "length": 17 + } + }, + { + "content": "4a", + "source": "D(1,3.2747,5.4678,3.4158,5.4678,3.4158,5.5645,3.2747,5.5645)", + "span": { + "offset": 3134, + "length": 2 + } + }, + { + "content": "300", + "source": "D(1,4.2666,5.4514,4.47,5.4454,4.4714,5.5559,4.2667,5.562)", + "span": { + "offset": 3146, + "length": 3 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.6858,5.4597,5.657,5.4597,5.657,5.5698,4.6858,5.5698)", + "span": { + "offset": 3171, + "length": 16 + } + }, + { + "content": "4b", + "source": "D(1,6.7776,5.4598,6.9147,5.4599,6.9145,5.5616,6.7775,5.5614)", + "span": { + "offset": 3197, + "length": 2 + } + }, + { + "content": "100", + "source": "D(1,7.7901,5.45,7.9687,5.4496,7.9687,5.5594,7.7903,5.5598)", + "span": { + "offset": 3209, + "length": 3 + } + }, + { + "content": "5a", + "source": "D(1,1.3282,5.628,1.4672,5.6253,1.4691,5.7275,1.3302,5.7302)", + "span": { + "offset": 3233, + "length": 2 + } + }, + { + "content": "Pensions and annuities", + "source": "D(1,1.5871,5.6222,2.7476,5.6176,2.748,5.7359,1.5875,5.7404)", + "span": { + "offset": 3236, + "length": 22 + } + }, + { + "content": ".", + "source": "D(1,2.8426,5.7059,2.8549,5.7059,2.8549,5.7182,2.8426,5.7182)", + "span": { + "offset": 3259, + "length": 1 + } + }, + { + "content": ".", + "source": "D(1,3.0093,5.7059,3.0216,5.7059,3.0216,5.7182,3.0093,5.7182)", + "span": { + "offset": 3261, + "length": 1 + } + }, + { + "content": "5a", + "source": "D(1,3.2768,5.6281,3.4116,5.6253,3.4137,5.7237,3.2788,5.7265)", + "span": { + "offset": 3272, + "length": 2 + } + }, + { + "content": "200", + "source": "D(1,4.2666,5.6128,4.4617,5.6128,4.4617,5.7202,4.2666,5.7202)", + "span": { + "offset": 3284, + "length": 3 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.6894,5.6234,5.6528,5.6188,5.6534,5.7312,4.69,5.7353)", + "span": { + "offset": 3309, + "length": 16 + } + }, + { + "content": "5b", + "source": "D(1,6.7776,5.6259,6.9154,5.627,6.9146,5.727,6.7768,5.7259)", + "span": { + "offset": 3335, + "length": 2 + } + }, + { + "content": "400", + "source": "D(1,7.7861,5.6125,7.9687,5.6125,7.9687,5.7202,7.7861,5.7202)", + "span": { + "offset": 3347, + "length": 3 + } + }, + { + "content": "Standard", + "source": "D(1,0.4475,5.8032,0.8804,5.8024,0.8806,5.903,0.4476,5.9038)", + "span": { + "offset": 3384, + "length": 8 + } + }, + { + "content": "Deduction for-", + "source": "D(1,0.4501,5.913,1.1714,5.9127,1.1715,6.0115,0.4501,6.0117)", + "span": { + "offset": 3393, + "length": 14 + } + }, + { + "content": ". Single or", + "source": "D(1,0.457,6.0518,0.8897,6.0443,0.891,6.1438,0.4587,6.1505)", + "span": { + "offset": 3408, + "length": 11 + } + }, + { + "content": "Married filing", + "source": "D(1,0.5178,6.1476,1.0547,6.1525,1.0538,6.2523,0.5169,6.2474)", + "span": { + "offset": 3420, + "length": 14 + } + }, + { + "content": "separately,", + "source": "D(1,0.5149,6.2501,0.9684,6.2556,0.967,6.352,0.5146,6.3425)", + "span": { + "offset": 3435, + "length": 11 + } + }, + { + "content": "$12,400", + "source": "D(1,0.5128,6.3433,0.8576,6.3433,0.8576,6.4399,0.5128,6.4399)", + "span": { + "offset": 3447, + "length": 7 + } + }, + { + "content": ". Married filing", + "source": "D(1,0.4578,6.4597,1.0544,6.4738,1.0521,6.571,0.4556,6.557)", + "span": { + "offset": 3455, + "length": 16 + } + }, + { + "content": "jointly or", + "source": "D(1,0.5112,6.5667,0.8726,6.5635,0.8734,6.6587,0.5121,6.6619)", + "span": { + "offset": 3472, + "length": 10 + } + }, + { + "content": "Qualifying", + "source": "D(1,0.5162,6.6655,0.9312,6.6655,0.9312,6.7622,0.5162,6.7622)", + "span": { + "offset": 3483, + "length": 10 + } + }, + { + "content": "widow(er),", + "source": "D(1,0.5159,6.7622,0.9385,6.7622,0.9385,6.8589,0.5159,6.8589)", + "span": { + "offset": 3494, + "length": 10 + } + }, + { + "content": "$24,800", + "source": "D(1,0.5136,6.8598,0.8591,6.8613,0.8586,6.9631,0.5132,6.9616)", + "span": { + "offset": 3505, + "length": 7 + } + }, + { + "content": ". Head of", + "source": "D(1,0.4589,6.9738,0.856,6.9738,0.856,7.069,0.4589,7.0691)", + "span": { + "offset": 3513, + "length": 9 + } + }, + { + "content": "household,", + "source": "D(1,0.5126,7.0791,0.9722,7.0791,0.9722,7.1758,0.5126,7.1758)", + "span": { + "offset": 3523, + "length": 10 + } + }, + { + "content": "$18,650", + "source": "D(1,0.5167,7.1687,0.8589,7.1698,0.8586,7.268,0.5164,7.2669)", + "span": { + "offset": 3534, + "length": 7 + } + }, + { + "content": ". If you checked", + "source": "D(1,0.4575,7.3017,1.1123,7.2966,1.1123,7.3951,0.4583,7.4002)", + "span": { + "offset": 3542, + "length": 16 + } + }, + { + "content": "any box under", + "source": "D(1,0.5162,7.3947,1.103,7.3942,1.1031,7.4869,0.5163,7.4875)", + "span": { + "offset": 3559, + "length": 13 + } + }, + { + "content": "Standard", + "source": "D(1,0.5157,7.4975,0.894,7.4981,0.8939,7.5856,0.5156,7.585)", + "span": { + "offset": 3573, + "length": 8 + } + }, + { + "content": "Deduction,", + "source": "D(1,0.5146,7.5948,0.9494,7.5831,0.9518,7.6824,0.5163,7.6941)", + "span": { + "offset": 3582, + "length": 10 + } + }, + { + "content": "see instructions.", + "source": "D(1,0.5136,7.6887,1.1714,7.6887,1.1714,7.7816,0.5136,7.7816)", + "span": { + "offset": 3593, + "length": 17 + } + }, + { + "content": "6a", + "source": "D(1,1.3292,5.7954,1.4661,5.7954,1.4661,5.8975,1.3292,5.8975)", + "span": { + "offset": 3620, + "length": 2 + } + }, + { + "content": "Social security benefits", + "source": "D(1,1.5875,5.7887,2.7517,5.7887,2.7517,5.9089,1.5875,5.9089)", + "span": { + "offset": 3623, + "length": 24 + } + }, + { + "content": ".", + "source": "D(1,3.0093,5.8725,3.0216,5.8725,3.0216,5.8849,3.0093,5.8849)", + "span": { + "offset": 3648, + "length": 1 + } + }, + { + "content": "6a", + "source": "D(1,3.2788,5.8008,3.422,5.8008,3.422,5.8975,3.2788,5.8975)", + "span": { + "offset": 3659, + "length": 2 + } + }, + { + "content": "100", + "source": "D(1,4.2721,5.7846,4.4617,5.7701,4.4658,5.8778,4.275,5.8924)", + "span": { + "offset": 3683, + "length": 3 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.6899,5.7899,5.6528,5.7899,5.6528,5.9028,4.6899,5.9028)", + "span": { + "offset": 3687, + "length": 16 + } + }, + { + "content": "6b", + "source": "D(1,6.7776,5.8008,6.9146,5.8008,6.9146,5.8975,6.7776,5.8975)", + "span": { + "offset": 3713, + "length": 2 + } + }, + { + "content": "500", + "source": "D(1,7.7861,5.782,7.9646,5.7817,7.9648,5.8936,7.7861,5.8939)", + "span": { + "offset": 3725, + "length": 3 + } + }, + { + "content": "7", + "source": "D(1,1.3312,5.9565,1.4028,5.9565,1.4028,6.0532,1.3312,6.0532)", + "span": { + "offset": 3761, + "length": 1 + } + }, + { + "content": "Capital gain or (loss). Attach Schedule D if required. If not required, check here", + "source": "D(1,1.5906,5.9454,5.5036,5.9521,5.5034,6.0831,1.5904,6.0764)", + "span": { + "offset": 3763, + "length": 82 + } + }, + { + "content": "☐", + "source": "D(1,6.458,5.9351,6.5825,5.9404,6.5825,6.0586,6.458,6.0586)", + "span": { + "offset": 3846, + "length": 1 + } + }, + { + "content": "7", + "source": "D(1,6.8149,5.9559,6.8813,5.9559,6.8813,6.054,6.8149,6.054)", + "span": { + "offset": 3857, + "length": 1 + } + }, + { + "content": "100", + "source": "D(1,7.7903,5.9512,7.9687,5.9512,7.9687,6.053,7.7903,6.053)", + "span": { + "offset": 3868, + "length": 3 + } + }, + { + "content": "8", + "source": "D(1,1.3271,6.1284,1.408,6.1284,1.408,6.2251,1.3271,6.2251)", + "span": { + "offset": 3904, + "length": 1 + } + }, + { + "content": "Other income from Schedule 1, line 9", + "source": "D(1,1.5886,6.1141,3.4593,6.1141,3.4594,6.2431,1.5886,6.2431)", + "span": { + "offset": 3906, + "length": 36 + } + }, + { + "content": "8", + "source": "D(1,6.8149,6.1284,6.8855,6.1284,6.8855,6.2251,6.8149,6.2251)", + "span": { + "offset": 3952, + "length": 1 + } + }, + { + "content": "180", + "source": "D(1,7.7861,6.1131,7.9686,6.1091,7.9687,6.2126,7.7861,6.2165)", + "span": { + "offset": 3963, + "length": 3 + } + }, + { + "content": "9", + "source": "D(1,1.3292,6.2949,1.4018,6.2949,1.4018,6.3916,1.3292,6.3916)", + "span": { + "offset": 3999, + "length": 1 + } + }, + { + "content": "Add lines 1, 2b, 3b, 4b, 5b, 6b, 7, and 8. This is your total income", + "source": "D(1,1.5875,6.2791,4.8893,6.2828,4.8892,6.4121,1.5874,6.4084)", + "span": { + "offset": 4001, + "length": 68 + } + }, + { + "content": "9", + "source": "D(1,6.8232,6.2949,6.8772,6.2949,6.8772,6.3916,6.8232,6.3916)", + "span": { + "offset": 4079, + "length": 1 + } + }, + { + "content": "1980", + "source": "D(1,7.7238,6.2796,7.9646,6.2794,7.9647,6.3879,7.7239,6.3881)", + "span": { + "offset": 4090, + "length": 4 + } + }, + { + "content": "10", + "source": "D(1,1.2752,6.4614,1.4008,6.4614,1.4008,6.5581,1.2752,6.5581)", + "span": { + "offset": 4127, + "length": 2 + } + }, + { + "content": "Adjustments to income:", + "source": "D(1,1.5854,6.447,2.7768,6.4492,2.7766,6.5793,1.5852,6.5772)", + "span": { + "offset": 4130, + "length": 22 + } + }, + { + "content": "400", + "source": "D(1,7.7861,6.9556,7.9646,6.9556,7.9646,7.0522,7.7861,7.0522)", + "span": { + "offset": 4196, + "length": 3 + } + }, + { + "content": "a", + "source": "D(1,1.3935,6.6423,1.4672,6.6423,1.4672,6.7302,1.3935,6.7302)", + "span": { + "offset": 4232, + "length": 1 + } + }, + { + "content": "From Schedule 1, line 22", + "source": "D(1,1.5865,6.6226,2.8409,6.6226,2.8409,6.7407,1.5865,6.7407)", + "span": { + "offset": 4234, + "length": 24 + } + }, + { + "content": "10a", + "source": "D(1,5.4536,6.6333,5.6445,6.6333,5.6445,6.73,5.4536,6.73)", + "span": { + "offset": 4268, + "length": 3 + } + }, + { + "content": "200", + "source": "D(1,6.4663,6.6172,6.6655,6.6172,6.6655,6.7246,6.4663,6.7246)", + "span": { + "offset": 4281, + "length": 3 + } + }, + { + "content": "b", + "source": "D(1,1.3893,6.8052,1.4661,6.8052,1.4661,6.9019,1.3893,6.9019)", + "span": { + "offset": 4317, + "length": 1 + } + }, + { + "content": "Charitable contributions if you take the standard deduction. See instructions", + "source": "D(1,1.5875,6.7937,5.2668,6.7937,5.2668,6.9133,1.5875,6.9133)", + "span": { + "offset": 4319, + "length": 77 + } + }, + { + "content": "10b", + "source": "D(1,5.4453,6.8012,5.6445,6.7873,5.6445,6.8949,5.4453,6.9088)", + "span": { + "offset": 4406, + "length": 3 + } + }, + { + "content": "200", + "source": "D(1,6.4705,6.7837,6.6655,6.7837,6.6655,6.8911,6.4705,6.8911)", + "span": { + "offset": 4419, + "length": 3 + } + }, + { + "content": "c", + "source": "D(1,1.4042,6.9925,1.4609,6.9925,1.4609,7.053,1.4042,7.053)", + "span": { + "offset": 4455, + "length": 1 + } + }, + { + "content": "Add lines 10a and 10b. These are your total adjustments to income", + "source": "D(1,1.5834,6.9532,5.0303,6.9566,5.0303,7.0805,1.5832,7.0769)", + "span": { + "offset": 4457, + "length": 65 + } + }, + { + "content": "10c", + "source": "D(1,6.7568,6.9663,6.9478,6.9663,6.9478,7.063,6.7568,7.063)", + "span": { + "offset": 4532, + "length": 3 + } + }, + { + "content": "11", + "source": "D(1,1.2711,7.1328,1.3987,7.1328,1.3987,7.2295,1.2711,7.2295)", + "span": { + "offset": 4568, + "length": 2 + } + }, + { + "content": "Subtract line 10c from line 9. This is your adjusted gross income", + "source": "D(1,1.5875,7.1165,4.8684,7.1165,4.8684,7.2463,1.5875,7.2463)", + "span": { + "offset": 4571, + "length": 65 + } + }, + { + "content": "11", + "source": "D(1,6.79,7.1263,6.9007,7.1343,6.8979,7.2306,6.79,7.2227)", + "span": { + "offset": 4646, + "length": 2 + } + }, + { + "content": "1880", + "source": "D(1,7.7239,7.1109,7.9646,7.1109,7.9646,7.2188,7.7239,7.2188)", + "span": { + "offset": 4658, + "length": 4 + } + }, + { + "content": "12", + "source": "D(1,1.2794,7.2939,1.408,7.2939,1.408,7.3906,1.2794,7.3906)", + "span": { + "offset": 4695, + "length": 2 + } + }, + { + "content": "Standard deduction or itemized deductions (from Schedule A)", + "source": "D(1,1.5854,7.2826,4.8103,7.281,4.8104,7.4109,1.5855,7.4125)", + "span": { + "offset": 4698, + "length": 59 + } + }, + { + "content": "12", + "source": "D(1,6.79,7.2939,6.9146,7.2939,6.9146,7.3906,6.79,7.3906)", + "span": { + "offset": 4767, + "length": 2 + } + }, + { + "content": "100", + "source": "D(1,7.7861,7.2764,7.9687,7.2764,7.9687,7.3853,7.7861,7.3853)", + "span": { + "offset": 4779, + "length": 3 + } + }, + { + "content": "13", + "source": "D(1,1.2721,7.4575,1.4086,7.4583,1.408,7.5588,1.2716,7.558)", + "span": { + "offset": 4815, + "length": 2 + } + }, + { + "content": "Qualified business income deduction. Attach Form 8995 or Form 8995-A", + "source": "D(1,1.5875,7.4471,5.2046,7.4441,5.2047,7.5718,1.5876,7.5748)", + "span": { + "offset": 4818, + "length": 68 + } + }, + { + "content": "13", + "source": "D(1,6.79,7.4604,6.9146,7.4604,6.9146,7.5571,6.79,7.5571)", + "span": { + "offset": 4896, + "length": 2 + } + }, + { + "content": "200", + "source": "D(1,7.7861,7.4454,7.9646,7.4454,7.9646,7.5507,7.7861,7.5507)", + "span": { + "offset": 4908, + "length": 3 + } + }, + { + "content": "14", + "source": "D(1,1.2742,7.6372,1.408,7.6372,1.408,7.7344,1.2742,7.7344)", + "span": { + "offset": 4944, + "length": 2 + } + }, + { + "content": "Add lines 12 and 13", + "source": "D(1,1.5854,7.6254,2.5919,7.6157,2.5931,7.7404,1.5866,7.7501)", + "span": { + "offset": 4947, + "length": 19 + } + }, + { + "content": "14", + "source": "D(1,6.79,7.6248,6.9146,7.6248,6.9146,7.7339,6.79,7.7339)", + "span": { + "offset": 4976, + "length": 2 + } + }, + { + "content": "500", + "source": "D(1,7.7778,7.6142,7.9646,7.6142,7.9646,7.7183,7.7778,7.7183)", + "span": { + "offset": 4988, + "length": 3 + } + }, + { + "content": "15", + "source": "D(1,1.2753,7.775,1.4111,7.7813,1.408,7.8827,1.2728,7.8764)", + "span": { + "offset": 5024, + "length": 2 + } + }, + { + "content": "Taxable income. Subtract line 14 from line 11. If zero or less, enter -0-", + "source": "D(1,1.5865,7.7708,5.1092,7.7735,5.1091,7.8927,1.5864,7.89)", + "span": { + "offset": 5027, + "length": 73 + } + }, + { + "content": "15", + "source": "D(1,6.79,7.7827,6.9062,7.7827,6.9062,7.8794,6.79,7.8794)", + "span": { + "offset": 5110, + "length": 2 + } + }, + { + "content": "510", + "source": "D(1,7.7762,7.7766,7.9687,7.7734,7.9687,7.8779,7.7779,7.8811)", + "span": { + "offset": 5122, + "length": 3 + } + }, + { + "content": "For Disclosure, Privacy Act, and Paperwork Reduction Act Notice, see separate instructions.", + "source": "D(1,0.4879,7.9635,4.7896,7.967,4.7895,8.0855,0.4878,8.082)", + "span": { + "offset": 5165, + "length": 91 + } + }, + { + "content": "Cat. No. 11320B", + "source": "D(1,5.6777,7.9761,6.3169,7.9761,6.3169,8.0692,5.6777,8.0692)", + "span": { + "offset": 5279, + "length": 15 + } + }, + { + "content": "Form 1040 (2020)", + "source": "D(1,7.2092,7.9586,8.0061,7.9586,8.0061,8.0781,7.2092,8.0781)", + "span": { + "offset": 5317, + "length": 16 + } + } + ] + }, + { + "pageNumber": 2, + "angle": 0, + "width": 8.5, + "height": 11, + "spans": [ + { + "offset": 5359, + "length": 5117 + } + ], + "words": [ + { + "content": "Page", + "span": { + "offset": 5376, + "length": 4 + }, + "confidence": 0.98, + "source": "D(2,7.6616,0.3486,7.8961,0.3426,7.8961,0.4725,7.6616,0.4751)" + }, + { + "content": "2", + "span": { + "offset": 5381, + "length": 1 + }, + "confidence": 0.984, + "source": "D(2,7.9148,0.342,7.9937,0.3394,7.9937,0.4707,7.9148,0.4721)" + }, + { + "content": "Form", + "span": { + "offset": 5405, + "length": 4 + }, + "confidence": 0.99, + "source": "D(2,0.4884,0.3457,0.7142,0.3459,0.714,0.4603,0.489,0.4584)" + }, + { + "content": "1040", + "span": { + "offset": 5410, + "length": 4 + }, + "confidence": 0.984, + "source": "D(2,0.7512,0.3459,0.9672,0.3465,0.9661,0.4621,0.7508,0.4606)" + }, + { + "content": "(", + "span": { + "offset": 5415, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,0.9886,0.3465,1.0236,0.3467,1.0224,0.4625,0.9875,0.4623)" + }, + { + "content": "2020", + "span": { + "offset": 5416, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,1.0178,0.3466,1.2338,0.3477,1.2319,0.4635,1.0166,0.4624)" + }, + { + "content": ")", + "span": { + "offset": 5420, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.228,0.3477,1.2669,0.3479,1.2648,0.4637,1.226,0.4635)" + }, + { + "content": "16", + "span": { + "offset": 5481, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.27,0.5455,1.4039,0.5453,1.4039,0.6479,1.27,0.6473)" + }, + { + "content": "Tax", + "span": { + "offset": 5484, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,1.5823,0.5364,1.7742,0.536,1.7742,0.6667,1.5823,0.6667)" + }, + { + "content": "(", + "span": { + "offset": 5488, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.8025,0.5359,1.8352,0.5358,1.8352,0.6668,1.8025,0.6668)" + }, + { + "content": "see", + "span": { + "offset": 5489, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,1.8352,0.5358,2.0009,0.5355,2.0009,0.6668,1.8352,0.6668)" + }, + { + "content": "instructions", + "span": { + "offset": 5493, + "length": 12 + }, + "confidence": 0.996, + "source": "D(2,2.0336,0.5354,2.5831,0.5349,2.5831,0.6668,2.0336,0.6668)" + }, + { + "content": ")", + "span": { + "offset": 5505, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,2.5831,0.5349,2.6158,0.5349,2.6158,0.6668,2.5831,0.6668)" + }, + { + "content": ".", + "span": { + "offset": 5506, + "length": 1 + }, + "confidence": 0.994, + "source": "D(2,2.6136,0.5349,2.6354,0.5349,2.6354,0.6668,2.6136,0.6668)" + }, + { + "content": "Check", + "span": { + "offset": 5508, + "length": 5 + }, + "confidence": 0.986, + "source": "D(2,2.6703,0.535,2.982,0.5353,2.982,0.6669,2.6703,0.6668)" + }, + { + "content": "if", + "span": { + "offset": 5514, + "length": 2 + }, + "confidence": 0.996, + "source": "D(2,3.0104,0.5354,3.0714,0.5354,3.0714,0.6669,3.0104,0.6669)" + }, + { + "content": "any", + "span": { + "offset": 5517, + "length": 3 + }, + "confidence": 0.98, + "source": "D(2,3.0932,0.5354,3.2655,0.5357,3.2655,0.6669,3.0932,0.6669)" + }, + { + "content": "from", + "span": { + "offset": 5521, + "length": 4 + }, + "confidence": 0.983, + "source": "D(2,3.2916,0.5359,3.5097,0.5368,3.5097,0.667,3.2916,0.6669)" + }, + { + "content": "Form", + "span": { + "offset": 5526, + "length": 4 + }, + "confidence": 0.993, + "source": "D(2,3.5467,0.5369,3.78,0.5379,3.78,0.6671,3.5467,0.667)" + }, + { + "content": "(", + "span": { + "offset": 5530, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.7887,0.5379,3.8214,0.5381,3.8214,0.6671,3.7887,0.6671)" + }, + { + "content": "s", + "span": { + "offset": 5531, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.8214,0.5381,3.8738,0.5383,3.8738,0.6671,3.8214,0.6671)" + }, + { + "content": ")", + "span": { + "offset": 5532, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.8716,0.5383,3.9065,0.5384,3.9065,0.6671,3.8716,0.6671)" + }, + { + "content": ":", + "span": { + "offset": 5533, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.9043,0.5384,3.9283,0.5385,3.9283,0.6671,3.9043,0.6671)" + }, + { + "content": "1", + "span": { + "offset": 5535, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,3.9959,0.5388,4.0591,0.5391,4.0591,0.6671,3.9959,0.6671)" + }, + { + "content": "☐", + "span": { + "offset": 5537, + "length": 1 + }, + "confidence": 0.977, + "source": "D(2,4.1213,0.5358,4.2417,0.5334,4.2417,0.659,4.1213,0.663)" + }, + { + "content": "8814", + "span": { + "offset": 5539, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,4.2957,0.5457,4.5488,0.5442,4.5488,0.6481,4.2957,0.6487)" + }, + { + "content": "2", + "span": { + "offset": 5544, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,4.6899,0.553,4.7605,0.5522,4.7605,0.6468,4.6899,0.647)" + }, + { + "content": "☑", + "span": { + "offset": 5546, + "length": 1 + }, + "confidence": 0.96, + "source": "D(2,4.8269,0.5351,4.9431,0.5354,4.9431,0.659,4.8269,0.6586)" + }, + { + "content": "4972", + "span": { + "offset": 5548, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,4.9888,0.545,5.2502,0.5441,5.2502,0.6483,4.9888,0.6479)" + }, + { + "content": "3", + "span": { + "offset": 5553, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,5.4038,0.5525,5.4619,0.5519,5.4619,0.6431,5.4038,0.6439)" + }, + { + "content": "☐", + "span": { + "offset": 5555, + "length": 1 + }, + "confidence": 0.988, + "source": "D(2,5.5242,0.5358,5.6487,0.5344,5.6487,0.6583,5.5242,0.661)" + }, + { + "content": ".", + "span": { + "offset": 5557, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.3414,0.6281,6.3522,0.6281,6.3522,0.6389,6.3414,0.6389)" + }, + { + "content": ".", + "span": { + "offset": 5559, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.5081,0.6281,6.5189,0.6281,6.5189,0.6389,6.5081,0.6389)" + }, + { + "content": "16", + "span": { + "offset": 5570, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.79,0.5474,6.9062,0.5479,6.9062,0.6465,6.79,0.6457)" + }, + { + "content": "100", + "span": { + "offset": 5582, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,7.7861,0.5349,7.9687,0.5335,7.9687,0.6349,7.7861,0.6351)" + }, + { + "content": "17", + "span": { + "offset": 5618, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2721,0.713,1.4039,0.7127,1.4039,0.8144,1.2721,0.8144)" + }, + { + "content": "Amount", + "span": { + "offset": 5621, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,1.5823,0.7042,1.9875,0.7029,1.9875,0.825,1.5823,0.8256)" + }, + { + "content": "from", + "span": { + "offset": 5628, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,2.0137,0.7028,2.2334,0.7027,2.2334,0.8249,2.0137,0.8249)" + }, + { + "content": "Schedule", + "span": { + "offset": 5633, + "length": 8 + }, + "confidence": 0.982, + "source": "D(2,2.2677,0.7027,2.7454,0.704,2.7454,0.8255,2.2677,0.8249)" + }, + { + "content": "2", + "span": { + "offset": 5642, + "length": 1 + }, + "confidence": 0.979, + "source": "D(2,2.7696,0.7041,2.83,0.7045,2.83,0.8258,2.7695,0.8256)" + }, + { + "content": ",", + "span": { + "offset": 5643, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,2.8341,0.7046,2.8582,0.7047,2.8582,0.8259,2.834,0.8258)" + }, + { + "content": "line", + "span": { + "offset": 5645, + "length": 4 + }, + "confidence": 0.931, + "source": "D(2,2.8905,0.7049,3.0618,0.706,3.0618,0.8265,2.8905,0.826)" + }, + { + "content": "3", + "span": { + "offset": 5650, + "length": 1 + }, + "confidence": 0.97, + "source": "D(2,3.09,0.7062,3.1626,0.7067,3.1626,0.8268,3.09,0.8266)" + }, + { + "content": "17", + "span": { + "offset": 5661, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.79,0.7126,6.9062,0.7131,6.9062,0.811,6.79,0.811)" + }, + { + "content": "100", + "span": { + "offset": 5673, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,7.7861,0.7007,7.9646,0.7011,7.9646,0.8012,7.7861,0.8003)" + }, + { + "content": "18", + "span": { + "offset": 5709, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2742,0.8805,1.4039,0.8799,1.4039,0.9786,1.2742,0.9792)" + }, + { + "content": "Add", + "span": { + "offset": 5712, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,1.5823,0.8699,1.7946,0.87,1.7946,0.9861,1.5823,0.9855)" + }, + { + "content": "lines", + "span": { + "offset": 5716, + "length": 5 + }, + "confidence": 0.992, + "source": "D(2,1.829,0.87,2.0527,0.8703,2.0527,0.9865,1.829,0.9862)" + }, + { + "content": "16", + "span": { + "offset": 5722, + "length": 2 + }, + "confidence": 0.985, + "source": "D(2,2.091,0.8704,2.2076,0.8706,2.2076,0.9866,2.091,0.9865)" + }, + { + "content": "and", + "span": { + "offset": 5725, + "length": 3 + }, + "confidence": 0.968, + "source": "D(2,2.2382,0.8706,2.4217,0.8713,2.4217,0.9863,2.2382,0.9866)" + }, + { + "content": "17", + "span": { + "offset": 5729, + "length": 2 + }, + "confidence": 0.992, + "source": "D(2,2.46,0.8714,2.5919,0.8719,2.5919,0.986,2.46,0.9862)" + }, + { + "content": "18", + "span": { + "offset": 5741, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.79,0.8778,6.9062,0.8787,6.9062,0.9773,6.79,0.9772)" + }, + { + "content": "100", + "span": { + "offset": 5753, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,7.7861,0.8632,7.9646,0.8677,7.9646,0.9694,7.7861,0.9646)" + }, + { + "content": "19", + "span": { + "offset": 5789, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2742,1.0462,1.4018,1.0445,1.4018,1.1427,1.2742,1.1457)" + }, + { + "content": "Child", + "span": { + "offset": 5792, + "length": 5 + }, + "confidence": 0.995, + "source": "D(2,1.5823,1.0343,1.8487,1.0346,1.8487,1.1555,1.5823,1.1545)" + }, + { + "content": "tax", + "span": { + "offset": 5798, + "length": 3 + }, + "confidence": 0.985, + "source": "D(2,1.883,1.0346,2.0343,1.0348,2.0343,1.1561,1.883,1.1556)" + }, + { + "content": "credit", + "span": { + "offset": 5802, + "length": 6 + }, + "confidence": 0.99, + "source": "D(2,2.0666,1.0348,2.3511,1.0351,2.3511,1.1573,2.0666,1.1563)" + }, + { + "content": "or", + "span": { + "offset": 5809, + "length": 2 + }, + "confidence": 0.984, + "source": "D(2,2.3793,1.0351,2.4842,1.0354,2.4842,1.1576,2.3793,1.1574)" + }, + { + "content": "credit", + "span": { + "offset": 5812, + "length": 6 + }, + "confidence": 0.98, + "source": "D(2,2.5084,1.0355,2.7929,1.0362,2.7929,1.1583,2.5084,1.1576)" + }, + { + "content": "for", + "span": { + "offset": 5819, + "length": 3 + }, + "confidence": 0.98, + "source": "D(2,2.8232,1.0363,2.9584,1.0366,2.9584,1.1587,2.8232,1.1584)" + }, + { + "content": "other", + "span": { + "offset": 5823, + "length": 5 + }, + "confidence": 0.988, + "source": "D(2,2.9826,1.0367,3.2509,1.0376,3.2509,1.1591,2.9826,1.1587)" + }, + { + "content": "dependents", + "span": { + "offset": 5829, + "length": 10 + }, + "confidence": 0.998, + "source": "D(2,3.2751,1.0377,3.8744,1.0402,3.8744,1.1597,3.2751,1.1592)" + }, + { + "content": "19", + "span": { + "offset": 5849, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,6.79,1.0422,6.9062,1.0431,6.9062,1.1408,6.79,1.1418)" + }, + { + "content": "100", + "span": { + "offset": 5861, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,7.7861,1.0312,7.9687,1.0312,7.9687,1.1347,7.7861,1.1341)" + }, + { + "content": "20", + "span": { + "offset": 5897, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,1.2083,1.4018,1.2094,1.4018,1.3112,1.2669,1.3119)" + }, + { + "content": "Amount", + "span": { + "offset": 5900, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,1.5792,1.2,1.9872,1.1991,1.9872,1.3199,1.5792,1.3191)" + }, + { + "content": "from", + "span": { + "offset": 5907, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,2.0134,1.199,2.2356,1.1988,2.2356,1.3202,2.0134,1.32)" + }, + { + "content": "Schedule", + "span": { + "offset": 5912, + "length": 8 + }, + "confidence": 0.988, + "source": "D(2,2.2659,1.1988,2.7445,1.1988,2.7445,1.3201,2.2659,1.3202)" + }, + { + "content": "3", + "span": { + "offset": 5921, + "length": 1 + }, + "confidence": 0.982, + "source": "D(2,2.7728,1.1989,2.8314,1.199,2.8314,1.3199,2.7728,1.32)" + }, + { + "content": ",", + "span": { + "offset": 5922, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,2.8334,1.199,2.8556,1.199,2.8556,1.3199,2.8334,1.3199)" + }, + { + "content": "line", + "span": { + "offset": 5924, + "length": 4 + }, + "confidence": 0.877, + "source": "D(2,2.892,1.1991,3.0616,1.1994,3.0616,1.3195,2.892,1.3198)" + }, + { + "content": "7", + "span": { + "offset": 5929, + "length": 1 + }, + "confidence": 0.947, + "source": "D(2,3.0899,1.1994,3.1626,1.1996,3.1626,1.3194,3.0899,1.3195)" + }, + { + "content": "20", + "span": { + "offset": 5940, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.2079,6.9146,1.2108,6.9146,1.3085,6.7776,1.3077)" + }, + { + "content": "100", + "span": { + "offset": 5952, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,7.7861,1.2003,7.9687,1.2007,7.9687,1.3051,7.7861,1.3039)" + }, + { + "content": "21", + "span": { + "offset": 5988, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,1.3767,1.3956,1.378,1.3956,1.4811,1.2669,1.4801)" + }, + { + "content": "Add", + "span": { + "offset": 5991, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,1.5823,1.3693,1.7973,1.3688,1.7973,1.4865,1.5823,1.4861)" + }, + { + "content": "lines", + "span": { + "offset": 5995, + "length": 5 + }, + "confidence": 0.985, + "source": "D(2,1.8328,1.3687,2.0516,1.3683,2.0516,1.4865,1.8328,1.4866)" + }, + { + "content": "19", + "span": { + "offset": 6001, + "length": 2 + }, + "confidence": 0.976, + "source": "D(2,2.0911,1.3683,2.2035,1.3682,2.2035,1.4863,2.0911,1.4864)" + }, + { + "content": "and", + "span": { + "offset": 6004, + "length": 3 + }, + "confidence": 0.948, + "source": "D(2,2.237,1.3682,2.4243,1.3683,2.4243,1.4853,2.237,1.4862)" + }, + { + "content": "20", + "span": { + "offset": 6008, + "length": 2 + }, + "confidence": 0.985, + "source": "D(2,2.4539,1.3683,2.5919,1.3684,2.5919,1.4844,2.4539,1.4851)" + }, + { + "content": "21", + "span": { + "offset": 6020, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.3764,6.8979,1.3782,6.8979,1.4775,6.7776,1.477)" + }, + { + "content": "110", + "span": { + "offset": 6032, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,7.7861,1.3653,7.9687,1.3655,7.9687,1.468,7.7861,1.4674)" + }, + { + "content": "22", + "span": { + "offset": 6068, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2679,1.5411,1.408,1.5431,1.408,1.6439,1.2679,1.6423)" + }, + { + "content": "Subtract", + "span": { + "offset": 6071, + "length": 8 + }, + "confidence": 0.993, + "source": "D(2,1.5803,1.5366,2.0216,1.5355,2.0213,1.6568,1.5803,1.6568)" + }, + { + "content": "line", + "span": { + "offset": 6080, + "length": 4 + }, + "confidence": 0.937, + "source": "D(2,2.0533,1.5354,2.2215,1.535,2.221,1.6568,2.0529,1.6568)" + }, + { + "content": "21", + "span": { + "offset": 6085, + "length": 2 + }, + "confidence": 0.943, + "source": "D(2,2.2492,1.5349,2.36,1.5347,2.3594,1.6568,2.2487,1.6568)" + }, + { + "content": "from", + "span": { + "offset": 6088, + "length": 4 + }, + "confidence": 0.936, + "source": "D(2,2.4055,1.5346,2.6312,1.5348,2.6303,1.6568,2.4049,1.6568)" + }, + { + "content": "line", + "span": { + "offset": 6093, + "length": 4 + }, + "confidence": 0.971, + "source": "D(2,2.6688,1.5349,2.835,1.5353,2.834,1.6567,2.6679,1.6568)" + }, + { + "content": "18", + "span": { + "offset": 6098, + "length": 2 + }, + "confidence": 0.932, + "source": "D(2,2.8766,1.5354,2.9894,1.5356,2.9883,1.6567,2.8755,1.6567)" + }, + { + "content": ".", + "span": { + "offset": 6100, + "length": 1 + }, + "confidence": 0.981, + "source": "D(2,2.9953,1.5356,3.0191,1.5357,3.0179,1.6567,2.9942,1.6567)" + }, + { + "content": "If", + "span": { + "offset": 6102, + "length": 2 + }, + "confidence": 0.894, + "source": "D(2,3.0587,1.5358,3.124,1.5359,3.1227,1.6566,3.0575,1.6567)" + }, + { + "content": "zero", + "span": { + "offset": 6105, + "length": 4 + }, + "confidence": 0.904, + "source": "D(2,3.1477,1.536,3.3615,1.5366,3.36,1.6566,3.1465,1.6566)" + }, + { + "content": "or", + "span": { + "offset": 6110, + "length": 2 + }, + "confidence": 0.935, + "source": "D(2,3.3911,1.5368,3.498,1.5376,3.4965,1.6565,3.3897,1.6566)" + }, + { + "content": "less", + "span": { + "offset": 6113, + "length": 4 + }, + "confidence": 0.941, + "source": "D(2,3.5257,1.5378,3.7157,1.5391,3.714,1.6564,3.5242,1.6565)" + }, + { + "content": ",", + "span": { + "offset": 6117, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.7177,1.5391,3.7434,1.5393,3.7417,1.6564,3.716,1.6564)" + }, + { + "content": "enter", + "span": { + "offset": 6119, + "length": 5 + }, + "confidence": 0.983, + "source": "D(2,3.7771,1.5395,4.0403,1.5414,4.0383,1.6562,3.7753,1.6563)" + }, + { + "content": "-", + "span": { + "offset": 6125, + "length": 1 + }, + "confidence": 0.992, + "source": "D(2,4.062,1.5415,4.1016,1.5418,4.0996,1.6562,4.0601,1.6562)" + }, + { + "content": "0", + "span": { + "offset": 6126, + "length": 1 + }, + "confidence": 0.944, + "source": "D(2,4.1036,1.5418,4.1669,1.5423,4.1649,1.6561,4.1016,1.6562)" + }, + { + "content": "-", + "span": { + "offset": 6127, + "length": 1 + }, + "confidence": 0.989, + "source": "D(2,4.1669,1.5423,4.2085,1.5425,4.2064,1.6561,4.1649,1.6561)" + }, + { + "content": "22", + "span": { + "offset": 6138, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.5417,6.9146,1.5482,6.9146,1.6462,6.7776,1.6413)" + }, + { + "content": "1100", + "span": { + "offset": 6150, + "length": 4 + }, + "confidence": 0.882, + "source": "D(2,7.7239,1.528,7.9646,1.529,7.9646,1.6329,7.7239,1.6315)" + }, + { + "content": "23", + "span": { + "offset": 6187, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.27,1.7107,1.408,1.709,1.408,1.8111,1.27,1.8097)" + }, + { + "content": "Other", + "span": { + "offset": 6190, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,1.5865,1.7021,1.8779,1.7019,1.8779,1.8253,1.5865,1.8247)" + }, + { + "content": "taxes", + "span": { + "offset": 6196, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,1.9046,1.7019,2.1652,1.7016,2.1652,1.8258,1.9046,1.8253)" + }, + { + "content": ",", + "span": { + "offset": 6201, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.1693,1.7016,2.1919,1.7016,2.1919,1.8259,2.1693,1.8258)" + }, + { + "content": "including", + "span": { + "offset": 6203, + "length": 9 + }, + "confidence": 0.998, + "source": "D(2,2.2329,1.7016,2.6762,1.7012,2.6762,1.8268,2.2329,1.826)" + }, + { + "content": "self", + "span": { + "offset": 6213, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,2.7131,1.7012,2.8937,1.7012,2.8937,1.8267,2.7131,1.8269)" + }, + { + "content": "-", + "span": { + "offset": 6217, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.8916,1.7012,2.9245,1.7011,2.9245,1.8267,2.8916,1.8267)" + }, + { + "content": "employment", + "span": { + "offset": 6218, + "length": 10 + }, + "confidence": 0.995, + "source": "D(2,2.9286,1.7011,3.5442,1.701,3.5442,1.8258,2.9286,1.8267)" + }, + { + "content": "tax", + "span": { + "offset": 6229, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,3.5709,1.701,3.7269,1.701,3.7268,1.8256,3.5709,1.8258)" + }, + { + "content": ",", + "span": { + "offset": 6232, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.731,1.701,3.7535,1.701,3.7535,1.8255,3.731,1.8256)" + }, + { + "content": "from", + "span": { + "offset": 6234, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,3.7864,1.701,4.0141,1.701,4.0141,1.8247,3.7864,1.8255)" + }, + { + "content": "Schedule", + "span": { + "offset": 6239, + "length": 8 + }, + "confidence": 0.789, + "source": "D(2,4.047,1.701,4.5128,1.7012,4.5128,1.8224,4.047,1.8245)" + }, + { + "content": "2", + "span": { + "offset": 6248, + "length": 1 + }, + "confidence": 0.959, + "source": "D(2,4.5415,1.7013,4.6011,1.7013,4.6011,1.8219,4.5415,1.8222)" + }, + { + "content": ",", + "span": { + "offset": 6249, + "length": 1 + }, + "confidence": 0.992, + "source": "D(2,4.6031,1.7013,4.6257,1.7013,4.6257,1.8218,4.6031,1.8219)" + }, + { + "content": "line", + "span": { + "offset": 6251, + "length": 4 + }, + "confidence": 0.259, + "source": "D(2,4.6667,1.7013,4.8391,1.7014,4.8391,1.8208,4.6667,1.8216)" + }, + { + "content": "10", + "span": { + "offset": 6256, + "length": 2 + }, + "confidence": 0.527, + "source": "D(2,4.874,1.7014,5.0012,1.7015,5.0012,1.8201,4.874,1.8207)" + }, + { + "content": "23", + "span": { + "offset": 6268, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.7105,6.9062,1.7124,6.9062,1.8088,6.7776,1.8094)" + }, + { + "content": "110", + "span": { + "offset": 6280, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,7.7861,1.701,7.9687,1.6967,7.9687,1.7961,7.7861,1.8004)" + }, + { + "content": "24", + "span": { + "offset": 6316, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.27,1.8779,1.4059,1.8839,1.4059,1.9847,1.27,1.9786)" + }, + { + "content": "Add", + "span": { + "offset": 6319, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,1.5792,1.8698,1.794,1.8697,1.794,1.9952,1.5792,1.9947)" + }, + { + "content": "lines", + "span": { + "offset": 6323, + "length": 5 + }, + "confidence": 0.976, + "source": "D(2,1.8316,1.8696,2.0526,1.8695,2.0526,1.9959,1.8316,1.9953)" + }, + { + "content": "22", + "span": { + "offset": 6329, + "length": 2 + }, + "confidence": 0.917, + "source": "D(2,2.0839,1.8694,2.207,1.8694,2.207,1.9963,2.0839,1.996)" + }, + { + "content": "and", + "span": { + "offset": 6332, + "length": 3 + }, + "confidence": 0.949, + "source": "D(2,2.2403,1.8693,2.4197,1.8694,2.4197,1.9965,2.2403,1.9964)" + }, + { + "content": "23", + "span": { + "offset": 6336, + "length": 2 + }, + "confidence": 0.931, + "source": "D(2,2.4551,1.8695,2.5782,1.8696,2.5782,1.9966,2.4551,1.9965)" + }, + { + "content": ".", + "span": { + "offset": 6338, + "length": 1 + }, + "confidence": 0.975, + "source": "D(2,2.5844,1.8696,2.6074,1.8696,2.6074,1.9966,2.5844,1.9966)" + }, + { + "content": "This", + "span": { + "offset": 6340, + "length": 4 + }, + "confidence": 0.948, + "source": "D(2,2.6407,1.8697,2.8472,1.8699,2.8472,1.9967,2.6407,1.9966)" + }, + { + "content": "is", + "span": { + "offset": 6345, + "length": 2 + }, + "confidence": 0.996, + "source": "D(2,2.8785,1.8699,2.9598,1.87,2.9598,1.9968,2.8785,1.9967)" + }, + { + "content": "your", + "span": { + "offset": 6348, + "length": 4 + }, + "confidence": 0.985, + "source": "D(2,2.9869,1.87,3.2163,1.8707,3.2163,1.9964,2.9869,1.9968)" + }, + { + "content": "total", + "span": { + "offset": 6353, + "length": 5 + }, + "confidence": 0.98, + "source": "D(2,3.2434,1.8708,3.477,1.8714,3.477,1.9959,3.2434,1.9963)" + }, + { + "content": "tax", + "span": { + "offset": 6359, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,3.5083,1.8715,3.6814,1.872,3.6814,1.9956,3.5083,1.9959)" + }, + { + "content": "24", + "span": { + "offset": 6372, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.8785,6.9146,1.8825,6.9146,1.9793,6.7776,1.9754)" + }, + { + "content": "100", + "span": { + "offset": 6384, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,7.7861,1.8679,7.9687,1.8726,7.9687,1.9747,7.7861,1.9704)" + }, + { + "content": "25", + "span": { + "offset": 6420, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2679,2.0433,1.408,2.0429,1.408,2.1416,1.2679,2.1423)" + }, + { + "content": "Federal", + "span": { + "offset": 6423, + "length": 7 + }, + "confidence": 0.995, + "source": "D(2,1.5865,2.0404,1.9605,2.0411,1.9605,2.1584,1.5865,2.1581)" + }, + { + "content": "income", + "span": { + "offset": 6431, + "length": 6 + }, + "confidence": 0.965, + "source": "D(2,1.9998,2.0412,2.3581,2.0415,2.3581,2.1584,1.9998,2.1584)" + }, + { + "content": "tax", + "span": { + "offset": 6438, + "length": 3 + }, + "confidence": 0.951, + "source": "D(2,2.3876,2.0415,2.5431,2.0415,2.5431,2.1583,2.3876,2.1584)" + }, + { + "content": "withheld", + "span": { + "offset": 6442, + "length": 8 + }, + "confidence": 0.942, + "source": "D(2,2.5706,2.0415,2.9899,2.041,2.9899,2.1579,2.5706,2.1583)" + }, + { + "content": "from", + "span": { + "offset": 6451, + "length": 4 + }, + "confidence": 0.971, + "source": "D(2,3.0194,2.041,3.2458,2.0406,3.2458,2.1575,3.0194,2.1578)" + }, + { + "content": ":", + "span": { + "offset": 6455, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.2556,2.0406,3.2871,2.0405,3.2871,2.1574,3.2556,2.1575)" + }, + { + "content": "300", + "span": { + "offset": 6500, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,7.7778,2.6944,7.9687,2.6959,7.9687,2.8016,7.7778,2.7983)" + }, + { + "content": "a", + "span": { + "offset": 6524, + "length": 1 + }, + "confidence": 0.923, + "source": "D(2,1.3904,2.2393,1.4641,2.2328,1.4641,2.3149,1.3904,2.32)" + }, + { + "content": "Form", + "span": { + "offset": 6526, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,1.5886,2.2079,1.8397,2.2069,1.8397,2.3315,1.5886,2.331)" + }, + { + "content": "(", + "span": { + "offset": 6530, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.852,2.2069,1.887,2.2069,1.887,2.3314,1.852,2.3315)" + }, + { + "content": "s", + "span": { + "offset": 6531, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,1.8829,2.2069,1.9384,2.2069,1.9384,2.3313,1.8829,2.3314)" + }, + { + "content": ")", + "span": { + "offset": 6532, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.9323,2.2069,1.9693,2.2069,1.9693,2.3312,1.9323,2.3313)" + }, + { + "content": "W", + "span": { + "offset": 6534, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.992,2.2069,2.0969,2.2072,2.0969,2.3305,1.992,2.3312)" + }, + { + "content": "-", + "span": { + "offset": 6535, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.0969,2.2072,2.1381,2.2074,2.1381,2.3303,2.0969,2.3305)" + }, + { + "content": "2", + "span": { + "offset": 6536, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.1381,2.2074,2.2142,2.2076,2.2142,2.3297,2.1381,2.3303)" + }, + { + "content": "25a", + "span": { + "offset": 6547, + "length": 3 + }, + "confidence": 0.976, + "source": "D(2,5.4412,2.2186,5.6445,2.2185,5.6445,2.3178,5.4412,2.318)" + }, + { + "content": "100", + "span": { + "offset": 6560, + "length": 3 + }, + "confidence": 0.982, + "source": "D(2,6.4871,2.1995,6.6655,2.1997,6.6655,2.3015,6.4871,2.3015)" + }, + { + "content": "b", + "span": { + "offset": 6584, + "length": 1 + }, + "confidence": 0.969, + "source": "D(2,1.3893,2.3837,1.4641,2.3835,1.4641,2.4782,1.3893,2.4783)" + }, + { + "content": "Form", + "span": { + "offset": 6586, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,1.5875,2.3727,1.8399,2.3728,1.8399,2.4977,1.5875,2.4974)" + }, + { + "content": "(", + "span": { + "offset": 6590, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.8503,2.3728,1.8854,2.3729,1.8854,2.4976,1.8502,2.4977)" + }, + { + "content": "s", + "span": { + "offset": 6591, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,1.8771,2.3728,1.933,2.373,1.933,2.4976,1.8771,2.4976)" + }, + { + "content": ")", + "span": { + "offset": 6592, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.9309,2.373,1.9661,2.3731,1.9661,2.4975,1.9309,2.4976)" + }, + { + "content": "1099", + "span": { + "offset": 6594, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,2.0033,2.3732,2.2495,2.3744,2.2495,2.4965,2.0033,2.4975)" + }, + { + "content": "25b", + "span": { + "offset": 6608, + "length": 3 + }, + "confidence": 0.981, + "source": "D(2,5.4412,2.3769,5.6445,2.3753,5.6445,2.4773,5.4412,2.4789)" + }, + { + "content": "100", + "span": { + "offset": 6621, + "length": 3 + }, + "confidence": 0.987, + "source": "D(2,6.4871,2.3673,6.6655,2.3673,6.6655,2.4724,6.4871,2.4707)" + }, + { + "content": "c", + "span": { + "offset": 6645, + "length": 1 + }, + "confidence": 1, + "source": "D(2,1.4042,2.5759,1.4609,2.5759,1.4609,2.6363,1.4042,2.6363)" + }, + { + "content": "Other", + "span": { + "offset": 6647, + "length": 5 + }, + "confidence": 0.994, + "source": "D(2,1.5865,2.537,1.8759,2.5366,1.8759,2.6629,1.5865,2.6629)" + }, + { + "content": "forms", + "span": { + "offset": 6653, + "length": 5 + }, + "confidence": 0.992, + "source": "D(2,1.9032,2.5366,2.1842,2.5366,2.1842,2.6629,1.9032,2.6629)" + }, + { + "content": "(", + "span": { + "offset": 6659, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.2178,2.5367,2.2513,2.5368,2.2513,2.6629,2.2178,2.6629)" + }, + { + "content": "see", + "span": { + "offset": 6660, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,2.2492,2.5368,2.4191,2.5372,2.4191,2.663,2.2492,2.6629)" + }, + { + "content": "instructions", + "span": { + "offset": 6664, + "length": 12 + }, + "confidence": 0.995, + "source": "D(2,2.4548,2.5373,3.0231,2.5403,3.0231,2.6637,2.4548,2.6631)" + }, + { + "content": ")", + "span": { + "offset": 6676, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.021,2.5402,3.063,2.5405,3.063,2.6637,3.021,2.6636)" + }, + { + "content": "25c", + "span": { + "offset": 6687, + "length": 3 + }, + "confidence": 0.977, + "source": "D(2,5.4453,2.5464,5.6445,2.5489,5.6445,2.6483,5.4453,2.6457)" + }, + { + "content": "100", + "span": { + "offset": 6700, + "length": 3 + }, + "confidence": 0.989, + "source": "D(2,6.4871,2.5266,6.6738,2.5263,6.6738,2.6299,6.4871,2.6303)" + }, + { + "content": "d", + "span": { + "offset": 6736, + "length": 1 + }, + "confidence": 0.971, + "source": "D(2,1.3945,2.7151,1.4692,2.7151,1.4692,2.8118,1.3945,2.8118)" + }, + { + "content": "Add", + "span": { + "offset": 6738, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,1.5792,2.6999,1.7924,2.7008,1.7924,2.8271,1.5792,2.8247)" + }, + { + "content": "lines", + "span": { + "offset": 6742, + "length": 5 + }, + "confidence": 0.996, + "source": "D(2,1.8286,2.7009,2.0546,2.7018,2.0546,2.8297,1.8286,2.8275)" + }, + { + "content": "25a", + "span": { + "offset": 6748, + "length": 3 + }, + "confidence": 0.981, + "source": "D(2,2.0844,2.7018,2.2699,2.7022,2.2699,2.8306,2.0845,2.8299)" + }, + { + "content": "through", + "span": { + "offset": 6752, + "length": 7 + }, + "confidence": 0.983, + "source": "D(2,2.2955,2.7023,2.6835,2.7027,2.6835,2.8306,2.2955,2.8307)" + }, + { + "content": "25c", + "span": { + "offset": 6760, + "length": 3 + }, + "confidence": 0.982, + "source": "D(2,2.7112,2.7027,2.9094,2.7028,2.9094,2.8298,2.7112,2.8305)" + }, + { + "content": "25d", + "span": { + "offset": 6773, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,6.7361,2.7064,6.9519,2.713,6.9519,2.815,6.7361,2.808)" + }, + { + "content": ".", + "span": { + "offset": 6809, + "length": 1 + }, + "confidence": 0.838, + "source": "D(2,0.455,2.9315,0.495,2.9324,0.4957,3.0288,0.4558,3.0278)" + }, + { + "content": "If", + "span": { + "offset": 6811, + "length": 2 + }, + "confidence": 0.877, + "source": "D(2,0.5222,2.933,0.5783,2.9344,0.5788,3.0311,0.5229,3.0296)" + }, + { + "content": "you", + "span": { + "offset": 6814, + "length": 3 + }, + "confidence": 0.993, + "source": "D(2,0.5911,2.9346,0.7384,2.9366,0.7386,3.0333,0.5916,3.0314)" + }, + { + "content": "have", + "span": { + "offset": 6818, + "length": 4 + }, + "confidence": 0.977, + "source": "D(2,0.7689,2.9368,0.9611,2.9361,0.9607,3.031,0.769,3.0333)" + }, + { + "content": "a", + "span": { + "offset": 6823, + "length": 1 + }, + "confidence": 0.989, + "source": "D(2,0.9835,2.9359,1.0443,2.9352,1.0438,3.0291,0.9831,3.0305)" + }, + { + "content": "qualifying", + "span": { + "offset": 6825, + "length": 10 + }, + "confidence": 0.997, + "source": "D(2,0.5165,3.0347,0.9033,3.0347,0.9038,3.1313,0.5175,3.1313)" + }, + { + "content": "child", + "span": { + "offset": 6836, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,0.9287,3.0347,1.119,3.0347,1.119,3.1313,0.9291,3.1313)" + }, + { + "content": ",", + "span": { + "offset": 6841, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,1.1237,3.0347,1.1507,3.0347,1.1507,3.1313,1.1238,3.1313)" + }, + { + "content": "attach", + "span": { + "offset": 6843, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,0.5136,3.1303,0.7697,3.1289,0.7703,3.2243,0.5146,3.2222)" + }, + { + "content": "Sch", + "span": { + "offset": 6850, + "length": 3 + }, + "confidence": 0.989, + "source": "D(2,0.7947,3.1289,0.9492,3.1287,0.9496,3.2248,0.7953,3.2243)" + }, + { + "content": ".", + "span": { + "offset": 6853, + "length": 1 + }, + "confidence": 0.991, + "source": "D(2,0.9539,3.1288,0.9727,3.1288,0.973,3.2247,0.9543,3.2248)" + }, + { + "content": "EIC", + "span": { + "offset": 6855, + "length": 3 + }, + "confidence": 0.947, + "source": "D(2,1.0039,3.129,1.1397,3.1296,1.1398,3.2243,1.0041,3.2247)" + }, + { + "content": ".", + "span": { + "offset": 6858, + "length": 1 + }, + "confidence": 0.991, + "source": "D(2,1.1428,3.1296,1.1631,3.1297,1.1631,3.2242,1.1429,3.2243)" + }, + { + "content": ".", + "span": { + "offset": 6860, + "length": 1 + }, + "confidence": 0.852, + "source": "D(2,0.4586,3.2529,0.4966,3.2531,0.4973,3.3444,0.4594,3.3443)" + }, + { + "content": "If", + "span": { + "offset": 6862, + "length": 2 + }, + "confidence": 0.934, + "source": "D(2,0.5239,3.2532,0.5816,3.2535,0.5821,3.3448,0.5246,3.3446)" + }, + { + "content": "you", + "span": { + "offset": 6865, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,0.5937,3.2536,0.7409,3.2549,0.7413,3.3462,0.5943,3.3449)" + }, + { + "content": "have", + "span": { + "offset": 6869, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,0.7698,3.2552,0.9686,3.2582,0.9686,3.3495,0.7701,3.3465)" + }, + { + "content": "nontaxable", + "span": { + "offset": 6874, + "length": 10 + }, + "confidence": 0.996, + "source": "D(2,0.5157,3.3521,0.9722,3.3478,0.9722,3.4391,0.5165,3.442)" + }, + { + "content": "combat", + "span": { + "offset": 6885, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,0.5149,3.4514,0.8277,3.4539,0.8273,3.5506,0.5154,3.5481)" + }, + { + "content": "pay", + "span": { + "offset": 6892, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.8484,3.4539,0.9993,3.4533,0.9983,3.55,0.8479,3.5506)" + }, + { + "content": ",", + "span": { + "offset": 6895, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,0.9977,3.4533,1.0231,3.4532,1.022,3.5499,0.9967,3.55)" + }, + { + "content": "see", + "span": { + "offset": 6897, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.5126,3.5537,0.6626,3.5536,0.6632,3.6448,0.5134,3.6454)" + }, + { + "content": "instructions", + "span": { + "offset": 6901, + "length": 12 + }, + "confidence": 0.997, + "source": "D(2,0.6889,3.5535,1.1514,3.556,1.1514,3.6484,0.6895,3.6447)" + }, + { + "content": ".", + "span": { + "offset": 6913, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.1545,3.556,1.1808,3.5563,1.1808,3.6488,1.1545,3.6484)" + }, + { + "content": "26", + "span": { + "offset": 6936, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2659,2.8762,1.4039,2.8762,1.4039,2.9836,1.2659,2.9836)" + }, + { + "content": "2020", + "span": { + "offset": 6939, + "length": 4 + }, + "confidence": 0.98, + "source": "D(2,1.5865,2.8706,1.8373,2.8703,1.8373,2.9969,1.5865,2.9965)" + }, + { + "content": "estimated", + "span": { + "offset": 6944, + "length": 9 + }, + "confidence": 0.995, + "source": "D(2,1.8728,2.8702,2.3577,2.8696,2.3577,2.9977,1.8728,2.997)" + }, + { + "content": "tax", + "span": { + "offset": 6954, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,2.3932,2.8695,2.5479,2.8693,2.5479,2.998,2.3932,2.9978)" + }, + { + "content": "payments", + "span": { + "offset": 6958, + "length": 8 + }, + "confidence": 0.998, + "source": "D(2,2.5792,2.8693,3.0662,2.8692,3.0662,2.9976,2.5792,2.9981)" + }, + { + "content": "and", + "span": { + "offset": 6967, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,3.0954,2.8692,3.2752,2.8692,3.2752,2.9972,3.0954,2.9975)" + }, + { + "content": "amount", + "span": { + "offset": 6971, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,3.3128,2.8692,3.6932,2.8693,3.6932,2.9964,3.3128,2.9971)" + }, + { + "content": "applied", + "span": { + "offset": 6978, + "length": 7 + }, + "confidence": 0.995, + "source": "D(2,3.7182,2.8693,4.0819,2.8698,4.0819,2.9948,3.7182,2.9963)" + }, + { + "content": "from", + "span": { + "offset": 6986, + "length": 4 + }, + "confidence": 0.96, + "source": "D(2,4.1133,2.8699,4.3411,2.8703,4.3411,2.9934,4.1132,2.9946)" + }, + { + "content": "2019", + "span": { + "offset": 6991, + "length": 4 + }, + "confidence": 0.858, + "source": "D(2,4.3724,2.8703,4.6211,2.8708,4.6211,2.9919,4.3724,2.9932)" + }, + { + "content": "return", + "span": { + "offset": 6996, + "length": 6 + }, + "confidence": 0.946, + "source": "D(2,4.6546,2.8708,4.9639,2.8714,4.9639,2.9901,4.6546,2.9917)" + }, + { + "content": "26", + "span": { + "offset": 7012, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,2.8794,6.9062,2.8801,6.9062,2.9794,6.7776,2.9788)" + }, + { + "content": "100", + "span": { + "offset": 7024, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,7.7861,2.8573,7.9687,2.8685,7.9687,2.9759,7.7861,2.9647)" + }, + { + "content": "27", + "span": { + "offset": 7048, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2659,3.0444,1.4039,3.0453,1.4039,3.148,1.2659,3.1435)" + }, + { + "content": "Earned", + "span": { + "offset": 7051, + "length": 6 + }, + "confidence": 0.992, + "source": "D(2,1.5896,3.0351,1.9414,3.0349,1.9414,3.1629,1.5896,3.1612)" + }, + { + "content": "income", + "span": { + "offset": 7058, + "length": 6 + }, + "confidence": 0.971, + "source": "D(2,1.9803,3.0349,2.3407,3.0343,2.3407,3.1633,1.9803,3.163)" + }, + { + "content": "credit", + "span": { + "offset": 7065, + "length": 6 + }, + "confidence": 0.982, + "source": "D(2,2.3731,3.0343,2.658,3.0336,2.658,3.1625,2.3731,3.1633)" + }, + { + "content": "(", + "span": { + "offset": 7072, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.686,3.0335,2.7206,3.0334,2.7206,3.1622,2.686,3.1624)" + }, + { + "content": "EIC", + "span": { + "offset": 7073, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,2.7206,3.0334,2.8868,3.0329,2.8868,3.1614,2.7206,3.1622)" + }, + { + "content": ")", + "span": { + "offset": 7076, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.8846,3.0329,2.9364,3.0327,2.9364,3.1612,2.8846,3.1615)" + }, + { + "content": "27", + "span": { + "offset": 7087, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,3.0451,5.6155,3.044,5.6155,3.1433,5.4744,3.1444)" + }, + { + "content": "200", + "span": { + "offset": 7099, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,6.4663,3.0308,6.6655,3.0317,6.6655,3.1337,6.4663,3.1329)" + }, + { + "content": "1600", + "span": { + "offset": 7134, + "length": 4 + }, + "confidence": 0.952, + "source": "D(2,7.7239,3.8645,7.9646,3.8645,7.9646,3.9666,7.7239,3.9666)" + }, + { + "content": "28", + "span": { + "offset": 7159, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,3.2085,1.4039,3.209,1.4039,3.3086,1.2669,3.3086)" + }, + { + "content": "Additional", + "span": { + "offset": 7162, + "length": 10 + }, + "confidence": 0.999, + "source": "D(2,1.5844,3.2008,2.0869,3.1999,2.0869,3.3203,1.5844,3.3212)" + }, + { + "content": "child", + "span": { + "offset": 7173, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,2.1225,3.1998,2.356,3.1993,2.356,3.3199,2.1225,3.3203)" + }, + { + "content": "tax", + "span": { + "offset": 7179, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,2.3896,3.1993,2.5439,3.1993,2.5439,3.3196,2.3896,3.3198)" + }, + { + "content": "credit", + "span": { + "offset": 7183, + "length": 6 + }, + "confidence": 0.993, + "source": "D(2,2.5736,3.1993,2.8545,3.1995,2.8545,3.3193,2.5736,3.3196)" + }, + { + "content": ".", + "span": { + "offset": 7189, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,2.8604,3.1995,2.8802,3.1995,2.8802,3.3193,2.8604,3.3193)" + }, + { + "content": "Attach", + "span": { + "offset": 7191, + "length": 6 + }, + "confidence": 0.994, + "source": "D(2,2.9099,3.1995,3.2363,3.1998,3.2363,3.3189,2.9099,3.3192)" + }, + { + "content": "Schedule", + "span": { + "offset": 7198, + "length": 8 + }, + "confidence": 0.99, + "source": "D(2,3.268,3.1999,3.7388,3.2013,3.7388,3.3187,3.268,3.3189)" + }, + { + "content": "8812", + "span": { + "offset": 7207, + "length": 4 + }, + "confidence": 0.967, + "source": "D(2,3.7626,3.2014,4.0217,3.2022,4.0217,3.3185,3.7626,3.3186)" + }, + { + "content": "28", + "span": { + "offset": 7221, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,3.2115,5.6155,3.2099,5.6155,3.3086,5.4744,3.3086)" + }, + { + "content": "300", + "span": { + "offset": 7233, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,6.4746,3.1932,6.6655,3.1945,6.6655,3.3005,6.4746,3.3005)" + }, + { + "content": "29", + "span": { + "offset": 7279, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,3.3768,1.4039,3.3807,1.4039,3.4827,1.2669,3.4788)" + }, + { + "content": "American", + "span": { + "offset": 7282, + "length": 8 + }, + "confidence": 0.999, + "source": "D(2,1.5823,3.3682,2.06,3.3665,2.06,3.4954,1.5823,3.4963)" + }, + { + "content": "opportunity", + "span": { + "offset": 7291, + "length": 11 + }, + "confidence": 0.999, + "source": "D(2,2.0917,3.3663,2.6708,3.3647,2.6708,3.4939,2.0917,3.4953)" + }, + { + "content": "credit", + "span": { + "offset": 7303, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,2.6962,3.3646,2.9773,3.3641,2.9773,3.493,2.6962,3.4939)" + }, + { + "content": "from", + "span": { + "offset": 7310, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,3.0027,3.3641,3.2331,3.3637,3.233,3.4922,3.0027,3.4929)" + }, + { + "content": "Form", + "span": { + "offset": 7315, + "length": 4 + }, + "confidence": 0.992, + "source": "D(2,3.2711,3.3636,3.5226,3.3636,3.5226,3.491,3.2711,3.4921)" + }, + { + "content": "8863", + "span": { + "offset": 7320, + "length": 4 + }, + "confidence": 0.97, + "source": "D(2,3.5585,3.3636,3.8016,3.3636,3.8016,3.4897,3.5585,3.4908)" + }, + { + "content": ",", + "span": { + "offset": 7324, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.8037,3.3636,3.827,3.3636,3.827,3.4896,3.8037,3.4897)" + }, + { + "content": "line", + "span": { + "offset": 7326, + "length": 4 + }, + "confidence": 0.864, + "source": "D(2,3.8629,3.3636,4.0362,3.3636,4.0362,3.4887,3.8629,3.4895)" + }, + { + "content": "8", + "span": { + "offset": 7331, + "length": 1 + }, + "confidence": 0.948, + "source": "D(2,4.0658,3.3636,4.1525,3.3637,4.1525,3.4882,4.0658,3.4886)" + }, + { + "content": "29", + "span": { + "offset": 7342, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,3.3757,5.6155,3.3757,5.6155,3.4778,5.4744,3.4778)" + }, + { + "content": "400", + "span": { + "offset": 7354, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,6.4705,3.369,6.6655,3.3681,6.6655,3.4701,6.4705,3.471)" + }, + { + "content": "30", + "span": { + "offset": 7378, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,3.5505,1.4039,3.5505,1.4039,3.6525,1.2669,3.6525)" + }, + { + "content": "Recovery", + "span": { + "offset": 7381, + "length": 8 + }, + "confidence": 0.993, + "source": "D(2,1.5896,3.5418,2.0626,3.5391,2.0626,3.666,1.5896,3.6671)" + }, + { + "content": "rebate", + "span": { + "offset": 7390, + "length": 6 + }, + "confidence": 0.993, + "source": "D(2,2.0918,3.539,2.4065,3.538,2.4065,3.6652,2.0918,3.6659)" + }, + { + "content": "credit", + "span": { + "offset": 7397, + "length": 6 + }, + "confidence": 0.946, + "source": "D(2,2.4377,3.538,2.719,3.5379,2.719,3.6646,2.4377,3.6652)" + }, + { + "content": ".", + "span": { + "offset": 7403, + "length": 1 + }, + "confidence": 0.986, + "source": "D(2,2.7211,3.5379,2.744,3.5379,2.744,3.6645,2.7211,3.6646)" + }, + { + "content": "See", + "span": { + "offset": 7405, + "length": 3 + }, + "confidence": 0.955, + "source": "D(2,2.7816,3.5379,2.9712,3.5381,2.9712,3.664,2.7816,3.6644)" + }, + { + "content": "instructions", + "span": { + "offset": 7409, + "length": 12 + }, + "confidence": 0.985, + "source": "D(2,3.0045,3.5382,3.5901,3.5412,3.5901,3.6628,3.0045,3.664)" + }, + { + "content": "30", + "span": { + "offset": 7431, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4827,3.5503,5.6155,3.5503,5.6155,3.647,5.4827,3.647)" + }, + { + "content": "500", + "span": { + "offset": 7443, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,6.4746,3.5353,6.6655,3.5369,6.6655,3.6389,6.4746,3.6374)" + }, + { + "content": "31", + "span": { + "offset": 7467, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,3.7217,1.3956,3.7175,1.3956,3.8199,1.2669,3.8225)" + }, + { + "content": "Amount", + "span": { + "offset": 7470, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,1.5865,3.7093,1.9871,3.7081,1.9871,3.8307,1.5865,3.8286)" + }, + { + "content": "from", + "span": { + "offset": 7477, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,2.0132,3.7081,2.2346,3.7077,2.2346,3.8314,2.0132,3.8308)" + }, + { + "content": "Schedule", + "span": { + "offset": 7482, + "length": 8 + }, + "confidence": 0.977, + "source": "D(2,2.2689,3.7077,2.7439,3.7079,2.7439,3.8312,2.2689,3.8314)" + }, + { + "content": "3", + "span": { + "offset": 7491, + "length": 1 + }, + "confidence": 0.963, + "source": "D(2,2.7721,3.708,2.8325,3.7082,2.8325,3.8308,2.7721,3.8311)" + }, + { + "content": ",", + "span": { + "offset": 7492, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,2.8345,3.7082,2.8586,3.7082,2.8586,3.8307,2.8345,3.8308)" + }, + { + "content": "line", + "span": { + "offset": 7494, + "length": 4 + }, + "confidence": 0.928, + "source": "D(2,2.8929,3.7083,3.0619,3.7088,3.0619,3.8298,2.8929,3.8306)" + }, + { + "content": "13", + "span": { + "offset": 7499, + "length": 2 + }, + "confidence": 0.957, + "source": "D(2,3.0962,3.7089,3.229,3.7093,3.229,3.829,3.0962,3.8296)" + }, + { + "content": "31", + "span": { + "offset": 7511, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,3.7161,5.603,3.7149,5.603,3.8143,5.4744,3.8155)" + }, + { + "content": "200", + "span": { + "offset": 7523, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,6.4663,3.6933,6.6655,3.6999,6.6655,3.8019,6.4663,3.7953)" + }, + { + "content": "32", + "span": { + "offset": 7559, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2679,3.8752,1.4039,3.8752,1.4039,3.9773,1.2679,3.9773)" + }, + { + "content": "Add", + "span": { + "offset": 7562, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,1.5813,3.8614,1.7931,3.8617,1.7931,3.99,1.5813,3.9895)" + }, + { + "content": "lines", + "span": { + "offset": 7566, + "length": 5 + }, + "confidence": 0.946, + "source": "D(2,1.8288,3.8617,2.0532,3.862,2.0532,3.9905,1.8288,3.9901)" + }, + { + "content": "27", + "span": { + "offset": 7572, + "length": 2 + }, + "confidence": 0.922, + "source": "D(2,2.0825,3.862,2.2042,3.8621,2.2041,3.9908,2.0825,3.9906)" + }, + { + "content": "through", + "span": { + "offset": 7575, + "length": 7 + }, + "confidence": 0.836, + "source": "D(2,2.2314,3.8621,2.6215,3.8626,2.6215,3.9917,2.2314,3.9909)" + }, + { + "content": "31", + "span": { + "offset": 7583, + "length": 2 + }, + "confidence": 0.648, + "source": "D(2,2.6529,3.8626,2.762,3.8627,2.762,3.992,2.6529,3.9917)" + }, + { + "content": ".", + "span": { + "offset": 7585, + "length": 1 + }, + "confidence": 0.943, + "source": "D(2,2.7809,3.8627,2.806,3.8628,2.806,3.9921,2.7809,3.992)" + }, + { + "content": "These", + "span": { + "offset": 7587, + "length": 5 + }, + "confidence": 0.666, + "source": "D(2,2.8354,3.8628,3.1437,3.8632,3.1437,3.9924,2.8354,3.9921)" + }, + { + "content": "are", + "span": { + "offset": 7593, + "length": 3 + }, + "confidence": 0.983, + "source": "D(2,3.1709,3.8632,3.3282,3.8634,3.3282,3.9923,3.1709,3.9924)" + }, + { + "content": "your", + "span": { + "offset": 7597, + "length": 4 + }, + "confidence": 0.975, + "source": "D(2,3.3555,3.8634,3.5862,3.8638,3.5862,3.9921,3.3555,3.9923)" + }, + { + "content": "total", + "span": { + "offset": 7602, + "length": 5 + }, + "confidence": 0.976, + "source": "D(2,3.6092,3.8638,3.8441,3.8641,3.8441,3.9919,3.6092,3.9921)" + }, + { + "content": "other", + "span": { + "offset": 7608, + "length": 5 + }, + "confidence": 0.984, + "source": "D(2,3.8756,3.8642,4.1629,3.8646,4.1629,3.9917,3.8756,3.9919)" + }, + { + "content": "payments", + "span": { + "offset": 7614, + "length": 8 + }, + "confidence": 0.964, + "source": "D(2,4.1922,3.8646,4.7123,3.8654,4.7123,3.9906,4.1922,3.9916)" + }, + { + "content": "and", + "span": { + "offset": 7623, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,4.7396,3.8654,4.9304,3.8658,4.9304,3.9898,4.7396,3.9905)" + }, + { + "content": "refundable", + "span": { + "offset": 7627, + "length": 10 + }, + "confidence": 0.968, + "source": "D(2,4.9703,3.8658,5.5386,3.8668,5.5386,3.9876,4.9703,3.9897)" + }, + { + "content": "credits", + "span": { + "offset": 7638, + "length": 7 + }, + "confidence": 0.944, + "source": "D(2,5.568,3.8669,5.9434,3.8675,5.9434,3.9862,5.568,3.9875)" + }, + { + "content": "32", + "span": { + "offset": 7655, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,3.8745,6.9146,3.8779,6.9146,3.9773,6.7776,3.9773)" + }, + { + "content": "33", + "span": { + "offset": 7690, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,4.0349,1.4028,4.0422,1.4028,4.1443,1.2669,4.137)" + }, + { + "content": "Add", + "span": { + "offset": 7693, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,1.5813,4.0283,1.7931,4.0283,1.7931,4.1572,1.5813,4.1572)" + }, + { + "content": "lines", + "span": { + "offset": 7697, + "length": 5 + }, + "confidence": 0.937, + "source": "D(2,1.8316,4.0283,2.0541,4.0283,2.0541,4.1572,1.8316,4.1572)" + }, + { + "content": "25d", + "span": { + "offset": 7703, + "length": 3 + }, + "confidence": 0.966, + "source": "D(2,2.084,4.0283,2.2701,4.0283,2.2701,4.1572,2.084,4.1572)" + }, + { + "content": ",", + "span": { + "offset": 7706, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,2.2787,4.0283,2.3022,4.0283,2.3022,4.1572,2.2787,4.1572)" + }, + { + "content": "26", + "span": { + "offset": 7708, + "length": 2 + }, + "confidence": 0.96, + "source": "D(2,2.3365,4.0283,2.4605,4.0283,2.4605,4.1572,2.3365,4.1572)" + }, + { + "content": ",", + "span": { + "offset": 7710, + "length": 1 + }, + "confidence": 0.991, + "source": "D(2,2.4627,4.0283,2.4884,4.0283,2.4884,4.1572,2.4627,4.1572)" + }, + { + "content": "and", + "span": { + "offset": 7712, + "length": 3 + }, + "confidence": 0.96, + "source": "D(2,2.5226,4.0283,2.7066,4.0283,2.7066,4.1572,2.5226,4.1572)" + }, + { + "content": "32", + "span": { + "offset": 7716, + "length": 2 + }, + "confidence": 0.839, + "source": "D(2,2.7429,4.0283,2.8606,4.0283,2.8606,4.1572,2.7429,4.1572)" + }, + { + "content": ".", + "span": { + "offset": 7718, + "length": 1 + }, + "confidence": 0.97, + "source": "D(2,2.867,4.0283,2.8905,4.0283,2.8905,4.1572,2.867,4.1572)" + }, + { + "content": "These", + "span": { + "offset": 7720, + "length": 5 + }, + "confidence": 0.779, + "source": "D(2,2.9226,4.0283,3.2307,4.0283,3.2307,4.1572,2.9226,4.1572)" + }, + { + "content": "are", + "span": { + "offset": 7726, + "length": 3 + }, + "confidence": 0.983, + "source": "D(2,3.2606,4.0283,3.4147,4.0283,3.4147,4.1572,3.2606,4.1572)" + }, + { + "content": "your", + "span": { + "offset": 7730, + "length": 4 + }, + "confidence": 0.965, + "source": "D(2,3.4403,4.0283,3.6714,4.0283,3.6714,4.1572,3.4403,4.1572)" + }, + { + "content": "total", + "span": { + "offset": 7735, + "length": 5 + }, + "confidence": 0.952, + "source": "D(2,3.6949,4.0283,3.9302,4.0283,3.9302,4.1572,3.6949,4.1572)" + }, + { + "content": "payments", + "span": { + "offset": 7741, + "length": 8 + }, + "confidence": 0.963, + "source": "D(2,3.9645,4.0283,4.4907,4.0283,4.4907,4.1572,3.9645,4.1572)" + }, + { + "content": "33", + "span": { + "offset": 7759, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,4.0411,6.9146,4.045,6.9146,4.1438,6.7776,4.1438)" + }, + { + "content": "2000", + "span": { + "offset": 7771, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,7.7156,4.0337,7.9646,4.0337,7.9646,4.1411,7.7156,4.1411)" + }, + { + "content": "Refund", + "span": { + "offset": 7808, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,0.4918,4.247,0.9836,4.247,0.9836,4.3774,0.4926,4.3774)" + }, + { + "content": "Direct", + "span": { + "offset": 7815, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,0.4913,4.5314,0.7451,4.5271,0.7451,4.6381,0.4913,4.6414)" + }, + { + "content": "deposit", + "span": { + "offset": 7822, + "length": 7 + }, + "confidence": 0.998, + "source": "D(2,0.7673,4.5268,1.0841,4.5225,1.0842,4.6357,0.7674,4.6379)" + }, + { + "content": "?", + "span": { + "offset": 7829, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.086,4.5225,1.1434,4.5217,1.1434,4.6354,1.086,4.6357)" + }, + { + "content": "See", + "span": { + "offset": 7831, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.49,4.6509,0.6562,4.6519,0.6568,4.7563,0.4908,4.7541)" + }, + { + "content": "instructions", + "span": { + "offset": 7835, + "length": 12 + }, + "confidence": 0.997, + "source": "D(2,0.6853,4.6521,1.1717,4.6553,1.1718,4.7587,0.6858,4.7567)" + }, + { + "content": ".", + "span": { + "offset": 7847, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.1735,4.6553,1.2026,4.6555,1.2026,4.7587,1.1735,4.7587)" + }, + { + "content": "34", + "span": { + "offset": 7870, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2648,4.202,1.408,4.218,1.408,4.3206,1.2648,4.3017)" + }, + { + "content": "If", + "span": { + "offset": 7873, + "length": 2 + }, + "confidence": 0.941, + "source": "D(2,1.5813,4.207,1.664,4.2067,1.664,4.3295,1.5813,4.3295)" + }, + { + "content": "line", + "span": { + "offset": 7876, + "length": 4 + }, + "confidence": 0.831, + "source": "D(2,1.6888,4.2067,1.8563,4.2062,1.8563,4.3295,1.6888,4.3295)" + }, + { + "content": "33", + "span": { + "offset": 7881, + "length": 2 + }, + "confidence": 0.825, + "source": "D(2,1.8873,4.2062,2.0093,4.2058,2.0093,4.3295,1.8873,4.3295)" + }, + { + "content": "is", + "span": { + "offset": 7884, + "length": 2 + }, + "confidence": 0.925, + "source": "D(2,2.0465,4.2057,2.121,4.2055,2.121,4.3296,2.0465,4.3296)" + }, + { + "content": "more", + "span": { + "offset": 7887, + "length": 4 + }, + "confidence": 0.967, + "source": "D(2,2.154,4.2054,2.4042,4.2048,2.4042,4.3296,2.154,4.3296)" + }, + { + "content": "than", + "span": { + "offset": 7892, + "length": 4 + }, + "confidence": 0.992, + "source": "D(2,2.4332,4.2047,2.6544,4.2041,2.6544,4.3297,2.4332,4.3296)" + }, + { + "content": "line", + "span": { + "offset": 7897, + "length": 4 + }, + "confidence": 0.959, + "source": "D(2,2.6916,4.204,2.8571,4.2036,2.8571,4.3297,2.6916,4.3297)" + }, + { + "content": "24", + "span": { + "offset": 7902, + "length": 2 + }, + "confidence": 0.929, + "source": "D(2,2.8881,4.2035,3.0101,4.2032,3.0101,4.3298,2.8881,4.3297)" + }, + { + "content": ",", + "span": { + "offset": 7904, + "length": 1 + }, + "confidence": 0.989, + "source": "D(2,3.0142,4.2032,3.0369,4.2031,3.0369,4.3298,3.0142,4.3298)" + }, + { + "content": "subtract", + "span": { + "offset": 7906, + "length": 8 + }, + "confidence": 0.981, + "source": "D(2,3.0742,4.203,3.4836,4.2033,3.4836,4.33,3.0742,4.3298)" + }, + { + "content": "line", + "span": { + "offset": 7915, + "length": 4 + }, + "confidence": 0.977, + "source": "D(2,3.5187,4.2033,3.6862,4.2034,3.6862,4.3302,3.5187,4.3301)" + }, + { + "content": "24", + "span": { + "offset": 7920, + "length": 2 + }, + "confidence": 0.938, + "source": "D(2,3.7151,4.2035,3.8433,4.2036,3.8433,4.3303,3.7151,4.3302)" + }, + { + "content": "from", + "span": { + "offset": 7923, + "length": 4 + }, + "confidence": 0.93, + "source": "D(2,3.8682,4.2036,4.0935,4.2038,4.0935,4.3305,3.8681,4.3303)" + }, + { + "content": "line", + "span": { + "offset": 7928, + "length": 4 + }, + "confidence": 0.883, + "source": "D(2,4.1307,4.2038,4.3024,4.204,4.3024,4.3306,4.1307,4.3305)" + }, + { + "content": "33", + "span": { + "offset": 7933, + "length": 2 + }, + "confidence": 0.525, + "source": "D(2,4.3334,4.204,4.4533,4.2041,4.4533,4.3307,4.3334,4.3306)" + }, + { + "content": ".", + "span": { + "offset": 7935, + "length": 1 + }, + "confidence": 0.866, + "source": "D(2,4.4616,4.2041,4.4843,4.2041,4.4843,4.3307,4.4616,4.3307)" + }, + { + "content": "This", + "span": { + "offset": 7937, + "length": 4 + }, + "confidence": 0.523, + "source": "D(2,4.5133,4.2041,4.7262,4.2047,4.7262,4.331,4.5133,4.3308)" + }, + { + "content": "is", + "span": { + "offset": 7942, + "length": 2 + }, + "confidence": 0.975, + "source": "D(2,4.7593,4.2048,4.8379,4.2052,4.8379,4.3311,4.7593,4.331)" + }, + { + "content": "the", + "span": { + "offset": 7945, + "length": 3 + }, + "confidence": 0.944, + "source": "D(2,4.8627,4.2053,5.0261,4.206,5.026,4.3313,4.8627,4.3311)" + }, + { + "content": "amount", + "span": { + "offset": 7949, + "length": 6 + }, + "confidence": 0.955, + "source": "D(2,5.055,4.2061,5.4334,4.2078,5.4334,4.3318,5.055,4.3314)" + }, + { + "content": "you", + "span": { + "offset": 7956, + "length": 3 + }, + "confidence": 0.97, + "source": "D(2,5.4582,4.2079,5.6422,4.2087,5.6422,4.3321,5.4582,4.3318)" + }, + { + "content": "overpaid", + "span": { + "offset": 7960, + "length": 8 + }, + "confidence": 0.785, + "source": "D(2,5.6794,4.2088,6.1467,4.2109,6.1467,4.3327,5.6794,4.3321)" + }, + { + "content": ".", + "span": { + "offset": 7969, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.3426,4.2892,6.3549,4.2892,6.3549,4.3016,6.3426,4.3016)" + }, + { + "content": ".", + "span": { + "offset": 7971, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.5092,4.2892,6.5216,4.2892,6.5216,4.3016,6.5092,4.3016)" + }, + { + "content": "34", + "span": { + "offset": 7982, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,4.2182,6.9146,4.2178,6.9146,4.3172,6.7776,4.3207)" + }, + { + "content": "200", + "span": { + "offset": 7994, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,7.7861,4.2029,7.9646,4.2029,7.9646,4.3049,7.7861,4.3049)" + }, + { + "content": "35a", + "span": { + "offset": 8030, + "length": 3 + }, + "confidence": 0.924, + "source": "D(2,1.269,4.3774,1.4641,4.3774,1.4641,4.4795,1.269,4.4795)" + }, + { + "content": "a", + "span": { + "offset": 8034, + "length": 1 + }, + "confidence": 0.916, + "source": "D(2,1.3759,4.3743,1.455,4.3743,1.455,4.4878,1.3759,4.4876)" + }, + { + "content": "Amount", + "span": { + "offset": 8036, + "length": 6 + }, + "confidence": 0.941, + "source": "D(2,1.5845,4.3742,1.9901,4.3739,1.9901,4.4891,1.5845,4.4881)" + }, + { + "content": "of", + "span": { + "offset": 8043, + "length": 2 + }, + "confidence": 0.985, + "source": "D(2,2.0171,4.3738,2.1157,4.3738,2.1157,4.4894,2.0171,4.4892)" + }, + { + "content": "line", + "span": { + "offset": 8046, + "length": 4 + }, + "confidence": 0.876, + "source": "D(2,2.1427,4.3737,2.3088,4.3736,2.3088,4.4899,2.1427,4.4895)" + }, + { + "content": "34", + "span": { + "offset": 8051, + "length": 2 + }, + "confidence": 0.716, + "source": "D(2,2.3417,4.3736,2.4691,4.3735,2.4691,4.4902,2.3417,4.4899)" + }, + { + "content": "you", + "span": { + "offset": 8054, + "length": 3 + }, + "confidence": 0.803, + "source": "D(2,2.4943,4.3735,2.6739,4.3733,2.6739,4.4907,2.4943,4.4903)" + }, + { + "content": "want", + "span": { + "offset": 8058, + "length": 4 + }, + "confidence": 0.962, + "source": "D(2,2.7087,4.3733,2.952,4.3733,2.952,4.4912,2.7087,4.4908)" + }, + { + "content": "refunded", + "span": { + "offset": 8063, + "length": 8 + }, + "confidence": 0.968, + "source": "D(2,2.9887,4.3733,3.4543,4.3734,3.4543,4.4915,2.9887,4.4912)" + }, + { + "content": "to", + "span": { + "offset": 8072, + "length": 2 + }, + "confidence": 0.978, + "source": "D(2,3.4871,4.3734,3.5953,4.3734,3.5953,4.4916,3.4871,4.4915)" + }, + { + "content": "you", + "span": { + "offset": 8075, + "length": 3 + }, + "confidence": 0.844, + "source": "D(2,3.6242,4.3734,3.8097,4.3735,3.8097,4.4917,3.6242,4.4916)" + }, + { + "content": ".", + "span": { + "offset": 8078, + "length": 1 + }, + "confidence": 0.938, + "source": "D(2,3.8213,4.3735,3.8444,4.3735,3.8444,4.4918,3.8213,4.4917)" + }, + { + "content": "If", + "span": { + "offset": 8080, + "length": 2 + }, + "confidence": 0.814, + "source": "D(2,3.885,4.3735,3.9449,4.3735,3.9449,4.4918,3.885,4.4918)" + }, + { + "content": "Form", + "span": { + "offset": 8083, + "length": 4 + }, + "confidence": 0.763, + "source": "D(2,3.9739,4.3735,4.225,4.3736,4.225,4.492,3.9739,4.4918)" + }, + { + "content": "8888", + "span": { + "offset": 8088, + "length": 4 + }, + "confidence": 0.876, + "source": "D(2,4.2597,4.3736,4.507,4.3739,4.507,4.4918,4.2597,4.492)" + }, + { + "content": "is", + "span": { + "offset": 8093, + "length": 2 + }, + "confidence": 0.947, + "source": "D(2,4.5417,4.3739,4.6209,4.374,4.6209,4.4916,4.5417,4.4917)" + }, + { + "content": "attached", + "span": { + "offset": 8096, + "length": 8 + }, + "confidence": 0.937, + "source": "D(2,4.6518,4.3741,5.0807,4.3746,5.0807,4.4912,4.6518,4.4916)" + }, + { + "content": ",", + "span": { + "offset": 8104, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,5.0845,4.3746,5.1116,4.3747,5.1116,4.4911,5.0845,4.4911)" + }, + { + "content": "check", + "span": { + "offset": 8106, + "length": 5 + }, + "confidence": 0.887, + "source": "D(2,5.1444,4.3747,5.4496,4.3751,5.4496,4.4908,5.1444,4.4911)" + }, + { + "content": "here", + "span": { + "offset": 8112, + "length": 4 + }, + "confidence": 0.923, + "source": "D(2,5.4766,4.3751,5.7026,4.3754,5.7026,4.4905,5.4766,4.4907)" + }, + { + "content": "☐", + "span": { + "offset": 8117, + "length": 1 + }, + "confidence": 0.953, + "source": "D(2,6.458,4.364,6.5742,4.364,6.5742,4.4822,6.458,4.4822)" + }, + { + "content": ".", + "span": { + "offset": 8119, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.8426,4.4559,5.855,4.4559,5.855,4.4682,5.8426,4.4682)" + }, + { + "content": ".", + "span": { + "offset": 8121, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.0093,4.4559,6.0216,4.4559,6.0216,4.4682,6.0093,4.4682)" + }, + { + "content": ".", + "span": { + "offset": 8123, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.176,4.4559,6.1883,4.4559,6.1883,4.4682,6.176,4.4682)" + }, + { + "content": "35a", + "span": { + "offset": 8134, + "length": 3 + }, + "confidence": 0.946, + "source": "D(2,6.7485,4.3774,6.9478,4.3774,6.9478,4.4768,6.7485,4.4768)" + }, + { + "content": "300", + "span": { + "offset": 8147, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,7.7778,4.3612,7.9646,4.3618,7.9646,4.4692,7.7778,4.4686)" + }, + { + "content": "b", + "span": { + "offset": 8183, + "length": 1 + }, + "confidence": 0.848, + "source": "D(2,1.2918,4.5375,1.4623,4.5376,1.4623,4.6584,1.2918,4.6554)" + }, + { + "content": "Routing", + "span": { + "offset": 8185, + "length": 7 + }, + "confidence": 0.99, + "source": "D(2,1.5943,4.5377,1.9576,4.5383,1.9577,4.6631,1.5943,4.6606)" + }, + { + "content": "number", + "span": { + "offset": 8193, + "length": 6 + }, + "confidence": 0.996, + "source": "D(2,1.9881,4.5384,2.3636,4.5395,2.3636,4.661,1.9881,4.6633)" + }, + { + "content": "520555555", + "span": { + "offset": 8200, + "length": 9 + }, + "confidence": 0.999, + "source": "D(2,2.401,4.5037,4.2002,4.5037,4.2002,4.6513,2.401,4.6511)" + }, + { + "content": "c", + "span": { + "offset": 8210, + "length": 1 + }, + "confidence": 0.946, + "source": "D(2,4.6069,4.541,4.7735,4.5423,4.7734,4.6603,4.6069,4.6587)" + }, + { + "content": "Type", + "span": { + "offset": 8212, + "length": 4 + }, + "confidence": 0.955, + "source": "D(2,4.7976,4.5428,5.0523,4.55,5.0523,4.6673,4.7975,4.6608)" + }, + { + "content": ":", + "span": { + "offset": 8216, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,5.0503,4.5499,5.0884,4.5513,5.0884,4.6685,5.0503,4.6673)" + }, + { + "content": "☑", + "span": { + "offset": 8218, + "length": 1 + }, + "confidence": 0.953, + "source": "D(2,5.2336,4.5386,5.3582,4.5359,5.3582,4.6567,5.2336,4.6594)" + }, + { + "content": "Checking", + "span": { + "offset": 8220, + "length": 8 + }, + "confidence": 0.998, + "source": "D(2,5.3914,4.5417,5.8728,4.5479,5.8728,4.6608,5.3914,4.6566)" + }, + { + "content": "☐", + "span": { + "offset": 8229, + "length": 1 + }, + "confidence": 0.96, + "source": "D(2,6.0347,4.5359,6.1633,4.5359,6.1633,4.6594,6.0347,4.6567)" + }, + { + "content": "Savings", + "span": { + "offset": 8231, + "length": 7 + }, + "confidence": 0.998, + "source": "D(2,6.1924,4.5401,6.595,4.541,6.595,4.6604,6.1924,4.6585)" + }, + { + "content": "d", + "span": { + "offset": 8315, + "length": 1 + }, + "confidence": 0.779, + "source": "D(2,1.2918,4.704,1.4633,4.7055,1.4633,4.8161,1.2918,4.8133)" + }, + { + "content": "Account", + "span": { + "offset": 8317, + "length": 7 + }, + "confidence": 0.996, + "source": "D(2,1.5976,4.7067,1.9816,4.7081,1.9817,4.8211,1.5976,4.8183)" + }, + { + "content": "number", + "span": { + "offset": 8325, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,2.004,4.7081,2.3657,4.7071,2.3657,4.8196,2.0041,4.8212)" + }, + { + "content": "12333365478901200", + "span": { + "offset": 8332, + "length": 17 + }, + "confidence": 0.997, + "source": "D(2,2.3969,4.6525,5.8022,4.6629,5.8022,4.8278,2.3969,4.8234)" + }, + { + "content": "36", + "span": { + "offset": 8370, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2679,4.8703,1.4039,4.8713,1.4039,4.9733,1.2679,4.9724)" + }, + { + "content": "6", + "span": { + "offset": 8373, + "length": 1 + }, + "confidence": 0.878, + "source": "D(2,1.3115,4.864,1.392,4.8638,1.392,4.9845,1.3115,4.9843)" + }, + { + "content": "Amount", + "span": { + "offset": 8375, + "length": 6 + }, + "confidence": 0.965, + "source": "D(2,1.5838,4.8634,1.984,4.8625,1.984,4.9861,1.5838,4.985)" + }, + { + "content": "of", + "span": { + "offset": 8382, + "length": 2 + }, + "confidence": 0.99, + "source": "D(2,2.0088,4.8624,2.114,4.8622,2.114,4.9864,2.0088,4.9862)" + }, + { + "content": "line", + "span": { + "offset": 8385, + "length": 4 + }, + "confidence": 0.935, + "source": "D(2,2.1388,4.8621,2.3079,4.8618,2.3079,4.987,2.1388,4.9865)" + }, + { + "content": "34", + "span": { + "offset": 8390, + "length": 2 + }, + "confidence": 0.716, + "source": "D(2,2.3368,4.8617,2.4585,4.8614,2.4585,4.9874,2.3368,4.987)" + }, + { + "content": "you", + "span": { + "offset": 8393, + "length": 3 + }, + "confidence": 0.811, + "source": "D(2,2.4874,4.8614,2.6689,4.8612,2.6689,4.9873,2.4874,4.9874)" + }, + { + "content": "want", + "span": { + "offset": 8397, + "length": 4 + }, + "confidence": 0.981, + "source": "D(2,2.702,4.8612,2.9413,4.861,2.9413,4.9872,2.702,4.9873)" + }, + { + "content": "applied", + "span": { + "offset": 8402, + "length": 7 + }, + "confidence": 0.962, + "source": "D(2,2.9701,4.861,3.3456,4.8606,3.3456,4.987,2.9701,4.9872)" + }, + { + "content": "to", + "span": { + "offset": 8410, + "length": 2 + }, + "confidence": 0.986, + "source": "D(2,3.3807,4.8606,3.4859,4.8605,3.4859,4.9869,3.3807,4.987)" + }, + { + "content": "your", + "span": { + "offset": 8413, + "length": 4 + }, + "confidence": 0.898, + "source": "D(2,3.5127,4.8605,3.7541,4.8605,3.7541,4.9864,3.5127,4.9869)" + }, + { + "content": "2021", + "span": { + "offset": 8418, + "length": 4 + }, + "confidence": 0.657, + "source": "D(2,3.7788,4.8605,4.014,4.8606,4.014,4.9855,3.7788,4.9863)" + }, + { + "content": "estimated", + "span": { + "offset": 8423, + "length": 9 + }, + "confidence": 0.782, + "source": "D(2,4.0553,4.8606,4.5751,4.8609,4.5751,4.9834,4.0553,4.9853)" + }, + { + "content": "tax", + "span": { + "offset": 8433, + "length": 3 + }, + "confidence": 0.984, + "source": "D(2,4.6061,4.861,4.8103,4.8611,4.8103,4.9825,4.6061,4.9833)" + }, + { + "content": "36", + "span": { + "offset": 8446, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,4.8689,5.6238,4.8689,5.6238,4.9763,5.4744,4.9763)" + }, + { + "content": "1200", + "span": { + "offset": 8458, + "length": 4 + }, + "confidence": 0.976, + "source": "D(2,6.4207,4.8674,6.6655,4.8705,6.6655,4.9734,6.4207,4.9726)" + }, + { + "content": "Amount", + "span": { + "offset": 8495, + "length": 6 + }, + "confidence": 0.999, + "source": "D(2,0.491,5.0408,1.0288,5.0408,1.0272,5.1639,0.4916,5.1621)" + }, + { + "content": "You", + "span": { + "offset": 8502, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,0.4926,5.1804,0.7461,5.1804,0.7465,5.3065,0.4934,5.306)" + }, + { + "content": "Owe", + "span": { + "offset": 8506, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,0.782,5.1804,1.1009,5.1804,1.1009,5.3067,0.7824,5.3065)" + }, + { + "content": "For", + "span": { + "offset": 8510, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,0.4921,5.3408,0.643,5.3419,0.6428,5.4467,0.4926,5.4453)" + }, + { + "content": "details", + "span": { + "offset": 8514, + "length": 7 + }, + "confidence": 0.996, + "source": "D(2,0.6619,5.342,0.9517,5.3372,0.9501,5.4405,0.6615,5.4469)" + }, + { + "content": "on", + "span": { + "offset": 8522, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,0.9757,5.3363,1.0957,5.332,1.0936,5.4335,0.9741,5.4393)" + }, + { + "content": "how", + "span": { + "offset": 8525, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.49,5.4488,0.6778,5.4482,0.6783,5.5477,0.4908,5.548)" + }, + { + "content": "to", + "span": { + "offset": 8529, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,0.699,5.4482,0.7904,5.4484,0.7909,5.5478,0.6995,5.5477)" + }, + { + "content": "pay", + "span": { + "offset": 8532, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,0.8182,5.4486,0.9798,5.4496,0.98,5.548,0.8186,5.5478)" + }, + { + "content": ",", + "span": { + "offset": 8535, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,0.9782,5.4496,0.9994,5.4499,0.9996,5.5481,0.9784,5.548)" + }, + { + "content": "see", + "span": { + "offset": 8537, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,1.0288,5.4503,1.1953,5.4526,1.1953,5.5488,1.029,5.5482)" + }, + { + "content": "instructions", + "span": { + "offset": 8541, + "length": 12 + }, + "confidence": 0.999, + "source": "D(2,0.4921,5.5465,0.9999,5.5399,0.9994,5.6366,0.4923,5.6431)" + }, + { + "content": ".", + "span": { + "offset": 8553, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.0031,5.5399,1.0303,5.5395,1.0298,5.6362,1.0026,5.6366)" + }, + { + "content": "37", + "span": { + "offset": 8576, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2679,5.0596,1.4008,5.0596,1.4008,5.1616,1.2679,5.1616)" + }, + { + "content": "Subtract", + "span": { + "offset": 8579, + "length": 8 + }, + "confidence": 0.995, + "source": "D(2,1.5875,5.0563,2.0204,5.0571,2.0204,5.1818,1.5875,5.1799)" + }, + { + "content": "line", + "span": { + "offset": 8588, + "length": 4 + }, + "confidence": 0.985, + "source": "D(2,2.0535,5.0571,2.2213,5.0574,2.2213,5.1826,2.0535,5.1819)" + }, + { + "content": "33", + "span": { + "offset": 8593, + "length": 2 + }, + "confidence": 0.935, + "source": "D(2,2.2523,5.0575,2.3704,5.0577,2.3704,5.1833,2.2523,5.1828)" + }, + { + "content": "from", + "span": { + "offset": 8596, + "length": 4 + }, + "confidence": 0.951, + "source": "D(2,2.4015,5.0577,2.6334,5.0581,2.6334,5.1844,2.4015,5.1834)" + }, + { + "content": "line", + "span": { + "offset": 8601, + "length": 4 + }, + "confidence": 0.976, + "source": "D(2,2.6686,5.0581,2.8323,5.0584,2.8323,5.1845,2.6686,5.1844)" + }, + { + "content": "24", + "span": { + "offset": 8606, + "length": 2 + }, + "confidence": 0.839, + "source": "D(2,2.8633,5.0584,2.9876,5.0586,2.9876,5.1846,2.8633,5.1846)" + }, + { + "content": ".", + "span": { + "offset": 8608, + "length": 1 + }, + "confidence": 0.962, + "source": "D(2,2.9938,5.0586,3.0166,5.0586,3.0166,5.1847,2.9938,5.1847)" + }, + { + "content": "This", + "span": { + "offset": 8610, + "length": 4 + }, + "confidence": 0.851, + "source": "D(2,3.0518,5.0587,3.2589,5.0589,3.2589,5.1848,3.0518,5.1847)" + }, + { + "content": "is", + "span": { + "offset": 8615, + "length": 2 + }, + "confidence": 0.988, + "source": "D(2,3.2879,5.059,3.3666,5.0591,3.3666,5.1849,3.2879,5.1849)" + }, + { + "content": "the", + "span": { + "offset": 8618, + "length": 3 + }, + "confidence": 0.969, + "source": "D(2,3.3935,5.0591,3.5613,5.0593,3.5613,5.1851,3.3935,5.1849)" + }, + { + "content": "amount", + "span": { + "offset": 8622, + "length": 6 + }, + "confidence": 0.946, + "source": "D(2,3.5903,5.0594,3.9921,5.0598,3.9921,5.1843,3.5903,5.1851)" + }, + { + "content": "you", + "span": { + "offset": 8629, + "length": 3 + }, + "confidence": 0.957, + "source": "D(2,4.0128,5.0598,4.2137,5.06,4.2137,5.1837,4.0128,5.1842)" + }, + { + "content": "owe", + "span": { + "offset": 8633, + "length": 3 + }, + "confidence": 0.849, + "source": "D(2,4.2489,5.06,4.4684,5.0602,4.4684,5.1829,4.2489,5.1836)" + }, + { + "content": "now", + "span": { + "offset": 8637, + "length": 3 + }, + "confidence": 0.878, + "source": "D(2,4.4974,5.0603,4.7356,5.0605,4.7356,5.1822,4.4974,5.1829)" + }, + { + "content": ".", + "span": { + "offset": 8641, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.0092,5.1424,5.0216,5.1424,5.0216,5.1547,5.0092,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8643, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.1759,5.1424,5.1882,5.1424,5.1882,5.1547,5.1759,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8645, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.3426,5.1424,5.3549,5.1424,5.3549,5.1547,5.3426,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8647, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.5092,5.1424,5.5216,5.1424,5.5216,5.1547,5.5092,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8649, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.6759,5.1424,5.6882,5.1424,5.6882,5.1547,5.6759,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8651, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.8426,5.1424,5.8549,5.1424,5.8549,5.1547,5.8426,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8653, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.0092,5.1424,6.0216,5.1424,6.0216,5.1547,6.0092,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8655, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.1759,5.1424,6.1882,5.1424,6.1882,5.1547,6.1759,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8657, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.3426,5.1424,6.3549,5.1424,6.3549,5.1547,6.3426,5.1547)" + }, + { + "content": "37", + "span": { + "offset": 8668, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,5.0409,6.9062,5.0442,6.9062,5.1428,6.7776,5.1428)" + }, + { + "content": "230", + "span": { + "offset": 8680, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,7.7861,5.0328,7.9646,5.0315,7.9646,5.1362,7.7861,5.1375)" + }, + { + "content": "Note", + "span": { + "offset": 8716, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,1.5875,5.2295,1.8446,5.23,1.8466,5.3538,1.5896,5.3525)" + }, + { + "content": ":", + "span": { + "offset": 8720, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.8488,5.23,1.8759,5.23,1.8779,5.3539,1.8507,5.3538)" + }, + { + "content": "Schedule", + "span": { + "offset": 8722, + "length": 8 + }, + "confidence": 0.99, + "source": "D(2,1.9198,5.2301,2.3921,5.2309,2.3939,5.3564,1.9218,5.3541)" + }, + { + "content": "H", + "span": { + "offset": 8731, + "length": 1 + }, + "confidence": 0.987, + "source": "D(2,2.4402,5.231,2.5071,5.2311,2.5088,5.3569,2.4419,5.3566)" + }, + { + "content": "and", + "span": { + "offset": 8733, + "length": 3 + }, + "confidence": 0.98, + "source": "D(2,2.5572,5.2312,2.7391,5.2315,2.7407,5.3581,2.5589,5.3572)" + }, + { + "content": "Schedule", + "span": { + "offset": 8737, + "length": 8 + }, + "confidence": 0.993, + "source": "D(2,2.7871,5.2316,3.2636,5.2324,3.265,5.3606,2.7887,5.3583)" + }, + { + "content": "SE", + "span": { + "offset": 8746, + "length": 2 + }, + "confidence": 0.996, + "source": "D(2,3.3033,5.2325,3.4434,5.233,3.4447,5.3611,3.3047,5.3607)" + }, + { + "content": "filers", + "span": { + "offset": 8749, + "length": 6 + }, + "confidence": 0.989, + "source": "D(2,3.4852,5.2331,3.7255,5.2339,3.7267,5.362,3.4864,5.3613)" + }, + { + "content": ",", + "span": { + "offset": 8755, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.7255,5.2339,3.7506,5.234,3.7518,5.3621,3.7267,5.362)" + }, + { + "content": "line", + "span": { + "offset": 8757, + "length": 4 + }, + "confidence": 0.937, + "source": "D(2,3.8007,5.2342,3.9679,5.2348,3.969,5.3628,3.8019,5.3622)" + }, + { + "content": "37", + "span": { + "offset": 8762, + "length": 2 + }, + "confidence": 0.842, + "source": "D(2,4.0139,5.2349,4.1414,5.2354,4.1424,5.3633,4.015,5.3629)" + }, + { + "content": "may", + "span": { + "offset": 8765, + "length": 3 + }, + "confidence": 0.833, + "source": "D(2,4.1874,5.2355,4.4005,5.2363,4.4014,5.3641,4.1884,5.3635)" + }, + { + "content": "not", + "span": { + "offset": 8769, + "length": 3 + }, + "confidence": 0.954, + "source": "D(2,4.4465,5.2364,4.6053,5.237,4.6062,5.3648,4.4474,5.3643)" + }, + { + "content": "represent", + "span": { + "offset": 8773, + "length": 9 + }, + "confidence": 0.932, + "source": "D(2,4.6451,5.2371,5.1236,5.2391,5.1242,5.3661,4.6459,5.3649)" + }, + { + "content": "all", + "span": { + "offset": 8783, + "length": 3 + }, + "confidence": 0.936, + "source": "D(2,5.1654,5.2393,5.2741,5.2398,5.2747,5.3663,5.166,5.3661)" + }, + { + "content": "of", + "span": { + "offset": 8787, + "length": 2 + }, + "confidence": 0.937, + "source": "D(2,5.3222,5.2401,5.4288,5.2406,5.4292,5.3665,5.3227,5.3664)" + }, + { + "content": "the", + "span": { + "offset": 8790, + "length": 3 + }, + "confidence": 0.842, + "source": "D(2,5.4622,5.2408,5.621,5.2416,5.6214,5.3668,5.4627,5.3666)" + }, + { + "content": "taxes", + "span": { + "offset": 8794, + "length": 5 + }, + "confidence": 0.864, + "source": "D(2,5.6628,5.2419,5.9261,5.2432,5.9264,5.3672,5.6632,5.3669)" + }, + { + "content": "you", + "span": { + "offset": 8800, + "length": 3 + }, + "confidence": 0.909, + "source": "D(2,5.9679,5.2434,6.1602,5.2444,6.1604,5.3676,5.9682,5.3673)" + }, + { + "content": "owe", + "span": { + "offset": 8804, + "length": 3 + }, + "confidence": 0.853, + "source": "D(2,6.2062,5.2447,6.4173,5.2458,6.4174,5.368,6.2064,5.3677)" + }, + { + "content": "for", + "span": { + "offset": 8808, + "length": 3 + }, + "confidence": 0.877, + "source": "D(2,6.4549,5.2459,6.6033,5.2467,6.6033,5.3682,6.455,5.368)" + }, + { + "content": "2020", + "span": { + "offset": 8888, + "length": 4 + }, + "confidence": 0.53, + "source": "D(2,1.5865,5.3725,1.8368,5.3723,1.8377,5.4973,1.5875,5.4973)" + }, + { + "content": ".", + "span": { + "offset": 8892, + "length": 1 + }, + "confidence": 0.907, + "source": "D(2,1.8451,5.3723,1.8681,5.3723,1.869,5.4973,1.8461,5.4973)" + }, + { + "content": "See", + "span": { + "offset": 8894, + "length": 3 + }, + "confidence": 0.507, + "source": "D(2,1.9035,5.3722,2.0933,5.3721,2.0942,5.4973,1.9044,5.4973)" + }, + { + "content": "Schedule", + "span": { + "offset": 8898, + "length": 8 + }, + "confidence": 0.877, + "source": "D(2,2.1246,5.3721,2.5897,5.3718,2.5904,5.4973,2.1254,5.4973)" + }, + { + "content": "3", + "span": { + "offset": 8907, + "length": 1 + }, + "confidence": 0.941, + "source": "D(2,2.6251,5.3717,2.6815,5.3718,2.6821,5.4973,2.6258,5.4973)" + }, + { + "content": ",", + "span": { + "offset": 8908, + "length": 1 + }, + "confidence": 0.991, + "source": "D(2,2.6856,5.3718,2.7065,5.3718,2.7071,5.4973,2.6863,5.4973)" + }, + { + "content": "line", + "span": { + "offset": 8910, + "length": 4 + }, + "confidence": 0.878, + "source": "D(2,2.7482,5.3718,2.9151,5.3719,2.9156,5.4973,2.7488,5.4973)" + }, + { + "content": "12e", + "span": { + "offset": 8915, + "length": 3 + }, + "confidence": 0.939, + "source": "D(2,2.9547,5.372,3.132,5.3721,3.1325,5.4973,2.9553,5.4973)" + }, + { + "content": ",", + "span": { + "offset": 8918, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,3.132,5.3721,3.1549,5.3721,3.1554,5.4973,3.1325,5.4973)" + }, + { + "content": "and", + "span": { + "offset": 8920, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,3.1904,5.3721,3.3718,5.3723,3.3722,5.4973,3.1909,5.4973)" + }, + { + "content": "its", + "span": { + "offset": 8924, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,3.4135,5.3723,3.5261,5.3724,3.5265,5.4973,3.4139,5.4973)" + }, + { + "content": "instructions", + "span": { + "offset": 8928, + "length": 12 + }, + "confidence": 0.99, + "source": "D(2,3.5595,5.3724,4.1268,5.3734,4.127,5.4973,3.5599,5.4973)" + }, + { + "content": "for", + "span": { + "offset": 8941, + "length": 3 + }, + "confidence": 0.983, + "source": "D(2,4.1581,5.3735,4.2999,5.3738,4.3001,5.4973,4.1583,5.4973)" + }, + { + "content": "details", + "span": { + "offset": 8945, + "length": 7 + }, + "confidence": 0.936, + "source": "D(2,4.3229,5.3738,4.6545,5.3745,4.6545,5.4973,4.323,5.4973)" + }, + { + "content": ".", + "span": { + "offset": 8952, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,4.6545,5.3745,4.6899,5.3746,4.6899,5.4973,4.6545,5.4973)" + }, + { + "content": "38", + "span": { + "offset": 8974, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.27,5.5393,1.4039,5.539,1.4039,5.6464,1.27,5.6467)" + }, + { + "content": "Estimated", + "span": { + "offset": 8977, + "length": 9 + }, + "confidence": 0.996, + "source": "D(2,1.5886,5.5306,2.0872,5.531,2.0872,5.6599,1.5886,5.6595)" + }, + { + "content": "tax", + "span": { + "offset": 8987, + "length": 3 + }, + "confidence": 0.987, + "source": "D(2,2.1193,5.531,2.2755,5.5311,2.2755,5.66,2.1193,5.6599)" + }, + { + "content": "penalty", + "span": { + "offset": 8991, + "length": 7 + }, + "confidence": 0.964, + "source": "D(2,2.3098,5.5312,2.6736,5.5316,2.6736,5.6605,2.3098,5.6601)" + }, + { + "content": "(", + "span": { + "offset": 8999, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.6992,5.5316,2.7313,5.5316,2.7313,5.6605,2.6992,5.6605)" + }, + { + "content": "see", + "span": { + "offset": 9000, + "length": 3 + }, + "confidence": 0.985, + "source": "D(2,2.7313,5.5316,2.9004,5.5318,2.9004,5.6607,2.7313,5.6605)" + }, + { + "content": "instructions", + "span": { + "offset": 9004, + "length": 12 + }, + "confidence": 0.982, + "source": "D(2,2.9368,5.5319,3.5039,5.5327,3.5039,5.6616,2.9368,5.6608)" + }, + { + "content": ")", + "span": { + "offset": 9016, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,3.5018,5.5327,3.5403,5.5327,3.5403,5.6616,3.5018,5.6616)" + }, + { + "content": "38", + "span": { + "offset": 9027, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4827,5.543,5.6155,5.543,5.6155,5.6464,5.4827,5.6447)" + }, + { + "content": "231", + "span": { + "offset": 9039, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,6.4663,5.5322,6.6531,5.5322,6.6531,5.6397,6.4663,5.6397)" + }, + { + "content": "Third", + "span": { + "offset": 9067, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,0.4929,5.7031,0.8172,5.717,0.8169,5.8566,0.4934,5.8427)" + }, + { + "content": "Party", + "span": { + "offset": 9073, + "length": 5 + }, + "confidence": 0.998, + "source": "D(2,0.8619,5.7177,1.2078,5.7146,1.2057,5.8542,0.8614,5.8573)" + }, + { + "content": "Designee", + "span": { + "offset": 9079, + "length": 8 + }, + "confidence": 0.998, + "source": "D(2,0.4947,5.8545,1.1009,5.8545,1.0988,5.9941,0.4934,5.9941)" + }, + { + "content": "Do", + "span": { + "offset": 9089, + "length": 2 + }, + "confidence": 0.983, + "source": "D(2,1.3893,5.7089,1.5349,5.709,1.5349,5.8271,1.3893,5.8269)" + }, + { + "content": "you", + "span": { + "offset": 9092, + "length": 3 + }, + "confidence": 0.972, + "source": "D(2,1.59,5.7091,1.773,5.7092,1.773,5.8274,1.59,5.8271)" + }, + { + "content": "want", + "span": { + "offset": 9096, + "length": 4 + }, + "confidence": 0.985, + "source": "D(2,1.83,5.7092,2.0799,5.7094,2.0799,5.8278,1.83,5.8275)" + }, + { + "content": "to", + "span": { + "offset": 9101, + "length": 2 + }, + "confidence": 0.99, + "source": "D(2,2.129,5.7094,2.2313,5.7095,2.2313,5.828,2.129,5.8279)" + }, + { + "content": "allow", + "span": { + "offset": 9104, + "length": 5 + }, + "confidence": 0.987, + "source": "D(2,2.2904,5.7096,2.5441,5.7097,2.5441,5.8285,2.2904,5.8281)" + }, + { + "content": "another", + "span": { + "offset": 9110, + "length": 7 + }, + "confidence": 0.989, + "source": "D(2,2.6051,5.7098,2.9946,5.7097,2.9946,5.8286,2.6051,5.8285)" + }, + { + "content": "person", + "span": { + "offset": 9118, + "length": 6 + }, + "confidence": 0.97, + "source": "D(2,3.0478,5.7097,3.3881,5.7093,3.3881,5.8281,3.0477,5.8285)" + }, + { + "content": "to", + "span": { + "offset": 9125, + "length": 2 + }, + "confidence": 0.957, + "source": "D(2,3.4432,5.7092,3.5455,5.7091,3.5455,5.8279,3.4432,5.8281)" + }, + { + "content": "discuss", + "span": { + "offset": 9128, + "length": 7 + }, + "confidence": 0.879, + "source": "D(2,3.5986,5.7091,3.9783,5.7086,3.9783,5.8274,3.5986,5.8279)" + }, + { + "content": "this", + "span": { + "offset": 9136, + "length": 4 + }, + "confidence": 0.944, + "source": "D(2,4.0334,5.7086,4.2144,5.7084,4.2143,5.8271,4.0334,5.8274)" + }, + { + "content": "return", + "span": { + "offset": 9141, + "length": 6 + }, + "confidence": 0.919, + "source": "D(2,4.2773,5.7082,4.5645,5.7074,4.5645,5.8258,4.2773,5.8269)" + }, + { + "content": "with", + "span": { + "offset": 9148, + "length": 4 + }, + "confidence": 0.931, + "source": "D(2,4.6216,5.7072,4.834,5.7066,4.834,5.8249,4.6216,5.8256)" + }, + { + "content": "the", + "span": { + "offset": 9153, + "length": 3 + }, + "confidence": 0.877, + "source": "D(2,4.8891,5.7064,5.0524,5.7059,5.0524,5.8241,4.8891,5.8247)" + }, + { + "content": "IRS", + "span": { + "offset": 9157, + "length": 3 + }, + "confidence": 0.885, + "source": "D(2,5.1114,5.7058,5.2826,5.7053,5.2826,5.8232,5.1114,5.8238)" + }, + { + "content": "?", + "span": { + "offset": 9160, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,5.2885,5.7053,5.3455,5.7051,5.3455,5.823,5.2885,5.8232)" + }, + { + "content": "See", + "span": { + "offset": 9162, + "length": 3 + }, + "confidence": 0.932, + "source": "D(2,5.3967,5.7049,5.6072,5.7043,5.6072,5.822,5.3967,5.8228)" + }, + { + "content": "instructions", + "span": { + "offset": 9166, + "length": 12 + }, + "confidence": 0.998, + "source": "D(2,1.3873,5.8491,1.9797,5.8491,1.9777,5.9565,1.3873,5.9565)" + }, + { + "content": "☑", + "span": { + "offset": 9180, + "length": 1 + }, + "confidence": 0.888, + "source": "D(2,5.6902,5.8223,5.8105,5.8223,5.8105,5.9512,5.6902,5.9512)" + }, + { + "content": "Yes", + "span": { + "offset": 9182, + "length": 3 + }, + "confidence": 0.944, + "source": "D(2,5.8396,5.8438,6.0382,5.8438,6.0382,5.9619,5.8396,5.9619)" + }, + { + "content": ".", + "span": { + "offset": 9185, + "length": 1 + }, + "confidence": 0.975, + "source": "D(2,6.0422,5.8438,6.068,5.8438,6.068,5.9619,6.0422,5.9619)" + }, + { + "content": "Complete", + "span": { + "offset": 9187, + "length": 8 + }, + "confidence": 0.953, + "source": "D(2,6.1018,5.8438,6.5924,5.8438,6.5924,5.9619,6.1018,5.9619)" + }, + { + "content": "below", + "span": { + "offset": 9196, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,6.6202,5.8438,6.9142,5.8438,6.9142,5.9619,6.6202,5.9619)" + }, + { + "content": ".", + "span": { + "offset": 9201, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,6.9162,5.8438,6.9519,5.8438,6.9519,5.9619,6.9162,5.9619)" + }, + { + "content": "☐", + "span": { + "offset": 9203, + "length": 1 + }, + "confidence": 0.899, + "source": "D(2,7.093,5.8384,7.2175,5.8384,7.2175,5.9673,7.093,5.9673)" + }, + { + "content": "No", + "span": { + "offset": 9205, + "length": 2 + }, + "confidence": 0.994, + "source": "D(2,7.2466,5.8491,7.396,5.8491,7.396,5.9565,7.2466,5.9565)" + }, + { + "content": "Designee's", + "span": { + "offset": 9209, + "length": 10 + }, + "confidence": 0.997, + "source": "D(2,1.3914,6.0141,1.8843,6.0133,1.8843,6.1208,1.3914,6.1215)" + }, + { + "content": "name", + "span": { + "offset": 9220, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,1.3873,6.1582,1.6456,6.1549,1.6456,6.2409,1.3873,6.2441)" + }, + { + "content": "Joy", + "span": { + "offset": 9225, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,2.4467,6.0643,2.5847,6.0647,2.5847,6.1768,2.4467,6.1768)" + }, + { + "content": "Morgan", + "span": { + "offset": 9229, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,2.5994,6.0647,2.9177,6.0673,2.9177,6.1768,2.5994,6.1768)" + }, + { + "content": "Phone", + "span": { + "offset": 9237, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,4.1877,6.0164,4.4824,6.0213,4.4824,6.1179,4.1877,6.1131)" + }, + { + "content": "no", + "span": { + "offset": 9243, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,4.1919,6.1553,4.3047,6.1553,4.3048,6.2411,4.1919,6.2345)" + }, + { + "content": ".", + "span": { + "offset": 9245, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,4.3073,6.1553,4.3372,6.1553,4.3372,6.2416,4.3074,6.2411)" + }, + { + "content": "321875280", + "span": { + "offset": 9247, + "length": 9 + }, + "confidence": 0.991, + "source": "D(2,4.7563,6.0785,5.1797,6.0791,5.1797,6.1758,4.7563,6.1752)" + }, + { + "content": "Personal", + "span": { + "offset": 9258, + "length": 8 + }, + "confidence": 0.997, + "source": "D(2,5.989,6.0108,6.37,6.01,6.37,6.1161,5.989,6.1125)" + }, + { + "content": "identification", + "span": { + "offset": 9267, + "length": 14 + }, + "confidence": 0.997, + "source": "D(2,6.4039,6.0101,6.9644,6.014,6.9644,6.1101,6.4039,6.116)" + }, + { + "content": "number", + "span": { + "offset": 9282, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,5.9849,6.139,6.3299,6.1336,6.3299,6.2358,5.9849,6.2358)" + }, + { + "content": "(", + "span": { + "offset": 9289, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.3497,6.1336,6.3844,6.1339,6.3843,6.2358,6.3497,6.2358)" + }, + { + "content": "PIN", + "span": { + "offset": 9290, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,6.3794,6.1338,6.5296,6.1379,6.5296,6.2358,6.3794,6.2358)" + }, + { + "content": ")", + "span": { + "offset": 9293, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.5296,6.1379,6.5659,6.1389,6.5659,6.2358,6.5296,6.2358)" + }, + { + "content": "35480", + "span": { + "offset": 9295, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,6.9976,6.0803,8.002,6.0755,8.002,6.2474,6.9976,6.2522)" + }, + { + "content": "Sign", + "span": { + "offset": 9306, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,0.4916,6.3128,0.8545,6.3053,0.8513,6.4776,0.4895,6.4912)" + }, + { + "content": "Here", + "span": { + "offset": 9311, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,0.4923,6.4982,0.8814,6.4985,0.8814,6.6508,0.4921,6.6454)" + }, + { + "content": "Under", + "span": { + "offset": 9317, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,1.3893,6.2942,1.659,6.2949,1.659,6.4147,1.3893,6.4136)" + }, + { + "content": "penalties", + "span": { + "offset": 9323, + "length": 9 + }, + "confidence": 0.996, + "source": "D(2,1.685,6.295,2.0646,6.296,2.0646,6.4164,1.685,6.4149)" + }, + { + "content": "of", + "span": { + "offset": 9333, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,2.0946,6.2961,2.1845,6.2963,2.1845,6.4169,2.0946,6.4165)" + }, + { + "content": "perjury", + "span": { + "offset": 9336, + "length": 7 + }, + "confidence": 0.952, + "source": "D(2,2.2124,6.2964,2.5061,6.2972,2.5061,6.4182,2.2124,6.417)" + }, + { + "content": ",", + "span": { + "offset": 9343, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,2.5041,6.2972,2.5261,6.2972,2.5261,6.4183,2.5041,6.4182)" + }, + { + "content": "I", + "span": { + "offset": 9345, + "length": 1 + }, + "confidence": 0.917, + "source": "D(2,2.5601,6.2973,2.582,6.2974,2.582,6.4185,2.5601,6.4185)" + }, + { + "content": "declare", + "span": { + "offset": 9347, + "length": 7 + }, + "confidence": 0.875, + "source": "D(2,2.614,6.2975,2.9277,6.2983,2.9277,6.42,2.614,6.4187)" + }, + { + "content": "that", + "span": { + "offset": 9355, + "length": 4 + }, + "confidence": 0.945, + "source": "D(2,2.9556,6.2984,3.1274,6.2988,3.1274,6.4208,2.9556,6.4201)" + }, + { + "content": "I", + "span": { + "offset": 9360, + "length": 1 + }, + "confidence": 0.934, + "source": "D(2,3.1614,6.2989,3.1834,6.299,3.1834,6.421,3.1614,6.4209)" + }, + { + "content": "have", + "span": { + "offset": 9362, + "length": 4 + }, + "confidence": 0.911, + "source": "D(2,3.2113,6.299,3.4111,6.2996,3.4111,6.422,3.2113,6.4211)" + }, + { + "content": "examined", + "span": { + "offset": 9367, + "length": 8 + }, + "confidence": 0.984, + "source": "D(2,3.4411,6.2997,3.8526,6.3004,3.8526,6.4229,3.4411,6.4221)" + }, + { + "content": "this", + "span": { + "offset": 9376, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,3.8806,6.3004,4.0404,6.3006,4.0404,6.423,3.8806,6.4229)" + }, + { + "content": "return", + "span": { + "offset": 9381, + "length": 6 + }, + "confidence": 0.994, + "source": "D(2,4.0664,6.3006,4.3221,6.3009,4.3221,6.4231,4.0664,6.423)" + }, + { + "content": "and", + "span": { + "offset": 9388, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,4.3461,6.3009,4.5079,6.3011,4.5079,6.4232,4.3461,6.4231)" + }, + { + "content": "accompanying", + "span": { + "offset": 9392, + "length": 12 + }, + "confidence": 0.986, + "source": "D(2,4.5359,6.3011,5.1632,6.3019,5.1632,6.4236,4.5359,6.4233)" + }, + { + "content": "schedules", + "span": { + "offset": 9405, + "length": 9 + }, + "confidence": 0.99, + "source": "D(2,5.1972,6.3019,5.6287,6.3024,5.6287,6.4239,5.1972,6.4236)" + }, + { + "content": "and", + "span": { + "offset": 9415, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,5.6567,6.3024,5.8185,6.3026,5.8185,6.4239,5.6567,6.4239)" + }, + { + "content": "statements", + "span": { + "offset": 9419, + "length": 10 + }, + "confidence": 0.985, + "source": "D(2,5.8485,6.3026,6.3279,6.3024,6.3279,6.4224,5.8485,6.4238)" + }, + { + "content": ",", + "span": { + "offset": 9429, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,6.3379,6.3024,6.3579,6.3024,6.3579,6.4223,6.3379,6.4224)" + }, + { + "content": "and", + "span": { + "offset": 9431, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,6.3839,6.3023,6.5437,6.3023,6.5437,6.4218,6.3839,6.4222)" + }, + { + "content": "to", + "span": { + "offset": 9435, + "length": 2 + }, + "confidence": 0.992, + "source": "D(2,6.5837,6.3023,6.6616,6.3022,6.6616,6.4214,6.5837,6.4216)" + }, + { + "content": "the", + "span": { + "offset": 9438, + "length": 3 + }, + "confidence": 0.972, + "source": "D(2,6.6875,6.3022,6.8274,6.3022,6.8274,6.4209,6.6876,6.4213)" + }, + { + "content": "best", + "span": { + "offset": 9442, + "length": 4 + }, + "confidence": 0.789, + "source": "D(2,6.8494,6.3022,7.0452,6.3021,7.0452,6.4203,6.8494,6.4208)" + }, + { + "content": "of", + "span": { + "offset": 9447, + "length": 2 + }, + "confidence": 0.721, + "source": "D(2,7.0711,6.3021,7.153,6.302,7.153,6.4199,7.0711,6.4202)" + }, + { + "content": "my", + "span": { + "offset": 9450, + "length": 2 + }, + "confidence": 0.538, + "source": "D(2,7.177,6.302,7.3129,6.302,7.3129,6.4195,7.177,6.4199)" + }, + { + "content": "knowledge", + "span": { + "offset": 9453, + "length": 9 + }, + "confidence": 0.326, + "source": "D(2,7.3248,6.302,7.8023,6.3018,7.8023,6.418,7.3249,6.4194)" + }, + { + "content": "and", + "span": { + "offset": 9463, + "length": 3 + }, + "confidence": 0.476, + "source": "D(2,7.8263,6.3018,8.0061,6.3017,8.0061,6.4174,7.8263,6.4179)" + }, + { + "content": "belief", + "span": { + "offset": 9467, + "length": 6 + }, + "confidence": 0.994, + "source": "D(2,1.3873,6.4238,1.6216,6.4238,1.6216,6.542,1.3873,6.542)" + }, + { + "content": ",", + "span": { + "offset": 9473, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,1.6235,6.4238,1.6452,6.4238,1.6452,6.542,1.6235,6.542)" + }, + { + "content": "they", + "span": { + "offset": 9475, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,1.6708,6.4238,1.8598,6.4238,1.8598,6.542,1.6708,6.542)" + }, + { + "content": "are", + "span": { + "offset": 9480, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,1.8854,6.4238,2.0134,6.4238,2.0134,6.542,1.8854,6.542)" + }, + { + "content": "true", + "span": { + "offset": 9484, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,2.039,6.4238,2.2103,6.4238,2.2103,6.542,2.039,6.542)" + }, + { + "content": ",", + "span": { + "offset": 9488, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,2.2122,6.4238,2.2319,6.4238,2.2319,6.542,2.2122,6.542)" + }, + { + "content": "correct", + "span": { + "offset": 9490, + "length": 7 + }, + "confidence": 0.996, + "source": "D(2,2.2615,6.4238,2.5666,6.4238,2.5666,6.542,2.2615,6.542)" + }, + { + "content": ",", + "span": { + "offset": 9497, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,2.5686,6.4238,2.5903,6.4238,2.5903,6.542,2.5686,6.542)" + }, + { + "content": "and", + "span": { + "offset": 9499, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,2.6139,6.4238,2.7714,6.4238,2.7714,6.542,2.6139,6.542)" + }, + { + "content": "complete", + "span": { + "offset": 9503, + "length": 8 + }, + "confidence": 0.278, + "source": "D(2,2.8049,6.4238,3.2026,6.4238,3.2026,6.542,2.8049,6.542)" + }, + { + "content": ".", + "span": { + "offset": 9511, + "length": 1 + }, + "confidence": 0.914, + "source": "D(2,3.2045,6.4238,3.2262,6.4238,3.2262,6.542,3.2045,6.542)" + }, + { + "content": "Declaration", + "span": { + "offset": 9513, + "length": 11 + }, + "confidence": 0.528, + "source": "D(2,3.2577,6.4238,3.7322,6.4238,3.7322,6.542,3.2577,6.542)" + }, + { + "content": "of", + "span": { + "offset": 9525, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,3.7598,6.4238,3.8503,6.4238,3.8503,6.542,3.7598,6.542)" + }, + { + "content": "preparer", + "span": { + "offset": 9528, + "length": 8 + }, + "confidence": 0.99, + "source": "D(2,3.872,6.4238,4.2323,6.4238,4.2323,6.542,3.872,6.542)" + }, + { + "content": "(", + "span": { + "offset": 9537, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,4.2579,6.4238,4.2874,6.4238,4.2874,6.542,4.2579,6.542)" + }, + { + "content": "other", + "span": { + "offset": 9538, + "length": 5 + }, + "confidence": 0.992, + "source": "D(2,4.2874,6.4238,4.5138,6.4238,4.5138,6.542,4.2874,6.542)" + }, + { + "content": "than", + "span": { + "offset": 9544, + "length": 4 + }, + "confidence": 0.992, + "source": "D(2,4.5296,6.4238,4.7166,6.4238,4.7166,6.542,4.5296,6.542)" + }, + { + "content": "taxpayer", + "span": { + "offset": 9549, + "length": 8 + }, + "confidence": 0.976, + "source": "D(2,4.7462,6.4238,5.1203,6.4238,5.1203,6.542,4.7462,6.542)" + }, + { + "content": ")", + "span": { + "offset": 9557, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,5.1144,6.4238,5.1439,6.4238,5.1439,6.542,5.1144,6.542)" + }, + { + "content": "is", + "span": { + "offset": 9559, + "length": 2 + }, + "confidence": 0.997, + "source": "D(2,5.1734,6.4238,5.2423,6.4238,5.2423,6.542,5.1734,6.542)" + }, + { + "content": "based", + "span": { + "offset": 9562, + "length": 5 + }, + "confidence": 0.988, + "source": "D(2,5.266,6.4238,5.5219,6.4238,5.5219,6.542,5.266,6.542)" + }, + { + "content": "on", + "span": { + "offset": 9568, + "length": 2 + }, + "confidence": 0.997, + "source": "D(2,5.5554,6.4238,5.6597,6.4238,5.6597,6.542,5.5554,6.542)" + }, + { + "content": "all", + "span": { + "offset": 9571, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,5.6873,6.4238,5.7779,6.4238,5.7779,6.542,5.6873,6.542)" + }, + { + "content": "information", + "span": { + "offset": 9575, + "length": 11 + }, + "confidence": 0.95, + "source": "D(2,5.8074,6.4238,6.2898,6.4238,6.2898,6.542,5.8074,6.542)" + }, + { + "content": "of", + "span": { + "offset": 9587, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,6.3095,6.4238,6.404,6.4238,6.404,6.542,6.3095,6.542)" + }, + { + "content": "which", + "span": { + "offset": 9590, + "length": 5 + }, + "confidence": 0.978, + "source": "D(2,6.4256,6.4238,6.6698,6.4238,6.6698,6.542,6.4256,6.542)" + }, + { + "content": "preparer", + "span": { + "offset": 9596, + "length": 8 + }, + "confidence": 0.876, + "source": "D(2,6.6954,6.4238,7.0773,6.4238,7.0773,6.542,6.6954,6.542)" + }, + { + "content": "has", + "span": { + "offset": 9605, + "length": 3 + }, + "confidence": 0.806, + "source": "D(2,7.101,6.4238,7.2565,6.4238,7.2565,6.542,7.101,6.542)" + }, + { + "content": "any", + "span": { + "offset": 9609, + "length": 3 + }, + "confidence": 0.661, + "source": "D(2,7.2644,6.4238,7.4258,6.4238,7.4258,6.542,7.2644,6.542)" + }, + { + "content": "knowledge", + "span": { + "offset": 9613, + "length": 9 + }, + "confidence": 0.476, + "source": "D(2,7.4475,6.4238,7.9003,6.4238,7.9003,6.542,7.4475,6.542)" + }, + { + "content": ".", + "span": { + "offset": 9622, + "length": 1 + }, + "confidence": 0.994, + "source": "D(2,7.9121,6.4238,7.9397,6.4238,7.9397,6.542,7.9121,6.542)" + }, + { + "content": "Your", + "span": { + "offset": 9625, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,1.3904,6.6074,1.6046,6.604,1.6046,6.7193,1.3904,6.7189)" + }, + { + "content": "signature", + "span": { + "offset": 9630, + "length": 9 + }, + "confidence": 0.998, + "source": "D(2,1.6239,6.604,2.0389,6.6073,2.0389,6.7259,1.6239,6.7195)" + }, + { + "content": "Robert", + "span": { + "offset": 9640, + "length": 6 + }, + "confidence": 0.89, + "source": "D(2,2.428,6.6872,2.8908,6.6873,2.8886,6.937,2.4238,6.9412)" + }, + { + "content": "morgan", + "span": { + "offset": 9647, + "length": 6 + }, + "confidence": 0.877, + "source": "D(2,2.8908,6.6873,3.3535,6.6901,3.3535,6.9466,2.8886,6.937)" + }, + { + "content": "Date", + "span": { + "offset": 9655, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,3.8453,6.6049,4.0591,6.6074,4.0591,6.7041,3.8453,6.7015)" + }, + { + "content": "12/10/1986", + "span": { + "offset": 9660, + "length": 10 + }, + "confidence": 0.982, + "source": "D(2,3.8267,6.7783,4.4326,6.7783,4.4326,6.8965,3.8267,6.8965)" + }, + { + "content": "Your", + "span": { + "offset": 9672, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,4.5488,6.6072,4.7612,6.6051,4.7612,6.7216,4.5488,6.7214)" + }, + { + "content": "occupation", + "span": { + "offset": 9677, + "length": 10 + }, + "confidence": 0.998, + "source": "D(2,4.7791,6.6049,5.2793,6.5943,5.2793,6.7125,4.779,6.7216)" + }, + { + "content": "Judge", + "span": { + "offset": 9688, + "length": 5 + }, + "confidence": 0.994, + "source": "D(2,4.8352,6.803,5.1755,6.8092,5.1755,6.9381,4.8352,6.9319)" + }, + { + "content": "If", + "span": { + "offset": 9695, + "length": 2 + }, + "confidence": 0.962, + "source": "D(2,6.4414,6.5984,6.5133,6.5972,6.5133,6.71,6.4414,6.7102)" + }, + { + "content": "the", + "span": { + "offset": 9698, + "length": 3 + }, + "confidence": 0.946, + "source": "D(2,6.5288,6.597,6.6667,6.5948,6.6667,6.7096,6.5288,6.71)" + }, + { + "content": "IRS", + "span": { + "offset": 9702, + "length": 3 + }, + "confidence": 0.981, + "source": "D(2,6.6958,6.5944,6.8415,6.5921,6.8415,6.7091,6.6958,6.7095)" + }, + { + "content": "sent", + "span": { + "offset": 9706, + "length": 4 + }, + "confidence": 0.989, + "source": "D(2,6.8687,6.5917,7.0552,6.5916,7.0552,6.7097,6.8687,6.7091)" + }, + { + "content": "you", + "span": { + "offset": 9711, + "length": 3 + }, + "confidence": 0.993, + "source": "D(2,7.0765,6.5916,7.2358,6.5915,7.2358,6.7104,7.0765,6.7098)" + }, + { + "content": "an", + "span": { + "offset": 9715, + "length": 2 + }, + "confidence": 0.99, + "source": "D(2,7.265,6.5915,7.3699,6.5926,7.3698,6.7113,7.2649,6.7105)" + }, + { + "content": "Identity", + "span": { + "offset": 9718, + "length": 8 + }, + "confidence": 0.924, + "source": "D(2,7.4009,6.5931,7.7156,6.5977,7.7156,6.7147,7.4009,6.7116)" + }, + { + "content": "Protection", + "span": { + "offset": 9727, + "length": 10 + }, + "confidence": 0.996, + "source": "D(2,6.4414,6.7139,6.8905,6.7139,6.8905,6.8213,6.4414,6.8213)" + }, + { + "content": "PIN", + "span": { + "offset": 9738, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,6.9229,6.7139,7.069,6.7139,7.069,6.8213,6.9229,6.8213)" + }, + { + "content": ",", + "span": { + "offset": 9741, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.0762,6.7139,7.0961,6.7139,7.0961,6.8213,7.0762,6.8213)" + }, + { + "content": "enter", + "span": { + "offset": 9743, + "length": 5 + }, + "confidence": 0.987, + "source": "D(2,7.1267,6.7139,7.3558,6.7139,7.3558,6.8213,7.1267,6.8213)" + }, + { + "content": "it", + "span": { + "offset": 9749, + "length": 2 + }, + "confidence": 0.979, + "source": "D(2,7.3792,6.7139,7.4351,6.7139,7.4351,6.8213,7.3792,6.8213)" + }, + { + "content": "here", + "span": { + "offset": 9752, + "length": 4 + }, + "confidence": 0.976, + "source": "D(2,7.4567,6.7139,7.6533,6.7139,7.6533,6.8213,7.4567,6.8213)" + }, + { + "content": "(", + "span": { + "offset": 9757, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.4373,6.8481,6.4782,6.8481,6.4782,6.9556,6.4373,6.9556)" + }, + { + "content": "see", + "span": { + "offset": 9758, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,6.4729,6.8481,6.6261,6.8481,6.6261,6.9556,6.4729,6.9556)" + }, + { + "content": "inst", + "span": { + "offset": 9762, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,6.6546,6.8481,6.8095,6.8481,6.8095,6.9556,6.6546,6.9556)" + }, + { + "content": ".", + "span": { + "offset": 9766, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8042,6.8481,6.8256,6.8481,6.8256,6.9556,6.8042,6.9556)" + }, + { + "content": ")", + "span": { + "offset": 9767, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8256,6.8481,6.8647,6.8481,6.8647,6.9556,6.8256,6.9556)" + }, + { + "content": "520000", + "span": { + "offset": 9769, + "length": 6 + }, + "confidence": 0.999, + "source": "D(2,6.9976,6.8357,7.9937,6.8258,7.9937,7.0005,6.9976,7.001)" + }, + { + "content": "Joint", + "span": { + "offset": 9777, + "length": 5 + }, + "confidence": 0.998, + "source": "D(2,0.4918,6.8841,0.6926,6.8806,0.6932,6.9834,0.4929,6.9815)" + }, + { + "content": "return", + "span": { + "offset": 9783, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,0.7181,6.8806,0.9512,6.8821,0.9513,6.9832,0.7187,6.9835)" + }, + { + "content": "?", + "span": { + "offset": 9789, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,0.9563,6.8822,1.0091,6.883,1.0091,6.9829,0.9564,6.9831)" + }, + { + "content": "See", + "span": { + "offset": 9791, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.4905,7.0043,0.6503,7.0004,0.6497,7.1078,0.4903,7.1117)" + }, + { + "content": "instructions", + "span": { + "offset": 9795, + "length": 12 + }, + "confidence": 0.998, + "source": "D(2,0.6752,6.9998,1.1458,6.9933,1.1438,7.1007,0.6745,7.1073)" + }, + { + "content": ".", + "span": { + "offset": 9807, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,1.1476,6.9933,1.1725,6.993,1.1704,7.1005,1.1456,7.1007)" + }, + { + "content": "Keep", + "span": { + "offset": 9809, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,0.4903,7.1221,0.7067,7.1221,0.7069,7.2295,0.4905,7.2295)" + }, + { + "content": "a", + "span": { + "offset": 9814, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,0.73,7.1221,0.7801,7.1221,0.7802,7.2295,0.7302,7.2295)" + }, + { + "content": "copy", + "span": { + "offset": 9816, + "length": 4 + }, + "confidence": 0.993, + "source": "D(2,0.8051,7.1221,1.0091,7.1221,1.0091,7.2295,0.8053,7.2295)" + }, + { + "content": "for", + "span": { + "offset": 9821, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,1.0234,7.1221,1.1486,7.1221,1.1486,7.2295,1.0234,7.2295)" + }, + { + "content": "your", + "span": { + "offset": 9825, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,0.4838,7.2448,0.6748,7.2462,0.6754,7.3473,0.4848,7.3413)" + }, + { + "content": "records", + "span": { + "offset": 9830, + "length": 7 + }, + "confidence": 0.998, + "source": "D(2,0.6944,7.246,1.0014,7.2408,1.0014,7.3411,0.695,7.3473)" + }, + { + "content": ".", + "span": { + "offset": 9837, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.003,7.2407,1.0324,7.24,1.0324,7.34,1.0031,7.3411)" + }, + { + "content": "Spouse's", + "span": { + "offset": 9840, + "length": 8 + }, + "confidence": 0.979, + "source": "D(2,1.3862,7.0248,1.7959,7.0233,1.7959,7.1444,1.3862,7.143)" + }, + { + "content": "signature", + "span": { + "offset": 9849, + "length": 9 + }, + "confidence": 0.888, + "source": "D(2,1.8239,7.0232,2.2316,7.0222,2.2316,7.1456,1.8239,7.1445)" + }, + { + "content": ".", + "span": { + "offset": 9858, + "length": 1 + }, + "confidence": 0.959, + "source": "D(2,2.2336,7.0222,2.2536,7.0222,2.2536,7.1456,2.2336,7.1456)" + }, + { + "content": "If", + "span": { + "offset": 9860, + "length": 2 + }, + "confidence": 0.813, + "source": "D(2,2.2875,7.0222,2.3415,7.0223,2.3415,7.1456,2.2875,7.1456)" + }, + { + "content": "a", + "span": { + "offset": 9863, + "length": 1 + }, + "confidence": 0.964, + "source": "D(2,2.3635,7.0223,2.4134,7.0224,2.4134,7.1455,2.3635,7.1456)" + }, + { + "content": "joint", + "span": { + "offset": 9865, + "length": 5 + }, + "confidence": 0.868, + "source": "D(2,2.4354,7.0224,2.6313,7.0226,2.6313,7.1455,2.4354,7.1455)" + }, + { + "content": "return", + "span": { + "offset": 9871, + "length": 6 + }, + "confidence": 0.966, + "source": "D(2,2.6573,7.0227,2.9051,7.023,2.9051,7.1454,2.6573,7.1455)" + }, + { + "content": ",", + "span": { + "offset": 9877, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,2.9111,7.023,2.9331,7.0231,2.933,7.1452,2.9111,7.1453)" + }, + { + "content": "both", + "span": { + "offset": 9879, + "length": 4 + }, + "confidence": 0.992, + "source": "D(2,2.969,7.0234,3.1749,7.0246,3.1749,7.1442,2.969,7.1451)" + }, + { + "content": "must", + "span": { + "offset": 9884, + "length": 4 + }, + "confidence": 0.985, + "source": "D(2,3.2028,7.0247,3.4207,7.026,3.4207,7.1432,3.2028,7.1441)" + }, + { + "content": "sign", + "span": { + "offset": 9889, + "length": 4 + }, + "confidence": 0.971, + "source": "D(2,3.4447,7.0262,3.6245,7.0272,3.6245,7.1424,3.4447,7.1431)" + }, + { + "content": ".", + "span": { + "offset": 9893, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,3.6285,7.0273,3.6565,7.0274,3.6565,7.1422,3.6285,7.1423)" + }, + { + "content": "Date", + "span": { + "offset": 9896, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,3.8453,7.0254,4.0591,7.0254,4.0591,7.1221,3.8453,7.1221)" + }, + { + "content": "Spouse's", + "span": { + "offset": 9902, + "length": 8 + }, + "confidence": 0.993, + "source": "D(2,4.5405,7.0254,4.9529,7.0254,4.9529,7.1415,4.5405,7.1406)" + }, + { + "content": "occupation", + "span": { + "offset": 9911, + "length": 10 + }, + "confidence": 0.997, + "source": "D(2,4.9763,7.0254,5.4785,7.0254,5.4785,7.1435,4.9763,7.1416)" + }, + { + "content": "If", + "span": { + "offset": 9923, + "length": 2 + }, + "confidence": 0.957, + "source": "D(2,6.4414,7.0133,6.5125,7.014,6.5125,7.1214,6.4414,7.1207)" + }, + { + "content": "the", + "span": { + "offset": 9926, + "length": 3 + }, + "confidence": 0.951, + "source": "D(2,6.5284,7.0142,6.6634,7.0156,6.6635,7.123,6.5284,7.1216)" + }, + { + "content": "IRS", + "span": { + "offset": 9930, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,6.6954,7.0159,6.8411,7.0175,6.8411,7.1249,6.6954,7.1233)" + }, + { + "content": "sent", + "span": { + "offset": 9934, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,6.8713,7.0178,7.056,7.0188,7.056,7.1262,6.8713,7.1252)" + }, + { + "content": "your", + "span": { + "offset": 9939, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,7.0809,7.0189,7.2763,7.0199,7.2763,7.1273,7.0809,7.1263)" + }, + { + "content": "spouse", + "span": { + "offset": 9944, + "length": 6 + }, + "confidence": 0.99, + "source": "D(2,7.2958,7.02,7.6138,7.02,7.6138,7.1274,7.2958,7.1274)" + }, + { + "content": "an", + "span": { + "offset": 9951, + "length": 2 + }, + "confidence": 0.996, + "source": "D(2,7.6369,7.02,7.7488,7.0199,7.7488,7.1274,7.6369,7.1274)" + }, + { + "content": "Identity", + "span": { + "offset": 9954, + "length": 8 + }, + "confidence": 0.979, + "source": "D(2,6.4414,7.1374,6.7677,7.1311,6.7677,7.2386,6.4414,7.2448)" + }, + { + "content": "Protection", + "span": { + "offset": 9963, + "length": 10 + }, + "confidence": 0.996, + "source": "D(2,6.796,7.1306,7.2323,7.1269,7.2323,7.2343,6.7961,7.238)" + }, + { + "content": "PIN", + "span": { + "offset": 9974, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,7.266,7.1268,7.4132,7.1265,7.4132,7.2339,7.266,7.2342)" + }, + { + "content": ",", + "span": { + "offset": 9977, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,7.4185,7.1265,7.438,7.1265,7.4381,7.2339,7.4186,7.2339)" + }, + { + "content": "enter", + "span": { + "offset": 9979, + "length": 5 + }, + "confidence": 0.98, + "source": "D(2,7.4682,7.1264,7.6969,7.1296,7.697,7.237,7.4682,7.2338)" + }, + { + "content": "it", + "span": { + "offset": 9985, + "length": 2 + }, + "confidence": 0.961, + "source": "D(2,7.72,7.13,7.7767,7.1308,7.7768,7.2382,7.72,7.2374)" + }, + { + "content": "here", + "span": { + "offset": 9988, + "length": 4 + }, + "confidence": 0.97, + "source": "D(2,7.798,7.1312,8.002,7.1342,8.002,7.2416,7.798,7.2386)" + }, + { + "content": "(", + "span": { + "offset": 9993, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.4414,7.2725,6.4784,7.2725,6.4784,7.3799,6.4414,7.3799)" + }, + { + "content": "see", + "span": { + "offset": 9994, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,6.4749,7.2725,6.6266,7.2725,6.6266,7.3799,6.4749,7.3799)" + }, + { + "content": "inst", + "span": { + "offset": 9998, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,6.6548,7.2725,6.8083,7.2725,6.8083,7.3799,6.6548,7.3799)" + }, + { + "content": ".", + "span": { + "offset": 10002, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8048,7.2725,6.8259,7.2725,6.8259,7.3799,6.8048,7.3799)" + }, + { + "content": ")", + "span": { + "offset": 10003, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8259,7.2725,6.8647,7.2725,6.8647,7.3799,6.8259,7.3799)" + }, + { + "content": "Phone", + "span": { + "offset": 10006, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,1.3883,7.4489,1.6701,7.449,1.668,7.5564,1.3862,7.5563)" + }, + { + "content": "no", + "span": { + "offset": 10012, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.6969,7.4486,1.8092,7.4451,1.8071,7.5526,1.6947,7.556)" + }, + { + "content": ".", + "span": { + "offset": 10014, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.8128,7.445,1.8448,7.444,1.8428,7.5514,1.8107,7.5524)" + }, + { + "content": "00141386305445", + "span": { + "offset": 10016, + "length": 14 + }, + "confidence": 0.963, + "source": "D(2,2.3823,7.439,3.2643,7.439,3.2643,7.5571,2.3823,7.5571)" + }, + { + "content": "Email", + "span": { + "offset": 10032, + "length": 5 + }, + "confidence": 0.992, + "source": "D(2,3.8453,7.4439,4.0791,7.4436,4.0791,7.5617,3.8453,7.5621)" + }, + { + "content": "address", + "span": { + "offset": 10038, + "length": 7 + }, + "confidence": 0.987, + "source": "D(2,4.1046,7.4435,4.4366,7.4431,4.4366,7.5612,4.1046,7.5617)" + }, + { + "content": "robert99@gmail.com.us", + "span": { + "offset": 10046, + "length": 21 + }, + "confidence": 0.977, + "source": "D(2,4.527,7.443,5.7939,7.4452,5.7939,7.5634,4.527,7.5612)" + }, + { + "content": "Paid", + "span": { + "offset": 10072, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,0.4947,7.6693,0.828,7.6672,0.828,7.8093,0.4949,7.8096)" + }, + { + "content": "Preparer", + "span": { + "offset": 10077, + "length": 8 + }, + "confidence": 0.997, + "source": "D(2,0.4947,7.8525,1.1445,7.8525,1.1403,7.9998,0.4936,8.0028)" + }, + { + "content": "Use", + "span": { + "offset": 10086, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,0.4967,8.0151,0.7744,8.0182,0.7716,8.1748,0.4949,8.1748)" + }, + { + "content": "Only", + "span": { + "offset": 10090, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,0.8133,8.0184,1.1611,8.0186,1.1569,8.1748,0.8104,8.1748)" + }, + { + "content": "Preparer's", + "span": { + "offset": 10096, + "length": 10 + }, + "confidence": 0.987, + "source": "D(2,1.3873,7.6042,1.8447,7.6104,1.844,7.7231,1.3873,7.7164)" + }, + { + "content": "name", + "span": { + "offset": 10107, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,1.8705,7.6105,2.125,7.6072,2.124,7.7175,1.8698,7.7231)" + }, + { + "content": "Mark", + "span": { + "offset": 10112, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,1.2897,7.7559,1.5572,7.7559,1.5551,7.8848,1.2877,7.8848)" + }, + { + "content": "Kelly", + "span": { + "offset": 10117, + "length": 5 + }, + "confidence": 0.995, + "source": "D(2,1.5866,7.7559,1.8625,7.7559,1.8604,7.8848,1.5846,7.8848)" + }, + { + "content": "Preparer's", + "span": { + "offset": 10124, + "length": 10 + }, + "confidence": 0.992, + "source": "D(2,3.0381,7.6096,3.496,7.6139,3.496,7.7315,3.0381,7.7213)" + }, + { + "content": "signature", + "span": { + "offset": 10135, + "length": 9 + }, + "confidence": 0.997, + "source": "D(2,3.5211,7.6141,3.9346,7.6171,3.9346,7.7348,3.5212,7.7319)" + }, + { + "content": "mark", + "span": { + "offset": 10145, + "length": 4 + }, + "confidence": 0.869, + "source": "D(2,4.2043,7.6133,4.5787,7.6231,4.5787,7.8795,4.2043,7.8724)" + }, + { + "content": "Kelly", + "span": { + "offset": 10150, + "length": 5 + }, + "confidence": 0.745, + "source": "D(2,4.5698,7.623,4.9888,7.6282,4.9888,7.8907,4.5698,7.8793)" + }, + { + "content": "Date", + "span": { + "offset": 10157, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,5.4453,7.6153,5.6611,7.6184,5.6611,7.7151,5.4453,7.7119)" + }, + { + "content": "10/20/1990", + "span": { + "offset": 10162, + "length": 10 + }, + "confidence": 0.975, + "source": "D(2,5.4744,7.729,6.072,7.729,6.072,7.8472,5.4744,7.8472)" + }, + { + "content": "PTIN", + "span": { + "offset": 10174, + "length": 4 + }, + "confidence": 0.989, + "source": "D(2,6.2754,7.6055,6.4995,7.6055,6.4995,7.7021,6.2754,7.7021)" + }, + { + "content": "09870", + "span": { + "offset": 10179, + "length": 5 + }, + "confidence": 0.993, + "source": "D(2,6.4373,7.7636,6.7527,7.7644,6.7527,7.8839,6.4373,7.8788)" + }, + { + "content": "Check", + "span": { + "offset": 10186, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,7.0432,7.6103,7.3373,7.6139,7.3373,7.716,7.0432,7.7123)" + }, + { + "content": "if", + "span": { + "offset": 10192, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,7.357,7.613,7.4162,7.6101,7.4161,7.7121,7.357,7.715)" + }, + { + "content": ":", + "span": { + "offset": 10194, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,7.4096,7.6104,7.4375,7.6091,7.4375,7.7111,7.4096,7.7125)" + }, + { + "content": "☐", + "span": { + "offset": 10197, + "length": 1 + }, + "confidence": 0.915, + "source": "D(2,7.093,7.7612,7.2175,7.7559,7.2175,7.8848,7.093,7.8794)" + }, + { + "content": "Self", + "span": { + "offset": 10199, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,7.2424,7.772,7.4179,7.7696,7.4179,7.877,7.2424,7.8794)" + }, + { + "content": "-", + "span": { + "offset": 10203, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.4142,7.7696,7.4471,7.7692,7.4471,7.8766,7.4142,7.877)" + }, + { + "content": "employed", + "span": { + "offset": 10204, + "length": 8 + }, + "confidence": 0.999, + "source": "D(2,7.4435,7.7692,7.8857,7.7743,7.8857,7.8817,7.4434,7.8766)" + }, + { + "content": "Firm's", + "span": { + "offset": 10214, + "length": 6 + }, + "confidence": 0.995, + "source": "D(2,1.3893,7.9642,1.6584,7.9683,1.6585,8.0703,1.3893,8.0663)" + }, + { + "content": "name", + "span": { + "offset": 10221, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,1.686,7.9686,1.9413,7.9715,1.9413,8.0735,1.6861,8.0707)" + }, + { + "content": "ANM", + "span": { + "offset": 10226, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,2.1188,7.9337,2.3711,7.9474,2.3716,8.068,2.1188,8.0513)" + }, + { + "content": "company", + "span": { + "offset": 10230, + "length": 7 + }, + "confidence": 0.998, + "source": "D(2,2.4081,7.9486,2.9073,7.9504,2.9073,8.0782,2.4086,8.0696)" + }, + { + "content": "Phone", + "span": { + "offset": 10239, + "length": 5 + }, + "confidence": 0.995, + "source": "D(2,6.4414,7.9635,6.7293,7.9707,6.7294,8.0727,6.4414,8.0655)" + }, + { + "content": "no", + "span": { + "offset": 10245, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7564,7.9705,6.8648,7.9672,6.8649,8.0692,6.7565,8.0726)" + }, + { + "content": ".", + "span": { + "offset": 10247, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8682,7.967,6.9021,7.966,6.9021,8.068,6.8682,8.0691)" + }, + { + "content": "8760765000876", + "span": { + "offset": 10249, + "length": 13 + }, + "confidence": 0.934, + "source": "D(2,7.0474,7.9429,7.8691,7.9391,7.8691,8.0567,7.0474,8.0586)" + }, + { + "content": "Firm's", + "span": { + "offset": 10264, + "length": 6 + }, + "confidence": 0.993, + "source": "D(2,1.3893,8.1283,1.6604,8.121,1.6604,8.2278,1.3893,8.2277)" + }, + { + "content": "address", + "span": { + "offset": 10271, + "length": 7 + }, + "confidence": 0.997, + "source": "D(2,1.6881,8.1211,2.0524,8.1319,2.0524,8.2379,1.688,8.2282)" + }, + { + "content": "9220", + "span": { + "offset": 10279, + "length": 4 + }, + "confidence": 0.973, + "source": "D(2,2.2308,8.1153,2.4857,8.1144,2.4857,8.2332,2.2308,8.2327)" + }, + { + "content": "BELHAVEN", + "span": { + "offset": 10284, + "length": 8 + }, + "confidence": 0.971, + "source": "D(2,2.5221,8.1142,3.123,8.112,3.123,8.2347,2.5221,8.2333)" + }, + { + "content": "LOS", + "span": { + "offset": 10293, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,3.1634,8.1118,3.386,8.1113,3.386,8.2346,3.1634,8.2348)" + }, + { + "content": "ANGELES", + "span": { + "offset": 10297, + "length": 7 + }, + "confidence": 0.962, + "source": "D(2,3.4143,8.1112,3.9504,8.1099,3.9504,8.2338,3.4143,8.2345)" + }, + { + "content": "CA", + "span": { + "offset": 10305, + "length": 2 + }, + "confidence": 0.96, + "source": "D(2,3.9868,8.1098,4.1466,8.1095,4.1466,8.2334,3.9868,8.2338)" + }, + { + "content": "90002-2009", + "span": { + "offset": 10308, + "length": 10 + }, + "confidence": 0.777, + "source": "D(2,4.175,8.1095,4.7697,8.1089,4.7697,8.2303,4.175,8.2333)" + }, + { + "content": "USA", + "span": { + "offset": 10319, + "length": 3 + }, + "confidence": 0.94, + "source": "D(2,4.8041,8.1089,5.0469,8.1086,5.0469,8.2289,4.8041,8.2301)" + }, + { + "content": "Firm's", + "span": { + "offset": 10324, + "length": 6 + }, + "confidence": 0.98, + "source": "D(2,6.4414,8.1223,6.7156,8.1213,6.7156,8.2285,6.4414,8.2285)" + }, + { + "content": "EIN", + "span": { + "offset": 10331, + "length": 3 + }, + "confidence": 0.934, + "source": "D(2,6.7446,8.1212,6.9062,8.121,6.9062,8.2285,6.7446,8.2285)" + }, + { + "content": "080686", + "span": { + "offset": 10335, + "length": 6 + }, + "confidence": 0.996, + "source": "D(2,7.3254,8.1191,7.7114,8.1133,7.7114,8.2208,7.3254,8.2265)" + }, + { + "content": "Go", + "span": { + "offset": 10360, + "length": 2 + }, + "confidence": 0.994, + "source": "D(2,0.4882,8.2975,0.6245,8.2977,0.6252,8.4159,0.489,8.4157)" + }, + { + "content": "to", + "span": { + "offset": 10363, + "length": 2 + }, + "confidence": 0.994, + "source": "D(2,0.6442,8.2978,0.7331,8.2979,0.7338,8.4161,0.645,8.4159)" + }, + { + "content": "www.irs.gov/Form1040", + "span": { + "offset": 10366, + "length": 20 + }, + "confidence": 0.308, + "source": "D(2,0.7568,8.2979,1.7741,8.2986,1.7746,8.4168,0.7575,8.4161)" + }, + { + "content": "for", + "span": { + "offset": 10387, + "length": 3 + }, + "confidence": 0.966, + "source": "D(2,1.7958,8.2986,1.9223,8.2984,1.9227,8.4166,1.7963,8.4168)" + }, + { + "content": "instructions", + "span": { + "offset": 10391, + "length": 12 + }, + "confidence": 0.964, + "source": "D(2,1.946,8.2984,2.4477,8.2976,2.448,8.4157,1.9464,8.4165)" + }, + { + "content": "and", + "span": { + "offset": 10404, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,2.4714,8.2975,2.6353,8.2971,2.6356,8.4153,2.4717,8.4157)" + }, + { + "content": "the", + "span": { + "offset": 10408, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,2.663,8.297,2.8052,8.2964,2.8054,8.4145,2.6632,8.4152)" + }, + { + "content": "latest", + "span": { + "offset": 10412, + "length": 6 + }, + "confidence": 0.977, + "source": "D(2,2.8309,8.2962,3.0679,8.2952,3.0681,8.4133,2.8311,8.4144)" + }, + { + "content": "information", + "span": { + "offset": 10419, + "length": 11 + }, + "confidence": 0.954, + "source": "D(2,3.0956,8.2951,3.5815,8.2929,3.5815,8.411,3.0957,8.4132)" + }, + { + "content": ".", + "span": { + "offset": 10430, + "length": 1 + }, + "confidence": 0.988, + "source": "D(2,3.5874,8.2928,3.6171,8.2927,3.6171,8.4109,3.5874,8.411)" + }, + { + "content": "Form", + "span": { + "offset": 10454, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,7.2175,8.2983,7.4186,8.2983,7.4186,8.4165,7.2175,8.4165)" + }, + { + "content": "1040", + "span": { + "offset": 10459, + "length": 4 + }, + "confidence": 0.989, + "source": "D(2,7.462,8.2983,7.7281,8.2983,7.7281,8.4165,7.462,8.4165)" + }, + { + "content": "(", + "span": { + "offset": 10464, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.7557,8.2983,7.7912,8.2983,7.7912,8.4165,7.7557,8.4165)" + }, + { + "content": "2020", + "span": { + "offset": 10465, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,7.7794,8.2983,7.9765,8.2983,7.9765,8.4165,7.7794,8.4165)" + }, + { + "content": ")", + "span": { + "offset": 10469, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.9647,8.2983,8.0061,8.2983,8.0061,8.4165,7.9647,8.4165)" + } + ], + "lines": [ + { + "content": "Page 2", + "source": "D(2,7.6593,0.3454,7.9937,0.3394,7.996,0.4707,7.6616,0.4761)", + "span": { + "offset": 5376, + "length": 6 + } + }, + { + "content": "Form 1040 (2020)", + "source": "D(2,0.4885,0.344,1.2669,0.3479,1.2663,0.4637,0.4879,0.4598)", + "span": { + "offset": 5405, + "length": 16 + } + }, + { + "content": "16", + "source": "D(2,1.27,0.545,1.4039,0.545,1.4039,0.6479,1.27,0.6479)", + "span": { + "offset": 5481, + "length": 2 + } + }, + { + "content": "Tax (see instructions). Check if any from Form(s): 1", + "source": "D(2,1.5823,0.5346,4.0591,0.535,4.0591,0.6671,1.5823,0.6667)", + "span": { + "offset": 5484, + "length": 52 + } + }, + { + "content": "☐", + "source": "D(2,4.1213,0.5358,4.2417,0.5334,4.2417,0.659,4.1213,0.663)", + "span": { + "offset": 5537, + "length": 1 + } + }, + { + "content": "8814", + "source": "D(2,4.2954,0.5447,4.5488,0.5442,4.5488,0.6481,4.2957,0.6487)", + "span": { + "offset": 5539, + "length": 4 + } + }, + { + "content": "2", + "source": "D(2,4.6899,0.5513,4.7605,0.5513,4.7605,0.647,4.6899,0.647)", + "span": { + "offset": 5544, + "length": 1 + } + }, + { + "content": "☑", + "source": "D(2,4.8269,0.5351,4.9431,0.5354,4.9431,0.659,4.8269,0.6586)", + "span": { + "offset": 5546, + "length": 1 + } + }, + { + "content": "4972", + "source": "D(2,4.9888,0.544,5.2503,0.5441,5.2502,0.6483,4.9887,0.6483)", + "span": { + "offset": 5548, + "length": 4 + } + }, + { + "content": "3", + "source": "D(2,5.4038,0.5519,5.4619,0.5519,5.4619,0.6439,5.4038,0.6439)", + "span": { + "offset": 5553, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(2,5.5242,0.5358,5.6487,0.5344,5.6487,0.6583,5.5242,0.661)", + "span": { + "offset": 5555, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.3414,0.6281,6.3522,0.6281,6.3522,0.6389,6.3414,0.6389)", + "span": { + "offset": 5557, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.5081,0.6281,6.5189,0.6281,6.5189,0.6389,6.5081,0.6389)", + "span": { + "offset": 5559, + "length": 1 + } + }, + { + "content": "16", + "source": "D(2,6.79,0.5471,6.9062,0.5471,6.9062,0.6465,6.79,0.6465)", + "span": { + "offset": 5570, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,7.7861,0.5336,7.9687,0.5335,7.9687,0.6349,7.7861,0.6351)", + "span": { + "offset": 5582, + "length": 3 + } + }, + { + "content": "17", + "source": "D(2,1.2721,0.7127,1.4039,0.7127,1.4039,0.8144,1.2721,0.8144)", + "span": { + "offset": 5618, + "length": 2 + } + }, + { + "content": "Amount from Schedule 2, line 3", + "source": "D(2,1.5823,0.702,3.1627,0.7033,3.1626,0.8268,1.5822,0.8256)", + "span": { + "offset": 5621, + "length": 30 + } + }, + { + "content": "17", + "source": "D(2,6.79,0.7126,6.9062,0.7126,6.9062,0.8111,6.79,0.8111)", + "span": { + "offset": 5661, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,7.7861,0.7001,7.9651,0.701,7.9646,0.8012,7.7861,0.8003)", + "span": { + "offset": 5673, + "length": 3 + } + }, + { + "content": "18", + "source": "D(2,1.2738,0.8801,1.4039,0.8795,1.4043,0.9786,1.2742,0.9792)", + "span": { + "offset": 5709, + "length": 2 + } + }, + { + "content": "Add lines 16 and 17", + "source": "D(2,1.5823,0.8698,2.592,0.8704,2.5919,0.9868,1.5823,0.9862)", + "span": { + "offset": 5712, + "length": 19 + } + }, + { + "content": "18", + "source": "D(2,6.79,0.8778,6.9062,0.8778,6.9062,0.9786,6.79,0.9786)", + "span": { + "offset": 5741, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,7.7861,0.8632,7.9672,0.8678,7.9646,0.9696,7.7861,0.965)", + "span": { + "offset": 5753, + "length": 3 + } + }, + { + "content": "19", + "source": "D(2,1.2729,1.046,1.4018,1.0444,1.4031,1.1441,1.2742,1.1457)", + "span": { + "offset": 5789, + "length": 2 + } + }, + { + "content": "Child tax credit or credit for other dependents", + "source": "D(2,1.5823,1.0333,3.8747,1.0385,3.8744,1.1607,1.5821,1.1555)", + "span": { + "offset": 5792, + "length": 47 + } + }, + { + "content": "19", + "source": "D(2,6.79,1.0422,6.9062,1.0422,6.9062,1.143,6.79,1.143)", + "span": { + "offset": 5849, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,7.7861,1.0312,7.9687,1.0312,7.9687,1.1347,7.7861,1.1347)", + "span": { + "offset": 5861, + "length": 3 + } + }, + { + "content": "20", + "source": "D(2,1.2669,1.2083,1.4018,1.2083,1.4018,1.3119,1.2669,1.3119)", + "span": { + "offset": 5897, + "length": 2 + } + }, + { + "content": "Amount from Schedule 3, line 7", + "source": "D(2,1.5792,1.1987,3.1626,1.1987,3.1626,1.3202,1.5792,1.3202)", + "span": { + "offset": 5900, + "length": 30 + } + }, + { + "content": "20", + "source": "D(2,6.7776,1.2079,6.9152,1.2088,6.9146,1.3088,6.777,1.308)", + "span": { + "offset": 5940, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,7.7862,1.1972,7.9687,1.1984,7.9687,1.3051,7.7861,1.3039)", + "span": { + "offset": 5952, + "length": 3 + } + }, + { + "content": "21", + "source": "D(2,1.2669,1.3757,1.3964,1.3767,1.3956,1.4811,1.2661,1.4801)", + "span": { + "offset": 5988, + "length": 2 + } + }, + { + "content": "Add lines 19 and 20", + "source": "D(2,1.5822,1.3688,2.5919,1.3678,2.592,1.4861,1.5823,1.487)", + "span": { + "offset": 5991, + "length": 19 + } + }, + { + "content": "21", + "source": "D(2,6.7776,1.3764,6.8984,1.3769,6.8979,1.4775,6.7771,1.477)", + "span": { + "offset": 6020, + "length": 2 + } + }, + { + "content": "110", + "source": "D(2,7.7861,1.3653,7.9687,1.3655,7.9687,1.468,7.7861,1.4678)", + "span": { + "offset": 6032, + "length": 3 + } + }, + { + "content": "22", + "source": "D(2,1.2679,1.5408,1.4091,1.5424,1.408,1.6439,1.2673,1.6423)", + "span": { + "offset": 6068, + "length": 2 + } + }, + { + "content": "Subtract line 21 from line 18. If zero or less, enter -0-", + "source": "D(2,1.5803,1.5344,4.2085,1.5344,4.2085,1.6568,1.5803,1.6568)", + "span": { + "offset": 6071, + "length": 57 + } + }, + { + "content": "22", + "source": "D(2,6.7776,1.5405,6.9173,1.5456,6.9146,1.6462,6.774,1.6411)", + "span": { + "offset": 6138, + "length": 2 + } + }, + { + "content": "1100", + "source": "D(2,7.7239,1.528,7.965,1.529,7.9646,1.6329,7.7235,1.632)", + "span": { + "offset": 6150, + "length": 4 + } + }, + { + "content": "23", + "source": "D(2,1.27,1.709,1.408,1.709,1.408,1.8111,1.27,1.8111)", + "span": { + "offset": 6187, + "length": 2 + } + }, + { + "content": "Other taxes, including self-employment tax, from Schedule 2, line 10", + "source": "D(2,1.5865,1.7014,5.0012,1.7007,5.0012,1.8265,1.5865,1.8272)", + "span": { + "offset": 6190, + "length": 68 + } + }, + { + "content": "23", + "source": "D(2,6.7776,1.7105,6.9062,1.7105,6.9062,1.8096,6.7776,1.8096)", + "span": { + "offset": 6268, + "length": 2 + } + }, + { + "content": "110", + "source": "D(2,7.7861,1.6972,7.9687,1.694,7.9687,1.796,7.7861,1.8004)", + "span": { + "offset": 6280, + "length": 3 + } + }, + { + "content": "24", + "source": "D(2,1.2702,1.8737,1.4106,1.88,1.4059,1.9847,1.2673,1.9784)", + "span": { + "offset": 6316, + "length": 2 + } + }, + { + "content": "Add lines 22 and 23. This is your total tax", + "source": "D(2,1.5792,1.869,3.6814,1.8699,3.6814,1.9971,1.5792,1.9962)", + "span": { + "offset": 6319, + "length": 43 + } + }, + { + "content": "24", + "source": "D(2,6.7776,1.8785,6.9173,1.8825,6.9145,1.9805,6.7748,1.9765)", + "span": { + "offset": 6372, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,7.7862,1.8664,7.9687,1.8708,7.9687,1.9747,7.7861,1.9703)", + "span": { + "offset": 6384, + "length": 3 + } + }, + { + "content": "25", + "source": "D(2,1.2677,2.0433,1.408,2.0429,1.4083,2.146,1.268,2.1464)", + "span": { + "offset": 6420, + "length": 2 + } + }, + { + "content": "Federal income tax withheld from:", + "source": "D(2,1.5865,2.0404,3.2871,2.0405,3.2871,2.1585,1.5865,2.1585)", + "span": { + "offset": 6423, + "length": 33 + } + }, + { + "content": "300", + "source": "D(2,7.7778,2.6944,7.9687,2.6959,7.9687,2.8052,7.777,2.8037)", + "span": { + "offset": 6500, + "length": 3 + } + }, + { + "content": "a", + "source": "D(2,1.3904,2.2328,1.4641,2.2328,1.4641,2.32,1.3904,2.32)", + "span": { + "offset": 6524, + "length": 1 + } + }, + { + "content": "Form(s) W-2", + "source": "D(2,1.5885,2.207,2.2142,2.2068,2.2143,2.3314,1.5886,2.3316)", + "span": { + "offset": 6526, + "length": 11 + } + }, + { + "content": "25a", + "source": "D(2,5.4411,2.2178,5.6445,2.2177,5.6445,2.3178,5.4412,2.318)", + "span": { + "offset": 6547, + "length": 3 + } + }, + { + "content": "100", + "source": "D(2,6.4871,2.1995,6.6655,2.1995,6.6655,2.3015,6.4871,2.3015)", + "span": { + "offset": 6560, + "length": 3 + } + }, + { + "content": "b", + "source": "D(2,1.3893,2.3835,1.4641,2.3835,1.4641,2.4798,1.3893,2.4798)", + "span": { + "offset": 6584, + "length": 1 + } + }, + { + "content": "Form(s) 1099", + "source": "D(2,1.5875,2.3727,2.2495,2.3727,2.2495,2.4977,1.5875,2.4977)", + "span": { + "offset": 6586, + "length": 12 + } + }, + { + "content": "25b", + "source": "D(2,5.4404,2.3769,5.6445,2.3753,5.6445,2.4775,5.4412,2.4791)", + "span": { + "offset": 6608, + "length": 3 + } + }, + { + "content": "100", + "source": "D(2,6.4871,2.3673,6.6655,2.3673,6.6655,2.4724,6.4871,2.4724)", + "span": { + "offset": 6621, + "length": 3 + } + }, + { + "content": "c", + "source": "D(2,1.4042,2.5759,1.4609,2.5759,1.4609,2.6363,1.4042,2.6363)", + "span": { + "offset": 6645, + "length": 1 + } + }, + { + "content": "Other forms (see instructions)", + "source": "D(2,1.5865,2.5361,3.0631,2.5369,3.063,2.6637,1.5864,2.6629)", + "span": { + "offset": 6647, + "length": 30 + } + }, + { + "content": "25c", + "source": "D(2,5.4453,2.5446,5.6445,2.5472,5.6445,2.6483,5.4453,2.6457)", + "span": { + "offset": 6687, + "length": 3 + } + }, + { + "content": "100", + "source": "D(2,6.4869,2.5266,6.6738,2.5263,6.6738,2.6304,6.4871,2.6307)", + "span": { + "offset": 6700, + "length": 3 + } + }, + { + "content": "d", + "source": "D(2,1.3945,2.7151,1.4692,2.7151,1.4692,2.8118,1.3945,2.8118)", + "span": { + "offset": 6736, + "length": 1 + } + }, + { + "content": "Add lines 25a through 25c", + "source": "D(2,1.5792,2.6999,2.9097,2.7028,2.9094,2.8323,1.5789,2.8294)", + "span": { + "offset": 6738, + "length": 25 + } + }, + { + "content": "25d", + "source": "D(2,6.7361,2.7064,6.955,2.7131,6.9519,2.8157,6.7347,2.809)", + "span": { + "offset": 6773, + "length": 3 + } + }, + { + "content": ". If you have a", + "source": "D(2,0.455,2.9315,1.0444,2.9352,1.0438,3.0337,0.4544,3.0318)", + "span": { + "offset": 6809, + "length": 15 + } + }, + { + "content": "qualifying child,", + "source": "D(2,0.5165,3.0347,1.1507,3.0347,1.1507,3.1313,0.5165,3.1313)", + "span": { + "offset": 6825, + "length": 17 + } + }, + { + "content": "attach Sch. EIC.", + "source": "D(2,0.5136,3.1287,1.1631,3.1287,1.1631,3.2248,0.5136,3.2248)", + "span": { + "offset": 6843, + "length": 16 + } + }, + { + "content": ". If you have", + "source": "D(2,0.4586,3.252,0.9695,3.2572,0.9686,3.3495,0.4577,3.3442)", + "span": { + "offset": 6860, + "length": 13 + } + }, + { + "content": "nontaxable", + "source": "D(2,0.5156,3.3521,0.9722,3.3478,0.9731,3.4404,0.5165,3.4434)", + "span": { + "offset": 6874, + "length": 10 + } + }, + { + "content": "combat pay,", + "source": "D(2,0.5149,3.4514,1.0231,3.4532,1.0227,3.5512,0.5146,3.5495)", + "span": { + "offset": 6885, + "length": 11 + } + }, + { + "content": "see instructions.", + "source": "D(2,0.5126,3.552,1.1813,3.5555,1.1808,3.6488,0.5121,3.6454)", + "span": { + "offset": 6897, + "length": 17 + } + }, + { + "content": "26", + "source": "D(2,1.2659,2.8762,1.4039,2.8762,1.4039,2.9836,1.2659,2.9836)", + "span": { + "offset": 6936, + "length": 2 + } + }, + { + "content": "2020 estimated tax payments and amount applied from 2019 return", + "source": "D(2,1.5865,2.8691,4.9639,2.8691,4.9639,2.9983,1.5865,2.9983)", + "span": { + "offset": 6939, + "length": 63 + } + }, + { + "content": "26", + "source": "D(2,6.7776,2.8774,6.9062,2.8781,6.9062,2.9794,6.7771,2.9788)", + "span": { + "offset": 7012, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,7.7861,2.8573,7.9687,2.8689,7.9686,2.9783,7.7861,2.9666)", + "span": { + "offset": 7024, + "length": 3 + } + }, + { + "content": "27", + "source": "D(2,1.2659,3.0444,1.4045,3.0453,1.4039,3.148,1.2652,3.1471)", + "span": { + "offset": 7048, + "length": 2 + } + }, + { + "content": "Earned income credit (EIC)", + "source": "D(2,1.5894,3.0351,2.9364,3.0327,2.9366,3.1625,1.5896,3.1649)", + "span": { + "offset": 7051, + "length": 26 + } + }, + { + "content": "27", + "source": "D(2,5.4736,3.0451,5.6155,3.044,5.6163,3.1443,5.4744,3.1454)", + "span": { + "offset": 7087, + "length": 2 + } + }, + { + "content": "200", + "source": "D(2,6.4663,3.0308,6.6659,3.0317,6.6655,3.1345,6.4659,3.1337)", + "span": { + "offset": 7099, + "length": 3 + } + }, + { + "content": "1600", + "source": "D(2,7.7239,3.8645,7.9646,3.8645,7.9646,3.9666,7.7239,3.9666)", + "span": { + "offset": 7134, + "length": 4 + } + }, + { + "content": "28", + "source": "D(2,1.2669,3.2085,1.4039,3.2085,1.4039,3.3086,1.2669,3.3086)", + "span": { + "offset": 7159, + "length": 2 + } + }, + { + "content": "Additional child tax credit. Attach Schedule 8812", + "source": "D(2,1.5843,3.2001,4.0217,3.1975,4.0219,3.3185,1.5844,3.3212)", + "span": { + "offset": 7162, + "length": 49 + } + }, + { + "content": "28", + "source": "D(2,5.4744,3.2099,5.6155,3.2099,5.6155,3.3086,5.4744,3.3086)", + "span": { + "offset": 7221, + "length": 2 + } + }, + { + "content": "300", + "source": "D(2,6.4746,3.1931,6.6655,3.1931,6.6655,3.3005,6.4746,3.3005)", + "span": { + "offset": 7233, + "length": 3 + } + }, + { + "content": "29", + "source": "D(2,1.267,3.3736,1.4056,3.3776,1.4039,3.4827,1.264,3.4788)", + "span": { + "offset": 7279, + "length": 2 + } + }, + { + "content": "American opportunity credit from Form 8863, line 8", + "source": "D(2,1.5821,3.3667,4.1525,3.3619,4.1527,3.4914,1.5823,3.4963)", + "span": { + "offset": 7282, + "length": 50 + } + }, + { + "content": "29", + "source": "D(2,5.4744,3.3757,5.6155,3.3757,5.6155,3.4778,5.4744,3.4778)", + "span": { + "offset": 7342, + "length": 2 + } + }, + { + "content": "400", + "source": "D(2,6.47,3.368,6.6655,3.3671,6.666,3.4701,6.4705,3.471)", + "span": { + "offset": 7354, + "length": 3 + } + }, + { + "content": "30", + "source": "D(2,1.2669,3.55,1.4039,3.55,1.4039,3.6525,1.2669,3.6525)", + "span": { + "offset": 7378, + "length": 2 + } + }, + { + "content": "Recovery rebate credit. See instructions", + "source": "D(2,1.5893,3.5395,3.5901,3.5375,3.5903,3.6628,1.5896,3.6671)", + "span": { + "offset": 7381, + "length": 40 + } + }, + { + "content": "30", + "source": "D(2,5.4827,3.5503,5.6155,3.5503,5.6155,3.647,5.4827,3.647)", + "span": { + "offset": 7431, + "length": 2 + } + }, + { + "content": "500", + "source": "D(2,6.4746,3.5353,6.6664,3.5369,6.6655,3.6398,6.4746,3.6383)", + "span": { + "offset": 7443, + "length": 3 + } + }, + { + "content": "31", + "source": "D(2,1.2649,3.7201,1.3956,3.7175,1.3976,3.8209,1.2669,3.8235)", + "span": { + "offset": 7467, + "length": 2 + } + }, + { + "content": "Amount from Schedule 3, line 13", + "source": "D(2,1.5865,3.7077,3.229,3.7077,3.229,3.8315,1.5865,3.8315)", + "span": { + "offset": 7470, + "length": 31 + } + }, + { + "content": "31", + "source": "D(2,5.4734,3.7162,5.603,3.7149,5.604,3.8185,5.4744,3.8197)", + "span": { + "offset": 7511, + "length": 2 + } + }, + { + "content": "200", + "source": "D(2,6.4663,3.6933,6.6683,3.7,6.6655,3.8031,6.4635,3.7964)", + "span": { + "offset": 7523, + "length": 3 + } + }, + { + "content": "32", + "source": "D(2,1.2679,3.8752,1.4039,3.8752,1.4039,3.9773,1.2679,3.9773)", + "span": { + "offset": 7559, + "length": 2 + } + }, + { + "content": "Add lines 27 through 31. These are your total other payments and refundable credits", + "source": "D(2,1.5813,3.8614,5.9434,3.8661,5.9433,3.9956,1.5812,3.991)", + "span": { + "offset": 7562, + "length": 83 + } + }, + { + "content": "32", + "source": "D(2,6.7776,3.8745,6.9146,3.8745,6.9146,3.9773,6.7776,3.9773)", + "span": { + "offset": 7655, + "length": 2 + } + }, + { + "content": "33", + "source": "D(2,1.2669,4.0349,1.4056,4.0425,1.4028,4.1457,1.2617,4.1381)", + "span": { + "offset": 7690, + "length": 2 + } + }, + { + "content": "Add lines 25d, 26, and 32. These are your total payments", + "source": "D(2,1.5813,4.0283,4.4907,4.0283,4.4907,4.1572,1.5813,4.1572)", + "span": { + "offset": 7693, + "length": 56 + } + }, + { + "content": "33", + "source": "D(2,6.7776,4.0411,6.9146,4.0411,6.9146,4.1438,6.7776,4.1438)", + "span": { + "offset": 7759, + "length": 2 + } + }, + { + "content": "2000", + "source": "D(2,7.7156,4.0337,7.9646,4.0337,7.9646,4.1411,7.7156,4.1411)", + "span": { + "offset": 7771, + "length": 4 + } + }, + { + "content": "Refund", + "source": "D(2,0.4918,4.247,0.9836,4.247,0.9836,4.3774,0.4918,4.3774)", + "span": { + "offset": 7808, + "length": 6 + } + }, + { + "content": "Direct deposit?", + "source": "D(2,0.4903,4.5278,1.1434,4.5217,1.1445,4.6354,0.4913,4.6414)", + "span": { + "offset": 7815, + "length": 15 + } + }, + { + "content": "See instructions.", + "source": "D(2,0.49,4.6509,1.2032,4.6554,1.2026,4.7603,0.4893,4.7558)", + "span": { + "offset": 7831, + "length": 17 + } + }, + { + "content": "34", + "source": "D(2,1.2648,4.202,1.4111,4.2193,1.408,4.3209,1.2617,4.3036)", + "span": { + "offset": 7870, + "length": 2 + } + }, + { + "content": "If line 33 is more than line 24, subtract line 24 from line 33. This is the amount you overpaid", + "source": "D(2,1.5813,4.2019,6.1468,4.2051,6.1467,4.3327,1.5812,4.3295)", + "span": { + "offset": 7873, + "length": 95 + } + }, + { + "content": ".", + "source": "D(2,6.3426,4.2892,6.3549,4.2892,6.3549,4.3016,6.3426,4.3016)", + "span": { + "offset": 7969, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.5092,4.2892,6.5216,4.2892,6.5216,4.3016,6.5092,4.3016)", + "span": { + "offset": 7971, + "length": 1 + } + }, + { + "content": "34", + "source": "D(2,6.7773,4.2139,6.9145,4.2135,6.9148,4.3204,6.7776,4.3207)", + "span": { + "offset": 7982, + "length": 2 + } + }, + { + "content": "200", + "source": "D(2,7.7861,4.2029,7.9646,4.2029,7.9646,4.3049,7.7861,4.3049)", + "span": { + "offset": 7994, + "length": 3 + } + }, + { + "content": "35a", + "source": "D(2,1.269,4.3774,1.4641,4.3774,1.4641,4.4795,1.269,4.4795)", + "span": { + "offset": 8030, + "length": 3 + } + }, + { + "content": "a Amount of line 34 you want refunded to you. If Form 8888 is attached, check here", + "source": "D(2,1.3759,4.3729,5.7027,4.3739,5.7026,4.4924,1.3758,4.4913)", + "span": { + "offset": 8034, + "length": 82 + } + }, + { + "content": "☐", + "source": "D(2,6.458,4.364,6.5742,4.364,6.5742,4.4822,6.458,4.4822)", + "span": { + "offset": 8117, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.8426,4.4559,5.855,4.4559,5.855,4.4682,5.8426,4.4682)", + "span": { + "offset": 8119, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.0093,4.4559,6.0216,4.4559,6.0216,4.4682,6.0093,4.4682)", + "span": { + "offset": 8121, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.176,4.4559,6.1883,4.4559,6.1883,4.4682,6.176,4.4682)", + "span": { + "offset": 8123, + "length": 1 + } + }, + { + "content": "35a", + "source": "D(2,6.7485,4.3774,6.9478,4.3774,6.9478,4.4768,6.7485,4.4768)", + "span": { + "offset": 8134, + "length": 3 + } + }, + { + "content": "300", + "source": "D(2,7.7778,4.3612,7.9649,4.3618,7.9646,4.4692,7.7775,4.4687)", + "span": { + "offset": 8147, + "length": 3 + } + }, + { + "content": "b Routing number", + "source": "D(2,1.2918,4.5371,2.3639,4.5391,2.3636,4.6641,1.2916,4.662)", + "span": { + "offset": 8183, + "length": 16 + } + }, + { + "content": "520555555", + "source": "D(2,2.401,4.5037,4.2002,4.5037,4.2002,4.6517,2.401,4.6517)", + "span": { + "offset": 8200, + "length": 9 + } + }, + { + "content": "c Type:", + "source": "D(2,4.607,4.5395,5.0908,4.5487,5.0884,4.6685,4.6045,4.6586)", + "span": { + "offset": 8210, + "length": 7 + } + }, + { + "content": "☑", + "source": "D(2,5.2336,4.5386,5.3582,4.5359,5.3582,4.6567,5.2336,4.6594)", + "span": { + "offset": 8218, + "length": 1 + } + }, + { + "content": "Checking", + "source": "D(2,5.3914,4.5404,5.8738,4.5446,5.8728,4.6608,5.3904,4.6566)", + "span": { + "offset": 8220, + "length": 8 + } + }, + { + "content": "☐", + "source": "D(2,6.0347,4.5359,6.1633,4.5359,6.1633,4.6594,6.0347,4.6567)", + "span": { + "offset": 8229, + "length": 1 + } + }, + { + "content": "Savings", + "source": "D(2,6.1924,4.5401,6.5952,4.541,6.595,4.6604,6.1924,4.6595)", + "span": { + "offset": 8231, + "length": 7 + } + }, + { + "content": "d Account number", + "source": "D(2,1.2918,4.704,2.366,4.7071,2.3657,4.8218,1.2915,4.8192)", + "span": { + "offset": 8315, + "length": 16 + } + }, + { + "content": "12333365478901200", + "source": "D(2,2.3969,4.6525,5.8027,4.6629,5.8022,4.8384,2.3963,4.8307)", + "span": { + "offset": 8332, + "length": 17 + } + }, + { + "content": "36", + "source": "D(2,1.2679,4.8703,1.4046,4.8713,1.4039,4.9742,1.2673,4.9732)", + "span": { + "offset": 8370, + "length": 2 + } + }, + { + "content": "6 Amount of line 34 you want applied to your 2021 estimated tax", + "source": "D(2,1.3115,4.8616,4.8103,4.8598,4.8104,4.9862,1.3115,4.9879)", + "span": { + "offset": 8373, + "length": 63 + } + }, + { + "content": "36", + "source": "D(2,5.4744,4.8689,5.6238,4.8689,5.6238,4.9763,5.4744,4.9763)", + "span": { + "offset": 8446, + "length": 2 + } + }, + { + "content": "1200", + "source": "D(2,6.4207,4.8674,6.6668,4.8705,6.6655,4.9756,6.4193,4.9726)", + "span": { + "offset": 8458, + "length": 4 + } + }, + { + "content": "Amount", + "source": "D(2,0.491,5.0408,1.0288,5.0408,1.0288,5.1646,0.491,5.1646)", + "span": { + "offset": 8495, + "length": 6 + } + }, + { + "content": "You Owe", + "source": "D(2,0.4926,5.1804,1.1009,5.1804,1.1009,5.3067,0.4926,5.3067)", + "span": { + "offset": 8502, + "length": 7 + } + }, + { + "content": "For details on", + "source": "D(2,0.4911,5.3408,1.0957,5.332,1.0957,5.4412,0.4927,5.4474)", + "span": { + "offset": 8510, + "length": 14 + } + }, + { + "content": "how to pay, see", + "source": "D(2,0.49,5.4478,1.1953,5.4486,1.1953,5.5488,0.4899,5.548)", + "span": { + "offset": 8525, + "length": 15 + } + }, + { + "content": "instructions.", + "source": "D(2,0.4911,5.5465,1.0303,5.5395,1.0316,5.6362,0.4923,5.6431)", + "span": { + "offset": 8541, + "length": 13 + } + }, + { + "content": "37", + "source": "D(2,1.2679,5.0596,1.4008,5.0596,1.4008,5.1616,1.2679,5.1616)", + "span": { + "offset": 8576, + "length": 2 + } + }, + { + "content": "Subtract line 33 from line 24. This is the amount you owe now", + "source": "D(2,1.5875,5.0563,4.7358,5.0605,4.7356,5.1872,1.5874,5.183)", + "span": { + "offset": 8579, + "length": 61 + } + }, + { + "content": ".", + "source": "D(2,5.0092,5.1424,5.0216,5.1424,5.0216,5.1547,5.0092,5.1547)", + "span": { + "offset": 8641, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.1759,5.1424,5.1882,5.1424,5.1882,5.1547,5.1759,5.1547)", + "span": { + "offset": 8643, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.3426,5.1424,5.3549,5.1424,5.3549,5.1547,5.3426,5.1547)", + "span": { + "offset": 8645, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.5092,5.1424,5.5216,5.1424,5.5216,5.1547,5.5092,5.1547)", + "span": { + "offset": 8647, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.6759,5.1424,5.6882,5.1424,5.6882,5.1547,5.6759,5.1547)", + "span": { + "offset": 8649, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.8426,5.1424,5.8549,5.1424,5.8549,5.1547,5.8426,5.1547)", + "span": { + "offset": 8651, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.0092,5.1424,6.0216,5.1424,6.0216,5.1547,6.0092,5.1547)", + "span": { + "offset": 8653, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.1759,5.1424,6.1882,5.1424,6.1882,5.1547,6.1759,5.1547)", + "span": { + "offset": 8655, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.3426,5.1424,6.3549,5.1424,6.3549,5.1547,6.3426,5.1547)", + "span": { + "offset": 8657, + "length": 1 + } + }, + { + "content": "37", + "source": "D(2,6.7776,5.0406,6.9062,5.0406,6.9062,5.1428,6.7776,5.1428)", + "span": { + "offset": 8668, + "length": 2 + } + }, + { + "content": "230", + "source": "D(2,7.7861,5.0328,7.9646,5.0315,7.9654,5.1386,7.7861,5.1399)", + "span": { + "offset": 8680, + "length": 3 + } + }, + { + "content": "Note: Schedule H and Schedule SE filers, line 37 may not represent all of the taxes you owe for", + "source": "D(2,1.5875,5.2271,6.6037,5.2428,6.6033,5.3699,1.5871,5.3553)", + "span": { + "offset": 8716, + "length": 95 + } + }, + { + "content": "2020. See Schedule 3, line 12e, and its instructions for details.", + "source": "D(2,1.5865,5.3717,4.6899,5.3717,4.6899,5.4973,1.5865,5.4973)", + "span": { + "offset": 8888, + "length": 65 + } + }, + { + "content": "38", + "source": "D(2,1.2698,5.536,1.4039,5.5357,1.4041,5.6464,1.27,5.6467)", + "span": { + "offset": 8974, + "length": 2 + } + }, + { + "content": "Estimated tax penalty (see instructions)", + "source": "D(2,1.5886,5.5304,3.5404,5.5325,3.5403,5.6616,1.5884,5.6595)", + "span": { + "offset": 8977, + "length": 40 + } + }, + { + "content": "38", + "source": "D(2,5.4827,5.543,5.6155,5.543,5.6155,5.6464,5.4827,5.6464)", + "span": { + "offset": 9027, + "length": 2 + } + }, + { + "content": "231", + "source": "D(2,6.4663,5.5322,6.6531,5.5322,6.6531,5.6397,6.4663,5.6397)", + "span": { + "offset": 9039, + "length": 3 + } + }, + { + "content": "Third Party", + "source": "D(2,0.4929,5.7031,1.2079,5.7146,1.2056,5.8626,0.4925,5.8514)", + "span": { + "offset": 9067, + "length": 11 + } + }, + { + "content": "Designee", + "source": "D(2,0.4934,5.8545,1.1009,5.8545,1.1009,5.9941,0.4934,5.9941)", + "span": { + "offset": 9079, + "length": 8 + } + }, + { + "content": "Do you want to allow another person to discuss this return with the IRS? See", + "source": "D(2,1.3892,5.7089,5.6072,5.7043,5.6073,5.8257,1.3893,5.8294)", + "span": { + "offset": 9089, + "length": 76 + } + }, + { + "content": "instructions", + "source": "D(2,1.3873,5.8491,1.9797,5.8491,1.9797,5.9565,1.3873,5.9565)", + "span": { + "offset": 9166, + "length": 12 + } + }, + { + "content": "☑", + "source": "D(2,5.6902,5.8223,5.8105,5.8223,5.8105,5.9512,5.6902,5.9512)", + "span": { + "offset": 9180, + "length": 1 + } + }, + { + "content": "Yes. Complete below.", + "source": "D(2,5.8396,5.8438,6.9519,5.8438,6.9519,5.9619,5.8396,5.9619)", + "span": { + "offset": 9182, + "length": 20 + } + }, + { + "content": "☐", + "source": "D(2,7.093,5.8384,7.2175,5.8384,7.2175,5.9673,7.093,5.9673)", + "span": { + "offset": 9203, + "length": 1 + } + }, + { + "content": "No", + "source": "D(2,7.2466,5.8491,7.396,5.8491,7.396,5.9565,7.2466,5.9565)", + "span": { + "offset": 9205, + "length": 2 + } + }, + { + "content": "Designee's", + "source": "D(2,1.3912,6.0132,1.8843,6.0125,1.8844,6.1207,1.3914,6.1215)", + "span": { + "offset": 9209, + "length": 10 + } + }, + { + "content": "name", + "source": "D(2,1.3861,6.1533,1.6456,6.1505,1.6467,6.2409,1.3873,6.2441)", + "span": { + "offset": 9220, + "length": 4 + } + }, + { + "content": "Joy Morgan", + "source": "D(2,2.4467,6.0642,2.9177,6.0642,2.9177,6.1768,2.4467,6.1768)", + "span": { + "offset": 9225, + "length": 10 + } + }, + { + "content": "Phone", + "source": "D(2,4.1878,6.0134,4.4824,6.0182,4.4824,6.1179,4.1862,6.1131)", + "span": { + "offset": 9237, + "length": 5 + } + }, + { + "content": "no.", + "source": "D(2,4.1919,6.1553,4.3372,6.1553,4.3372,6.2416,4.1919,6.2416)", + "span": { + "offset": 9243, + "length": 3 + } + }, + { + "content": "321875280", + "source": "D(2,4.7563,6.0785,5.1797,6.0791,5.1797,6.1797,4.7562,6.1791)", + "span": { + "offset": 9247, + "length": 9 + } + }, + { + "content": "Personal identification", + "source": "D(2,5.989,6.0098,6.9644,6.0098,6.9644,6.1162,5.989,6.1162)", + "span": { + "offset": 9258, + "length": 23 + } + }, + { + "content": "number (PIN)", + "source": "D(2,5.9849,6.1336,6.5659,6.1336,6.5659,6.2358,5.9849,6.2358)", + "span": { + "offset": 9282, + "length": 12 + } + }, + { + "content": "35480", + "source": "D(2,6.9967,6.0773,8.0019,6.073,8.002,6.2474,6.9976,6.2522)", + "span": { + "offset": 9295, + "length": 5 + } + }, + { + "content": "Sign", + "source": "D(2,0.487,6.3131,0.8543,6.3,0.8577,6.478,0.4895,6.4912)", + "span": { + "offset": 9306, + "length": 4 + } + }, + { + "content": "Here", + "source": "D(2,0.4922,6.4982,0.8816,6.4985,0.8814,6.6508,0.4921,6.6505)", + "span": { + "offset": 9311, + "length": 4 + } + }, + { + "content": "Under penalties of perjury, I declare that I have examined this return and accompanying schedules and statements, and to the best of my knowledge and", + "source": "D(2,1.3893,6.2942,8.0062,6.3017,8.0061,6.4273,1.3892,6.4202)", + "span": { + "offset": 9317, + "length": 149 + } + }, + { + "content": "belief, they are true, correct, and complete. Declaration of preparer (other than taxpayer) is based on all information of which preparer has any knowledge.", + "source": "D(2,1.3873,6.4238,7.9397,6.4238,7.9397,6.542,1.3873,6.542)", + "span": { + "offset": 9467, + "length": 156 + } + }, + { + "content": "Your signature", + "source": "D(2,1.3905,6.5994,2.0402,6.6063,2.0389,6.7258,1.3892,6.7189)", + "span": { + "offset": 9625, + "length": 14 + } + }, + { + "content": "Robert morgan", + "source": "D(2,2.4253,6.6842,3.3535,6.6896,3.3535,6.9466,2.4238,6.9412)", + "span": { + "offset": 9640, + "length": 13 + } + }, + { + "content": "Date", + "source": "D(2,3.8454,6.6044,4.0602,6.6062,4.0591,6.7041,3.8442,6.7015)", + "span": { + "offset": 9655, + "length": 4 + } + }, + { + "content": "12/10/1986", + "source": "D(2,3.8267,6.7783,4.4326,6.7783,4.4326,6.8965,3.8267,6.8965)", + "span": { + "offset": 9660, + "length": 10 + } + }, + { + "content": "Your occupation", + "source": "D(2,4.5488,6.6072,5.2793,6.5943,5.2793,6.7144,4.5489,6.7262)", + "span": { + "offset": 9672, + "length": 15 + } + }, + { + "content": "Judge", + "source": "D(2,4.8352,6.803,5.1779,6.8092,5.1755,6.9419,4.8328,6.9357)", + "span": { + "offset": 9688, + "length": 5 + } + }, + { + "content": "If the IRS sent you an Identity", + "source": "D(2,6.4414,6.5885,7.716,6.593,7.7156,6.7147,6.4414,6.7102)", + "span": { + "offset": 9695, + "length": 31 + } + }, + { + "content": "Protection PIN, enter it here", + "source": "D(2,6.4414,6.7139,7.6533,6.7139,7.6533,6.8213,6.4414,6.8213)", + "span": { + "offset": 9727, + "length": 29 + } + }, + { + "content": "(see inst.)", + "source": "D(2,6.4373,6.8481,6.8647,6.8481,6.8647,6.9556,6.4373,6.9556)", + "span": { + "offset": 9757, + "length": 11 + } + }, + { + "content": "520000", + "source": "D(2,6.9975,6.8262,7.9937,6.8258,7.9937,7.0005,6.9976,7.001)", + "span": { + "offset": 9769, + "length": 6 + } + }, + { + "content": "Joint return?", + "source": "D(2,0.4918,6.8803,1.0091,6.8803,1.0091,6.9838,0.4918,6.9838)", + "span": { + "offset": 9777, + "length": 13 + } + }, + { + "content": "See instructions.", + "source": "D(2,0.4885,7.0026,1.1725,6.9919,1.1732,7.1004,0.4903,7.1117)", + "span": { + "offset": 9791, + "length": 17 + } + }, + { + "content": "Keep a copy for", + "source": "D(2,0.4903,7.1221,1.1486,7.1221,1.1486,7.2295,0.4903,7.2295)", + "span": { + "offset": 9809, + "length": 15 + } + }, + { + "content": "your records.", + "source": "D(2,0.4838,7.2448,1.0324,7.24,1.0333,7.3453,0.4847,7.3501)", + "span": { + "offset": 9825, + "length": 13 + } + }, + { + "content": "Spouse's signature. If a joint return, both must sign.", + "source": "D(2,1.3862,7.0221,3.6565,7.0221,3.6565,7.1456,1.3862,7.1456)", + "span": { + "offset": 9840, + "length": 54 + } + }, + { + "content": "Date", + "source": "D(2,3.8453,7.0254,4.0591,7.0254,4.0591,7.1221,3.8453,7.1221)", + "span": { + "offset": 9896, + "length": 4 + } + }, + { + "content": "Spouse's occupation", + "source": "D(2,4.5405,7.0254,5.4785,7.0254,5.4785,7.1435,4.5405,7.1435)", + "span": { + "offset": 9902, + "length": 19 + } + }, + { + "content": "If the IRS sent your spouse an", + "source": "D(2,6.4414,7.0133,7.7493,7.0199,7.7488,7.1297,6.4414,7.123)", + "span": { + "offset": 9923, + "length": 30 + } + }, + { + "content": "Identity Protection PIN, enter it here", + "source": "D(2,6.4414,7.1285,8.0019,7.1253,8.002,7.2416,6.4414,7.2448)", + "span": { + "offset": 9954, + "length": 38 + } + }, + { + "content": "(see inst.)", + "source": "D(2,6.4414,7.2725,6.8647,7.2725,6.8647,7.3799,6.4414,7.3799)", + "span": { + "offset": 9993, + "length": 11 + } + }, + { + "content": "Phone no.", + "source": "D(2,1.3851,7.4489,1.8448,7.444,1.846,7.5545,1.3863,7.5594)", + "span": { + "offset": 10006, + "length": 9 + } + }, + { + "content": "00141386305445", + "source": "D(2,2.3823,7.439,3.2643,7.439,3.2643,7.5571,2.3823,7.5571)", + "span": { + "offset": 10016, + "length": 14 + } + }, + { + "content": "Email address robert99@gmail.com.us", + "source": "D(2,3.8453,7.4425,5.7939,7.4439,5.7939,7.5634,3.8453,7.5621)", + "span": { + "offset": 10032, + "length": 35 + } + }, + { + "content": "Paid", + "source": "D(2,0.4947,7.6669,0.828,7.6666,0.8281,7.8093,0.4948,7.8096)", + "span": { + "offset": 10072, + "length": 4 + } + }, + { + "content": "Preparer", + "source": "D(2,0.4936,7.8525,1.1445,7.8525,1.1445,8.0031,0.4936,8.0031)", + "span": { + "offset": 10077, + "length": 8 + } + }, + { + "content": "Use Only", + "source": "D(2,0.4958,8.0151,1.1611,8.0186,1.1602,8.1766,0.4949,8.1748)", + "span": { + "offset": 10086, + "length": 8 + } + }, + { + "content": "Preparer's name", + "source": "D(2,1.3873,7.6042,2.125,7.6072,2.1245,7.7247,1.3868,7.7218)", + "span": { + "offset": 10096, + "length": 15 + } + }, + { + "content": "Mark Kelly", + "source": "D(2,1.2877,7.7559,1.8625,7.7559,1.8625,7.8848,1.2877,7.8848)", + "span": { + "offset": 10112, + "length": 10 + } + }, + { + "content": "Preparer's signature", + "source": "D(2,3.0381,7.6096,3.9346,7.6171,3.9346,7.7362,3.0381,7.7286)", + "span": { + "offset": 10124, + "length": 20 + } + }, + { + "content": "mark Kelly", + "source": "D(2,4.2043,7.6133,4.9915,7.6283,4.9888,7.8907,4.2002,7.8757)", + "span": { + "offset": 10145, + "length": 10 + } + }, + { + "content": "Date", + "source": "D(2,5.4453,7.6153,5.6611,7.6185,5.6611,7.7168,5.4453,7.7136)", + "span": { + "offset": 10157, + "length": 4 + } + }, + { + "content": "10/20/1990", + "source": "D(2,5.4744,7.729,6.072,7.729,6.072,7.8472,5.4744,7.8472)", + "span": { + "offset": 10162, + "length": 10 + } + }, + { + "content": "PTIN", + "source": "D(2,6.2754,7.6055,6.4995,7.6055,6.4995,7.7021,6.2754,7.7021)", + "span": { + "offset": 10174, + "length": 4 + } + }, + { + "content": "09870", + "source": "D(2,6.4374,7.7559,6.7547,7.7581,6.7527,7.8839,6.4359,7.8788)", + "span": { + "offset": 10179, + "length": 5 + } + }, + { + "content": "Check if:", + "source": "D(2,7.0429,7.6103,7.4375,7.6091,7.4375,7.7171,7.0432,7.7183)", + "span": { + "offset": 10186, + "length": 9 + } + }, + { + "content": "☐", + "source": "D(2,7.093,7.7612,7.2175,7.7559,7.2175,7.8848,7.093,7.8794)", + "span": { + "offset": 10197, + "length": 1 + } + }, + { + "content": "Self-employed", + "source": "D(2,7.2424,7.7682,7.8857,7.7706,7.8857,7.8817,7.242,7.8794)", + "span": { + "offset": 10199, + "length": 13 + } + }, + { + "content": "Firm's name", + "source": "D(2,1.3893,7.9642,1.9424,7.9715,1.9413,8.074,1.389,8.0668)", + "span": { + "offset": 10214, + "length": 11 + } + }, + { + "content": "ANM company", + "source": "D(2,2.1188,7.9337,2.9101,7.9505,2.9072,8.0825,2.116,8.0664)", + "span": { + "offset": 10226, + "length": 11 + } + }, + { + "content": "Phone no.", + "source": "D(2,6.4414,7.9635,6.9027,7.966,6.9021,8.0737,6.4414,8.0711)", + "span": { + "offset": 10239, + "length": 9 + } + }, + { + "content": "8760765000876", + "source": "D(2,7.0471,7.9308,7.8691,7.9289,7.8691,8.0567,7.0474,8.0586)", + "span": { + "offset": 10249, + "length": 13 + } + }, + { + "content": "Firm's address", + "source": "D(2,1.3895,8.1158,2.0531,8.1253,2.0524,8.2379,1.389,8.2276)", + "span": { + "offset": 10264, + "length": 14 + } + }, + { + "content": "9220 BELHAVEN LOS ANGELES CA 90002-2009 USA", + "source": "D(2,2.2307,8.112,5.0469,8.1083,5.0469,8.2323,2.2308,8.2361)", + "span": { + "offset": 10279, + "length": 43 + } + }, + { + "content": "Firm's EIN", + "source": "D(2,6.4414,8.121,6.9062,8.121,6.9062,8.2285,6.4414,8.2285)", + "span": { + "offset": 10324, + "length": 10 + } + }, + { + "content": "080686", + "source": "D(2,7.3239,8.1191,7.7114,8.1133,7.7131,8.2262,7.3255,8.2319)", + "span": { + "offset": 10335, + "length": 6 + } + }, + { + "content": "Go to www.irs.gov/Form1040 for instructions and the latest information.", + "source": "D(2,0.4882,8.2975,3.6171,8.2927,3.6173,8.4139,0.4884,8.4188)", + "span": { + "offset": 10360, + "length": 71 + } + }, + { + "content": "Form 1040 (2020)", + "source": "D(2,7.2175,8.2983,8.0061,8.2983,8.0061,8.4165,7.2175,8.4165)", + "span": { + "offset": 10454, + "length": 16 + } + } + ] + } + ], + "paragraphs": [ + { + "role": "pageHeader", + "content": "Form 1040", + "source": "D(1,0.5003,0.5022,1.2545,0.5019,1.2545,0.7748,0.5004,0.7751)", + "span": { + "offset": 0, + "length": 31 + } + }, + { + "role": "pageHeader", + "content": "Department of the Treasury-Internal Revenue Service U.S. Individual Income Tax Return", + "source": "D(1,1.3427,0.5198,3.8935,0.5242,3.8931,0.8008,1.3422,0.7964)", + "span": { + "offset": 32, + "length": 107 + } + }, + { + "role": "pageHeader", + "content": "(99)", + "source": "D(1,3.7354,0.5157,3.9087,0.5175,3.9076,0.6304,3.7342,0.6286)", + "span": { + "offset": 140, + "length": 26 + } + }, + { + "role": "pageHeader", + "content": "2020", + "source": "D(1,4.1292,0.5327,4.8643,0.5315,4.8647,0.7722,4.1296,0.7734)", + "span": { + "offset": 167, + "length": 26 + } + }, + { + "role": "pageHeader", + "content": "OMB No. 1545-0074", + "source": "D(1,4.939,0.6877,5.8521,0.6877,5.8521,0.7883,4.939,0.7883)", + "span": { + "offset": 194, + "length": 39 + } + }, + { + "role": "pageHeader", + "content": "IRS Use Only-Do not write or staple in this space.", + "source": "D(1,5.9849,0.6981,7.8984,0.7028,7.8982,0.8069,5.9846,0.8023)", + "span": { + "offset": 234, + "length": 72 + } + }, + { + "content": "Filing Status Check only one box.", + "source": "D(1,0.4904,0.9132,1.2536,0.9142,1.2531,1.3039,0.4899,1.3029)", + "span": { + "offset": 308, + "length": 33 + } + }, + { + "content": "☑ Single ☐ Married filing jointly ☐ Married filing separately (MFS) ☐ Head of household (HOH) ☐ Qualifying widow(er) (QW)", + "source": "D(1,1.3209,0.9339,7.9688,0.9343,7.9687,1.069,1.3209,1.0686)", + "span": { + "offset": 343, + "length": 121 + } + }, + { + "content": "If you checked the MFS box, enter the name of your spouse. If you checked the HOH or QW box, enter the child's name if the qualifying person is a child but not your dependent", + "source": "D(1,1.3146,1.1119,7.9854,1.1119,7.9854,1.3835,1.3146,1.3835)", + "span": { + "offset": 466, + "length": 174 + } + }, + { + "content": "Your first name and middle initial Robert", + "source": "D(1,0.5227,1.4445,1.9849,1.4445,1.9849,1.7085,0.5227,1.7085)", + "span": { + "offset": 642, + "length": 41 + } + }, + { + "content": "Last name Morgan", + "source": "D(1,3.3274,1.4481,3.8106,1.4509,3.809,1.7311,3.3258,1.7283)", + "span": { + "offset": 685, + "length": 16 + } + }, + { + "content": "Your social security number 0 8 5 5 0 6 1 1 0", + "source": "D(1,6.545,1.4431,7.9648,1.444,7.9646,1.7256,6.5448,1.7247)", + "span": { + "offset": 703, + "length": 45 + } + }, + { + "content": "If joint return, spouse's first name and middle initial", + "source": "D(1,0.5411,1.7708,2.7745,1.7678,2.7747,1.8832,0.5413,1.8862)", + "span": { + "offset": 750, + "length": 55 + } + }, + { + "content": "Last name", + "source": "D(1,3.3431,1.7805,3.8106,1.7832,3.8101,1.8803,3.3426,1.8776)", + "span": { + "offset": 807, + "length": 9 + } + }, + { + "content": "Spouse's social security number", + "source": "D(1,6.545,1.7712,8.0061,1.7696,8.0062,1.8824,6.5452,1.884)", + "span": { + "offset": 818, + "length": 31 + } + }, + { + "content": "Home address (number and street). If you have a P.O. box, see instructions. 254 W 78TH LOS ANGELES CA 90003-2459 USA", + "source": "D(1,0.5201,2.1079,3.8516,2.1042,3.8519,2.3718,0.5204,2.3756)", + "span": { + "offset": 851, + "length": 116 + } + }, + { + "content": "Apt. no. 254", + "source": "D(1,5.8396,2.1128,6.2447,2.1168,6.2422,2.3707,5.8371,2.3666)", + "span": { + "offset": 969, + "length": 12 + } + }, + { + "content": "City, town, or post office. If you have a foreign address, also complete spaces below. 10107 1/4 WILMINGTON LOS ANGELES CA 90002-2984 USA", + "source": "D(1,0.5284,2.448,4.2542,2.4476,4.2542,2.7125,0.5284,2.7129)", + "span": { + "offset": 983, + "length": 137 + } + }, + { + "content": "State LA", + "source": "D(1,4.7036,2.5269,4.7839,2.363,5.2752,2.6043,5.1948,2.7681)", + "span": { + "offset": 1122, + "length": 8 + } + }, + { + "content": "ZIP code 10107", + "source": "D(1,5.6362,2.4475,6.2274,2.4517,6.2256,2.7089,5.6344,2.7048)", + "span": { + "offset": 1132, + "length": 14 + } + }, + { + "content": "Foreign country name N/A", + "source": "D(1,0.5195,2.7793,1.5107,2.7793,1.5107,3.0405,0.5195,3.0405)", + "span": { + "offset": 1148, + "length": 24 + } + }, + { + "content": "Foreign province/state/county N/A", + "source": "D(1,3.6357,2.7766,4.9639,2.7765,4.9639,3.0405,3.6357,3.0407)", + "span": { + "offset": 1174, + "length": 33 + } + }, + { + "content": "Foreign postal code N/A", + "source": "D(1,5.6444,2.7812,6.458,2.78,6.4584,3.0374,5.6447,3.0386)", + "span": { + "offset": 1209, + "length": 23 + } + }, + { + "content": "Presidential Election Campaign Check here if you, or your spouse if filing jointly, want $3 to go to this fund. Checking a box below will not change your tax or refund.", + "source": "D(1,6.5358,2.1129,8.007,2.1243,8.0011,2.8961,6.5298,2.8848)", + "span": { + "offset": 1234, + "length": 168 + } + }, + { + "content": "☐ You ☐ Spouse", + "source": "D(1,6.9851,2.9165,7.9944,2.9165,7.9944,3.0454,6.9851,3.0454)", + "span": { + "offset": 1404, + "length": 14 + } + }, + { + "content": "At any time during 2020, did you receive, sell, send, exchange, or otherwise acquire any financial interest in any virtual currency?", + "source": "D(1,0.4926,3.1469,6.8772,3.1469,6.8772,3.2762,0.4926,3.2762)", + "span": { + "offset": 1420, + "length": 132 + } + }, + { + "content": "☑ Yes ☐ No", + "source": "D(1,6.9976,3.1373,7.7997,3.1407,7.7991,3.2771,6.997,3.2737)", + "span": { + "offset": 1554, + "length": 10 + } + }, + { + "content": "Standard Deduction", + "source": "D(1,0.4918,3.373,1.1849,3.373,1.1849,3.6398,0.4918,3.6398)", + "span": { + "offset": 1566, + "length": 18 + } + }, + { + "content": "Someone can claim:", + "source": "D(1,1.2877,3.3597,2.3787,3.3646,2.3781,3.4831,1.2871,3.4783)", + "span": { + "offset": 1586, + "length": 18 + } + }, + { + "content": "☐ You as a dependent ☐ Your spouse as a dependent ☐ Spouse itemizes on a separate return or you were a dual-status alien", + "source": "D(1,1.3209,3.3569,5.5366,3.3569,5.5366,3.6513,1.3209,3.6513)", + "span": { + "offset": 1606, + "length": 120 + } + }, + { + "content": "Age/Blindness", + "source": "D(1,0.4903,3.7768,1.2453,3.7781,1.2451,3.9043,0.49,3.9029)", + "span": { + "offset": 1728, + "length": 13 + } + }, + { + "content": "You:", + "source": "D(1,1.2949,3.7796,1.5445,3.781,1.5439,3.89,1.2943,3.8886)", + "span": { + "offset": 1743, + "length": 4 + } + }, + { + "content": "☐ Were born before January 2, 1956 ☑ Are blind", + "source": "D(1,1.6221,3.7598,4.2463,3.7456,4.2471,3.8957,1.6229,3.9099)", + "span": { + "offset": 1749, + "length": 46 + } + }, + { + "content": "Spouse:", + "source": "D(1,4.4845,3.7789,4.9347,3.7716,4.9368,3.8974,4.4866,3.9047)", + "span": { + "offset": 1797, + "length": 7 + } + }, + { + "content": "☐ Was born before January 2, 1956 ☐ Is blind", + "source": "D(1,5.022,3.7623,7.5539,3.7659,7.5537,3.9027,5.0218,3.8991)", + "span": { + "offset": 1806, + "length": 44 + } + }, + { + "content": "Dependents If more than four dependents, see instructions and check here ☐", + "source": "D(1,0.4414,3.9065,1.2936,3.9054,1.2931,4.9149,0.4375,4.9144)", + "span": { + "offset": 1882, + "length": 74 + } + }, + { + "content": "(see instructions): (1) First name", + "source": "D(1,1.2936,3.9054,2.2786,3.9055,2.2792,4.2475,1.2933,4.2474)", + "span": { + "offset": 1966, + "length": 34 + } + }, + { + "content": "Last name", + "source": "D(1,2.2786,3.9055,3.7063,3.9061,3.7062,4.2468,2.2792,4.2475)", + "span": { + "offset": 2010, + "length": 9 + } + }, + { + "content": "(2) Social security number", + "source": "D(1,3.7063,3.9061,4.9002,3.9069,4.9007,4.2471,3.7062,4.2468)", + "span": { + "offset": 2041, + "length": 26 + } + }, + { + "content": "(3) Relationship to you", + "source": "D(1,4.9002,3.9069,5.8,3.9077,5.8003,4.2467,4.9007,4.2471)", + "span": { + "offset": 2077, + "length": 23 + } + }, + { + "content": "(4) ✓ if qualifies for\nChild tax credit", + "source": "D(1,5.8,3.9077,6.9019,3.9081,6.9024,4.2468,5.8003,4.2467)", + "span": { + "offset": 2110, + "length": 39 + } + }, + { + "content": "(see instructions):\nCredit for other dependents", + "source": "D(1,6.9019,3.9081,7.9981,3.91,7.9979,4.247,6.9024,4.2468)", + "span": { + "offset": 2159, + "length": 47 + } + }, + { + "content": "Milsa", + "source": "D(1,1.2933,4.2474,2.2792,4.2475,2.2793,4.418,1.2931,4.4183)", + "span": { + "offset": 2227, + "length": 5 + } + }, + { + "content": "Hill", + "source": "D(1,2.2792,4.2475,3.7062,4.2468,3.7062,4.4175,2.2793,4.418)", + "span": { + "offset": 2242, + "length": 4 + } + }, + { + "content": "052000520", + "source": "D(1,4.3298,4.2477,4.9007,4.2471,4.9005,4.4173,4.3305,4.4177)", + "span": { + "offset": 2276, + "length": 9 + } + }, + { + "content": "friend", + "source": "D(1,4.9007,4.2471,5.8003,4.2467,5.8,4.4171,4.9005,4.4173)", + "span": { + "offset": 2295, + "length": 6 + } + }, + { + "content": "☐", + "source": "D(1,5.8003,4.2467,6.9024,4.2468,6.9023,4.417,5.8,4.4171)", + "span": { + "offset": 2311, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.9024,4.2468,7.9979,4.247,7.9977,4.4172,6.9023,4.417)", + "span": { + "offset": 2322, + "length": 1 + } + }, + { + "content": "Amanda", + "source": "D(1,1.2931,4.4183,2.2793,4.418,2.2784,4.5805,1.293,4.581)", + "span": { + "offset": 2344, + "length": 6 + } + }, + { + "content": "Hill", + "source": "D(1,2.2793,4.418,3.7062,4.4175,3.706,4.5804,2.2784,4.5805)", + "span": { + "offset": 2360, + "length": 4 + } + }, + { + "content": "5 2 0", + "source": "D(1,3.7062,4.4175,4.0713,4.4175,4.071,4.5802,3.706,4.5804)", + "span": { + "offset": 2374, + "length": 5 + } + }, + { + "content": "8 5", + "source": "D(1,4.0713,4.4175,4.3305,4.4177,4.3307,4.5804,4.071,4.5802)", + "span": { + "offset": 2389, + "length": 3 + } + }, + { + "content": "2 0 0 0", + "source": "D(1,4.3305,4.4177,4.9005,4.4173,4.9003,4.5805,4.3307,4.5804)", + "span": { + "offset": 2402, + "length": 7 + } + }, + { + "content": "friend", + "source": "D(1,4.9005,4.4173,5.8,4.4171,5.7995,4.5802,4.9003,4.5805)", + "span": { + "offset": 2419, + "length": 6 + } + }, + { + "content": "☐", + "source": "D(1,5.8,4.4171,6.9023,4.417,6.902,4.5803,5.7995,4.5802)", + "span": { + "offset": 2435, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.9023,4.417,7.9977,4.4172,7.9977,4.5808,6.902,4.5803)", + "span": { + "offset": 2446, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,5.7995,4.5802,6.902,4.5803,6.9021,4.75,5.7996,4.7504)", + "span": { + "offset": 2528, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.902,4.5803,7.9977,4.5808,7.9976,4.7503,6.9021,4.75)", + "span": { + "offset": 2539, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,5.7996,4.7504,6.9021,4.75,6.9032,4.9142,5.8006,4.9145)", + "span": { + "offset": 2621, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.9021,4.75,7.9976,4.7503,7.9979,4.9146,6.9032,4.9142)", + "span": { + "offset": 2632, + "length": 1 + } + }, + { + "content": "Attach Sch. B if required.", + "source": "D(1,0.3993,4.9156,1.2067,4.9152,1.2055,5.7513,0.3981,5.7523)", + "span": { + "offset": 2685, + "length": 26 + } + }, + { + "content": "1 Wages, salaries, tips, etc. Attach Form(s) W-2", + "source": "D(1,1.2067,4.9152,6.6869,4.9146,6.6868,5.0793,1.2068,5.0798)", + "span": { + "offset": 2733, + "length": 48 + } + }, + { + "content": "1", + "source": "D(1,6.6869,4.9146,6.9933,4.9143,6.993,5.0793,6.6868,5.0793)", + "span": { + "offset": 2791, + "length": 1 + } + }, + { + "content": "200", + "source": "D(1,6.9933,4.9143,8.0109,4.9147,8.011,5.0792,6.993,5.0793)", + "span": { + "offset": 2802, + "length": 3 + } + }, + { + "content": "2a Tax-exempt interest . .", + "source": "D(1,1.2068,5.0798,3.2005,5.0788,3.1998,5.2552,1.2063,5.2556)", + "span": { + "offset": 2826, + "length": 26 + } + }, + { + "content": "2a", + "source": "D(1,3.2005,5.0788,3.4856,5.0787,3.4849,5.2545,3.1998,5.2552)", + "span": { + "offset": 2862, + "length": 2 + } + }, + { + "content": "100", + "source": "D(1,3.4856,5.0787,4.5188,5.079,4.5183,5.2548,3.4849,5.2545)", + "span": { + "offset": 2874, + "length": 3 + } + }, + { + "content": "b Taxable interest", + "source": "D(1,4.5188,5.079,6.6868,5.0793,6.6865,5.2554,4.5183,5.2548)", + "span": { + "offset": 2899, + "length": 18 + } + }, + { + "content": "2b", + "source": "D(1,6.6868,5.0793,6.993,5.0793,6.9925,5.2553,6.6865,5.2554)", + "span": { + "offset": 2927, + "length": 2 + } + }, + { + "content": "300", + "source": "D(1,6.993,5.0793,8.011,5.0792,8.0111,5.2556,6.9925,5.2553)", + "span": { + "offset": 2939, + "length": 3 + } + }, + { + "content": "3a Qualified dividends . . .", + "source": "D(1,1.2063,5.2556,3.1998,5.2552,3.1998,5.4179,1.2057,5.4185)", + "span": { + "offset": 2963, + "length": 28 + } + }, + { + "content": "3a", + "source": "D(1,3.1998,5.2552,3.4849,5.2545,3.4844,5.4177,3.1998,5.4179)", + "span": { + "offset": 3001, + "length": 2 + } + }, + { + "content": "200", + "source": "D(1,3.4849,5.2545,4.5183,5.2548,4.5177,5.4176,3.4844,5.4177)", + "span": { + "offset": 3013, + "length": 3 + } + }, + { + "content": "b Ordinary dividends", + "source": "D(1,4.5183,5.2548,6.6865,5.2554,6.6857,5.4177,4.5177,5.4176)", + "span": { + "offset": 3038, + "length": 20 + } + }, + { + "content": "3b", + "source": "D(1,6.6865,5.2554,6.9925,5.2553,6.9923,5.4177,6.6857,5.4177)", + "span": { + "offset": 3068, + "length": 2 + } + }, + { + "content": "200", + "source": "D(1,6.9925,5.2553,8.0111,5.2556,8.011,5.4177,6.9923,5.4177)", + "span": { + "offset": 3080, + "length": 3 + } + }, + { + "content": "4a IRA distributions", + "source": "D(1,1.2057,5.4185,3.1998,5.4179,3.1997,5.5824,1.2055,5.583)", + "span": { + "offset": 3104, + "length": 20 + } + }, + { + "content": "4a", + "source": "D(1,3.1998,5.4179,3.4844,5.4177,3.4845,5.5821,3.1997,5.5824)", + "span": { + "offset": 3134, + "length": 2 + } + }, + { + "content": "300", + "source": "D(1,3.4844,5.4177,4.5177,5.4176,4.5177,5.582,3.4845,5.5821)", + "span": { + "offset": 3146, + "length": 3 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.5177,5.4176,6.6857,5.4177,6.6859,5.5821,4.5177,5.582)", + "span": { + "offset": 3171, + "length": 16 + } + }, + { + "content": "4b", + "source": "D(1,6.6857,5.4177,6.9923,5.4177,6.9924,5.5821,6.6859,5.5821)", + "span": { + "offset": 3197, + "length": 2 + } + }, + { + "content": "100", + "source": "D(1,6.9923,5.4177,8.011,5.4177,8.0111,5.5822,6.9924,5.5821)", + "span": { + "offset": 3209, + "length": 3 + } + }, + { + "content": "5a Pensions and annuities . .", + "source": "D(1,1.2055,5.583,3.1997,5.5824,3.2001,5.7502,1.2055,5.7513)", + "span": { + "offset": 3233, + "length": 29 + } + }, + { + "content": "5a", + "source": "D(1,3.1997,5.5824,3.4845,5.5821,3.4845,5.75,3.2001,5.7502)", + "span": { + "offset": 3272, + "length": 2 + } + }, + { + "content": "200", + "source": "D(1,3.4845,5.5821,4.5177,5.582,4.5186,5.7499,3.4845,5.75)", + "span": { + "offset": 3284, + "length": 3 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.5177,5.582,6.6859,5.5821,6.6853,5.7503,4.5186,5.7499)", + "span": { + "offset": 3309, + "length": 16 + } + }, + { + "content": "5b", + "source": "D(1,6.6859,5.5821,6.9924,5.5821,6.9922,5.7504,6.6853,5.7503)", + "span": { + "offset": 3335, + "length": 2 + } + }, + { + "content": "400", + "source": "D(1,6.9924,5.5821,8.0111,5.5822,8.011,5.7507,6.9922,5.7504)", + "span": { + "offset": 3347, + "length": 3 + } + }, + { + "content": "Standard Deduction for- . Single or Married filing separately, $12,400 . Married filing jointly or Qualifying widow(er), $24,800 . Head of household, $18,650 . If you checked any box under Standard Deduction, see instructions.", + "source": "D(1,0.3981,5.7523,1.2055,5.7513,1.2072,7.9119,0.3956,7.912)", + "span": { + "offset": 3384, + "length": 226 + } + }, + { + "content": "6a Social security benefits .", + "source": "D(1,1.2055,5.7513,3.2001,5.7502,3.2003,5.9104,1.2057,5.9115)", + "span": { + "offset": 3620, + "length": 29 + } + }, + { + "content": "6a", + "source": "D(1,3.2001,5.7502,3.4845,5.75,3.4847,5.9106,3.2003,5.9104)", + "span": { + "offset": 3659, + "length": 2 + } + }, + { + "content": "100 b Taxable amount", + "source": "D(1,3.4845,5.75,6.6853,5.7503,6.6858,5.9108,3.4847,5.9106)", + "span": { + "offset": 3683, + "length": 20 + } + }, + { + "content": "6b", + "source": "D(1,6.6853,5.7503,6.9922,5.7504,6.9933,5.9109,6.6858,5.9108)", + "span": { + "offset": 3713, + "length": 2 + } + }, + { + "content": "500", + "source": "D(1,6.9922,5.7504,8.011,5.7507,8.011,5.9116,6.9933,5.9109)", + "span": { + "offset": 3725, + "length": 3 + } + }, + { + "content": "7 Capital gain or (loss). Attach Schedule D if required. If not required, check here ☐", + "source": "D(1,1.2057,5.9115,6.6858,5.9108,6.6857,6.0836,1.2055,6.0838)", + "span": { + "offset": 3761, + "length": 86 + } + }, + { + "content": "7", + "source": "D(1,6.6858,5.9108,6.9933,5.9109,6.9935,6.0835,6.6857,6.0836)", + "span": { + "offset": 3857, + "length": 1 + } + }, + { + "content": "100", + "source": "D(1,6.9933,5.9109,8.011,5.9116,8.011,6.084,6.9935,6.0835)", + "span": { + "offset": 3868, + "length": 3 + } + }, + { + "content": "8 Other income from Schedule 1, line 9", + "source": "D(1,1.2055,6.0838,6.6857,6.0836,6.686,6.2474,1.2056,6.2481)", + "span": { + "offset": 3904, + "length": 38 + } + }, + { + "content": "8", + "source": "D(1,6.6857,6.0836,6.9935,6.0835,6.9936,6.2477,6.686,6.2474)", + "span": { + "offset": 3952, + "length": 1 + } + }, + { + "content": "180", + "source": "D(1,6.9935,6.0835,8.011,6.084,8.0113,6.2482,6.9936,6.2477)", + "span": { + "offset": 3963, + "length": 3 + } + }, + { + "content": "9 Add lines 1, 2b, 3b, 4b, 5b, 6b, 7, and 8. This is your total income", + "source": "D(1,1.2056,6.2481,6.686,6.2474,6.6844,6.4102,1.205,6.4111)", + "span": { + "offset": 3999, + "length": 70 + } + }, + { + "content": "9", + "source": "D(1,6.686,6.2474,6.9936,6.2477,6.9923,6.4098,6.6844,6.4102)", + "span": { + "offset": 4079, + "length": 1 + } + }, + { + "content": "1980", + "source": "D(1,6.9936,6.2477,8.0113,6.2482,8.0112,6.4102,6.9923,6.4098)", + "span": { + "offset": 4090, + "length": 4 + } + }, + { + "content": "10 Adjustments to income:", + "source": "D(1,1.205,6.4111,6.6844,6.4102,6.6856,6.5748,1.2051,6.5786)", + "span": { + "offset": 4127, + "length": 25 + } + }, + { + "content": "400", + "source": "D(1,6.9923,6.4098,8.0112,6.4102,8.012,7.0769,6.994,7.0767)", + "span": { + "offset": 4196, + "length": 3 + } + }, + { + "content": "a From Schedule 1, line 22", + "source": "D(1,1.2051,6.5786,5.3994,6.5757,5.4003,6.7508,1.205,6.7518)", + "span": { + "offset": 4232, + "length": 26 + } + }, + { + "content": "10a", + "source": "D(1,5.3994,6.5757,5.6924,6.5756,5.6932,6.7507,5.4003,6.7508)", + "span": { + "offset": 4268, + "length": 3 + } + }, + { + "content": "200", + "source": "D(1,5.6924,6.5756,6.6856,6.5748,6.6856,6.7509,5.6932,6.7507)", + "span": { + "offset": 4281, + "length": 3 + } + }, + { + "content": "b Charitable contributions if you take the standard deduction. See instructions", + "source": "D(1,1.205,6.7518,5.4003,6.7508,5.3981,6.9176,1.205,6.9192)", + "span": { + "offset": 4317, + "length": 79 + } + }, + { + "content": "10b", + "source": "D(1,5.4003,6.7508,5.6932,6.7507,5.6918,6.9178,5.3981,6.9176)", + "span": { + "offset": 4406, + "length": 3 + } + }, + { + "content": "200", + "source": "D(1,5.6932,6.7507,6.6856,6.7509,6.6857,6.9182,5.6918,6.9178)", + "span": { + "offset": 4419, + "length": 3 + } + }, + { + "content": "c Add lines 10a and 10b. These are your total adjustments to income", + "source": "D(1,1.205,6.9192,6.6857,6.9182,6.6862,7.0768,1.2051,7.0791)", + "span": { + "offset": 4455, + "length": 67 + } + }, + { + "content": "10c", + "source": "D(1,6.6857,6.9182,6.993,6.9182,6.994,7.0767,6.6862,7.0768)", + "span": { + "offset": 4532, + "length": 3 + } + }, + { + "content": "11 Subtract line 10c from line 9. This is your adjusted gross income", + "source": "D(1,1.2051,7.0791,6.6862,7.0768,6.6862,7.251,1.2051,7.2519)", + "span": { + "offset": 4568, + "length": 68 + } + }, + { + "content": "11", + "source": "D(1,6.6862,7.0768,6.994,7.0767,6.9939,7.251,6.6862,7.251)", + "span": { + "offset": 4646, + "length": 2 + } + }, + { + "content": "1880", + "source": "D(1,6.994,7.0767,8.012,7.0769,8.0121,7.2511,6.9939,7.251)", + "span": { + "offset": 4658, + "length": 4 + } + }, + { + "content": "12 Standard deduction or itemized deductions (from Schedule A)", + "source": "D(1,1.2051,7.2519,6.6862,7.251,6.6859,7.4131,1.205,7.415)", + "span": { + "offset": 4695, + "length": 62 + } + }, + { + "content": "12", + "source": "D(1,6.6862,7.251,6.9939,7.251,6.9935,7.4131,6.6859,7.4131)", + "span": { + "offset": 4767, + "length": 2 + } + }, + { + "content": "100", + "source": "D(1,6.9939,7.251,8.0121,7.2511,8.012,7.4126,6.9935,7.4131)", + "span": { + "offset": 4779, + "length": 3 + } + }, + { + "content": "13 Qualified business income deduction. Attach Form 8995 or Form 8995-A", + "source": "D(1,1.205,7.415,6.6859,7.4131,6.6864,7.5788,1.2052,7.5795)", + "span": { + "offset": 4815, + "length": 71 + } + }, + { + "content": "13", + "source": "D(1,6.6859,7.4131,6.9935,7.4131,6.9939,7.579,6.6864,7.5788)", + "span": { + "offset": 4896, + "length": 2 + } + }, + { + "content": "200", + "source": "D(1,6.9935,7.4131,8.012,7.4126,8.0123,7.5791,6.9939,7.579)", + "span": { + "offset": 4908, + "length": 3 + } + }, + { + "content": "14 Add lines 12 and 13", + "source": "D(1,1.2052,7.5795,6.6864,7.5788,6.6863,7.7476,1.2053,7.7497)", + "span": { + "offset": 4944, + "length": 22 + } + }, + { + "content": "14", + "source": "D(1,6.6864,7.5788,6.9939,7.579,6.9937,7.7474,6.6863,7.7476)", + "span": { + "offset": 4976, + "length": 2 + } + }, + { + "content": "500", + "source": "D(1,6.9939,7.579,8.0123,7.5791,8.0119,7.7473,6.9937,7.7474)", + "span": { + "offset": 4988, + "length": 3 + } + }, + { + "content": "15 Taxable income. Subtract line 14 from line 11. If zero or less, enter -0-", + "source": "D(1,1.2053,7.7497,6.6863,7.7476,6.6886,7.9109,1.2072,7.9119)", + "span": { + "offset": 5024, + "length": 76 + } + }, + { + "content": "15", + "source": "D(1,6.6863,7.7476,6.9937,7.7474,6.996,7.911,6.6886,7.9109)", + "span": { + "offset": 5110, + "length": 2 + } + }, + { + "content": "510", + "source": "D(1,6.9937,7.7474,8.0119,7.7473,8.0115,7.9108,6.996,7.911)", + "span": { + "offset": 5122, + "length": 3 + } + }, + { + "role": "pageFooter", + "content": "For Disclosure, Privacy Act, and Paperwork Reduction Act Notice, see separate instructions.", + "source": "D(1,0.4879,7.9635,4.7896,7.967,4.7895,8.0855,0.4878,8.082)", + "span": { + "offset": 5148, + "length": 113 + } + }, + { + "role": "pageFooter", + "content": "Cat. No. 11320B", + "source": "D(1,5.6777,7.9761,6.3169,7.9761,6.3169,8.0692,5.6777,8.0692)", + "span": { + "offset": 5262, + "length": 37 + } + }, + { + "role": "pageFooter", + "content": "Form 1040 (2020)", + "source": "D(1,7.2092,7.9586,8.0061,7.9586,8.0061,8.0781,7.2092,8.0781)", + "span": { + "offset": 5300, + "length": 38 + } + }, + { + "role": "pageNumber", + "content": "Page 2", + "source": "D(2,7.6593,0.3454,7.9937,0.3394,7.996,0.4707,7.6616,0.4767)", + "span": { + "offset": 5359, + "length": 28 + } + }, + { + "role": "pageHeader", + "content": "Form 1040 (2020)", + "source": "D(2,0.4885,0.344,1.2669,0.3479,1.2663,0.4637,0.4879,0.4598)", + "span": { + "offset": 5388, + "length": 38 + } + }, + { + "content": "16 Tax (see instructions). Check if any from Form(s): 1 ☐ 8814 2 ☑ 4972 3 ☐ . .", + "source": "D(2,1.2407,0.4946,6.6947,0.494,6.6929,0.6715,1.2396,0.6727)", + "span": { + "offset": 5481, + "length": 79 + } + }, + { + "content": "16", + "source": "D(2,6.6947,0.494,6.9948,0.4934,6.9931,0.6706,6.6929,0.6715)", + "span": { + "offset": 5570, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,6.9948,0.4934,8.0007,0.4942,8.0004,0.6714,6.9931,0.6706)", + "span": { + "offset": 5582, + "length": 3 + } + }, + { + "content": "17 Amount from Schedule 2, line 3", + "source": "D(2,1.2396,0.6727,6.6929,0.6715,6.6928,0.8366,1.2393,0.8386)", + "span": { + "offset": 5618, + "length": 33 + } + }, + { + "content": "17", + "source": "D(2,6.6929,0.6715,6.9931,0.6706,6.9928,0.8359,6.6928,0.8366)", + "span": { + "offset": 5661, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,6.9931,0.6706,8.0004,0.6714,8.0009,0.8365,6.9928,0.8359)", + "span": { + "offset": 5673, + "length": 3 + } + }, + { + "content": "18 Add lines 16 and 17", + "source": "D(2,1.2393,0.8386,6.6928,0.8366,6.6925,1.0044,1.2388,1.0063)", + "span": { + "offset": 5709, + "length": 22 + } + }, + { + "content": "18", + "source": "D(2,6.6928,0.8366,6.9928,0.8359,6.9927,1.0036,6.6925,1.0044)", + "span": { + "offset": 5741, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,6.9928,0.8359,8.0009,0.8365,8.0005,1.0037,6.9927,1.0036)", + "span": { + "offset": 5753, + "length": 3 + } + }, + { + "content": "19 Child tax credit or credit for other dependents", + "source": "D(2,1.2388,1.0063,6.6925,1.0044,6.6924,1.1664,1.2392,1.1683)", + "span": { + "offset": 5789, + "length": 50 + } + }, + { + "content": "19", + "source": "D(2,6.6925,1.0044,6.9927,1.0036,6.9928,1.1658,6.6924,1.1664)", + "span": { + "offset": 5849, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,6.9927,1.0036,8.0005,1.0037,8.0006,1.1658,6.9928,1.1658)", + "span": { + "offset": 5861, + "length": 3 + } + }, + { + "content": "20 Amount from Schedule 3, line 7", + "source": "D(2,1.2392,1.1683,6.6924,1.1664,6.692,1.3322,1.2391,1.3338)", + "span": { + "offset": 5897, + "length": 33 + } + }, + { + "content": "20", + "source": "D(2,6.6924,1.1664,6.9928,1.1658,6.9925,1.3317,6.692,1.3322)", + "span": { + "offset": 5940, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,6.9928,1.1658,8.0006,1.1658,8.0006,1.3319,6.9925,1.3317)", + "span": { + "offset": 5952, + "length": 3 + } + }, + { + "content": "21 Add lines 19 and 20", + "source": "D(2,1.2391,1.3338,6.692,1.3322,6.6931,1.4979,1.2394,1.4991)", + "span": { + "offset": 5988, + "length": 22 + } + }, + { + "content": "21", + "source": "D(2,6.692,1.3322,6.9925,1.3317,6.9931,1.4977,6.6931,1.4979)", + "span": { + "offset": 6020, + "length": 2 + } + }, + { + "content": "110", + "source": "D(2,6.9925,1.3317,8.0006,1.3319,8.0007,1.4981,6.9931,1.4977)", + "span": { + "offset": 6032, + "length": 3 + } + }, + { + "content": "22 Subtract line 21 from line 18. If zero or less, enter -0-", + "source": "D(2,1.2394,1.4991,6.6931,1.4979,6.6933,1.6637,1.2393,1.6647)", + "span": { + "offset": 6068, + "length": 60 + } + }, + { + "content": "22", + "source": "D(2,6.6931,1.4979,6.9931,1.4977,6.9932,1.6634,6.6933,1.6637)", + "span": { + "offset": 6138, + "length": 2 + } + }, + { + "content": "1100", + "source": "D(2,6.9931,1.4977,8.0007,1.4981,8.0003,1.6639,6.9932,1.6634)", + "span": { + "offset": 6150, + "length": 4 + } + }, + { + "content": "23 Other taxes, including self-employment tax, from Schedule 2, line 10", + "source": "D(2,1.2393,1.6647,6.6933,1.6637,6.6935,1.8332,1.239,1.8343)", + "span": { + "offset": 6187, + "length": 71 + } + }, + { + "content": "23", + "source": "D(2,6.6933,1.6637,6.9932,1.6634,6.9936,1.833,6.6935,1.8332)", + "span": { + "offset": 6268, + "length": 2 + } + }, + { + "content": "110", + "source": "D(2,6.9932,1.6634,8.0003,1.6639,8.0002,1.8337,6.9936,1.833)", + "span": { + "offset": 6280, + "length": 3 + } + }, + { + "content": "24 Add lines 22 and 23. This is your total tax", + "source": "D(2,1.239,1.8343,6.6935,1.8332,6.6915,2.0007,1.2386,2.0023)", + "span": { + "offset": 6316, + "length": 46 + } + }, + { + "content": "24", + "source": "D(2,6.6935,1.8332,6.9936,1.833,6.9928,2,6.6915,2.0007)", + "span": { + "offset": 6372, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,6.9936,1.833,8.0002,1.8337,8.0007,2.001,6.9928,2)", + "span": { + "offset": 6384, + "length": 3 + } + }, + { + "content": "25 Federal income tax withheld from:", + "source": "D(2,1.2386,2.0023,6.6915,2.0007,6.6927,2.1542,1.2384,2.1604)", + "span": { + "offset": 6420, + "length": 36 + } + }, + { + "content": "300", + "source": "D(2,6.9928,2,8.0007,2.001,8.0009,2.8313,6.9935,2.8317)", + "span": { + "offset": 6500, + "length": 3 + } + }, + { + "content": "a Form(s) W-2", + "source": "D(2,1.2384,2.1604,5.3942,2.1561,5.3937,2.3315,1.2386,2.3325)", + "span": { + "offset": 6524, + "length": 13 + } + }, + { + "content": "25a", + "source": "D(2,5.3942,2.1561,5.6966,2.156,5.6965,2.3314,5.3937,2.3315)", + "span": { + "offset": 6547, + "length": 3 + } + }, + { + "content": "100", + "source": "D(2,5.6966,2.156,6.6927,2.1542,6.6933,2.3314,5.6965,2.3314)", + "span": { + "offset": 6560, + "length": 3 + } + }, + { + "content": "b Form(s) 1099", + "source": "D(2,1.2386,2.3325,5.3937,2.3315,5.394,2.5001,1.2388,2.5015)", + "span": { + "offset": 6584, + "length": 14 + } + }, + { + "content": "25b", + "source": "D(2,5.3937,2.3315,5.6965,2.3314,5.6967,2.5,5.394,2.5001)", + "span": { + "offset": 6608, + "length": 3 + } + }, + { + "content": "100", + "source": "D(2,5.6965,2.3314,6.6933,2.3314,6.6935,2.4999,5.6967,2.5)", + "span": { + "offset": 6621, + "length": 3 + } + }, + { + "content": "c Other forms (see instructions)", + "source": "D(2,1.2388,2.5015,5.394,2.5001,5.3936,2.6635,1.2387,2.6653)", + "span": { + "offset": 6645, + "length": 32 + } + }, + { + "content": "25c", + "source": "D(2,5.394,2.5001,5.6967,2.5,5.6968,2.6638,5.3936,2.6635)", + "span": { + "offset": 6687, + "length": 3 + } + }, + { + "content": "100", + "source": "D(2,5.6967,2.5,6.6935,2.4999,6.6925,2.6642,5.6968,2.6638)", + "span": { + "offset": 6700, + "length": 3 + } + }, + { + "content": "d Add lines 25a through 25c", + "source": "D(2,1.2387,2.6653,6.6925,2.6642,6.6927,2.832,1.2385,2.8331)", + "span": { + "offset": 6736, + "length": 27 + } + }, + { + "content": "25d", + "source": "D(2,6.6925,2.6642,6.9936,2.6634,6.9935,2.8317,6.6927,2.832)", + "span": { + "offset": 6773, + "length": 3 + } + }, + { + "content": ". If you have a qualifying child, attach Sch. EIC. . If you have nontaxable combat pay, see instructions.", + "source": "D(2,0.413,2.8335,1.2385,2.8331,1.2384,4.1668,0.4121,4.1668)", + "span": { + "offset": 6809, + "length": 105 + } + }, + { + "content": "26 2020 estimated tax payments and amount applied from 2019 return", + "source": "D(2,1.2385,2.8331,6.6927,2.832,6.6925,2.9986,1.2386,2.9994)", + "span": { + "offset": 6936, + "length": 66 + } + }, + { + "content": "26", + "source": "D(2,6.6927,2.832,6.9935,2.8317,6.9929,2.9981,6.6925,2.9986)", + "span": { + "offset": 7012, + "length": 2 + } + }, + { + "content": "100", + "source": "D(2,6.9935,2.8317,8.0009,2.8313,8.0009,2.9981,6.9929,2.9981)", + "span": { + "offset": 7024, + "length": 3 + } + }, + { + "content": "27 Earned income credit (EIC)", + "source": "D(2,1.2386,2.9994,5.3936,2.998,5.3931,3.16,1.2391,3.1619)", + "span": { + "offset": 7048, + "length": 29 + } + }, + { + "content": "27", + "source": "D(2,5.3936,2.998,5.6962,2.9985,5.6961,3.1598,5.3931,3.16)", + "span": { + "offset": 7087, + "length": 2 + } + }, + { + "content": "200", + "source": "D(2,5.6962,2.9985,6.6925,2.9986,6.6934,3.1598,5.6961,3.1598)", + "span": { + "offset": 7099, + "length": 3 + } + }, + { + "content": "1600", + "source": "D(2,6.9929,2.9981,8.0009,2.9981,8.001,4.0026,6.9932,4.0024)", + "span": { + "offset": 7134, + "length": 4 + } + }, + { + "content": "28 Additional child tax credit. Attach Schedule 8812", + "source": "D(2,1.2391,3.1619,5.3931,3.16,5.3931,3.3281,1.2388,3.329)", + "span": { + "offset": 7159, + "length": 52 + } + }, + { + "content": "28", + "source": "D(2,5.3931,3.16,5.6961,3.1598,5.696,3.328,5.3931,3.3281)", + "span": { + "offset": 7221, + "length": 2 + } + }, + { + "content": "300", + "source": "D(2,5.6961,3.1598,6.6934,3.1598,6.6938,3.3281,5.696,3.328)", + "span": { + "offset": 7233, + "length": 3 + } + }, + { + "content": "29 American opportunity credit from Form 8863, line 8", + "source": "D(2,1.2388,3.329,5.3931,3.3281,5.3928,3.4971,1.2383,3.4983)", + "span": { + "offset": 7279, + "length": 53 + } + }, + { + "content": "29", + "source": "D(2,5.3931,3.3281,5.696,3.328,5.6958,3.497,5.3928,3.4971)", + "span": { + "offset": 7342, + "length": 2 + } + }, + { + "content": "400", + "source": "D(2,5.696,3.328,6.6938,3.3281,6.6937,3.4972,5.6958,3.497)", + "span": { + "offset": 7354, + "length": 3 + } + }, + { + "content": "30 Recovery rebate credit. See instructions", + "source": "D(2,1.2383,3.4983,5.3928,3.4971,5.3944,3.6636,1.2386,3.6644)", + "span": { + "offset": 7378, + "length": 43 + } + }, + { + "content": "30", + "source": "D(2,5.3928,3.4971,5.6958,3.497,5.6974,3.6633,5.3944,3.6636)", + "span": { + "offset": 7431, + "length": 2 + } + }, + { + "content": "500", + "source": "D(2,5.6958,3.497,6.6937,3.4972,6.6936,3.6637,5.6974,3.6633)", + "span": { + "offset": 7443, + "length": 3 + } + }, + { + "content": "31 Amount from Schedule 3, line 13", + "source": "D(2,1.2386,3.6644,5.3944,3.6636,5.3943,3.8325,1.2387,3.8346)", + "span": { + "offset": 7467, + "length": 34 + } + }, + { + "content": "31", + "source": "D(2,5.3944,3.6636,5.6974,3.6633,5.6973,3.8327,5.3943,3.8325)", + "span": { + "offset": 7511, + "length": 2 + } + }, + { + "content": "200", + "source": "D(2,5.6974,3.6633,6.6936,3.6637,6.693,3.8327,5.6973,3.8327)", + "span": { + "offset": 7523, + "length": 3 + } + }, + { + "content": "32 Add lines 27 through 31. These are your total other payments and refundable credits", + "source": "D(2,1.2387,3.8346,6.693,3.8327,6.6932,4.0026,1.2383,4.0041)", + "span": { + "offset": 7559, + "length": 86 + } + }, + { + "content": "32", + "source": "D(2,6.693,3.8327,6.9935,3.8318,6.9932,4.0024,6.6932,4.0026)", + "span": { + "offset": 7655, + "length": 2 + } + }, + { + "content": "33 Add lines 25d, 26, and 32. These are your total payments", + "source": "D(2,1.2383,4.0041,6.6932,4.0026,6.6931,4.1652,1.2384,4.1668)", + "span": { + "offset": 7690, + "length": 59 + } + }, + { + "content": "33", + "source": "D(2,6.6932,4.0026,6.9932,4.0024,6.9932,4.1648,6.6931,4.1652)", + "span": { + "offset": 7759, + "length": 2 + } + }, + { + "content": "2000", + "source": "D(2,6.9932,4.0024,8.001,4.0026,8.0013,4.1649,6.9932,4.1648)", + "span": { + "offset": 7771, + "length": 4 + } + }, + { + "content": "Refund Direct deposit? See instructions.", + "source": "D(2,0.4121,4.1668,1.2384,4.1668,1.2385,4.9955,0.4122,4.9957)", + "span": { + "offset": 7808, + "length": 40 + } + }, + { + "content": "34 If line 33 is more than line 24, subtract line 24 from line 33. This is the amount you overpaid . .", + "source": "D(2,1.2384,4.1668,6.6931,4.1652,6.6935,4.3331,1.2384,4.3347)", + "span": { + "offset": 7870, + "length": 102 + } + }, + { + "content": "34", + "source": "D(2,6.6931,4.1652,6.9932,4.1648,6.9933,4.3329,6.6935,4.3331)", + "span": { + "offset": 7982, + "length": 2 + } + }, + { + "content": "200", + "source": "D(2,6.9932,4.1648,8.0013,4.1649,8.0013,4.3331,6.9933,4.3329)", + "span": { + "offset": 7994, + "length": 3 + } + }, + { + "content": "a Amount of line 34 you want refunded to you. If Form 8888 is attached, check here\n35a\n☐ . . .", + "source": "D(2,1.2384,4.3347,6.6935,4.3331,6.6936,4.4978,1.2383,4.4998)", + "span": { + "offset": 8030, + "length": 94 + } + }, + { + "content": "35a", + "source": "D(2,6.6935,4.3331,6.9933,4.3329,6.9935,4.4976,6.6936,4.4978)", + "span": { + "offset": 8134, + "length": 3 + } + }, + { + "content": "300", + "source": "D(2,6.9933,4.3329,8.0013,4.3331,8.0009,4.4979,6.9935,4.4976)", + "span": { + "offset": 8147, + "length": 3 + } + }, + { + "content": "b Routing number 520555555 c Type: ☑ Checking ☐ Savings", + "source": "D(2,1.2383,4.4998,6.6936,4.4978,6.6932,4.6593,1.2383,4.6618)", + "span": { + "offset": 8183, + "length": 55 + } + }, + { + "content": "d Account number 12333365478901200", + "source": "D(2,1.2383,4.6618,6.6932,4.6593,6.6934,4.8289,1.2386,4.8302)", + "span": { + "offset": 8315, + "length": 34 + } + }, + { + "content": "6 Amount of line 34 you want applied to your 2021 estimated tax\n36", + "source": "D(2,1.2386,4.8302,5.3939,4.8294,5.3944,4.9953,1.2385,4.9955)", + "span": { + "offset": 8370, + "length": 66 + } + }, + { + "content": "36", + "source": "D(2,5.3939,4.8294,5.6963,4.8296,5.6976,4.9955,5.3944,4.9953)", + "span": { + "offset": 8446, + "length": 2 + } + }, + { + "content": "1200", + "source": "D(2,5.6963,4.8296,6.6934,4.8289,6.6933,4.9953,5.6976,4.9955)", + "span": { + "offset": 8458, + "length": 4 + } + }, + { + "content": "Amount You Owe For details on how to pay, see instructions.", + "source": "D(2,0.4122,4.9957,1.2385,4.9955,1.2395,5.664,0.4113,5.6638)", + "span": { + "offset": 8495, + "length": 59 + } + }, + { + "content": "37 Subtract line 33 from line 24. This is the amount you owe now . . . . . . . . .", + "source": "D(2,1.2385,4.9955,6.6933,4.9953,6.6933,5.1774,1.2378,5.1795)", + "span": { + "offset": 8576, + "length": 82 + } + }, + { + "content": "37", + "source": "D(2,6.6933,4.9953,6.9932,4.9952,6.9936,5.1772,6.6933,5.1774)", + "span": { + "offset": 8668, + "length": 2 + } + }, + { + "content": "230", + "source": "D(2,6.9932,4.9952,8.0012,4.9954,8.0014,5.177,6.9936,5.1772)", + "span": { + "offset": 8680, + "length": 3 + } + }, + { + "content": "Note: Schedule H and Schedule SE filers, line 37 may not represent all of the taxes you owe for", + "source": "D(2,1.2378,5.1795,6.6933,5.1774,6.6928,5.3364,1.2381,5.3388)", + "span": { + "offset": 8716, + "length": 95 + } + }, + { + "content": "2020. See Schedule 3, line 12e, and its instructions for details.", + "source": "D(2,1.2381,5.3388,6.6928,5.3364,6.6934,5.4972,1.2381,5.4986)", + "span": { + "offset": 8888, + "length": 65 + } + }, + { + "content": "38 Estimated tax penalty (see instructions)", + "source": "D(2,1.2381,5.4986,5.3927,5.4976,5.3936,5.6633,1.2395,5.664)", + "span": { + "offset": 8974, + "length": 43 + } + }, + { + "content": "38", + "source": "D(2,5.3927,5.4976,5.6958,5.4975,5.6965,5.6635,5.3936,5.6633)", + "span": { + "offset": 9027, + "length": 2 + } + }, + { + "content": "231", + "source": "D(2,5.6958,5.4975,6.6934,5.4972,6.6947,5.664,5.6965,5.6635)", + "span": { + "offset": 9039, + "length": 3 + } + }, + { + "role": "sectionHeading", + "content": "Third Party Designee", + "source": "D(2,0.4929,5.7031,1.2079,5.7146,1.2033,6.0055,0.4882,5.9941)", + "span": { + "offset": 9065, + "length": 22 + } + }, + { + "content": "Do you want to allow another person to discuss this return with the IRS? See instructions", + "source": "D(2,1.387,5.7089,5.6072,5.7043,5.6074,5.9526,1.3873,5.9572)", + "span": { + "offset": 9089, + "length": 89 + } + }, + { + "content": "☑ Yes. Complete below. ☐ No", + "source": "D(2,5.6902,5.8209,7.3973,5.8404,7.3957,5.9797,5.6886,5.9602)", + "span": { + "offset": 9180, + "length": 27 + } + }, + { + "content": "Designee's name Joy Morgan", + "source": "D(2,1.3859,6.0132,2.9176,6.0108,2.918,6.2417,1.3863,6.2441)", + "span": { + "offset": 9209, + "length": 26 + } + }, + { + "content": "Phone no. 321875280", + "source": "D(2,4.1862,6.0134,5.1797,6.0134,5.1797,6.2416,4.1862,6.2416)", + "span": { + "offset": 9237, + "length": 19 + } + }, + { + "content": "Personal identification number (PIN) 35480", + "source": "D(2,5.9871,5.9941,8.0055,6.0266,8.0016,6.2684,5.9832,6.2358)", + "span": { + "offset": 9258, + "length": 42 + } + }, + { + "role": "sectionHeading", + "content": "Sign Here", + "source": "D(2,0.4869,6.3052,0.8788,6.2996,0.8837,6.6507,0.4918,6.6563)", + "span": { + "offset": 9303, + "length": 12 + } + }, + { + "content": "Under penalties of perjury, I declare that I have examined this return and accompanying schedules and statements, and to the best of my knowledge and belief, they are true, correct, and complete. Declaration of preparer (other than taxpayer) is based on all information of which preparer has any knowledge.", + "source": "D(2,1.3874,6.2942,8.0062,6.3017,8.006,6.5495,1.3871,6.542)", + "span": { + "offset": 9317, + "length": 306 + } + }, + { + "content": "Your signature Robert morgan", + "source": "D(2,1.3926,6.5652,3.3697,6.6906,3.3501,7,1.373,6.8746)", + "span": { + "offset": 9625, + "length": 28 + } + }, + { + "content": "Date 12/10/1986", + "source": "D(2,3.8267,6.6044,4.4326,6.6044,4.4326,6.8965,3.8267,6.8965)", + "span": { + "offset": 9655, + "length": 15 + } + }, + { + "content": "Your occupation Judge", + "source": "D(2,4.5468,6.6072,5.2793,6.5943,5.2854,6.94,4.5529,6.9529)", + "span": { + "offset": 9672, + "length": 21 + } + }, + { + "content": "If the IRS sent you an Identity Protection PIN, enter it here (see inst.) 520000", + "source": "D(2,6.4382,6.5884,7.9952,6.5939,7.9937,7.0045,6.4367,6.999)", + "span": { + "offset": 9695, + "length": 80 + } + }, + { + "content": "Joint return? See instructions. Keep a copy for your records.", + "source": "D(2,0.4838,6.8803,1.1732,6.8803,1.1732,7.3501,0.4838,7.3501)", + "span": { + "offset": 9777, + "length": 61 + } + }, + { + "content": "Spouse's signature. If a joint return, both must sign.", + "source": "D(2,1.3862,7.0221,3.6565,7.0221,3.6565,7.1456,1.3862,7.1456)", + "span": { + "offset": 9840, + "length": 54 + } + }, + { + "content": "Date", + "source": "D(2,3.8453,7.0254,4.0591,7.0254,4.0591,7.1221,3.8453,7.1221)", + "span": { + "offset": 9896, + "length": 4 + } + }, + { + "content": "Spouse's occupation", + "source": "D(2,4.5405,7.0254,5.4785,7.0254,5.4785,7.1435,4.5405,7.1435)", + "span": { + "offset": 9902, + "length": 19 + } + }, + { + "content": "If the IRS sent your spouse an Identity Protection PIN, enter it here (see inst.)", + "source": "D(2,6.4414,7.0133,8.002,7.0133,8.002,7.3799,6.4414,7.3799)", + "span": { + "offset": 9923, + "length": 81 + } + }, + { + "content": "Phone no. 00141386305445", + "source": "D(2,1.3851,7.4402,3.2643,7.4379,3.2644,7.5571,1.3852,7.5594)", + "span": { + "offset": 10006, + "length": 24 + } + }, + { + "content": "Email address robert99@gmail.com.us", + "source": "D(2,3.8453,7.4425,5.794,7.4439,5.7939,7.5634,3.8453,7.5621)", + "span": { + "offset": 10032, + "length": 35 + } + }, + { + "role": "sectionHeading", + "content": "Paid Preparer Use Only", + "source": "D(2,0.4942,7.6657,1.162,7.6675,1.1606,8.1766,0.4927,8.1748)", + "span": { + "offset": 10070, + "length": 24 + } + }, + { + "content": "Preparer's name Mark Kelly", + "source": "D(2,1.2877,7.6042,2.125,7.6042,2.125,7.8848,1.2877,7.8848)", + "span": { + "offset": 10096, + "length": 26 + } + }, + { + "content": "Preparer's signature mark Kelly", + "source": "D(2,3.0384,7.5912,4.9938,7.6283,4.9888,7.8907,3.0335,7.8535)", + "span": { + "offset": 10124, + "length": 31 + } + }, + { + "content": "Date 10/20/1990", + "source": "D(2,5.4453,7.6153,6.072,7.6153,6.072,7.8472,5.4453,7.8472)", + "span": { + "offset": 10157, + "length": 15 + } + }, + { + "content": "PTIN 09870", + "source": "D(2,6.2755,7.6018,6.7571,7.6096,6.7527,7.8839,6.271,7.8761)", + "span": { + "offset": 10174, + "length": 10 + } + }, + { + "content": "Check if:", + "source": "D(2,7.0429,7.6103,7.4375,7.6091,7.4378,7.7171,7.0432,7.7183)", + "span": { + "offset": 10186, + "length": 9 + } + }, + { + "content": "☐ Self-employed", + "source": "D(2,7.093,7.7559,7.8857,7.7559,7.8857,7.8848,7.093,7.8848)", + "span": { + "offset": 10197, + "length": 15 + } + }, + { + "content": "Firm's name ANM company", + "source": "D(2,1.3897,7.9273,2.9101,7.9407,2.9089,8.0826,1.3884,8.0692)", + "span": { + "offset": 10214, + "length": 23 + } + }, + { + "content": "Phone no. 8760765000876", + "source": "D(2,6.4391,7.9414,7.8689,7.9164,7.8714,8.0567,6.4416,8.0817)", + "span": { + "offset": 10239, + "length": 23 + } + }, + { + "content": "Firm's address 9220 BELHAVEN LOS ANGELES CA 90002-2009 USA", + "source": "D(2,1.3888,8.1136,5.0469,8.1068,5.0471,8.2323,1.389,8.2391)", + "span": { + "offset": 10264, + "length": 58 + } + }, + { + "content": "Firm's EIN 080686", + "source": "D(2,6.4408,8.121,7.7124,8.1133,7.7131,8.2296,6.4415,8.2372)", + "span": { + "offset": 10324, + "length": 17 + } + }, + { + "role": "pageFooter", + "content": "Go to www.irs.gov/Form1040 for instructions and the latest information.", + "source": "D(2,0.4882,8.2975,3.6171,8.2927,3.6173,8.4139,0.4884,8.4188)", + "span": { + "offset": 10343, + "length": 93 + } + }, + { + "role": "pageFooter", + "content": "Form 1040 (2020)", + "source": "D(2,7.2175,8.2983,8.0061,8.2983,8.0061,8.4165,7.2175,8.4165)", + "span": { + "offset": 10437, + "length": 38 + } + } + ], + "sections": [ + { + "span": { + "offset": 308, + "length": 10033 + }, + "elements": [ + "/sections/1", + "/sections/2", + "/sections/4" + ] + }, + { + "span": { + "offset": 308, + "length": 8754 + }, + "elements": [ + "/paragraphs/6", + "/paragraphs/7", + "/paragraphs/8", + "/paragraphs/9", + "/paragraphs/10", + "/paragraphs/11", + "/paragraphs/12", + "/paragraphs/13", + "/paragraphs/14", + "/paragraphs/15", + "/paragraphs/16", + "/paragraphs/17", + "/paragraphs/18", + "/paragraphs/19", + "/paragraphs/20", + "/paragraphs/21", + "/paragraphs/22", + "/paragraphs/23", + "/paragraphs/24", + "/paragraphs/25", + "/paragraphs/26", + "/paragraphs/27", + "/paragraphs/28", + "/paragraphs/29", + "/paragraphs/30", + "/paragraphs/31", + "/paragraphs/32", + "/paragraphs/33", + "/paragraphs/34", + "/tables/0", + "/tables/1", + "/tables/2" + ] + }, + { + "span": { + "offset": 9065, + "length": 1002 + }, + "elements": [ + "/paragraphs/219", + "/paragraphs/220", + "/paragraphs/221", + "/paragraphs/222", + "/paragraphs/223", + "/paragraphs/224", + "/sections/3" + ] + }, + { + "span": { + "offset": 9303, + "length": 764 + }, + "elements": [ + "/paragraphs/225", + "/paragraphs/226", + "/paragraphs/227", + "/paragraphs/228", + "/paragraphs/229", + "/paragraphs/230", + "/paragraphs/231", + "/paragraphs/232", + "/paragraphs/233", + "/paragraphs/234", + "/paragraphs/235", + "/paragraphs/236", + "/paragraphs/237" + ] + }, + { + "span": { + "offset": 10070, + "length": 271 + }, + "elements": [ + "/paragraphs/238", + "/paragraphs/239", + "/paragraphs/240", + "/paragraphs/241", + "/paragraphs/242", + "/paragraphs/243", + "/paragraphs/244", + "/paragraphs/245", + "/paragraphs/246", + "/paragraphs/247", + "/paragraphs/248" + ] + } + ], + "tables": [ + { + "rowCount": 5, + "columnCount": 9, + "cells": [ + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 0, + "rowSpan": 5, + "columnSpan": 1, + "content": "Dependents If more than four dependents, see instructions and check here ☐", + "source": "D(1,0.4414,3.9065,1.2936,3.9054,1.2931,4.9149,0.4375,4.9144)", + "span": { + "offset": 1882, + "length": 74 + }, + "elements": [ + "/paragraphs/35" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "(see instructions): (1) First name", + "source": "D(1,1.2936,3.9054,2.2786,3.9055,2.2792,4.2475,1.2933,4.2474)", + "span": { + "offset": 1966, + "length": 34 + }, + "elements": [ + "/paragraphs/36" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "Last name", + "source": "D(1,2.2786,3.9055,3.7063,3.9061,3.7062,4.2468,2.2792,4.2475)", + "span": { + "offset": 2010, + "length": 9 + }, + "elements": [ + "/paragraphs/37" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 3, + "content": "(2) Social security number", + "source": "D(1,3.7063,3.9061,4.9002,3.9069,4.9007,4.2471,3.7062,4.2468)", + "span": { + "offset": 2041, + "length": 26 + }, + "elements": [ + "/paragraphs/38" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "(3) Relationship to you", + "source": "D(1,4.9002,3.9069,5.8,3.9077,5.8003,4.2467,4.9007,4.2471)", + "span": { + "offset": 2077, + "length": 23 + }, + "elements": [ + "/paragraphs/39" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "(4) ✓ if qualifies for\nChild tax credit", + "source": "D(1,5.8,3.9077,6.9019,3.9081,6.9024,4.2468,5.8003,4.2467)", + "span": { + "offset": 2110, + "length": 39 + }, + "elements": [ + "/paragraphs/40" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "(see instructions):\nCredit for other dependents", + "source": "D(1,6.9019,3.9081,7.9981,3.91,7.9979,4.247,6.9024,4.2468)", + "span": { + "offset": 2159, + "length": 47 + }, + "elements": [ + "/paragraphs/41" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "Milsa", + "source": "D(1,1.2933,4.2474,2.2792,4.2475,2.2793,4.418,1.2931,4.4183)", + "span": { + "offset": 2227, + "length": 5 + }, + "elements": [ + "/paragraphs/42" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "Hill", + "source": "D(1,2.2792,4.2475,3.7062,4.2468,3.7062,4.4175,2.2793,4.418)", + "span": { + "offset": 2242, + "length": 4 + }, + "elements": [ + "/paragraphs/43" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,3.7062,4.2468,4.0705,4.2475,4.0713,4.4175,3.7062,4.4175)", + "span": { + "offset": 2256, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.0705,4.2475,4.3298,4.2477,4.3305,4.4177,4.0713,4.4175)", + "span": { + "offset": 2266, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "052000520", + "source": "D(1,4.3298,4.2477,4.9007,4.2471,4.9005,4.4173,4.3305,4.4177)", + "span": { + "offset": 2276, + "length": 9 + }, + "elements": [ + "/paragraphs/44" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "friend", + "source": "D(1,4.9007,4.2471,5.8003,4.2467,5.8,4.4171,4.9005,4.4173)", + "span": { + "offset": 2295, + "length": 6 + }, + "elements": [ + "/paragraphs/45" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,5.8003,4.2467,6.9024,4.2468,6.9023,4.417,5.8,4.4171)", + "span": { + "offset": 2311, + "length": 1 + }, + "elements": [ + "/paragraphs/46" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,6.9024,4.2468,7.9979,4.247,7.9977,4.4172,6.9023,4.417)", + "span": { + "offset": 2322, + "length": 1 + }, + "elements": [ + "/paragraphs/47" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "Amanda", + "source": "D(1,1.2931,4.4183,2.2793,4.418,2.2784,4.5805,1.293,4.581)", + "span": { + "offset": 2344, + "length": 6 + }, + "elements": [ + "/paragraphs/48" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "Hill", + "source": "D(1,2.2793,4.418,3.7062,4.4175,3.706,4.5804,2.2784,4.5805)", + "span": { + "offset": 2360, + "length": 4 + }, + "elements": [ + "/paragraphs/49" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "5 2 0", + "source": "D(1,3.7062,4.4175,4.0713,4.4175,4.071,4.5802,3.706,4.5804)", + "span": { + "offset": 2374, + "length": 5 + }, + "elements": [ + "/paragraphs/50" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "8 5", + "source": "D(1,4.0713,4.4175,4.3305,4.4177,4.3307,4.5804,4.071,4.5802)", + "span": { + "offset": 2389, + "length": 3 + }, + "elements": [ + "/paragraphs/51" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "2 0 0 0", + "source": "D(1,4.3305,4.4177,4.9005,4.4173,4.9003,4.5805,4.3307,4.5804)", + "span": { + "offset": 2402, + "length": 7 + }, + "elements": [ + "/paragraphs/52" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "friend", + "source": "D(1,4.9005,4.4173,5.8,4.4171,5.7995,4.5802,4.9003,4.5805)", + "span": { + "offset": 2419, + "length": 6 + }, + "elements": [ + "/paragraphs/53" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,5.8,4.4171,6.9023,4.417,6.902,4.5803,5.7995,4.5802)", + "span": { + "offset": 2435, + "length": 1 + }, + "elements": [ + "/paragraphs/54" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,6.9023,4.417,7.9977,4.4172,7.9977,4.5808,6.902,4.5803)", + "span": { + "offset": 2446, + "length": 1 + }, + "elements": [ + "/paragraphs/55" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,1.293,4.581,2.2784,4.5805,2.2778,4.7519,1.2926,4.7528)", + "span": { + "offset": 2468, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,2.2784,4.5805,3.706,4.5804,3.7059,4.7508,2.2778,4.7519)", + "span": { + "offset": 2478, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,3.706,4.5804,4.071,4.5802,4.0708,4.7508,3.7059,4.7508)", + "span": { + "offset": 2488, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.071,4.5802,4.3307,4.5804,4.3305,4.7508,4.0708,4.7508)", + "span": { + "offset": 2498, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.3307,4.5804,4.9003,4.5805,4.9,4.751,4.3305,4.7508)", + "span": { + "offset": 2508, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.9003,4.5805,5.7995,4.5802,5.7996,4.7504,4.9,4.751)", + "span": { + "offset": 2518, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,5.7995,4.5802,6.902,4.5803,6.9021,4.75,5.7996,4.7504)", + "span": { + "offset": 2528, + "length": 1 + }, + "elements": [ + "/paragraphs/56" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,6.902,4.5803,7.9977,4.5808,7.9976,4.7503,6.9021,4.75)", + "span": { + "offset": 2539, + "length": 1 + }, + "elements": [ + "/paragraphs/57" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,1.2926,4.7528,2.2778,4.7519,2.2797,4.9145,1.2931,4.9149)", + "span": { + "offset": 2561, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,2.2778,4.7519,3.7059,4.7508,3.7061,4.9144,2.2797,4.9145)", + "span": { + "offset": 2571, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,3.7059,4.7508,4.0708,4.7508,4.0715,4.9139,3.7061,4.9144)", + "span": { + "offset": 2581, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.0708,4.7508,4.3305,4.7508,4.3316,4.9142,4.0715,4.9139)", + "span": { + "offset": 2591, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.3305,4.7508,4.9,4.751,4.9008,4.9146,4.3316,4.9142)", + "span": { + "offset": 2601, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.9,4.751,5.7996,4.7504,5.8006,4.9145,4.9008,4.9146)", + "span": { + "offset": 2611, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,5.7996,4.7504,6.9021,4.75,6.9032,4.9142,5.8006,4.9145)", + "span": { + "offset": 2621, + "length": 1 + }, + "elements": [ + "/paragraphs/58" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,6.9021,4.75,7.9976,4.7503,7.9979,4.9146,6.9032,4.9142)", + "span": { + "offset": 2632, + "length": 1 + }, + "elements": [ + "/paragraphs/59" + ] + } + ], + "source": "D(1,0.4571,3.9316,8.0061,3.9209,8.0061,4.8877,0.4584,4.8984)", + "span": { + "offset": 1853, + "length": 800 + } + }, + { + "rowCount": 18, + "columnCount": 9, + "cells": [ + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 0, + "rowSpan": 5, + "columnSpan": 1, + "content": "Attach Sch. B if required.", + "source": "D(1,0.3993,4.9156,1.2067,4.9152,1.2055,5.7513,0.3981,5.7523)", + "span": { + "offset": 2685, + "length": 26 + }, + "elements": [ + "/paragraphs/60" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "1 Wages, salaries, tips, etc. Attach Form(s) W-2", + "source": "D(1,1.2067,4.9152,6.6869,4.9146,6.6868,5.0793,1.2068,5.0798)", + "span": { + "offset": 2733, + "length": 48 + }, + "elements": [ + "/paragraphs/61" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "1", + "source": "D(1,6.6869,4.9146,6.9933,4.9143,6.993,5.0793,6.6868,5.0793)", + "span": { + "offset": 2791, + "length": 1 + }, + "elements": [ + "/paragraphs/62" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(1,6.9933,4.9143,8.0109,4.9147,8.011,5.0792,6.993,5.0793)", + "span": { + "offset": 2802, + "length": 3 + }, + "elements": [ + "/paragraphs/63" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "2a Tax-exempt interest . .", + "source": "D(1,1.2068,5.0798,3.2005,5.0788,3.1998,5.2552,1.2063,5.2556)", + "span": { + "offset": 2826, + "length": 26 + }, + "elements": [ + "/paragraphs/64" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "2a", + "source": "D(1,3.2005,5.0788,3.4856,5.0787,3.4849,5.2545,3.1998,5.2552)", + "span": { + "offset": 2862, + "length": 2 + }, + "elements": [ + "/paragraphs/65" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(1,3.4856,5.0787,4.5188,5.079,4.5183,5.2548,3.4849,5.2545)", + "span": { + "offset": 2874, + "length": 3 + }, + "elements": [ + "/paragraphs/66" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Taxable interest", + "source": "D(1,4.5188,5.079,6.6868,5.0793,6.6865,5.2554,4.5183,5.2548)", + "span": { + "offset": 2899, + "length": 18 + }, + "elements": [ + "/paragraphs/67" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "2b", + "source": "D(1,6.6868,5.0793,6.993,5.0793,6.9925,5.2553,6.6865,5.2554)", + "span": { + "offset": 2927, + "length": 2 + }, + "elements": [ + "/paragraphs/68" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "300", + "source": "D(1,6.993,5.0793,8.011,5.0792,8.0111,5.2556,6.9925,5.2553)", + "span": { + "offset": 2939, + "length": 3 + }, + "elements": [ + "/paragraphs/69" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "3a Qualified dividends . . .", + "source": "D(1,1.2063,5.2556,3.1998,5.2552,3.1998,5.4179,1.2057,5.4185)", + "span": { + "offset": 2963, + "length": 28 + }, + "elements": [ + "/paragraphs/70" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "3a", + "source": "D(1,3.1998,5.2552,3.4849,5.2545,3.4844,5.4177,3.1998,5.4179)", + "span": { + "offset": 3001, + "length": 2 + }, + "elements": [ + "/paragraphs/71" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(1,3.4849,5.2545,4.5183,5.2548,4.5177,5.4176,3.4844,5.4177)", + "span": { + "offset": 3013, + "length": 3 + }, + "elements": [ + "/paragraphs/72" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Ordinary dividends", + "source": "D(1,4.5183,5.2548,6.6865,5.2554,6.6857,5.4177,4.5177,5.4176)", + "span": { + "offset": 3038, + "length": 20 + }, + "elements": [ + "/paragraphs/73" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "3b", + "source": "D(1,6.6865,5.2554,6.9925,5.2553,6.9923,5.4177,6.6857,5.4177)", + "span": { + "offset": 3068, + "length": 2 + }, + "elements": [ + "/paragraphs/74" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(1,6.9925,5.2553,8.0111,5.2556,8.011,5.4177,6.9923,5.4177)", + "span": { + "offset": 3080, + "length": 3 + }, + "elements": [ + "/paragraphs/75" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "4a IRA distributions", + "source": "D(1,1.2057,5.4185,3.1998,5.4179,3.1997,5.5824,1.2055,5.583)", + "span": { + "offset": 3104, + "length": 20 + }, + "elements": [ + "/paragraphs/76" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "4a", + "source": "D(1,3.1998,5.4179,3.4844,5.4177,3.4845,5.5821,3.1997,5.5824)", + "span": { + "offset": 3134, + "length": 2 + }, + "elements": [ + "/paragraphs/77" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "300", + "source": "D(1,3.4844,5.4177,4.5177,5.4176,4.5177,5.582,3.4845,5.5821)", + "span": { + "offset": 3146, + "length": 3 + }, + "elements": [ + "/paragraphs/78" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Taxable amount", + "source": "D(1,4.5177,5.4176,6.6857,5.4177,6.6859,5.5821,4.5177,5.582)", + "span": { + "offset": 3171, + "length": 16 + }, + "elements": [ + "/paragraphs/79" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "4b", + "source": "D(1,6.6857,5.4177,6.9923,5.4177,6.9924,5.5821,6.6859,5.5821)", + "span": { + "offset": 3197, + "length": 2 + }, + "elements": [ + "/paragraphs/80" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(1,6.9923,5.4177,8.011,5.4177,8.0111,5.5822,6.9924,5.5821)", + "span": { + "offset": 3209, + "length": 3 + }, + "elements": [ + "/paragraphs/81" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "5a Pensions and annuities . .", + "source": "D(1,1.2055,5.583,3.1997,5.5824,3.2001,5.7502,1.2055,5.7513)", + "span": { + "offset": 3233, + "length": 29 + }, + "elements": [ + "/paragraphs/82" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "5a", + "source": "D(1,3.1997,5.5824,3.4845,5.5821,3.4845,5.75,3.2001,5.7502)", + "span": { + "offset": 3272, + "length": 2 + }, + "elements": [ + "/paragraphs/83" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(1,3.4845,5.5821,4.5177,5.582,4.5186,5.7499,3.4845,5.75)", + "span": { + "offset": 3284, + "length": 3 + }, + "elements": [ + "/paragraphs/84" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Taxable amount", + "source": "D(1,4.5177,5.582,6.6859,5.5821,6.6853,5.7503,4.5186,5.7499)", + "span": { + "offset": 3309, + "length": 16 + }, + "elements": [ + "/paragraphs/85" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "5b", + "source": "D(1,6.6859,5.5821,6.9924,5.5821,6.9922,5.7504,6.6853,5.7503)", + "span": { + "offset": 3335, + "length": 2 + }, + "elements": [ + "/paragraphs/86" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "400", + "source": "D(1,6.9924,5.5821,8.0111,5.5822,8.011,5.7507,6.9922,5.7504)", + "span": { + "offset": 3347, + "length": 3 + }, + "elements": [ + "/paragraphs/87" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 0, + "rowSpan": 13, + "columnSpan": 1, + "content": "Standard Deduction for- . Single or Married filing separately, $12,400 . Married filing jointly or Qualifying widow(er), $24,800 . Head of household, $18,650 . If you checked any box under Standard Deduction, see instructions.", + "source": "D(1,0.3981,5.7523,1.2055,5.7513,1.2072,7.9119,0.3956,7.912)", + "span": { + "offset": 3384, + "length": 226 + }, + "elements": [ + "/paragraphs/88" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "6a Social security benefits .", + "source": "D(1,1.2055,5.7513,3.2001,5.7502,3.2003,5.9104,1.2057,5.9115)", + "span": { + "offset": 3620, + "length": 29 + }, + "elements": [ + "/paragraphs/89" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "6a", + "source": "D(1,3.2001,5.7502,3.4845,5.75,3.4847,5.9106,3.2003,5.9104)", + "span": { + "offset": 3659, + "length": 2 + }, + "elements": [ + "/paragraphs/90" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 4, + "content": "100 b Taxable amount", + "source": "D(1,3.4845,5.75,6.6853,5.7503,6.6858,5.9108,3.4847,5.9106)", + "span": { + "offset": 3683, + "length": 20 + }, + "elements": [ + "/paragraphs/91" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "6b", + "source": "D(1,6.6853,5.7503,6.9922,5.7504,6.9933,5.9109,6.6858,5.9108)", + "span": { + "offset": 3713, + "length": 2 + }, + "elements": [ + "/paragraphs/92" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "500", + "source": "D(1,6.9922,5.7504,8.011,5.7507,8.011,5.9116,6.9933,5.9109)", + "span": { + "offset": 3725, + "length": 3 + }, + "elements": [ + "/paragraphs/93" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "7 Capital gain or (loss). Attach Schedule D if required. If not required, check here ☐", + "source": "D(1,1.2057,5.9115,6.6858,5.9108,6.6857,6.0836,1.2055,6.0838)", + "span": { + "offset": 3761, + "length": 86 + }, + "elements": [ + "/paragraphs/94" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "7", + "source": "D(1,6.6858,5.9108,6.9933,5.9109,6.9935,6.0835,6.6857,6.0836)", + "span": { + "offset": 3857, + "length": 1 + }, + "elements": [ + "/paragraphs/95" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(1,6.9933,5.9109,8.011,5.9116,8.011,6.084,6.9935,6.0835)", + "span": { + "offset": 3868, + "length": 3 + }, + "elements": [ + "/paragraphs/96" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "8 Other income from Schedule 1, line 9", + "source": "D(1,1.2055,6.0838,6.6857,6.0836,6.686,6.2474,1.2056,6.2481)", + "span": { + "offset": 3904, + "length": 38 + }, + "elements": [ + "/paragraphs/97" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "8", + "source": "D(1,6.6857,6.0836,6.9935,6.0835,6.9936,6.2477,6.686,6.2474)", + "span": { + "offset": 3952, + "length": 1 + }, + "elements": [ + "/paragraphs/98" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "180", + "source": "D(1,6.9935,6.0835,8.011,6.084,8.0113,6.2482,6.9936,6.2477)", + "span": { + "offset": 3963, + "length": 3 + }, + "elements": [ + "/paragraphs/99" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "9 Add lines 1, 2b, 3b, 4b, 5b, 6b, 7, and 8. This is your total income", + "source": "D(1,1.2056,6.2481,6.686,6.2474,6.6844,6.4102,1.205,6.4111)", + "span": { + "offset": 3999, + "length": 70 + }, + "elements": [ + "/paragraphs/100" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "9", + "source": "D(1,6.686,6.2474,6.9936,6.2477,6.9923,6.4098,6.6844,6.4102)", + "span": { + "offset": 4079, + "length": 1 + }, + "elements": [ + "/paragraphs/101" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "1980", + "source": "D(1,6.9936,6.2477,8.0113,6.2482,8.0112,6.4102,6.9923,6.4098)", + "span": { + "offset": 4090, + "length": 4 + }, + "elements": [ + "/paragraphs/102" + ] + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "10 Adjustments to income:", + "source": "D(1,1.205,6.4111,6.6844,6.4102,6.6856,6.5748,1.2051,6.5786)", + "span": { + "offset": 4127, + "length": 25 + }, + "elements": [ + "/paragraphs/103" + ] + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 7, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(1,6.6844,6.4102,6.9923,6.4098,6.993,6.9182,6.6857,6.9182)", + "span": { + "offset": 4174, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 8, + "rowSpan": 4, + "columnSpan": 1, + "content": "400", + "source": "D(1,6.9923,6.4098,8.0112,6.4102,8.012,7.0769,6.994,7.0767)", + "span": { + "offset": 4196, + "length": 3 + }, + "elements": [ + "/paragraphs/104" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 4, + "content": "a From Schedule 1, line 22", + "source": "D(1,1.2051,6.5786,5.3994,6.5757,5.4003,6.7508,1.205,6.7518)", + "span": { + "offset": 4232, + "length": 26 + }, + "elements": [ + "/paragraphs/105" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "10a", + "source": "D(1,5.3994,6.5757,5.6924,6.5756,5.6932,6.7507,5.4003,6.7508)", + "span": { + "offset": 4268, + "length": 3 + }, + "elements": [ + "/paragraphs/106" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(1,5.6924,6.5756,6.6856,6.5748,6.6856,6.7509,5.6932,6.7507)", + "span": { + "offset": 4281, + "length": 3 + }, + "elements": [ + "/paragraphs/107" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 4, + "content": "b Charitable contributions if you take the standard deduction. See instructions", + "source": "D(1,1.205,6.7518,5.4003,6.7508,5.3981,6.9176,1.205,6.9192)", + "span": { + "offset": 4317, + "length": 79 + }, + "elements": [ + "/paragraphs/108" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "10b", + "source": "D(1,5.4003,6.7508,5.6932,6.7507,5.6918,6.9178,5.3981,6.9176)", + "span": { + "offset": 4406, + "length": 3 + }, + "elements": [ + "/paragraphs/109" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(1,5.6932,6.7507,6.6856,6.7509,6.6857,6.9182,5.6918,6.9178)", + "span": { + "offset": 4419, + "length": 3 + }, + "elements": [ + "/paragraphs/110" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "c Add lines 10a and 10b. These are your total adjustments to income", + "source": "D(1,1.205,6.9192,6.6857,6.9182,6.6862,7.0768,1.2051,7.0791)", + "span": { + "offset": 4455, + "length": 67 + }, + "elements": [ + "/paragraphs/111" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "10c", + "source": "D(1,6.6857,6.9182,6.993,6.9182,6.994,7.0767,6.6862,7.0768)", + "span": { + "offset": 4532, + "length": 3 + }, + "elements": [ + "/paragraphs/112" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "11 Subtract line 10c from line 9. This is your adjusted gross income", + "source": "D(1,1.2051,7.0791,6.6862,7.0768,6.6862,7.251,1.2051,7.2519)", + "span": { + "offset": 4568, + "length": 68 + }, + "elements": [ + "/paragraphs/113" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "11", + "source": "D(1,6.6862,7.0768,6.994,7.0767,6.9939,7.251,6.6862,7.251)", + "span": { + "offset": 4646, + "length": 2 + }, + "elements": [ + "/paragraphs/114" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "1880", + "source": "D(1,6.994,7.0767,8.012,7.0769,8.0121,7.2511,6.9939,7.251)", + "span": { + "offset": 4658, + "length": 4 + }, + "elements": [ + "/paragraphs/115" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "12 Standard deduction or itemized deductions (from Schedule A)", + "source": "D(1,1.2051,7.2519,6.6862,7.251,6.6859,7.4131,1.205,7.415)", + "span": { + "offset": 4695, + "length": 62 + }, + "elements": [ + "/paragraphs/116" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "12", + "source": "D(1,6.6862,7.251,6.9939,7.251,6.9935,7.4131,6.6859,7.4131)", + "span": { + "offset": 4767, + "length": 2 + }, + "elements": [ + "/paragraphs/117" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(1,6.9939,7.251,8.0121,7.2511,8.012,7.4126,6.9935,7.4131)", + "span": { + "offset": 4779, + "length": 3 + }, + "elements": [ + "/paragraphs/118" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "13 Qualified business income deduction. Attach Form 8995 or Form 8995-A", + "source": "D(1,1.205,7.415,6.6859,7.4131,6.6864,7.5788,1.2052,7.5795)", + "span": { + "offset": 4815, + "length": 71 + }, + "elements": [ + "/paragraphs/119" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "13", + "source": "D(1,6.6859,7.4131,6.9935,7.4131,6.9939,7.579,6.6864,7.5788)", + "span": { + "offset": 4896, + "length": 2 + }, + "elements": [ + "/paragraphs/120" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(1,6.9935,7.4131,8.012,7.4126,8.0123,7.5791,6.9939,7.579)", + "span": { + "offset": 4908, + "length": 3 + }, + "elements": [ + "/paragraphs/121" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "14 Add lines 12 and 13", + "source": "D(1,1.2052,7.5795,6.6864,7.5788,6.6863,7.7476,1.2053,7.7497)", + "span": { + "offset": 4944, + "length": 22 + }, + "elements": [ + "/paragraphs/122" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "14", + "source": "D(1,6.6864,7.5788,6.9939,7.579,6.9937,7.7474,6.6863,7.7476)", + "span": { + "offset": 4976, + "length": 2 + }, + "elements": [ + "/paragraphs/123" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "500", + "source": "D(1,6.9939,7.579,8.0123,7.5791,8.0119,7.7473,6.9937,7.7474)", + "span": { + "offset": 4988, + "length": 3 + }, + "elements": [ + "/paragraphs/124" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "15 Taxable income. Subtract line 14 from line 11. If zero or less, enter -0-", + "source": "D(1,1.2053,7.7497,6.6863,7.7476,6.6886,7.9109,1.2072,7.9119)", + "span": { + "offset": 5024, + "length": 76 + }, + "elements": [ + "/paragraphs/125" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "15", + "source": "D(1,6.6863,7.7476,6.9937,7.7474,6.996,7.911,6.6886,7.9109)", + "span": { + "offset": 5110, + "length": 2 + }, + "elements": [ + "/paragraphs/126" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "510", + "source": "D(1,6.9937,7.7474,8.0119,7.7473,8.0115,7.9108,6.996,7.911)", + "span": { + "offset": 5122, + "length": 3 + }, + "elements": [ + "/paragraphs/127" + ] + } + ], + "source": "D(1,0.3951,4.9414,8.0061,4.9226,8.002,7.9009,0.3956,7.9009)", + "span": { + "offset": 2656, + "length": 2489 + } + }, + { + "rowCount": 31, + "columnCount": 6, + "cells": [ + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 0, + "rowSpan": 14, + "columnSpan": 1, + "content": "", + "source": "D(2,0.4144,0.4966,1.2407,0.4946,1.2385,2.8331,0.413,2.8335)", + "span": { + "offset": 5459, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "16 Tax (see instructions). Check if any from Form(s): 1 ☐ 8814 2 ☑ 4972 3 ☐ . .", + "source": "D(2,1.2407,0.4946,6.6947,0.494,6.6929,0.6715,1.2396,0.6727)", + "span": { + "offset": 5481, + "length": 79 + }, + "elements": [ + "/paragraphs/133" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "16", + "source": "D(2,6.6947,0.494,6.9948,0.4934,6.9931,0.6706,6.6929,0.6715)", + "span": { + "offset": 5570, + "length": 2 + }, + "elements": [ + "/paragraphs/134" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,6.9948,0.4934,8.0007,0.4942,8.0004,0.6714,6.9931,0.6706)", + "span": { + "offset": 5582, + "length": 3 + }, + "elements": [ + "/paragraphs/135" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "17 Amount from Schedule 2, line 3", + "source": "D(2,1.2396,0.6727,6.6929,0.6715,6.6928,0.8366,1.2393,0.8386)", + "span": { + "offset": 5618, + "length": 33 + }, + "elements": [ + "/paragraphs/136" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "17", + "source": "D(2,6.6929,0.6715,6.9931,0.6706,6.9928,0.8359,6.6928,0.8366)", + "span": { + "offset": 5661, + "length": 2 + }, + "elements": [ + "/paragraphs/137" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,6.9931,0.6706,8.0004,0.6714,8.0009,0.8365,6.9928,0.8359)", + "span": { + "offset": 5673, + "length": 3 + }, + "elements": [ + "/paragraphs/138" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "18 Add lines 16 and 17", + "source": "D(2,1.2393,0.8386,6.6928,0.8366,6.6925,1.0044,1.2388,1.0063)", + "span": { + "offset": 5709, + "length": 22 + }, + "elements": [ + "/paragraphs/139" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "18", + "source": "D(2,6.6928,0.8366,6.9928,0.8359,6.9927,1.0036,6.6925,1.0044)", + "span": { + "offset": 5741, + "length": 2 + }, + "elements": [ + "/paragraphs/140" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,6.9928,0.8359,8.0009,0.8365,8.0005,1.0037,6.9927,1.0036)", + "span": { + "offset": 5753, + "length": 3 + }, + "elements": [ + "/paragraphs/141" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "19 Child tax credit or credit for other dependents", + "source": "D(2,1.2388,1.0063,6.6925,1.0044,6.6924,1.1664,1.2392,1.1683)", + "span": { + "offset": 5789, + "length": 50 + }, + "elements": [ + "/paragraphs/142" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "19", + "source": "D(2,6.6925,1.0044,6.9927,1.0036,6.9928,1.1658,6.6924,1.1664)", + "span": { + "offset": 5849, + "length": 2 + }, + "elements": [ + "/paragraphs/143" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,6.9927,1.0036,8.0005,1.0037,8.0006,1.1658,6.9928,1.1658)", + "span": { + "offset": 5861, + "length": 3 + }, + "elements": [ + "/paragraphs/144" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "20 Amount from Schedule 3, line 7", + "source": "D(2,1.2392,1.1683,6.6924,1.1664,6.692,1.3322,1.2391,1.3338)", + "span": { + "offset": 5897, + "length": 33 + }, + "elements": [ + "/paragraphs/145" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "20", + "source": "D(2,6.6924,1.1664,6.9928,1.1658,6.9925,1.3317,6.692,1.3322)", + "span": { + "offset": 5940, + "length": 2 + }, + "elements": [ + "/paragraphs/146" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,6.9928,1.1658,8.0006,1.1658,8.0006,1.3319,6.9925,1.3317)", + "span": { + "offset": 5952, + "length": 3 + }, + "elements": [ + "/paragraphs/147" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "21 Add lines 19 and 20", + "source": "D(2,1.2391,1.3338,6.692,1.3322,6.6931,1.4979,1.2394,1.4991)", + "span": { + "offset": 5988, + "length": 22 + }, + "elements": [ + "/paragraphs/148" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "21", + "source": "D(2,6.692,1.3322,6.9925,1.3317,6.9931,1.4977,6.6931,1.4979)", + "span": { + "offset": 6020, + "length": 2 + }, + "elements": [ + "/paragraphs/149" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "110", + "source": "D(2,6.9925,1.3317,8.0006,1.3319,8.0007,1.4981,6.9931,1.4977)", + "span": { + "offset": 6032, + "length": 3 + }, + "elements": [ + "/paragraphs/150" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "22 Subtract line 21 from line 18. If zero or less, enter -0-", + "source": "D(2,1.2394,1.4991,6.6931,1.4979,6.6933,1.6637,1.2393,1.6647)", + "span": { + "offset": 6068, + "length": 60 + }, + "elements": [ + "/paragraphs/151" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "22", + "source": "D(2,6.6931,1.4979,6.9931,1.4977,6.9932,1.6634,6.6933,1.6637)", + "span": { + "offset": 6138, + "length": 2 + }, + "elements": [ + "/paragraphs/152" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "1100", + "source": "D(2,6.9931,1.4977,8.0007,1.4981,8.0003,1.6639,6.9932,1.6634)", + "span": { + "offset": 6150, + "length": 4 + }, + "elements": [ + "/paragraphs/153" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "23 Other taxes, including self-employment tax, from Schedule 2, line 10", + "source": "D(2,1.2393,1.6647,6.6933,1.6637,6.6935,1.8332,1.239,1.8343)", + "span": { + "offset": 6187, + "length": 71 + }, + "elements": [ + "/paragraphs/154" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "23", + "source": "D(2,6.6933,1.6637,6.9932,1.6634,6.9936,1.833,6.6935,1.8332)", + "span": { + "offset": 6268, + "length": 2 + }, + "elements": [ + "/paragraphs/155" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "110", + "source": "D(2,6.9932,1.6634,8.0003,1.6639,8.0002,1.8337,6.9936,1.833)", + "span": { + "offset": 6280, + "length": 3 + }, + "elements": [ + "/paragraphs/156" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "24 Add lines 22 and 23. This is your total tax", + "source": "D(2,1.239,1.8343,6.6935,1.8332,6.6915,2.0007,1.2386,2.0023)", + "span": { + "offset": 6316, + "length": 46 + }, + "elements": [ + "/paragraphs/157" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "24", + "source": "D(2,6.6935,1.8332,6.9936,1.833,6.9928,2,6.6915,2.0007)", + "span": { + "offset": 6372, + "length": 2 + }, + "elements": [ + "/paragraphs/158" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,6.9936,1.833,8.0002,1.8337,8.0007,2.001,6.9928,2)", + "span": { + "offset": 6384, + "length": 3 + }, + "elements": [ + "/paragraphs/159" + ] + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "25 Federal income tax withheld from:", + "source": "D(2,1.2386,2.0023,6.6915,2.0007,6.6927,2.1542,1.2384,2.1604)", + "span": { + "offset": 6420, + "length": 36 + }, + "elements": [ + "/paragraphs/160" + ] + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 4, + "rowSpan": 4, + "columnSpan": 1, + "content": "", + "source": "D(2,6.6915,2.0007,6.9928,2,6.9936,2.6634,6.6925,2.6642)", + "span": { + "offset": 6478, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 5, + "rowSpan": 5, + "columnSpan": 1, + "content": "300", + "source": "D(2,6.9928,2,8.0007,2.001,8.0009,2.8313,6.9935,2.8317)", + "span": { + "offset": 6500, + "length": 3 + }, + "elements": [ + "/paragraphs/161" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "a Form(s) W-2", + "source": "D(2,1.2384,2.1604,5.3942,2.1561,5.3937,2.3315,1.2386,2.3325)", + "span": { + "offset": 6524, + "length": 13 + }, + "elements": [ + "/paragraphs/162" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "25a", + "source": "D(2,5.3942,2.1561,5.6966,2.156,5.6965,2.3314,5.3937,2.3315)", + "span": { + "offset": 6547, + "length": 3 + }, + "elements": [ + "/paragraphs/163" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,5.6966,2.156,6.6927,2.1542,6.6933,2.3314,5.6965,2.3314)", + "span": { + "offset": 6560, + "length": 3 + }, + "elements": [ + "/paragraphs/164" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "b Form(s) 1099", + "source": "D(2,1.2386,2.3325,5.3937,2.3315,5.394,2.5001,1.2388,2.5015)", + "span": { + "offset": 6584, + "length": 14 + }, + "elements": [ + "/paragraphs/165" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "25b", + "source": "D(2,5.3937,2.3315,5.6965,2.3314,5.6967,2.5,5.394,2.5001)", + "span": { + "offset": 6608, + "length": 3 + }, + "elements": [ + "/paragraphs/166" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,5.6965,2.3314,6.6933,2.3314,6.6935,2.4999,5.6967,2.5)", + "span": { + "offset": 6621, + "length": 3 + }, + "elements": [ + "/paragraphs/167" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "c Other forms (see instructions)", + "source": "D(2,1.2388,2.5015,5.394,2.5001,5.3936,2.6635,1.2387,2.6653)", + "span": { + "offset": 6645, + "length": 32 + }, + "elements": [ + "/paragraphs/168" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "25c", + "source": "D(2,5.394,2.5001,5.6967,2.5,5.6968,2.6638,5.3936,2.6635)", + "span": { + "offset": 6687, + "length": 3 + }, + "elements": [ + "/paragraphs/169" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,5.6967,2.5,6.6935,2.4999,6.6925,2.6642,5.6968,2.6638)", + "span": { + "offset": 6700, + "length": 3 + }, + "elements": [ + "/paragraphs/170" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "d Add lines 25a through 25c", + "source": "D(2,1.2387,2.6653,6.6925,2.6642,6.6927,2.832,1.2385,2.8331)", + "span": { + "offset": 6736, + "length": 27 + }, + "elements": [ + "/paragraphs/171" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "25d", + "source": "D(2,6.6925,2.6642,6.9936,2.6634,6.9935,2.8317,6.6927,2.832)", + "span": { + "offset": 6773, + "length": 3 + }, + "elements": [ + "/paragraphs/172" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 0, + "rowSpan": 8, + "columnSpan": 1, + "content": ". If you have a qualifying child, attach Sch. EIC. . If you have nontaxable combat pay, see instructions.", + "source": "D(2,0.413,2.8335,1.2385,2.8331,1.2384,4.1668,0.4121,4.1668)", + "span": { + "offset": 6809, + "length": 105 + }, + "elements": [ + "/paragraphs/173" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "26 2020 estimated tax payments and amount applied from 2019 return", + "source": "D(2,1.2385,2.8331,6.6927,2.832,6.6925,2.9986,1.2386,2.9994)", + "span": { + "offset": 6936, + "length": 66 + }, + "elements": [ + "/paragraphs/174" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "26", + "source": "D(2,6.6927,2.832,6.9935,2.8317,6.9929,2.9981,6.6925,2.9986)", + "span": { + "offset": 7012, + "length": 2 + }, + "elements": [ + "/paragraphs/175" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "100", + "source": "D(2,6.9935,2.8317,8.0009,2.8313,8.0009,2.9981,6.9929,2.9981)", + "span": { + "offset": 7024, + "length": 3 + }, + "elements": [ + "/paragraphs/176" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "27 Earned income credit (EIC)", + "source": "D(2,1.2386,2.9994,5.3936,2.998,5.3931,3.16,1.2391,3.1619)", + "span": { + "offset": 7048, + "length": 29 + }, + "elements": [ + "/paragraphs/177" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "27", + "source": "D(2,5.3936,2.998,5.6962,2.9985,5.6961,3.1598,5.3931,3.16)", + "span": { + "offset": 7087, + "length": 2 + }, + "elements": [ + "/paragraphs/178" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(2,5.6962,2.9985,6.6925,2.9986,6.6934,3.1598,5.6961,3.1598)", + "span": { + "offset": 7099, + "length": 3 + }, + "elements": [ + "/paragraphs/179" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(2,6.6925,2.9986,6.9929,2.9981,6.9936,3.1592,6.6934,3.1598)", + "span": { + "offset": 7112, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 5, + "rowSpan": 6, + "columnSpan": 1, + "content": "1600", + "source": "D(2,6.9929,2.9981,8.0009,2.9981,8.001,4.0026,6.9932,4.0024)", + "span": { + "offset": 7134, + "length": 4 + }, + "elements": [ + "/paragraphs/180" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "28 Additional child tax credit. Attach Schedule 8812", + "source": "D(2,1.2391,3.1619,5.3931,3.16,5.3931,3.3281,1.2388,3.329)", + "span": { + "offset": 7159, + "length": 52 + }, + "elements": [ + "/paragraphs/181" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "28", + "source": "D(2,5.3931,3.16,5.6961,3.1598,5.696,3.328,5.3931,3.3281)", + "span": { + "offset": 7221, + "length": 2 + }, + "elements": [ + "/paragraphs/182" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "300", + "source": "D(2,5.6961,3.1598,6.6934,3.1598,6.6938,3.3281,5.696,3.328)", + "span": { + "offset": 7233, + "length": 3 + }, + "elements": [ + "/paragraphs/183" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 4, + "rowSpan": 4, + "columnSpan": 1, + "content": "", + "source": "D(2,6.6934,3.1598,6.9936,3.1592,6.9935,3.8318,6.693,3.8327)", + "span": { + "offset": 7258, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "29 American opportunity credit from Form 8863, line 8", + "source": "D(2,1.2388,3.329,5.3931,3.3281,5.3928,3.4971,1.2383,3.4983)", + "span": { + "offset": 7279, + "length": 53 + }, + "elements": [ + "/paragraphs/184" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "29", + "source": "D(2,5.3931,3.3281,5.696,3.328,5.6958,3.497,5.3928,3.4971)", + "span": { + "offset": 7342, + "length": 2 + }, + "elements": [ + "/paragraphs/185" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "400", + "source": "D(2,5.696,3.328,6.6938,3.3281,6.6937,3.4972,5.6958,3.497)", + "span": { + "offset": 7354, + "length": 3 + }, + "elements": [ + "/paragraphs/186" + ] + }, + { + "kind": "content", + "rowIndex": 18, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "30 Recovery rebate credit. See instructions", + "source": "D(2,1.2383,3.4983,5.3928,3.4971,5.3944,3.6636,1.2386,3.6644)", + "span": { + "offset": 7378, + "length": 43 + }, + "elements": [ + "/paragraphs/187" + ] + }, + { + "kind": "content", + "rowIndex": 18, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "30", + "source": "D(2,5.3928,3.4971,5.6958,3.497,5.6974,3.6633,5.3944,3.6636)", + "span": { + "offset": 7431, + "length": 2 + }, + "elements": [ + "/paragraphs/188" + ] + }, + { + "kind": "content", + "rowIndex": 18, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "500", + "source": "D(2,5.6958,3.497,6.6937,3.4972,6.6936,3.6637,5.6974,3.6633)", + "span": { + "offset": 7443, + "length": 3 + }, + "elements": [ + "/paragraphs/189" + ] + }, + { + "kind": "content", + "rowIndex": 19, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "31 Amount from Schedule 3, line 13", + "source": "D(2,1.2386,3.6644,5.3944,3.6636,5.3943,3.8325,1.2387,3.8346)", + "span": { + "offset": 7467, + "length": 34 + }, + "elements": [ + "/paragraphs/190" + ] + }, + { + "kind": "content", + "rowIndex": 19, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "31", + "source": "D(2,5.3944,3.6636,5.6974,3.6633,5.6973,3.8327,5.3943,3.8325)", + "span": { + "offset": 7511, + "length": 2 + }, + "elements": [ + "/paragraphs/191" + ] + }, + { + "kind": "content", + "rowIndex": 19, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(2,5.6974,3.6633,6.6936,3.6637,6.693,3.8327,5.6973,3.8327)", + "span": { + "offset": 7523, + "length": 3 + }, + "elements": [ + "/paragraphs/192" + ] + }, + { + "kind": "content", + "rowIndex": 20, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "32 Add lines 27 through 31. These are your total other payments and refundable credits", + "source": "D(2,1.2387,3.8346,6.693,3.8327,6.6932,4.0026,1.2383,4.0041)", + "span": { + "offset": 7559, + "length": 86 + }, + "elements": [ + "/paragraphs/193" + ] + }, + { + "kind": "content", + "rowIndex": 20, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "32", + "source": "D(2,6.693,3.8327,6.9935,3.8318,6.9932,4.0024,6.6932,4.0026)", + "span": { + "offset": 7655, + "length": 2 + }, + "elements": [ + "/paragraphs/194" + ] + }, + { + "kind": "content", + "rowIndex": 21, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "33 Add lines 25d, 26, and 32. These are your total payments", + "source": "D(2,1.2383,4.0041,6.6932,4.0026,6.6931,4.1652,1.2384,4.1668)", + "span": { + "offset": 7690, + "length": 59 + }, + "elements": [ + "/paragraphs/195" + ] + }, + { + "kind": "content", + "rowIndex": 21, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "33", + "source": "D(2,6.6932,4.0026,6.9932,4.0024,6.9932,4.1648,6.6931,4.1652)", + "span": { + "offset": 7759, + "length": 2 + }, + "elements": [ + "/paragraphs/196" + ] + }, + { + "kind": "content", + "rowIndex": 21, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "2000", + "source": "D(2,6.9932,4.0024,8.001,4.0026,8.0013,4.1649,6.9932,4.1648)", + "span": { + "offset": 7771, + "length": 4 + }, + "elements": [ + "/paragraphs/197" + ] + }, + { + "kind": "content", + "rowIndex": 22, + "columnIndex": 0, + "rowSpan": 5, + "columnSpan": 1, + "content": "Refund Direct deposit? See instructions.", + "source": "D(2,0.4121,4.1668,1.2384,4.1668,1.2385,4.9955,0.4122,4.9957)", + "span": { + "offset": 7808, + "length": 40 + }, + "elements": [ + "/paragraphs/198" + ] + }, + { + "kind": "content", + "rowIndex": 22, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "34 If line 33 is more than line 24, subtract line 24 from line 33. This is the amount you overpaid . .", + "source": "D(2,1.2384,4.1668,6.6931,4.1652,6.6935,4.3331,1.2384,4.3347)", + "span": { + "offset": 7870, + "length": 102 + }, + "elements": [ + "/paragraphs/199" + ] + }, + { + "kind": "content", + "rowIndex": 22, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "34", + "source": "D(2,6.6931,4.1652,6.9932,4.1648,6.9933,4.3329,6.6935,4.3331)", + "span": { + "offset": 7982, + "length": 2 + }, + "elements": [ + "/paragraphs/200" + ] + }, + { + "kind": "content", + "rowIndex": 22, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "200", + "source": "D(2,6.9932,4.1648,8.0013,4.1649,8.0013,4.3331,6.9933,4.3329)", + "span": { + "offset": 7994, + "length": 3 + }, + "elements": [ + "/paragraphs/201" + ] + }, + { + "kind": "content", + "rowIndex": 23, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "a Amount of line 34 you want refunded to you. If Form 8888 is attached, check here\n35a\n☐ . . .", + "source": "D(2,1.2384,4.3347,6.6935,4.3331,6.6936,4.4978,1.2383,4.4998)", + "span": { + "offset": 8030, + "length": 94 + }, + "elements": [ + "/paragraphs/202" + ] + }, + { + "kind": "content", + "rowIndex": 23, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "35a", + "source": "D(2,6.6935,4.3331,6.9933,4.3329,6.9935,4.4976,6.6936,4.4978)", + "span": { + "offset": 8134, + "length": 3 + }, + "elements": [ + "/paragraphs/203" + ] + }, + { + "kind": "content", + "rowIndex": 23, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "300", + "source": "D(2,6.9933,4.3329,8.0013,4.3331,8.0009,4.4979,6.9935,4.4976)", + "span": { + "offset": 8147, + "length": 3 + }, + "elements": [ + "/paragraphs/204" + ] + }, + { + "kind": "content", + "rowIndex": 24, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Routing number 520555555 c Type: ☑ Checking ☐ Savings", + "source": "D(2,1.2383,4.4998,6.6936,4.4978,6.6932,4.6593,1.2383,4.6618)", + "span": { + "offset": 8183, + "length": 55 + }, + "elements": [ + "/paragraphs/205" + ] + }, + { + "kind": "content", + "rowIndex": 24, + "columnIndex": 4, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(2,6.6936,4.4978,6.9935,4.4976,6.9932,4.9952,6.6933,4.9953)", + "span": { + "offset": 8260, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 24, + "columnIndex": 5, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(2,6.9935,4.4976,8.0009,4.4979,8.0012,4.9954,6.9932,4.9952)", + "span": { + "offset": 8282, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 25, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "d Account number 12333365478901200", + "source": "D(2,1.2383,4.6618,6.6932,4.6593,6.6934,4.8289,1.2386,4.8302)", + "span": { + "offset": 8315, + "length": 34 + }, + "elements": [ + "/paragraphs/206" + ] + }, + { + "kind": "content", + "rowIndex": 26, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "6 Amount of line 34 you want applied to your 2021 estimated tax\n36", + "source": "D(2,1.2386,4.8302,5.3939,4.8294,5.3944,4.9953,1.2385,4.9955)", + "span": { + "offset": 8370, + "length": 66 + }, + "elements": [ + "/paragraphs/207" + ] + }, + { + "kind": "content", + "rowIndex": 26, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "36", + "source": "D(2,5.3939,4.8294,5.6963,4.8296,5.6976,4.9955,5.3944,4.9953)", + "span": { + "offset": 8446, + "length": 2 + }, + "elements": [ + "/paragraphs/208" + ] + }, + { + "kind": "content", + "rowIndex": 26, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "1200", + "source": "D(2,5.6963,4.8296,6.6934,4.8289,6.6933,4.9953,5.6976,4.9955)", + "span": { + "offset": 8458, + "length": 4 + }, + "elements": [ + "/paragraphs/209" + ] + }, + { + "kind": "content", + "rowIndex": 27, + "columnIndex": 0, + "rowSpan": 4, + "columnSpan": 1, + "content": "Amount You Owe For details on how to pay, see instructions.", + "source": "D(2,0.4122,4.9957,1.2385,4.9955,1.2395,5.664,0.4113,5.6638)", + "span": { + "offset": 8495, + "length": 59 + }, + "elements": [ + "/paragraphs/210" + ] + }, + { + "kind": "content", + "rowIndex": 27, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "37 Subtract line 33 from line 24. This is the amount you owe now . . . . . . . . .", + "source": "D(2,1.2385,4.9955,6.6933,4.9953,6.6933,5.1774,1.2378,5.1795)", + "span": { + "offset": 8576, + "length": 82 + }, + "elements": [ + "/paragraphs/211" + ] + }, + { + "kind": "content", + "rowIndex": 27, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "37", + "source": "D(2,6.6933,4.9953,6.9932,4.9952,6.9936,5.1772,6.6933,5.1774)", + "span": { + "offset": 8668, + "length": 2 + }, + "elements": [ + "/paragraphs/212" + ] + }, + { + "kind": "content", + "rowIndex": 27, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "230", + "source": "D(2,6.9932,4.9952,8.0012,4.9954,8.0014,5.177,6.9936,5.1772)", + "span": { + "offset": 8680, + "length": 3 + }, + "elements": [ + "/paragraphs/213" + ] + }, + { + "kind": "content", + "rowIndex": 28, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "Note: Schedule H and Schedule SE filers, line 37 may not represent all of the taxes you owe for", + "source": "D(2,1.2378,5.1795,6.6933,5.1774,6.6928,5.3364,1.2381,5.3388)", + "span": { + "offset": 8716, + "length": 95 + }, + "elements": [ + "/paragraphs/214" + ] + }, + { + "kind": "content", + "rowIndex": 28, + "columnIndex": 4, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(2,6.6933,5.1774,6.9936,5.1772,6.9942,5.6639,6.6947,5.664)", + "span": { + "offset": 8833, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 28, + "columnIndex": 5, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(2,6.9936,5.1772,8.0014,5.177,8.0015,5.664,6.9942,5.6639)", + "span": { + "offset": 8855, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 29, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "2020. See Schedule 3, line 12e, and its instructions for details.", + "source": "D(2,1.2381,5.3388,6.6928,5.3364,6.6934,5.4972,1.2381,5.4986)", + "span": { + "offset": 8888, + "length": 65 + }, + "elements": [ + "/paragraphs/215" + ] + }, + { + "kind": "content", + "rowIndex": 30, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "38 Estimated tax penalty (see instructions)", + "source": "D(2,1.2381,5.4986,5.3927,5.4976,5.3936,5.6633,1.2395,5.664)", + "span": { + "offset": 8974, + "length": 43 + }, + "elements": [ + "/paragraphs/216" + ] + }, + { + "kind": "content", + "rowIndex": 30, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "38", + "source": "D(2,5.3927,5.4976,5.6958,5.4975,5.6965,5.6635,5.3936,5.6633)", + "span": { + "offset": 9027, + "length": 2 + }, + "elements": [ + "/paragraphs/217" + ] + }, + { + "kind": "content", + "rowIndex": 30, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "231", + "source": "D(2,5.6958,5.4975,6.6934,5.4972,6.6947,5.664,5.6965,5.6635)", + "span": { + "offset": 9039, + "length": 3 + }, + "elements": [ + "/paragraphs/218" + ] + } + ], + "source": "D(2,0.4054,0.4972,8.002,0.4814,8.002,5.6504,0.4062,5.6665)", + "span": { + "offset": 5429, + "length": 3633 + } + } + ], + "analyzerId": "prebuilt-documentSearch", + "mimeType": "application/pdf" + } + ] + }, + "usage": { + "documentPagesStandard": 2, + "contextualizationTokens": 2000, + "tokens": { + "gpt-4.1-mini-input": 11830, + "gpt-4.1-mini-output": 630 + } + } +} \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf new file mode 100644 index 0000000000000000000000000000000000000000..efe5d5d53c97f6ee5a79ecceca9fff74be9f1a4b GIT binary patch literal 72080 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 }-|el8dg$_qY@52ckT0FPSA=Tv;IFQYuvee- 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

3$#OG9t?D`ktb{d${A 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 literal 0 HcmV?d00001 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf.labels.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf.labels.json new file mode 100644 index 000000000000..301a67a5ffc4 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf.labels.json @@ -0,0 +1,184 @@ +{ + "$schema": "https://schema.ai.azure.com/mmi/2025-11-01/labels.json", + "fileId": "", + "fieldLabels": { + "FieldYourFirstNameAndMiddleInitial": { + "type": "string", + "valueString": "Anthony", + "spans": [ + { + "offset": 643, + "length": 7 + } + ], + "confidence": null, + "source": "D(1,0.5169,1.5941,0.9795,1.5982,0.9795,1.7254,0.516,1.7206)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"Anthony\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[0.5288,1.6137,0.9632,1.6137,0.9632,1.7194000000000003,0.5288,1.7194000000000003]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "FieldYourFirstNameAndMiddleInitialLastName": { + "type": "string", + "valueString": "Kelly", + "spans": [ + { + "offset": 660, + "length": 5 + } + ], + "confidence": null, + "source": "D(1,3.3352,1.5969,3.6136,1.5998,3.6136,1.7217,3.3347,1.7207)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"Kelly\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[3.349,1.6137,3.5921,1.6137,3.5921,1.7194000000000003,3.349,1.7194000000000003]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "FieldWagesSalariesTipsEtcAttachFormSW2": { + "type": "string", + "valueString": "2501", + "spans": [ + { + "offset": 3167, + "length": 4 + } + ], + "confidence": null, + "source": "D(1,7.7188,4.9479,7.9632,4.9485,7.9632,5.0565,7.7183,5.0562)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"2501\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[7.7308,4.9625,7.9439,4.9625,7.9439,5.0419,7.7308,5.0419]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "CheckboxYouAsADependent": { + "type": "boolean", + "valueBoolean": false, + "spans": [ + { + "offset": 1750, + "length": 1 + } + ], + "confidence": null, + "source": "D(1,2.519,3.3518,2.6497,3.3514,2.6499,3.4789,2.5197,3.48)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"selectionMark\",\"content\":\"unselected\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[2.5169000000000006,3.348,2.6461,3.348,2.6461,3.4745,2.5169000000000006,3.4745]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "TableDependents": { + "type": "array", + "kind": "confirmed", + "valueArray": [ + { + "type": "object", + "kind": "confirmed", + "valueObject": { + "CheckboxChildTaxCredit": { + "type": "boolean", + "valueBoolean": false, + "spans": [ + { + "offset": 2492, + "length": 1 + } + ], + "confidence": null, + "source": "D(1,6.2852,4.2704,6.4115,4.2708,6.4118,4.394,6.2858,4.394)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"selectionMark\",\"content\":\"unselected\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[6.2822,4.2705,6.4094,4.2705,6.4094,4.392,6.2822,4.392]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "CheckboxCreditForOtherDependents": { + "type": "boolean", + "valueBoolean": false, + "spans": [ + { + "offset": 2513, + "length": 1 + } + ], + "confidence": null, + "source": "D(1,7.3871,4.27,7.512,4.2711,7.5122,4.3961,7.3874,4.3957)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"selectionMark\",\"content\":\"unselected\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[7.383,4.2672,7.5214,4.2672,7.5214,4.3993,7.383,4.3993]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "FirstNameLastName": { + "type": "string", + "valueString": "Evelyn Collins", + "spans": [ + { + "offset": 2384, + "length": 6 + }, + { + "offset": 2400, + "length": 7 + } + ], + "confidence": null, + "source": "D(1,1.4789,4.2651,1.8428,4.2691,1.8428,4.3941,1.4785,4.3897);D(1,2.5233,4.2959,2.8167,4.2961,2.8166,4.3956,2.523,4.3947)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"Evelyn Collins\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[1.4964,4.2821,1.8388,4.2821,1.8388,4.3878,1.4964,4.3878]},{\"pageNumber\":1,\"polygon\":[2.5261,4.3016,2.8222,4.3064,2.8174,4.3924,2.5261,4.3924]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "SocialSecurityNumber": { + "type": "string", + "valueString": "005 78 5758", + "spans": [ + { + "offset": 2427, + "length": 3 + }, + { + "offset": 2440, + "length": 2 + }, + { + "offset": 2452, + "length": 4 + } + ], + "confidence": null, + "source": "D(1,3.87,4.2597,4.0221,4.2599,4.0218,4.3456,3.8699,4.3449);D(1,4.1094,4.2592,4.2168,4.2606,4.2168,4.3452,4.1091,4.3444);D(1,4.4368,4.2775,4.6374,4.2784,4.6374,4.3723,4.4365,4.3712)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"005 78 5758\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[3.868,4.2635,4.016,4.2635,4.016,4.3446,3.868,4.3446]},{\"pageNumber\":1,\"polygon\":[4.1211,4.2587,4.207,4.2587,4.207,4.3398,4.1211,4.3398]},{\"pageNumber\":1,\"polygon\":[4.441,4.2778,4.6272,4.2826,4.6272,4.3637,4.4362,4.3589]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + }, + "RelationshipToYou": { + "type": "string", + "valueString": "friend", + "spans": [ + { + "offset": 2476, + "length": 6 + } + ], + "confidence": null, + "source": "D(1,5.2828,4.2663,5.5339,4.266,5.5339,4.3679,5.2824,4.3679)", + "kind": "confirmed", + "metadata": { + "original_label": "{\"type\":\"string\",\"content\":\"friend\",\"boundingRegions\":[{\"pageNumber\":1,\"polygon\":[5.2862,4.2682,5.520200000000001,4.273,5.5154,4.3589,5.2862,4.3542]}],\"spans\":null,\"confidence\":null,\"metadata\":null,\"kind\":\"confirmed\",\"valueArray\":null,\"valueObject\":null,\"valueString\":null,\"valueNumber\":null,\"valueBoolean\":null,\"valueDate\":null,\"valueTime\":null,\"valuePhoneNumber\":null,\"valueSelectionMark\":null,\"valueCountryRegion\":null,\"valueSignature\":null,\"valueCurrency\":null}", + "status": "ocr_mapped" + } + } + } + } + ] + } + }, + "metadata": {} +} \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf.result.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf.result.json new file mode 100644 index 000000000000..fa6387347d86 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/IRS_1040_1_10.pdf.result.json @@ -0,0 +1,23507 @@ +{ + "id": "4de52373-e3a2-414e-a08f-34488213a70c", + "status": "Succeeded", + "result": { + "analyzerId": "prebuilt-documentSearch", + "apiVersion": "2025-11-01", + "createdAt": "2025-11-17T05:31:23Z", + "warnings": [], + "contents": [ + { + "path": "input1", + "markdown": "\n\n\n\n\n\nFiling Status\nCheck only\none box.\n\n☐\nSingle\n☑\nMarried filing jointly\n☐\nMarried filing separately (MFS)\n☐\nHead of household (HOH)\n☐\nQualifying widow(er) (QW)\n\nIf you checked the MFS box, enter the name of your spouse. If you checked the HOH or QW box, enter the child's name if the qualifying\nperson is a child but not your dependent\n\nYour first name and middle initial\nAnthony\n\nLast name\nKelly\n\nYour social security number\n980 9 7 0 2 0 0\n\nIf joint return, spouse's first name and middle initial\nLauren\n\nLast name\nWatson\n\nSpouse's social security number\n0 5 6 0 4 1 0 8 5\n\nHome address (number and street). If you have a P.O. box, see instructions.\n10221 COMPTON LOS ANGELES CA 90002-2805 USA\n\nApt. no.\n10221\n\nCity, town, or post office. If you have a foreign address, also complete spaces below.\n615 E 80TH LOS ANGELES CA 90001-3255 USA\n\nState\nLA\n\nZIP code\n61500\n\nForeign country name\nN/A\n\nForeign province/state/county\nN/A\n\nForeign postal code\nN/A\n\nPresidential Election Campaign\nCheck here if you, or your\nspouse if filing jointly, want $3\nto go to this fund. Checking a\nbox below will not change\nyour tax or refund.\n\n☐\nYou\n☐\nSpouse\n\nAt any time during 2020, did you receive, sell, send, exchange, or otherwise acquire any financial interest in any virtual currency?\n\n☐\nYes\n☑\nNo\n\nStandard\nDeduction\n\nSomeone can claim:\n\n☐\nYou as a dependent\n☐\nYour spouse as a dependent\n☐\nSpouse itemizes on a separate return or you were a dual-status alien\n\nAge/Blindness\n\nYou:\n\n☑\nWere born before January 2, 1956\n☐\nAre blind\n\nSpouse:\n\n☐\nWas born before January 2, 1956\n☑\nIs blind\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Dependents If more than four dependents, see instructions and check here ☐(see instructions):(2) Social security number(3) Relationship to you(4) ✓ if qualifies for (see instructions):
(1) First nameLast nameChild tax creditCredit for other dependents
EvelynCollins005785758friend☐☐
☐☐
☐☐
☐☐
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Attach Sch. B if required.1 Wages, salaries, tips, etc. Attach Form(s) W-212501
2a Tax-exempt interest . .2a2010b Taxable interest2b5202
3a Qualified dividends . . .3a1007b Ordinary dividends3b3405
4a IRA distributions4a3524b Taxable amount4b4508
5a Pensions and annuities . .5a2535b Taxable amount5b1008
Standard Deduction for- . Single or Married filing separately, $12,400 . Married filing jointly or Qualifying widow(er), $24,800 . Head of household, $18,650 . If you checked any box under Standard Deduction, see instructions.6a Social security benefits .6a5328b Taxable amount6b2004
7 Capital gain or (loss). Attach Schedule D if required. If not required, check here ☐73006
8 Other income from Schedule 1, line 984006
9 Add lines 1, 2b, 3b, 4b, 5b, 6b, 7, and 8. This is your total income946708
10 Adjustments to income:6455
a From Schedule 1, line 2210a6538
b Charitable contributions if you take the standard deduction. See instructions10b6536
c Add lines 10a and 10b. These are your total adjustments to income10c
11 Subtract line 10c from line 9. This is your adjusted gross income117658
12 Standard deduction or itemized deductions (from Schedule A)123427
13 Qualified business income deduction. Attach Form 8995 or Form 8995-A138009
14 Add lines 12 and 13146008
15 Taxable income. Subtract line 14 from line 11. If zero or less, enter -0-151055
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
16 Tax (see instructions). Check if any from Form(s): 1 ☑ 8814 2 ☐ 4972 3 ☐ . .162350
17 Amount from Schedule 2, line 3175437
18 Add lines 16 and 17181000
19 Child tax credit or credit for other dependents19753
20 Amount from Schedule 3, line 7205430
21 Add lines 19 and 202115790
22 Subtract line 21 from line 18. If zero or less, enter -0-225436
23 Other taxes, including self-employment tax, from Schedule 2, line 10237650
24 Add lines 22 and 23. This is your total tax2412780
25 Federal income tax withheld from:6220
a Form(s) W-225a4220
b Form(s) 109925b1000
c Other forms (see instructions)25c2000
d Add lines 25a through 25c25d
. If you have a qualifying child, attach Sch. EIC. . If you have nontaxable combat pay, see instructions.26 2020 estimated tax payments and amount applied from 2019 return265438
27 Earned income credit (EIC)2743596534
28 Additional child tax credit. Attach Schedule 8812285326
29 American opportunity credit from Form 8863, line 8296743
30 Recovery rebate credit. See instructions304562
31 Amount from Schedule 3, line 13312428
32 Add lines 27 through 31. These are your total other payments and refundable credits32
33 Add lines 25d, 26, and 32. These are your total payments333657
Refund Direct deposit? See instructions.34 If line 33 is more than line 24, subtract line 24 from line 33. This is the amount you overpaid . .346338
35a 5a Amount of line 34 you want refunded to you. If Form 8888 is attached, check here ☐ . . .35a6335
b Routing number 052088863 ▶ c Type: ☐ Checking ☑ Savings
▶d Account number 5206340044401004
36 Amount of line 34 you want applied to your 2021 estimated tax3645830
Amount You Owe For details on how to pay, see instructions.37 Subtract line 33 from line 24. This is the amount you owe now . . . . . . . . .376430
Note: Schedule H and Schedule SE filers, line 37 may not represent all of the taxes you owe for
2020. See Schedule 3, line 12e, and its instructions for details.
38 Estimated tax penalty (see instructions)381250
\n\n\n# Third Party Designee\n\nDo you want to allow another person to discuss this return with the IRS? See\ninstructions\n\n☐\nYes. Complete below.\n☑\nNo\n\nDesignee's\nname\n\nPhone\nno.\n\nPersonal identification\nnumber (PIN)\n\n\n## Sign Here\n\nUnder penalties of perjury, I declare that I have examined this return and accompanying schedules and statements, and to the best of my knowledge and\nbelief, they are true, correct, and complete. Declaration of preparer (other than taxpayer) is based on all information of which preparer has any knowledge.\n\nYour signature\nanthony kelly\n\nDate\n12/10/1986\n\nYour occupation\nJudge\n\nIf the IRS sent you an Identity\nProtection PIN, enter it here\n(see inst.)\n654344\n\nJoint return?\nSee instructions.\nKeep a copy for\nyour records.\n\nSpouse's signature. If a joint return, both must sign.\nlaren waston\n\nDate\n02/19/1978\n\nSpouse's occupation\nnurse\n\nIf the IRS sent your spouse an\nIdentity Protection PIN, enter it here\n(see inst.)\n574890\n\nPhone no.\n00141386308\n\nEmail address mirachael123@gmail.com.us\n\n\n# Paid Preparer Use Only\n\nPreparer's name\nMark Collins\n\nPreparer's signature\nmark collins\n\nDate\n10/20/1990\n\nPTIN\n09870\n\nCheck if:\n\n☐\nSelf-employed\n\nFirm's name\nSTATE company\n\nPhone no.\n8760765000876\n\nFirm's address\n2025 E 76TH LOS ANGELES CA 90001-2712 USA\n\nFirm's EIN\n080686\n\n\n\n", + "fields": { + "Summary": { + "type": "string", + "valueString": "This document is a completed 2020 U.S. Individual Income Tax Return (Form 1040) for Anthony Kelly and spouse Lauren Watson, filing jointly. It includes personal information, filing status, dependents, income details, tax calculations, payments, refund and amount owed, third party designee information, signatures, and paid preparer details. The form shows Anthony was born before January 2, 1956, and is not blind; Lauren is blind but not born before that date. They have one dependent named Evelyn Collins. The total income reported is $46,708 with taxable income of $1,055. The total tax is $12,780 with federal income tax withheld totaling $6,220. The refund amount is $6,338 with direct deposit to a savings account. The preparer is Mark Collins from STATE company.", + "spans": [ + { + "offset": 17, + "length": 4 + }, + { + "offset": 22, + "length": 4 + }, + { + "offset": 162, + "length": 4 + }, + { + "offset": 286, + "length": 13 + }, + { + "offset": 300, + "length": 10 + }, + { + "offset": 311, + "length": 8 + }, + { + "offset": 321, + "length": 1 + }, + { + "offset": 323, + "length": 6 + }, + { + "offset": 330, + "length": 1 + }, + { + "offset": 332, + "length": 22 + }, + { + "offset": 355, + "length": 1 + }, + { + "offset": 357, + "length": 31 + }, + { + "offset": 389, + "length": 1 + }, + { + "offset": 391, + "length": 23 + }, + { + "offset": 415, + "length": 1 + }, + { + "offset": 417, + "length": 25 + }, + { + "offset": 620, + "length": 34 + }, + { + "offset": 655, + "length": 7 + }, + { + "offset": 664, + "length": 9 + }, + { + "offset": 674, + "length": 5 + }, + { + "offset": 681, + "length": 27 + }, + { + "offset": 709, + "length": 15 + }, + { + "offset": 726, + "length": 55 + }, + { + "offset": 782, + "length": 6 + }, + { + "offset": 790, + "length": 9 + }, + { + "offset": 800, + "length": 6 + }, + { + "offset": 808, + "length": 31 + }, + { + "offset": 840, + "length": 17 + }, + { + "offset": 859, + "length": 75 + }, + { + "offset": 935, + "length": 43 + }, + { + "offset": 1125, + "length": 5 + }, + { + "offset": 1131, + "length": 2 + }, + { + "offset": 1135, + "length": 8 + }, + { + "offset": 1144, + "length": 5 + }, + { + "offset": 1151, + "length": 20 + }, + { + "offset": 1172, + "length": 3 + }, + { + "offset": 1177, + "length": 29 + }, + { + "offset": 1207, + "length": 3 + }, + { + "offset": 1212, + "length": 19 + }, + { + "offset": 1232, + "length": 3 + }, + { + "offset": 1423, + "length": 132 + }, + { + "offset": 1557, + "length": 1 + }, + { + "offset": 1559, + "length": 3 + }, + { + "offset": 1563, + "length": 1 + }, + { + "offset": 1565, + "length": 2 + }, + { + "offset": 1752, + "length": 1 + }, + { + "offset": 1754, + "length": 32 + }, + { + "offset": 1787, + "length": 1 + }, + { + "offset": 1789, + "length": 9 + }, + { + "offset": 1809, + "length": 1 + }, + { + "offset": 1811, + "length": 31 + }, + { + "offset": 1843, + "length": 1 + }, + { + "offset": 1845, + "length": 8 + }, + { + "offset": 1885, + "length": 10 + }, + { + "offset": 1896, + "length": 7 + }, + { + "offset": 1904, + "length": 9 + }, + { + "offset": 1914, + "length": 11 + }, + { + "offset": 1926, + "length": 16 + }, + { + "offset": 1943, + "length": 9 + }, + { + "offset": 1953, + "length": 4 + }, + { + "offset": 1958, + "length": 1 + }, + { + "offset": 2307, + "length": 6 + }, + { + "offset": 2323, + "length": 7 + }, + { + "offset": 2379, + "length": 6 + }, + { + "offset": 2738, + "length": 6 + }, + { + "offset": 2745, + "length": 9 + }, + { + "offset": 2755, + "length": 9 + }, + { + "offset": 2786, + "length": 1 + }, + { + "offset": 2788, + "length": 46 + }, + { + "offset": 2844, + "length": 1 + }, + { + "offset": 2855, + "length": 4 + }, + { + "offset": 4074, + "length": 1 + }, + { + "offset": 4076, + "length": 68 + }, + { + "offset": 4154, + "length": 1 + }, + { + "offset": 4165, + "length": 5 + }, + { + "offset": 4647, + "length": 2 + }, + { + "offset": 4650, + "length": 65 + }, + { + "offset": 4725, + "length": 2 + }, + { + "offset": 4895, + "length": 2 + }, + { + "offset": 4898, + "length": 68 + }, + { + "offset": 4976, + "length": 2 + }, + { + "offset": 5025, + "length": 2 + }, + { + "offset": 5028, + "length": 19 + }, + { + "offset": 5057, + "length": 2 + }, + { + "offset": 5106, + "length": 2 + }, + { + "offset": 5109, + "length": 73 + }, + { + "offset": 5192, + "length": 2 + }, + { + "offset": 5204, + "length": 4 + }, + { + "offset": 6276, + "length": 2 + }, + { + "offset": 6279, + "length": 68 + }, + { + "offset": 6357, + "length": 2 + }, + { + "offset": 6406, + "length": 2 + }, + { + "offset": 6409, + "length": 43 + }, + { + "offset": 6462, + "length": 2 + }, + { + "offset": 6474, + "length": 5 + }, + { + "offset": 6512, + "length": 2 + }, + { + "offset": 6515, + "length": 33 + }, + { + "offset": 6617, + "length": 1 + }, + { + "offset": 6619, + "length": 11 + }, + { + "offset": 6678, + "length": 1 + }, + { + "offset": 6680, + "length": 12 + }, + { + "offset": 6740, + "length": 1 + }, + { + "offset": 6742, + "length": 30 + }, + { + "offset": 6832, + "length": 1 + }, + { + "offset": 6834, + "length": 25 + }, + { + "offset": 7032, + "length": 2 + }, + { + "offset": 7035, + "length": 63 + }, + { + "offset": 7108, + "length": 2 + }, + { + "offset": 7145, + "length": 2 + }, + { + "offset": 7148, + "length": 26 + }, + { + "offset": 7184, + "length": 2 + }, + { + "offset": 7257, + "length": 2 + }, + { + "offset": 7260, + "length": 49 + }, + { + "offset": 7319, + "length": 2 + }, + { + "offset": 7378, + "length": 2 + }, + { + "offset": 7381, + "length": 50 + }, + { + "offset": 7441, + "length": 2 + }, + { + "offset": 7478, + "length": 2 + }, + { + "offset": 7481, + "length": 40 + }, + { + "offset": 7531, + "length": 2 + }, + { + "offset": 7568, + "length": 2 + }, + { + "offset": 7571, + "length": 31 + }, + { + "offset": 7612, + "length": 2 + }, + { + "offset": 7661, + "length": 2 + }, + { + "offset": 7664, + "length": 83 + }, + { + "offset": 7757, + "length": 2 + }, + { + "offset": 7792, + "length": 2 + }, + { + "offset": 7795, + "length": 56 + }, + { + "offset": 7861, + "length": 2 + }, + { + "offset": 7910, + "length": 6 + }, + { + "offset": 7917, + "length": 15 + }, + { + "offset": 7933, + "length": 17 + }, + { + "offset": 7972, + "length": 2 + }, + { + "offset": 7975, + "length": 95 + }, + { + "offset": 8071, + "length": 1 + }, + { + "offset": 8073, + "length": 1 + }, + { + "offset": 8084, + "length": 2 + }, + { + "offset": 8096, + "length": 4 + }, + { + "offset": 8288, + "length": 16 + }, + { + "offset": 8305, + "length": 9 + }, + { + "offset": 8315, + "length": 9 + }, + { + "offset": 8325, + "length": 1 + }, + { + "offset": 8327, + "length": 8 + }, + { + "offset": 8336, + "length": 1 + }, + { + "offset": 8338, + "length": 7 + }, + { + "offset": 8422, + "length": 17 + }, + { + "offset": 8440, + "length": 16 + }, + { + "offset": 8477, + "length": 64 + }, + { + "offset": 8551, + "length": 2 + }, + { + "offset": 8601, + "length": 6 + }, + { + "offset": 8608, + "length": 7 + }, + { + "offset": 8616, + "length": 14 + }, + { + "offset": 8631, + "length": 15 + }, + { + "offset": 8647, + "length": 13 + }, + { + "offset": 8682, + "length": 2 + }, + { + "offset": 8685, + "length": 61 + }, + { + "offset": 8747, + "length": 1 + }, + { + "offset": 8749, + "length": 1 + }, + { + "offset": 8751, + "length": 1 + }, + { + "offset": 8753, + "length": 1 + }, + { + "offset": 8755, + "length": 1 + }, + { + "offset": 8757, + "length": 1 + }, + { + "offset": 8759, + "length": 1 + }, + { + "offset": 8761, + "length": 1 + }, + { + "offset": 8763, + "length": 1 + }, + { + "offset": 8774, + "length": 2 + }, + { + "offset": 8786, + "length": 4 + }, + { + "offset": 9706, + "length": 14 + }, + { + "offset": 9721, + "length": 13 + }, + { + "offset": 9736, + "length": 4 + }, + { + "offset": 9741, + "length": 10 + }, + { + "offset": 9753, + "length": 15 + }, + { + "offset": 9769, + "length": 5 + }, + { + "offset": 9921, + "length": 54 + }, + { + "offset": 9976, + "length": 12 + }, + { + "offset": 9990, + "length": 4 + }, + { + "offset": 9995, + "length": 10 + }, + { + "offset": 10007, + "length": 19 + }, + { + "offset": 10027, + "length": 5 + }, + { + "offset": 10215, + "length": 15 + }, + { + "offset": 10231, + "length": 12 + }, + { + "offset": 10245, + "length": 20 + }, + { + "offset": 10266, + "length": 12 + }, + { + "offset": 10280, + "length": 4 + }, + { + "offset": 10285, + "length": 10 + }, + { + "offset": 10337, + "length": 11 + }, + { + "offset": 10349, + "length": 13 + }, + { + "offset": 10364, + "length": 9 + }, + { + "offset": 10374, + "length": 13 + }, + { + "offset": 10389, + "length": 14 + }, + { + "offset": 10404, + "length": 41 + }, + { + "offset": 10447, + "length": 10 + }, + { + "offset": 10458, + "length": 6 + } + ], + "confidence": 0.011, + "source": "D(1,0.4982,0.7739,0.5081,0.5311,0.5935,0.5277,0.5864,0.7706);D(1,0.6023,0.5028,1.2576,0.5043,1.2576,0.7684,0.6023,0.7684);D(1,4.1296,0.5311,4.8684,0.5334,4.8684,0.7729,4.1296,0.7726);D(1,0.4923,0.9128,1.2517,0.9148,1.2513,1.0546,0.4919,1.0526);D(1,0.4927,1.0742,1.0552,1.0831,1.0533,1.2026,0.4908,1.1937);D(1,0.4908,1.2040,0.9323,1.2034,0.9324,1.3023,0.4909,1.3028);D(1,1.3209,0.9393,1.4454,0.9373,1.4454,1.0621,1.3209,1.0641);D(1,1.4931,0.9428,1.8137,0.9424,1.8137,1.0617,1.4931,1.0610);D(1,1.9227,0.9406,2.0430,0.9406,2.0430,1.0628,1.9227,1.0621);D(1,2.0845,0.9328,3.0703,0.9412,3.0692,1.0683,2.0834,1.0599);D(1,3.2207,0.9393,3.3452,0.9393,3.3452,1.0635,3.2207,1.0635);D(1,3.3867,0.9363,4.8976,0.9373,4.8975,1.0649,3.3866,1.0639);D(1,5.0178,0.9379,5.1423,0.9379,5.1423,1.0648,5.0178,1.0648);D(1,5.1880,0.9334,6.4001,0.9353,6.3999,1.0605,5.1878,1.0586);D(1,6.5203,0.9386,6.6448,0.9386,6.6448,1.0648,6.5203,1.0648);D(1,6.6863,0.9337,7.9771,0.9337,7.9771,1.0693,6.6863,1.0693);D(1,0.5421,1.4438,1.9849,1.4433,1.9849,1.5522,0.5421,1.5526);D(1,0.5198,1.5983,0.9805,1.5989,0.9790,1.7246,0.5183,1.7240);D(1,3.3452,1.4482,3.8109,1.4522,3.8101,1.5499,3.3444,1.5459);D(1,3.3369,1.6006,3.6088,1.6014,3.6088,1.7241,3.3369,1.7220);D(1,6.5450,1.4457,7.8567,1.4437,7.8569,1.5540,6.5452,1.5559);D(1,6.5535,1.5759,7.9649,1.5789,7.9646,1.7288,6.5532,1.7257);D(1,0.5421,1.7790,2.7745,1.7706,2.7749,1.8856,0.5425,1.8940);D(1,0.5209,1.9321,0.9022,1.9333,0.9022,2.0407,0.5214,2.0395);D(1,3.3431,1.7791,3.8111,1.7838,3.8101,1.8817,3.3421,1.8770);D(1,3.3265,1.9325,3.7457,1.9333,3.7457,2.0408,3.3265,2.0399);D(1,6.5327,1.7743,8.0061,1.7749,8.0061,1.8901,6.5327,1.8895);D(1,6.5452,1.9088,7.9647,1.9100,7.9646,2.0596,6.5451,2.0584);D(1,0.5453,2.1060,3.8516,2.1060,3.8516,2.2227,0.5453,2.2227);D(1,0.5274,2.2516,3.3452,2.2516,3.3452,2.3730,0.5274,2.3730);D(1,4.7397,2.4532,4.9680,2.4532,4.9680,2.5446,4.7397,2.5446);D(1,5.0593,2.6007,5.2253,2.5995,5.2253,2.7064,5.0593,2.7051);D(1,5.6362,2.4446,6.0115,2.4510,6.0098,2.5504,5.6345,2.5440);D(1,5.8894,2.6016,6.2007,2.6017,6.2007,2.7077,5.8894,2.7063);D(1,0.5442,2.7795,1.5119,2.7804,1.5118,2.8932,0.5441,2.8923);D(1,0.5178,2.9299,0.7274,2.9299,0.7274,3.0401,0.5178,3.0401);D(1,3.6378,2.7765,4.9639,2.7765,4.9639,2.8953,3.6378,2.8953);D(1,3.6357,2.9313,3.8373,2.9319,3.8370,3.0405,3.6354,3.0399);D(1,5.6442,2.7812,6.4580,2.7791,6.4583,2.8888,5.6445,2.8909);D(1,5.9434,2.9342,6.1472,2.9351,6.1467,3.0379,5.9429,3.0370);D(1,0.4936,3.1426,6.8773,3.1480,6.8772,3.2792,0.4935,3.2737);D(1,6.9976,3.1394,7.1096,3.1421,7.1096,3.2656,6.9976,3.2629);D(1,7.1345,3.1500,7.3379,3.1499,7.3379,3.2520,7.1345,3.2521);D(1,7.4956,3.1501,7.6160,3.1448,7.6160,3.2683,7.4956,3.2737);D(1,7.6409,3.1525,7.7986,3.1522,7.7986,3.2487,7.6409,3.2555);D(1,1.6135,3.7544,1.7432,3.7544,1.7432,3.8779,1.6135,3.8779);D(1,1.7863,3.7707,3.4822,3.7645,3.4827,3.8966,1.7867,3.9028);D(1,3.6171,3.7678,3.7395,3.7678,3.7395,3.8967,3.6171,3.8967);D(1,3.7915,3.7711,4.2477,3.7792,4.2456,3.8967,3.7894,3.8885);D(1,5.0178,3.7625,5.1631,3.7651,5.1631,3.8994,5.0178,3.8994);D(1,5.1918,3.7686,6.8315,3.7651,6.8318,3.8972,5.1921,3.9008);D(1,7.0142,3.7651,7.1594,3.7651,7.1594,3.8994,7.0142,3.8994);D(1,7.1807,3.7640,7.5575,3.7774,7.5531,3.9015,7.1763,3.8881);D(1,0.4939,3.9592,1.2545,3.9576,1.2545,4.0894,0.4942,4.0928);D(1,0.4923,4.1439,0.8544,4.1549,0.8511,4.2661,0.4890,4.2551);D(1,0.4897,4.2765,0.9511,4.2771,0.9510,4.3826,0.4896,4.3820);D(1,0.4916,4.4008,1.1144,4.4004,1.1145,4.5090,0.4917,4.5094);D(1,0.4903,4.5251,1.2545,4.5251,1.2545,4.6299,0.4903,4.6299);D(1,0.4905,4.6452,1.0205,4.6439,1.0208,4.7478,0.4907,4.7491);D(1,0.4923,4.7642,0.7258,4.7642,0.7253,4.8608,0.4923,4.8608);D(1,0.8913,4.7507,1.0303,4.7507,1.0303,4.8743,0.8913,4.8743);D(1,1.4807,4.2692,1.8438,4.2712,1.8438,4.3893,1.4807,4.3874);D(1,2.5234,4.2962,2.8160,4.2977,2.8160,4.3944,2.5234,4.3929);D(1,5.2834,4.2695,5.5283,4.2635,5.5283,4.3601,5.2834,4.3662);D(1,0.5139,5.0776,0.8327,5.0784,0.8327,5.1805,0.5144,5.1797);D(1,0.5185,5.2182,0.9298,5.2207,0.9292,5.3289,0.5179,5.3264);D(1,0.5159,5.3593,0.9436,5.3607,0.9432,5.4692,0.5156,5.4678);D(1,1.3395,4.9634,1.3945,4.9628,1.3945,5.0569,1.3395,5.0569);D(1,1.5834,4.9491,3.8682,4.9494,3.8682,5.0754,1.5834,5.0751);D(1,6.8232,4.9629,6.8689,4.9629,6.8689,5.0569,6.8232,5.0569);D(1,7.7156,4.9495,7.9563,4.9495,7.9563,5.0550,7.7156,5.0529);D(1,1.3333,6.2949,1.4018,6.2949,1.4018,6.3916,1.3333,6.3916);D(1,1.5865,6.2777,4.8894,6.2829,4.8892,6.4113,1.5863,6.4061);D(1,6.8232,6.2949,6.8813,6.2949,6.8813,6.3916,6.8232,6.3916);D(1,7.6616,6.2715,7.9646,6.2747,7.9646,6.3821,7.6616,6.3789);D(1,1.2711,7.1328,1.3987,7.1328,1.3987,7.2295,1.2711,7.2295);D(1,1.5875,7.1166,4.8684,7.1166,4.8684,7.2458,1.5875,7.2458);D(1,6.7900,7.1263,6.8979,7.1340,6.8979,7.2306,6.7900,7.2230);D(1,1.2721,7.4614,1.4080,7.4621,1.4080,7.5588,1.2721,7.5580);D(1,1.5875,7.4494,5.2045,7.4297,5.2053,7.5669,1.5882,7.5866);D(1,6.7900,7.4604,6.9062,7.4604,6.9062,7.5571,6.7900,7.5571);D(1,1.2742,7.6402,1.4080,7.6383,1.4080,7.7317,1.2742,7.7306);D(1,1.5854,7.6243,2.5919,7.6150,2.5930,7.7390,1.5866,7.7483);D(1,6.7900,7.6377,6.9146,7.6377,6.9146,7.7344,6.7900,7.7344);D(1,1.2752,7.7782,1.4070,7.7840,1.4070,7.8807,1.2752,7.8748);D(1,1.5865,7.7701,5.1092,7.7743,5.1091,7.8942,1.5864,7.8900);D(1,6.7900,7.7827,6.9062,7.7827,6.9062,7.8794,6.7900,7.8794);D(1,7.7239,7.7764,7.9646,7.7730,7.9646,7.8750,7.7239,7.8785);D(2,1.2679,1.7107,1.4080,1.7100,1.4080,1.8101,1.2679,1.8101);D(2,1.5864,1.7015,5.0054,1.6987,5.0055,1.8250,1.5865,1.8278);D(2,6.7776,1.7103,6.9062,1.7127,6.9062,1.8089,6.7776,1.8085);D(2,1.2700,1.8769,1.4059,1.8841,1.4059,1.9848,1.2700,1.9776);D(2,1.5792,1.8687,3.6856,1.8706,3.6855,1.9975,1.5791,1.9956);D(2,6.7776,1.8799,6.9146,1.8836,6.9146,1.9785,6.7776,1.9759);D(2,7.6616,1.8664,7.9646,1.8669,7.9646,1.9716,7.6616,1.9711);D(2,1.2669,2.0433,1.4080,2.0429,1.4080,2.1412,1.2669,2.1425);D(2,1.5865,2.0404,3.2871,2.0399,3.2871,2.1579,1.5865,2.1585);D(2,1.3873,2.2381,1.4641,2.2326,1.4641,2.3147,1.3873,2.3188);D(2,1.5874,2.2075,2.2142,2.2070,2.2143,2.3311,1.5875,2.3317);D(2,1.3893,2.3846,1.4641,2.3844,1.4641,2.4782,1.3893,2.4783);D(2,1.5875,2.3727,2.2495,2.3727,2.2495,2.4976,1.5875,2.4976);D(2,1.4042,2.5759,1.4609,2.5759,1.4609,2.6363,1.4042,2.6363);D(2,1.5865,2.5352,3.0632,2.5374,3.0630,2.6651,1.5863,2.6629);D(2,1.3935,2.7151,1.4692,2.7151,1.4692,2.8118,1.3935,2.8118);D(2,1.5792,2.6996,2.9118,2.7028,2.9115,2.8312,1.5789,2.8280);D(2,1.2659,2.8762,1.4039,2.8762,1.4039,2.9836,1.2659,2.9836);D(2,1.5864,2.8704,4.9639,2.8667,4.9640,2.9975,1.5865,3.0012);D(2,6.7776,2.8769,6.9146,2.8825,6.9146,2.9796,6.7776,2.9751);D(2,1.2659,3.0444,1.4039,3.0453,1.4039,3.1480,1.2659,3.1435);D(2,1.5895,3.0307,2.9364,3.0300,2.9365,3.1619,1.5896,3.1626);D(2,5.4661,3.0442,5.6155,3.0440,5.6155,3.1433,5.4661,3.1436);D(2,1.2669,3.2082,1.4039,3.2101,1.4039,3.3088,1.2669,3.3088);D(2,1.5844,3.2007,4.0217,3.2000,4.0217,3.3205,1.5844,3.3212);D(2,5.4744,3.2115,5.6155,3.2099,5.6155,3.3086,5.4744,3.3086);D(2,1.2669,3.3757,1.4070,3.3757,1.4070,3.4778,1.2669,3.4778);D(2,1.5820,3.3673,4.1525,3.3614,4.1528,3.4910,1.5823,3.4969);D(2,5.4744,3.3757,5.6155,3.3757,5.6155,3.4778,5.4744,3.4778);D(2,1.2669,3.5505,1.4039,3.5505,1.4039,3.6522,1.2669,3.6513);D(2,1.5885,3.5384,3.5901,3.5362,3.5902,3.6648,1.5886,3.6669);D(2,5.4827,3.5503,5.6155,3.5503,5.6155,3.6470,5.4827,3.6470);D(2,1.2669,3.7213,1.3956,3.7179,1.3956,3.8201,1.2669,3.8223);D(2,1.5843,3.7085,3.2290,3.7073,3.2291,3.8307,1.5844,3.8320);D(2,5.4744,3.7161,5.6030,3.7149,5.6030,3.8143,5.4744,3.8155);D(2,1.2679,3.8745,1.4080,3.8766,1.4080,3.9773,1.2679,3.9773);D(2,1.5792,3.8614,5.9435,3.8642,5.9434,3.9942,1.5791,3.9914);D(2,6.7776,3.8747,6.9146,3.8777,6.9146,3.9773,6.7776,3.9773);D(2,1.2669,4.0391,1.4080,4.0430,1.4080,4.1451,1.2669,4.1412);D(2,1.5803,4.0271,4.4908,4.0283,4.4907,4.1580,1.5802,4.1568);D(2,6.7776,4.0410,6.9146,4.0444,6.9146,4.1429,6.7776,4.1437);D(2,0.4918,4.2485,0.9857,4.2485,0.9852,4.3774,0.4926,4.3774);D(2,0.4898,4.5306,1.1434,4.5214,1.1450,4.6346,0.4914,4.6438);D(2,0.4900,4.6512,1.2053,4.6554,1.2047,4.7597,0.4894,4.7556);D(2,1.2648,4.2030,1.4080,4.2181,1.4080,4.3206,1.2648,4.3017);D(2,1.5792,4.1982,6.1470,4.2093,6.1467,4.3346,1.5789,4.3235);D(2,6.3426,4.2892,6.3549,4.2892,6.3549,4.3016,6.3426,4.3016);D(2,6.5092,4.2892,6.5216,4.2892,6.5216,4.3016,6.5092,4.3016);D(2,6.7776,4.2182,6.9146,4.2178,6.9146,4.3172,6.7776,4.3175);D(2,7.7156,4.2002,7.9646,4.2002,7.9646,4.3055,7.7156,4.3041);D(2,1.2939,4.5348,2.3663,4.5401,2.3657,4.6647,1.2933,4.6593);D(2,2.4031,4.5033,4.2002,4.5015,4.2002,4.6534,2.4031,4.6507);D(2,4.5905,4.5348,5.0922,4.5510,5.0882,4.6757,4.5865,4.6596);D(2,5.2336,4.5359,5.3540,4.5359,5.3540,4.6594,5.2336,4.6567);D(2,5.3914,4.5417,5.8728,4.5435,5.8728,4.6594,5.3914,4.6560);D(2,6.0264,4.5386,6.1633,4.5386,6.1633,4.6621,6.0264,4.6621);D(2,6.1924,4.5401,6.5950,4.5444,6.5950,4.6591,6.1924,4.6582);D(2,1.2897,4.7034,2.3640,4.7075,2.3636,4.8214,1.2893,4.8173);D(2,2.3969,4.6552,5.6030,4.6661,5.6030,4.8278,2.3969,4.8236);D(2,1.2617,4.8597,4.8187,4.8617,4.8186,4.9879,1.2616,4.9860);D(2,5.4744,4.8668,5.6196,4.8768,5.6196,4.9842,5.4744,4.9742);D(2,0.4910,5.0408,1.0293,5.0408,1.0272,5.1640,0.4913,5.1631);D(2,0.4918,5.1788,1.1012,5.1804,1.1009,5.3073,0.4915,5.3058);D(2,0.4914,5.3408,1.0956,5.3291,1.0978,5.4385,0.4935,5.4502);D(2,0.4900,5.4463,1.1958,5.4498,1.1953,5.5514,0.4895,5.5479);D(2,0.4921,5.5416,1.0303,5.5387,1.0308,5.6359,0.4926,5.6388);D(2,1.2679,5.0596,1.4008,5.0596,1.4008,5.1616,1.2679,5.1616);D(2,1.5865,5.0579,4.7357,5.0604,4.7356,5.1858,1.5864,5.1833);D(2,5.0092,5.1424,5.0216,5.1424,5.0216,5.1547,5.0092,5.1547);D(2,5.1759,5.1424,5.1882,5.1424,5.1882,5.1547,5.1759,5.1547);D(2,5.3426,5.1424,5.3549,5.1424,5.3549,5.1547,5.3426,5.1547);D(2,5.5092,5.1424,5.5216,5.1424,5.5216,5.1547,5.5092,5.1547);D(2,5.6759,5.1424,5.6882,5.1424,5.6882,5.1547,5.6759,5.1547);D(2,5.8426,5.1424,5.8549,5.1424,5.8549,5.1547,5.8426,5.1547);D(2,6.0092,5.1424,6.0216,5.1424,6.0216,5.1547,6.0092,5.1547);D(2,6.1759,5.1424,6.1882,5.1424,6.1882,5.1547,6.1759,5.1547);D(2,6.3426,5.1424,6.3549,5.1424,6.3549,5.1547,6.3426,5.1547);D(2,6.7776,5.0515,6.9062,5.0515,6.9062,5.1536,6.7776,5.1536);D(2,7.7156,5.0300,7.9646,5.0300,7.9646,5.1375,7.7156,5.1375);D(2,1.3904,6.6042,2.0382,6.6063,2.0378,6.7240,1.3900,6.7219);D(2,2.4072,6.7579,3.2468,6.7622,3.2456,6.9888,2.4061,6.9845);D(2,3.8453,6.6053,4.0591,6.6070,4.0591,6.7037,3.8453,6.7019);D(2,3.8267,6.7783,4.4326,6.7783,4.4326,6.8965,3.8267,6.8965);D(2,4.5447,6.6029,5.2758,6.6070,5.2751,6.7279,4.5441,6.7239);D(2,4.8394,6.8055,5.1797,6.8097,5.1797,6.9386,4.8394,6.9344);D(2,1.3862,7.0254,3.6627,7.0254,3.6627,7.1436,1.3862,7.1436);D(2,2.2412,7.1907,3.0061,7.1958,3.0048,7.3865,2.2399,7.3814);D(2,3.8453,7.0254,4.0591,7.0254,4.0591,7.1221,3.8453,7.1221);D(2,3.8246,7.1919,4.4451,7.1919,4.4451,7.3101,3.8246,7.3101);D(2,4.5446,7.0268,5.4785,7.0259,5.4786,7.1382,4.5447,7.1391);D(2,4.8684,7.2402,5.1838,7.2402,5.1838,7.3367,4.8684,7.3351);D(2,1.3894,7.5995,2.1256,7.6103,2.1239,7.7272,1.3877,7.7164);D(2,1.2888,7.7551,1.9656,7.7631,1.9641,7.8877,1.2873,7.8797);D(2,3.0465,7.6003,3.9402,7.6115,3.9386,7.7369,3.0449,7.7256);D(2,4.1836,7.7168,4.9560,7.7183,4.9556,7.9039,4.1832,7.9024);D(2,5.4453,7.6153,5.6611,7.6185,5.6611,7.7152,5.4453,7.7120);D(2,5.4661,7.7290,6.0762,7.7290,6.0762,7.8472,5.4661,7.8472);D(2,1.3894,7.9614,1.9441,7.9705,1.9423,8.0771,1.3876,8.0680);D(2,2.1208,7.9453,3.0158,7.9487,3.0153,8.0791,2.1203,8.0757);D(2,6.4376,7.9636,6.9014,7.9465,6.9059,8.0666,6.4421,8.0837);D(2,7.0474,7.9429,7.8691,7.9392,7.8691,8.0574,7.0474,8.0610);D(2,1.3877,8.1127,2.0554,8.1314,2.0522,8.2463,1.3845,8.2276);D(2,2.2265,8.1127,4.8145,8.1088,4.8147,8.2323,2.2267,8.2362);D(2,6.4373,8.1211,6.9062,8.1210,6.9062,8.2286,6.4373,8.2287);D(2,7.3254,8.1211,7.7114,8.1211,7.7114,8.2285,7.3254,8.2285)" + } + }, + "kind": "document", + "startPageNumber": 1, + "endPageNumber": 2, + "unit": "inch", + "pages": [ + { + "pageNumber": 1, + "angle": 0, + "width": 8.5, + "height": 11, + "spans": [ + { + "offset": 0, + "length": 5442 + } + ], + "words": [ + { + "content": "Form", + "span": { + "offset": 17, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,0.4982,0.7739,0.5081,0.5311,0.5935,0.5277,0.5864,0.7706)" + }, + { + "content": "1040", + "span": { + "offset": 22, + "length": 4 + }, + "confidence": 0.994, + "source": "D(1,0.6023,0.5028,1.2576,0.5043,1.2576,0.7684,0.6023,0.7684)" + }, + { + "content": "Department", + "span": { + "offset": 49, + "length": 10 + }, + "confidence": 0.992, + "source": "D(1,1.3427,0.5222,1.7899,0.5231,1.7915,0.6244,1.3447,0.6236)" + }, + { + "content": "of", + "span": { + "offset": 60, + "length": 2 + }, + "confidence": 0.993, + "source": "D(1,1.8102,0.5231,1.8895,0.5232,1.891,0.6246,1.8118,0.6244)" + }, + { + "content": "the", + "span": { + "offset": 63, + "length": 3 + }, + "confidence": 0.981, + "source": "D(1,1.9047,0.5233,2.0262,0.5235,2.0276,0.6248,1.9062,0.6246)" + }, + { + "content": "Treasury", + "span": { + "offset": 67, + "length": 8 + }, + "confidence": 0.945, + "source": "D(1,2.0448,0.5235,2.3773,0.5236,2.3783,0.6245,2.0461,0.6248)" + }, + { + "content": "-", + "span": { + "offset": 75, + "length": 1 + }, + "confidence": 0.927, + "source": "D(1,2.3773,0.5236,2.4414,0.5236,2.4424,0.6245,2.3783,0.6245)" + }, + { + "content": "Internal", + "span": { + "offset": 76, + "length": 8 + }, + "confidence": 0.932, + "source": "D(1,2.4583,0.5236,2.73,0.5237,2.7307,0.6242,2.4592,0.6245)" + }, + { + "content": "Revenue", + "span": { + "offset": 85, + "length": 7 + }, + "confidence": 0.986, + "source": "D(1,2.7587,0.5237,3.0828,0.5232,3.0831,0.6231,2.7594,0.6241)" + }, + { + "content": "Service", + "span": { + "offset": 93, + "length": 7 + }, + "confidence": 0.986, + "source": "D(1,3.103,0.5232,3.395,0.5228,3.395,0.6221,3.1033,0.623)" + }, + { + "content": "(", + "span": { + "offset": 101, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.7354,0.5157,3.7676,0.5168,3.7677,0.6274,3.7354,0.6259)" + }, + { + "content": "99", + "span": { + "offset": 102, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,3.7587,0.5165,3.8699,0.5188,3.8699,0.6302,3.7587,0.627)" + }, + { + "content": ")", + "span": { + "offset": 104, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.8645,0.5188,3.9076,0.5191,3.9076,0.6304,3.8646,0.6301)" + }, + { + "content": "U", + "span": { + "offset": 106, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,1.3489,0.6434,1.4533,0.6439,1.4533,0.7943,1.3489,0.7938)" + }, + { + "content": ".", + "span": { + "offset": 107, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,1.4633,0.6439,1.5006,0.6441,1.5006,0.7945,1.4633,0.7943)" + }, + { + "content": "S", + "span": { + "offset": 108, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,1.5055,0.6441,1.605,0.6446,1.605,0.795,1.5055,0.7945)" + }, + { + "content": ".", + "span": { + "offset": 109, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,1.6149,0.6446,1.6473,0.6448,1.6473,0.7952,1.6149,0.7951)" + }, + { + "content": "Individual", + "span": { + "offset": 111, + "length": 10 + }, + "confidence": 0.994, + "source": "D(1,1.7169,0.6451,2.4131,0.6477,2.4131,0.798,1.7169,0.7956)" + }, + { + "content": "Income", + "span": { + "offset": 122, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,2.4753,0.6477,3.0124,0.6486,3.0124,0.7985,2.4753,0.7981)" + }, + { + "content": "Tax", + "span": { + "offset": 129, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,3.0596,0.6486,3.3357,0.6482,3.3357,0.7975,3.0597,0.7984)" + }, + { + "content": "Return", + "span": { + "offset": 133, + "length": 6 + }, + "confidence": 0.996, + "source": "D(1,3.3879,0.6481,3.8951,0.6473,3.8951,0.7955,3.3879,0.7973)" + }, + { + "content": "2020", + "span": { + "offset": 162, + "length": 4 + }, + "confidence": 0.983, + "source": "D(1,4.1296,0.5311,4.8684,0.5334,4.8684,0.7729,4.1296,0.7726)" + }, + { + "content": "OMB", + "span": { + "offset": 189, + "length": 3 + }, + "confidence": 0.986, + "source": "D(1,4.939,0.6877,5.1656,0.6877,5.1656,0.7878,4.939,0.7875)" + }, + { + "content": "No", + "span": { + "offset": 193, + "length": 2 + }, + "confidence": 0.972, + "source": "D(1,5.1991,0.6877,5.3217,0.6877,5.3217,0.788,5.1991,0.7878)" + }, + { + "content": ".", + "span": { + "offset": 195, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,5.325,0.6877,5.3452,0.6877,5.3452,0.788,5.325,0.788)" + }, + { + "content": "1545-0074", + "span": { + "offset": 197, + "length": 9 + }, + "confidence": 0.978, + "source": "D(1,5.3787,0.6877,5.8521,0.6878,5.8521,0.7883,5.3787,0.788)" + }, + { + "content": "IRS", + "span": { + "offset": 229, + "length": 3 + }, + "confidence": 0.957, + "source": "D(1,5.9849,0.6988,6.1264,0.699,6.1264,0.8022,5.9849,0.8017)" + }, + { + "content": "Use", + "span": { + "offset": 233, + "length": 3 + }, + "confidence": 0.954, + "source": "D(1,6.1488,0.699,6.3006,0.6993,6.3006,0.8028,6.1488,0.8023)" + }, + { + "content": "Only", + "span": { + "offset": 237, + "length": 4 + }, + "confidence": 0.97, + "source": "D(1,6.3213,0.6993,6.4991,0.6996,6.4991,0.8035,6.3213,0.8029)" + }, + { + "content": "-", + "span": { + "offset": 241, + "length": 1 + }, + "confidence": 0.957, + "source": "D(1,6.5008,0.6996,6.5629,0.6997,6.5629,0.8038,6.5008,0.8036)" + }, + { + "content": "Do", + "span": { + "offset": 242, + "length": 2 + }, + "confidence": 0.971, + "source": "D(1,6.5767,0.6997,6.6837,0.6999,6.6837,0.8041,6.5767,0.8038)" + }, + { + "content": "not", + "span": { + "offset": 245, + "length": 3 + }, + "confidence": 0.947, + "source": "D(1,6.7079,0.7,6.8287,0.7002,6.8287,0.8045,6.7079,0.8042)" + }, + { + "content": "write", + "span": { + "offset": 249, + "length": 5 + }, + "confidence": 0.945, + "source": "D(1,6.8459,0.7003,7.0323,0.7007,7.0323,0.805,6.8459,0.8045)" + }, + { + "content": "or", + "span": { + "offset": 255, + "length": 2 + }, + "confidence": 0.939, + "source": "D(1,7.053,0.7008,7.1341,0.7009,7.1341,0.8052,7.053,0.805)" + }, + { + "content": "staple", + "span": { + "offset": 258, + "length": 6 + }, + "confidence": 0.716, + "source": "D(1,7.1479,0.701,7.3791,0.7016,7.3791,0.8057,7.1479,0.8053)" + }, + { + "content": "in", + "span": { + "offset": 265, + "length": 2 + }, + "confidence": 0.886, + "source": "D(1,7.4033,0.7017,7.4637,0.7019,7.4637,0.8058,7.4033,0.8057)" + }, + { + "content": "this", + "span": { + "offset": 268, + "length": 4 + }, + "confidence": 0.786, + "source": "D(1,7.4844,0.7019,7.6207,0.7024,7.6207,0.806,7.4844,0.8058)" + }, + { + "content": "space", + "span": { + "offset": 273, + "length": 5 + }, + "confidence": 0.935, + "source": "D(1,7.6414,0.7024,7.8675,0.7031,7.8675,0.8063,7.6414,0.806)" + }, + { + "content": ".", + "span": { + "offset": 278, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,7.8692,0.7031,7.8899,0.7032,7.8899,0.8064,7.8692,0.8063)" + }, + { + "content": "Filing", + "span": { + "offset": 286, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,0.4923,0.9131,0.8131,0.914,0.8131,1.0534,0.4923,1.0526)" + }, + { + "content": "Status", + "span": { + "offset": 293, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,0.8493,0.9141,1.2513,0.9148,1.2513,1.0516,0.8493,1.0534)" + }, + { + "content": "Check", + "span": { + "offset": 300, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,0.4926,1.0776,0.8169,1.0796,0.8155,1.1952,0.4921,1.1937)" + }, + { + "content": "only", + "span": { + "offset": 306, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,0.8404,1.0798,1.0552,1.0831,1.0532,1.1989,0.8388,1.1954)" + }, + { + "content": "one", + "span": { + "offset": 311, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,0.4908,1.204,0.6758,1.2051,0.6764,1.3022,0.4918,1.3018)" + }, + { + "content": "box", + "span": { + "offset": 315, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,0.7115,1.2052,0.8982,1.2046,0.8983,1.3023,0.7121,1.3022)" + }, + { + "content": ".", + "span": { + "offset": 318, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,0.8998,1.2046,0.9323,1.2044,0.9323,1.3022,0.8999,1.3023)" + }, + { + "content": "☐", + "span": { + "offset": 321, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,1.3209,0.9393,1.4454,0.9373,1.4454,1.0621,1.3209,1.0641)" + }, + { + "content": "Single", + "span": { + "offset": 323, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,1.4931,0.9428,1.8137,0.9424,1.8137,1.0617,1.4931,1.061)" + }, + { + "content": "☑", + "span": { + "offset": 330, + "length": 1 + }, + "confidence": 0.963, + "source": "D(1,1.9227,0.9406,2.043,0.9406,2.043,1.0628,1.9227,1.0621)" + }, + { + "content": "Married", + "span": { + "offset": 332, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,2.0845,0.9341,2.4681,0.9385,2.4682,1.0628,2.0845,1.0567)" + }, + { + "content": "filing", + "span": { + "offset": 340, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,2.503,0.9388,2.7328,0.9404,2.7328,1.0654,2.503,1.0631)" + }, + { + "content": "jointly", + "span": { + "offset": 347, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,2.7594,0.9405,3.0692,0.9412,3.0692,1.0665,2.7595,1.0655)" + }, + { + "content": "☐", + "span": { + "offset": 355, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,3.2207,0.9393,3.3452,0.9393,3.3452,1.0635,3.2207,1.0635)" + }, + { + "content": "Married", + "span": { + "offset": 357, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,3.3867,0.9369,3.7665,0.9369,3.7665,1.0632,3.3867,1.0613)" + }, + { + "content": "filing", + "span": { + "offset": 365, + "length": 6 + }, + "confidence": 0.992, + "source": "D(1,3.8022,0.9369,4.0267,0.937,4.0267,1.0641,3.8022,1.0634)" + }, + { + "content": "separately", + "span": { + "offset": 372, + "length": 10 + }, + "confidence": 0.99, + "source": "D(1,4.0624,0.937,4.5722,0.9372,4.5722,1.0647,4.0624,1.0642)" + }, + { + "content": "(", + "span": { + "offset": 383, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.5995,0.9372,4.6352,0.9372,4.6352,1.0647,4.5995,1.0647)" + }, + { + "content": "MFS", + "span": { + "offset": 384, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,4.6373,0.9372,4.8513,0.9373,4.8513,1.0645,4.6373,1.0647)" + }, + { + "content": ")", + "span": { + "offset": 387, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.8513,0.9373,4.8975,0.9373,4.8975,1.0644,4.8513,1.0645)" + }, + { + "content": "☐", + "span": { + "offset": 389, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,5.0178,0.9379,5.1423,0.9379,5.1423,1.0648,5.0178,1.0648)" + }, + { + "content": "Head", + "span": { + "offset": 391, + "length": 4 + }, + "confidence": 0.993, + "source": "D(1,5.188,0.935,5.4398,0.9359,5.4398,1.0573,5.188,1.0554)" + }, + { + "content": "of", + "span": { + "offset": 396, + "length": 2 + }, + "confidence": 0.963, + "source": "D(1,5.4746,0.936,5.5708,0.9363,5.5708,1.0583,5.4746,1.0575)" + }, + { + "content": "household", + "span": { + "offset": 399, + "length": 9 + }, + "confidence": 0.972, + "source": "D(1,5.5954,0.9364,6.0765,0.9363,6.0765,1.06,5.5954,1.0584)" + }, + { + "content": "(", + "span": { + "offset": 409, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.1072,0.9362,6.144,0.9361,6.144,1.06,6.1072,1.06)" + }, + { + "content": "HOH", + "span": { + "offset": 410, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,6.142,0.9361,6.359,0.9354,6.359,1.06,6.142,1.06)" + }, + { + "content": ")", + "span": { + "offset": 413, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.359,0.9354,6.3999,0.9353,6.3999,1.06,6.359,1.06)" + }, + { + "content": "☐", + "span": { + "offset": 415, + "length": 1 + }, + "confidence": 0.988, + "source": "D(1,6.5203,0.9386,6.6448,0.9386,6.6448,1.0648,6.5203,1.0648)" + }, + { + "content": "Qualifying", + "span": { + "offset": 417, + "length": 10 + }, + "confidence": 0.995, + "source": "D(1,6.6863,0.9359,7.1838,0.9343,7.1838,1.069,6.6863,1.068)" + }, + { + "content": "widow", + "span": { + "offset": 428, + "length": 5 + }, + "confidence": 0.996, + "source": "D(1,7.2129,0.9343,7.5378,0.9337,7.5378,1.0693,7.2129,1.069)" + }, + { + "content": "(", + "span": { + "offset": 433, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.5446,0.9337,7.5759,0.9337,7.5759,1.0693,7.5446,1.0693)" + }, + { + "content": "er", + "span": { + "offset": 434, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,7.5714,0.9337,7.67,0.9337,7.67,1.0693,7.5714,1.0693)" + }, + { + "content": ")", + "span": { + "offset": 436, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.6633,0.9337,7.6969,0.9337,7.6969,1.0693,7.6633,1.0693)" + }, + { + "content": "(", + "span": { + "offset": 438, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.7238,0.9337,7.7597,0.9337,7.7597,1.0693,7.7238,1.0693)" + }, + { + "content": "QW", + "span": { + "offset": 439, + "length": 2 + }, + "confidence": 0.996, + "source": "D(1,7.7507,0.9337,7.939,0.9337,7.939,1.0693,7.7507,1.0693)" + }, + { + "content": ")", + "span": { + "offset": 441, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.9277,0.9337,7.9771,0.9337,7.9771,1.0693,7.9277,1.0693)" + }, + { + "content": "If", + "span": { + "offset": 444, + "length": 2 + }, + "confidence": 0.946, + "source": "D(1,1.3167,1.1168,1.3889,1.1167,1.3889,1.2377,1.3167,1.2377)" + }, + { + "content": "you", + "span": { + "offset": 447, + "length": 3 + }, + "confidence": 0.989, + "source": "D(1,1.4075,1.1167,1.587,1.1164,1.587,1.2378,1.4075,1.2377)" + }, + { + "content": "checked", + "span": { + "offset": 451, + "length": 7 + }, + "confidence": 0.993, + "source": "D(1,1.6221,1.1164,2.0347,1.1158,2.0347,1.2379,1.6221,1.2378)" + }, + { + "content": "the", + "span": { + "offset": 459, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,2.0698,1.1158,2.2287,1.1156,2.2287,1.238,2.0698,1.2379)" + }, + { + "content": "MFS", + "span": { + "offset": 463, + "length": 3 + }, + "confidence": 0.994, + "source": "D(1,2.2617,1.1155,2.4825,1.1152,2.4825,1.2381,2.2617,1.238)" + }, + { + "content": "box", + "span": { + "offset": 467, + "length": 3 + }, + "confidence": 0.981, + "source": "D(1,2.5217,1.1152,2.7033,1.1149,2.7033,1.2382,2.5217,1.2381)" + }, + { + "content": ",", + "span": { + "offset": 470, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,2.7012,1.1149,2.726,1.1149,2.726,1.2382,2.7012,1.2382)" + }, + { + "content": "enter", + "span": { + "offset": 472, + "length": 5 + }, + "confidence": 0.98, + "source": "D(1,2.759,1.1149,3.0169,1.1145,3.0169,1.2383,2.759,1.2382)" + }, + { + "content": "the", + "span": { + "offset": 478, + "length": 3 + }, + "confidence": 0.993, + "source": "D(1,3.0416,1.1145,3.1964,1.1143,3.1964,1.2383,3.0416,1.2383)" + }, + { + "content": "name", + "span": { + "offset": 482, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,3.2294,1.1142,3.4997,1.1139,3.4997,1.2384,3.2294,1.2383)" + }, + { + "content": "of", + "span": { + "offset": 487, + "length": 2 + }, + "confidence": 0.992, + "source": "D(1,3.5286,1.1138,3.6297,1.1138,3.6297,1.2385,3.5286,1.2384)" + }, + { + "content": "your", + "span": { + "offset": 490, + "length": 4 + }, + "confidence": 0.983, + "source": "D(1,3.6503,1.1138,3.8773,1.1137,3.8773,1.2385,3.6503,1.2385)" + }, + { + "content": "spouse", + "span": { + "offset": 495, + "length": 6 + }, + "confidence": 0.556, + "source": "D(1,3.902,1.1137,4.2631,1.1135,4.2631,1.2386,3.902,1.2385)" + }, + { + "content": ".", + "span": { + "offset": 501, + "length": 1 + }, + "confidence": 0.898, + "source": "D(1,4.2673,1.1135,4.2899,1.1135,4.29,1.2386,4.2673,1.2386)" + }, + { + "content": "If", + "span": { + "offset": 503, + "length": 2 + }, + "confidence": 0.714, + "source": "D(1,4.3271,1.1135,4.389,1.1135,4.389,1.2386,4.3271,1.2386)" + }, + { + "content": "you", + "span": { + "offset": 506, + "length": 3 + }, + "confidence": 0.919, + "source": "D(1,4.4096,1.1135,4.5871,1.1134,4.5871,1.2386,4.4096,1.2386)" + }, + { + "content": "checked", + "span": { + "offset": 510, + "length": 7 + }, + "confidence": 0.963, + "source": "D(1,4.6201,1.1134,5.0369,1.1132,5.0369,1.2387,4.6201,1.2386)" + }, + { + "content": "the", + "span": { + "offset": 518, + "length": 3 + }, + "confidence": 0.992, + "source": "D(1,5.0678,1.1132,5.2226,1.1131,5.2226,1.2387,5.0678,1.2387)" + }, + { + "content": "HOH", + "span": { + "offset": 522, + "length": 3 + }, + "confidence": 0.955, + "source": "D(1,5.2576,1.1131,5.4929,1.113,5.4929,1.2388,5.2576,1.2387)" + }, + { + "content": "or", + "span": { + "offset": 526, + "length": 2 + }, + "confidence": 0.957, + "source": "D(1,5.5259,1.113,5.6332,1.1129,5.6332,1.2388,5.5259,1.2388)" + }, + { + "content": "QW", + "span": { + "offset": 529, + "length": 2 + }, + "confidence": 0.905, + "source": "D(1,5.6682,1.1129,5.8519,1.1129,5.8519,1.2388,5.6682,1.2388)" + }, + { + "content": "box", + "span": { + "offset": 532, + "length": 3 + }, + "confidence": 0.879, + "source": "D(1,5.8828,1.1129,6.052,1.113,6.052,1.2388,5.8828,1.2388)" + }, + { + "content": ",", + "span": { + "offset": 535, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,6.0603,1.113,6.0892,1.113,6.0892,1.2388,6.0603,1.2388)" + }, + { + "content": "enter", + "span": { + "offset": 537, + "length": 5 + }, + "confidence": 0.978, + "source": "D(1,6.116,1.113,6.3801,1.1132,6.3801,1.2388,6.116,1.2388)" + }, + { + "content": "the", + "span": { + "offset": 543, + "length": 3 + }, + "confidence": 0.994, + "source": "D(1,6.3203,1.1131,6.5679,1.1133,6.5679,1.2388,6.3203,1.2388)" + }, + { + "content": "child's", + "span": { + "offset": 547, + "length": 7 + }, + "confidence": 0.955, + "source": "D(1,6.5864,1.1133,6.898,1.1134,6.898,1.2388,6.5864,1.2388)" + }, + { + "content": "name", + "span": { + "offset": 555, + "length": 4 + }, + "confidence": 0.927, + "source": "D(1,6.9289,1.1134,7.2034,1.1136,7.2034,1.2389,6.9289,1.2388)" + }, + { + "content": "if", + "span": { + "offset": 560, + "length": 2 + }, + "confidence": 0.977, + "source": "D(1,7.2405,1.1136,7.3086,1.1136,7.3086,1.2389,7.2405,1.2389)" + }, + { + "content": "the", + "span": { + "offset": 563, + "length": 3 + }, + "confidence": 0.907, + "source": "D(1,7.3292,1.1136,7.5211,1.1137,7.5211,1.2389,7.3292,1.2389)" + }, + { + "content": "qualifying", + "span": { + "offset": 567, + "length": 10 + }, + "confidence": 0.84, + "source": "D(1,7.5025,1.1137,7.9854,1.1139,7.9854,1.2389,7.5025,1.2389)" + }, + { + "content": "person", + "span": { + "offset": 578, + "length": 6 + }, + "confidence": 0.976, + "source": "D(1,1.3146,1.2655,1.6547,1.2635,1.6564,1.3828,1.3167,1.3826)" + }, + { + "content": "is", + "span": { + "offset": 585, + "length": 2 + }, + "confidence": 0.958, + "source": "D(1,1.6951,1.2632,1.77,1.2628,1.7716,1.3829,1.6968,1.3828)" + }, + { + "content": "a", + "span": { + "offset": 588, + "length": 1 + }, + "confidence": 0.947, + "source": "D(1,1.8024,1.2626,1.8591,1.2622,1.8606,1.383,1.804,1.3829)" + }, + { + "content": "child", + "span": { + "offset": 590, + "length": 5 + }, + "confidence": 0.934, + "source": "D(1,1.8915,1.262,2.1202,1.2611,2.1214,1.3829,1.8929,1.383)" + }, + { + "content": "but", + "span": { + "offset": 596, + "length": 3 + }, + "confidence": 0.963, + "source": "D(1,2.1586,1.261,2.3165,1.2606,2.3175,1.3827,2.1598,1.3829)" + }, + { + "content": "not", + "span": { + "offset": 600, + "length": 3 + }, + "confidence": 0.942, + "source": "D(1,2.3468,1.2605,2.5047,1.2601,2.5056,1.3825,2.3479,1.3827)" + }, + { + "content": "your", + "span": { + "offset": 604, + "length": 4 + }, + "confidence": 0.925, + "source": "D(1,2.529,1.26,2.7557,1.2597,2.7563,1.3821,2.5298,1.3825)" + }, + { + "content": "dependent", + "span": { + "offset": 609, + "length": 9 + }, + "confidence": 0.989, + "source": "D(1,2.7779,1.2597,3.3224,1.26,3.3224,1.3805,2.7785,1.382)" + }, + { + "content": "Your", + "span": { + "offset": 620, + "length": 4 + }, + "confidence": 0.97, + "source": "D(1,0.5421,1.4452,0.7604,1.4446,0.7612,1.5522,0.5432,1.5522)" + }, + { + "content": "first", + "span": { + "offset": 625, + "length": 5 + }, + "confidence": 0.877, + "source": "D(1,0.7802,1.4445,0.9443,1.444,0.9451,1.5522,0.7811,1.5522)" + }, + { + "content": "name", + "span": { + "offset": 631, + "length": 4 + }, + "confidence": 0.979, + "source": "D(1,0.9696,1.4439,1.2094,1.4436,1.21,1.5522,0.9703,1.5522)" + }, + { + "content": "and", + "span": { + "offset": 636, + "length": 3 + }, + "confidence": 0.967, + "source": "D(1,1.2365,1.4436,1.4006,1.4435,1.401,1.5522,1.237,1.5522)" + }, + { + "content": "middle", + "span": { + "offset": 640, + "length": 6 + }, + "confidence": 0.902, + "source": "D(1,1.4313,1.4435,1.7234,1.4438,1.7236,1.5522,1.4317,1.5522)" + }, + { + "content": "initial", + "span": { + "offset": 647, + "length": 7 + }, + "confidence": 0.956, + "source": "D(1,1.7541,1.4438,1.9849,1.4442,1.9849,1.5522,1.7542,1.5522)" + }, + { + "content": "Anthony", + "span": { + "offset": 655, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,0.5198,1.5983,0.9805,1.5989,0.979,1.7246,0.5183,1.724)" + }, + { + "content": "Last", + "span": { + "offset": 664, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,3.3452,1.4517,3.5405,1.4504,3.5405,1.5454,3.3452,1.5459)" + }, + { + "content": "name", + "span": { + "offset": 669, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,3.5631,1.4504,3.8101,1.4522,3.8101,1.5479,3.5631,1.5455)" + }, + { + "content": "Kelly", + "span": { + "offset": 674, + "length": 5 + }, + "confidence": 0.994, + "source": "D(1,3.3369,1.6006,3.6088,1.6014,3.6088,1.7241,3.3369,1.722)" + }, + { + "content": "Your", + "span": { + "offset": 681, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,6.5452,1.446,6.7729,1.4455,6.7729,1.5556,6.5452,1.5559)" + }, + { + "content": "social", + "span": { + "offset": 686, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,6.7947,1.4454,7.0698,1.4449,7.0698,1.5551,6.7947,1.5555)" + }, + { + "content": "security", + "span": { + "offset": 693, + "length": 8 + }, + "confidence": 0.996, + "source": "D(1,7.0989,1.4449,7.4723,1.4445,7.4723,1.5544,7.0989,1.5551)" + }, + { + "content": "number", + "span": { + "offset": 702, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,7.4942,1.4445,7.8567,1.4446,7.8567,1.5536,7.4942,1.5544)" + }, + { + "content": "980", + "span": { + "offset": 709, + "length": 3 + }, + "confidence": 0.517, + "source": "D(1,6.5535,1.5764,6.943,1.5768,6.943,1.7266,6.5535,1.7257)" + }, + { + "content": "9", + "span": { + "offset": 713, + "length": 1 + }, + "confidence": 0.716, + "source": "D(1,7.0336,1.5769,7.0998,1.5771,7.0998,1.7269,7.0336,1.7268)" + }, + { + "content": "7", + "span": { + "offset": 715, + "length": 1 + }, + "confidence": 0.523, + "source": "D(1,7.2002,1.5774,7.2688,1.5776,7.2688,1.727,7.2002,1.7269)" + }, + { + "content": "0", + "span": { + "offset": 717, + "length": 1 + }, + "confidence": 0.541, + "source": "D(1,7.3644,1.5779,7.4379,1.5782,7.4379,1.7271,7.3644,1.727)" + }, + { + "content": "2", + "span": { + "offset": 719, + "length": 1 + }, + "confidence": 0.656, + "source": "D(1,7.531,1.5786,7.6069,1.579,7.6069,1.727,7.531,1.7271)" + }, + { + "content": "0", + "span": { + "offset": 721, + "length": 1 + }, + "confidence": 0.523, + "source": "D(1,7.6951,1.5795,7.7735,1.58,7.7735,1.7268,7.6951,1.7269)" + }, + { + "content": "0", + "span": { + "offset": 723, + "length": 1 + }, + "confidence": 0.584, + "source": "D(1,7.8666,1.5805,7.9646,1.581,7.9646,1.7266,7.8666,1.7267)" + }, + { + "content": "If", + "span": { + "offset": 726, + "length": 2 + }, + "confidence": 0.84, + "source": "D(1,0.5421,1.7807,0.6081,1.7803,0.6091,1.8928,0.5432,1.8929)" + }, + { + "content": "joint", + "span": { + "offset": 729, + "length": 5 + }, + "confidence": 0.709, + "source": "D(1,0.6232,1.7802,0.8136,1.7791,0.8146,1.8922,0.6242,1.8927)" + }, + { + "content": "return", + "span": { + "offset": 735, + "length": 6 + }, + "confidence": 0.978, + "source": "D(1,0.8419,1.7789,1.0908,1.7774,1.0916,1.8915,0.8428,1.8922)" + }, + { + "content": ",", + "span": { + "offset": 741, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.1002,1.7774,1.1191,1.7772,1.1199,1.8914,1.101,1.8915)" + }, + { + "content": "spouse's", + "span": { + "offset": 743, + "length": 8 + }, + "confidence": 0.959, + "source": "D(1,1.1511,1.7771,1.5395,1.7753,1.5401,1.8901,1.1519,1.8914)" + }, + { + "content": "first", + "span": { + "offset": 752, + "length": 5 + }, + "confidence": 0.933, + "source": "D(1,1.5678,1.7752,1.7338,1.7745,1.7342,1.8894,1.5684,1.89)" + }, + { + "content": "name", + "span": { + "offset": 758, + "length": 4 + }, + "confidence": 0.921, + "source": "D(1,1.762,1.7744,1.9996,1.7735,2,1.8885,1.7625,1.8893)" + }, + { + "content": "and", + "span": { + "offset": 763, + "length": 3 + }, + "confidence": 0.936, + "source": "D(1,2.026,1.7734,2.1882,1.7731,2.1884,1.8876,2.0264,1.8884)" + }, + { + "content": "middle", + "span": { + "offset": 767, + "length": 6 + }, + "confidence": 0.926, + "source": "D(1,2.2221,1.7731,2.5143,1.7726,2.5145,1.8861,2.2223,1.8875)" + }, + { + "content": "initial", + "span": { + "offset": 774, + "length": 7 + }, + "confidence": 0.809, + "source": "D(1,2.5426,1.7726,2.7745,1.7722,2.7745,1.885,2.5427,1.886)" + }, + { + "content": "Lauren", + "span": { + "offset": 782, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,0.5209,1.9321,0.9022,1.9333,0.9022,2.0407,0.5214,2.0395)" + }, + { + "content": "Last", + "span": { + "offset": 790, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,3.3431,1.7806,3.5409,1.7814,3.5409,1.8778,3.3431,1.877)" + }, + { + "content": "name", + "span": { + "offset": 795, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,3.5636,1.7815,3.8101,1.7838,3.8101,1.8806,3.5636,1.8779)" + }, + { + "content": "Watson", + "span": { + "offset": 800, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,3.3265,1.9325,3.7457,1.9333,3.7457,2.0408,3.3265,2.0399)" + }, + { + "content": "Spouse's", + "span": { + "offset": 808, + "length": 8 + }, + "confidence": 0.983, + "source": "D(1,6.5327,1.7743,6.9574,1.7749,6.9574,1.8888,6.5327,1.8895)" + }, + { + "content": "social", + "span": { + "offset": 817, + "length": 6 + }, + "confidence": 0.994, + "source": "D(1,6.9819,1.7749,7.2469,1.7752,7.2469,1.8886,6.9819,1.8888)" + }, + { + "content": "security", + "span": { + "offset": 824, + "length": 8 + }, + "confidence": 0.982, + "source": "D(1,7.275,1.7753,7.6359,1.7757,7.6359,1.8885,7.275,1.8886)" + }, + { + "content": "number", + "span": { + "offset": 833, + "length": 6 + }, + "confidence": 0.987, + "source": "D(1,7.6547,1.7757,8.0061,1.776,8.0061,1.8887,7.6547,1.8885)" + }, + { + "content": "0", + "span": { + "offset": 840, + "length": 1 + }, + "confidence": 0.93, + "source": "D(1,6.5452,1.9091,6.624,1.9091,6.624,2.0584,6.5452,2.0584)" + }, + { + "content": "5", + "span": { + "offset": 842, + "length": 1 + }, + "confidence": 0.922, + "source": "D(1,6.7053,1.9091,6.7793,1.9091,6.7793,2.0584,6.7053,2.0584)" + }, + { + "content": "6", + "span": { + "offset": 844, + "length": 1 + }, + "confidence": 0.923, + "source": "D(1,6.8631,1.9091,6.937,1.9092,6.937,2.0584,6.8631,2.0584)" + }, + { + "content": "0", + "span": { + "offset": 846, + "length": 1 + }, + "confidence": 0.915, + "source": "D(1,7.0306,1.9092,7.112,1.9094,7.112,2.0583,7.0306,2.0584)" + }, + { + "content": "4", + "span": { + "offset": 848, + "length": 1 + }, + "confidence": 0.895, + "source": "D(1,7.1982,1.9096,7.2746,1.9098,7.2746,2.0582,7.1982,2.0582)" + }, + { + "content": "1", + "span": { + "offset": 850, + "length": 1 + }, + "confidence": 0.928, + "source": "D(1,7.3633,1.91,7.4225,1.9101,7.4225,2.0581,7.3633,2.0581)" + }, + { + "content": "0", + "span": { + "offset": 852, + "length": 1 + }, + "confidence": 0.896, + "source": "D(1,7.526,1.9104,7.6073,1.9108,7.6073,2.0579,7.526,2.058)" + }, + { + "content": "8", + "span": { + "offset": 854, + "length": 1 + }, + "confidence": 0.878, + "source": "D(1,7.6935,1.9112,7.7699,1.9116,7.7699,2.0577,7.6935,2.0578)" + }, + { + "content": "5", + "span": { + "offset": 856, + "length": 1 + }, + "confidence": 0.914, + "source": "D(1,7.8611,1.912,7.9646,1.9125,7.9646,2.0574,7.8611,2.0575)" + }, + { + "content": "Home", + "span": { + "offset": 859, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,0.5453,2.1106,0.8088,2.1096,0.8097,2.2225,0.5463,2.2227)" + }, + { + "content": "address", + "span": { + "offset": 864, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,0.8353,2.1095,1.186,2.1082,1.1869,2.2222,0.8363,2.2225)" + }, + { + "content": "(", + "span": { + "offset": 872, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.2126,2.1081,1.241,2.108,1.2418,2.2222,1.2134,2.2222)" + }, + { + "content": "number", + "span": { + "offset": 873, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,1.2391,2.108,1.5785,2.1067,1.5792,2.2219,1.2399,2.2222)" + }, + { + "content": "and", + "span": { + "offset": 880, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,1.5974,2.1066,1.7605,2.1064,1.7611,2.2218,1.5981,2.2219)" + }, + { + "content": "street", + "span": { + "offset": 884, + "length": 6 + }, + "confidence": 0.991, + "source": "D(1,1.7908,2.1064,2.0392,2.1063,2.0397,2.2217,1.7915,2.2218)" + }, + { + "content": ")", + "span": { + "offset": 890, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,2.0316,2.1063,2.06,2.1063,2.0606,2.2217,2.0321,2.2217)" + }, + { + "content": ".", + "span": { + "offset": 891, + "length": 1 + }, + "confidence": 0.976, + "source": "D(1,2.0657,2.1063,2.0847,2.1063,2.0852,2.2216,2.0663,2.2217)" + }, + { + "content": "If", + "span": { + "offset": 893, + "length": 2 + }, + "confidence": 0.92, + "source": "D(1,2.1188,2.1062,2.1757,2.1062,2.1762,2.2216,2.1193,2.2216)" + }, + { + "content": "you", + "span": { + "offset": 896, + "length": 3 + }, + "confidence": 0.989, + "source": "D(1,2.1908,2.1062,2.352,2.1061,2.3524,2.2215,2.1913,2.2216)" + }, + { + "content": "have", + "span": { + "offset": 900, + "length": 4 + }, + "confidence": 0.982, + "source": "D(1,2.3861,2.1061,2.5908,2.1061,2.5912,2.2214,2.3866,2.2215)" + }, + { + "content": "a", + "span": { + "offset": 905, + "length": 1 + }, + "confidence": 0.974, + "source": "D(1,2.6155,2.106,2.6667,2.106,2.667,2.2213,2.6159,2.2214)" + }, + { + "content": "P", + "span": { + "offset": 907, + "length": 1 + }, + "confidence": 0.92, + "source": "D(1,2.697,2.106,2.7558,2.106,2.7561,2.2213,2.6974,2.2213)" + }, + { + "content": ".", + "span": { + "offset": 908, + "length": 1 + }, + "confidence": 0.959, + "source": "D(1,2.7596,2.106,2.7785,2.1061,2.7789,2.2213,2.7599,2.2213)" + }, + { + "content": "O", + "span": { + "offset": 909, + "length": 1 + }, + "confidence": 0.897, + "source": "D(1,2.7861,2.1061,2.8582,2.1063,2.8585,2.2212,2.7864,2.2213)" + }, + { + "content": ".", + "span": { + "offset": 910, + "length": 1 + }, + "confidence": 0.938, + "source": "D(1,2.8582,2.1063,2.879,2.1064,2.8793,2.2212,2.8585,2.2212)" + }, + { + "content": "box", + "span": { + "offset": 912, + "length": 3 + }, + "confidence": 0.716, + "source": "D(1,2.915,2.1065,3.0781,2.107,3.0783,2.2212,2.9153,2.2212)" + }, + { + "content": ",", + "span": { + "offset": 915, + "length": 1 + }, + "confidence": 0.995, + "source": "D(1,3.08,2.107,3.1008,2.107,3.1011,2.2212,3.0802,2.2212)" + }, + { + "content": "see", + "span": { + "offset": 917, + "length": 3 + }, + "confidence": 0.987, + "source": "D(1,3.133,2.1071,3.2847,2.1076,3.2849,2.2211,3.1333,2.2212)" + }, + { + "content": "instructions", + "span": { + "offset": 921, + "length": 12 + }, + "confidence": 0.965, + "source": "D(1,3.315,2.1077,3.8155,2.1092,3.8156,2.2209,3.3152,2.2211)" + }, + { + "content": ".", + "span": { + "offset": 933, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,3.8193,2.1092,3.8516,2.1093,3.8516,2.2209,3.8193,2.2209)" + }, + { + "content": "10221", + "span": { + "offset": 935, + "length": 5 + }, + "confidence": 0.968, + "source": "D(1,0.5274,2.2534,0.8176,2.2529,0.8189,2.3719,0.5289,2.3715)" + }, + { + "content": "COMPTON", + "span": { + "offset": 941, + "length": 7 + }, + "confidence": 0.977, + "source": "D(1,0.8616,2.2528,1.4239,2.2518,1.425,2.3727,0.863,2.372)" + }, + { + "content": "LOS", + "span": { + "offset": 949, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,1.464,2.2518,1.6841,2.2517,1.685,2.3728,1.465,2.3727)" + }, + { + "content": "ANGELES", + "span": { + "offset": 953, + "length": 7 + }, + "confidence": 0.975, + "source": "D(1,1.7121,2.2517,2.2505,2.2516,2.2511,2.373,1.713,2.3728)" + }, + { + "content": "CA", + "span": { + "offset": 961, + "length": 2 + }, + "confidence": 0.967, + "source": "D(1,2.2865,2.2516,2.4446,2.2516,2.4451,2.373,2.2871,2.373)" + }, + { + "content": "90002-2805", + "span": { + "offset": 964, + "length": 10 + }, + "confidence": 0.857, + "source": "D(1,2.4786,2.2516,3.073,2.2524,3.0732,2.3725,2.4791,2.373)" + }, + { + "content": "USA", + "span": { + "offset": 975, + "length": 3 + }, + "confidence": 0.95, + "source": "D(1,3.1091,2.2525,3.3452,2.2528,3.3452,2.3723,3.1092,2.3725)" + }, + { + "content": "Apt", + "span": { + "offset": 980, + "length": 3 + }, + "confidence": 0.854, + "source": "D(1,5.8396,2.1144,6.0045,2.1154,6.0045,2.2173,5.8396,2.2149)" + }, + { + "content": ".", + "span": { + "offset": 983, + "length": 1 + }, + "confidence": 0.914, + "source": "D(1,6.001,2.1154,6.0219,2.1155,6.0219,2.2175,6.0011,2.2173)" + }, + { + "content": "no", + "span": { + "offset": 985, + "length": 2 + }, + "confidence": 0.889, + "source": "D(1,6.0549,2.1157,6.166,2.1163,6.166,2.2183,6.0549,2.2178)" + }, + { + "content": ".", + "span": { + "offset": 987, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,6.166,2.1163,6.2007,2.1165,6.2007,2.2184,6.166,2.2183)" + }, + { + "content": "10221", + "span": { + "offset": 989, + "length": 5 + }, + "confidence": 0.997, + "source": "D(1,5.989,2.2623,6.2961,2.2641,6.2961,2.3746,5.989,2.371)" + }, + { + "content": "City", + "span": { + "offset": 996, + "length": 4 + }, + "confidence": 0.993, + "source": "D(1,0.5453,2.4493,0.7243,2.4491,0.7253,2.5621,0.5463,2.5619)" + }, + { + "content": ",", + "span": { + "offset": 1000, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.7243,2.4491,0.745,2.4491,0.746,2.5621,0.7253,2.5621)" + }, + { + "content": "town", + "span": { + "offset": 1002, + "length": 4 + }, + "confidence": 0.994, + "source": "D(1,0.7733,2.4491,0.9844,2.4489,0.9853,2.5623,0.7743,2.5621)" + }, + { + "content": ",", + "span": { + "offset": 1006, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.99,2.4489,1.0108,2.4488,1.0117,2.5624,0.9909,2.5623)" + }, + { + "content": "or", + "span": { + "offset": 1008, + "length": 2 + }, + "confidence": 0.95, + "source": "D(1,1.0428,2.4488,1.1351,2.4487,1.136,2.5625,1.0437,2.5624)" + }, + { + "content": "post", + "span": { + "offset": 1011, + "length": 4 + }, + "confidence": 0.936, + "source": "D(1,1.1596,2.4487,1.35,2.4485,1.3508,2.5627,1.1605,2.5625)" + }, + { + "content": "office", + "span": { + "offset": 1016, + "length": 6 + }, + "confidence": 0.523, + "source": "D(1,1.3783,2.4485,1.6157,2.4483,1.6164,2.563,1.3791,2.5627)" + }, + { + "content": ".", + "span": { + "offset": 1022, + "length": 1 + }, + "confidence": 0.927, + "source": "D(1,1.6195,2.4483,1.6383,2.4482,1.6391,2.563,1.6202,2.563)" + }, + { + "content": "If", + "span": { + "offset": 1024, + "length": 2 + }, + "confidence": 0.772, + "source": "D(1,1.6741,2.4482,1.7326,2.4481,1.7333,2.5631,1.6749,2.563)" + }, + { + "content": "you", + "span": { + "offset": 1027, + "length": 3 + }, + "confidence": 0.899, + "source": "D(1,1.7457,2.4481,1.9059,2.4481,1.9066,2.5631,1.7464,2.5631)" + }, + { + "content": "have", + "span": { + "offset": 1031, + "length": 4 + }, + "confidence": 0.952, + "source": "D(1,1.9399,2.4481,2.1453,2.4481,2.1459,2.563,1.9405,2.5631)" + }, + { + "content": "a", + "span": { + "offset": 1036, + "length": 1 + }, + "confidence": 0.977, + "source": "D(1,2.1698,2.4482,2.2226,2.4482,2.2231,2.563,2.1704,2.563)" + }, + { + "content": "foreign", + "span": { + "offset": 1038, + "length": 7 + }, + "confidence": 0.947, + "source": "D(1,2.2489,2.4482,2.5467,2.4482,2.5472,2.5629,2.2495,2.563)" + }, + { + "content": "address", + "span": { + "offset": 1046, + "length": 7 + }, + "confidence": 0.99, + "source": "D(1,2.5769,2.4482,2.9255,2.4482,2.9259,2.5628,2.5773,2.5629)" + }, + { + "content": ",", + "span": { + "offset": 1053, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,2.9274,2.4482,2.95,2.4483,2.9504,2.5628,2.9278,2.5628)" + }, + { + "content": "also", + "span": { + "offset": 1055, + "length": 4 + }, + "confidence": 0.978, + "source": "D(1,2.9783,2.4483,3.1592,2.4484,3.1595,2.5625,2.9786,2.5628)" + }, + { + "content": "complete", + "span": { + "offset": 1060, + "length": 8 + }, + "confidence": 0.982, + "source": "D(1,3.1856,2.4485,3.5945,2.449,3.5947,2.5619,3.1859,2.5625)" + }, + { + "content": "spaces", + "span": { + "offset": 1069, + "length": 6 + }, + "confidence": 0.984, + "source": "D(1,3.619,2.449,3.9319,2.4494,3.932,2.5613,3.6192,2.5618)" + }, + { + "content": "below", + "span": { + "offset": 1076, + "length": 5 + }, + "confidence": 0.986, + "source": "D(1,3.9602,2.4494,4.2202,2.4497,4.2202,2.5609,3.9602,2.5613)" + }, + { + "content": ".", + "span": { + "offset": 1081, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,4.2202,2.4497,4.2542,2.4498,4.2542,2.5608,4.2202,2.5609)" + }, + { + "content": "615", + "span": { + "offset": 1083, + "length": 3 + }, + "confidence": 0.858, + "source": "D(1,0.5193,2.5948,0.708,2.5943,0.7092,2.7125,0.5206,2.7122)" + }, + { + "content": "E", + "span": { + "offset": 1087, + "length": 1 + }, + "confidence": 0.965, + "source": "D(1,0.7418,2.5943,0.8073,2.5941,0.8085,2.7126,0.7429,2.7125)" + }, + { + "content": "80TH", + "span": { + "offset": 1089, + "length": 4 + }, + "confidence": 0.797, + "source": "D(1,0.8391,2.594,1.1092,2.5934,1.1102,2.7129,0.8402,2.7126)" + }, + { + "content": "LOS", + "span": { + "offset": 1094, + "length": 3 + }, + "confidence": 0.987, + "source": "D(1,1.1529,2.5933,1.3714,2.5927,1.3722,2.7132,1.1539,2.713)" + }, + { + "content": "ANGELES", + "span": { + "offset": 1098, + "length": 7 + }, + "confidence": 0.976, + "source": "D(1,1.3992,2.5927,1.9374,2.5922,1.938,2.7133,1.4,2.7132)" + }, + { + "content": "CA", + "span": { + "offset": 1106, + "length": 2 + }, + "confidence": 0.976, + "source": "D(1,1.9732,2.5922,2.1321,2.592,2.1325,2.7133,1.9737,2.7133)" + }, + { + "content": "90001-3255", + "span": { + "offset": 1109, + "length": 10 + }, + "confidence": 0.681, + "source": "D(1,2.1618,2.592,2.7597,2.5922,2.7598,2.7128,2.1623,2.7133)" + }, + { + "content": "USA", + "span": { + "offset": 1120, + "length": 3 + }, + "confidence": 0.943, + "source": "D(1,2.7934,2.5922,3.0298,2.5923,3.0298,2.7126,2.7936,2.7128)" + }, + { + "content": "State", + "span": { + "offset": 1125, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,4.7397,2.4532,4.968,2.4532,4.968,2.5446,4.7397,2.5446)" + }, + { + "content": "LA", + "span": { + "offset": 1131, + "length": 2 + }, + "confidence": 0.985, + "source": "D(1,5.0593,2.6007,5.2253,2.5995,5.2253,2.7064,5.0593,2.7051)" + }, + { + "content": "ZIP", + "span": { + "offset": 1135, + "length": 3 + }, + "confidence": 0.986, + "source": "D(1,5.6362,2.4473,5.7796,2.4494,5.7797,2.5465,5.6362,2.5437)" + }, + { + "content": "code", + "span": { + "offset": 1139, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,5.803,2.4497,6.0098,2.451,6.0098,2.5489,5.803,2.5468)" + }, + { + "content": "61500", + "span": { + "offset": 1144, + "length": 5 + }, + "confidence": 0.979, + "source": "D(1,5.8894,2.6016,6.2007,2.6017,6.2007,2.7077,5.8894,2.7063)" + }, + { + "content": "Foreign", + "span": { + "offset": 1151, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,0.5442,2.7804,0.8722,2.7798,0.8729,2.8926,0.5453,2.892)" + }, + { + "content": "country", + "span": { + "offset": 1159, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,0.9034,2.7799,1.2369,2.7809,1.2372,2.8921,0.904,2.8925)" + }, + { + "content": "name", + "span": { + "offset": 1167, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,1.2607,2.7811,1.5118,2.7827,1.5118,2.8911,1.261,2.892)" + }, + { + "content": "N", + "span": { + "offset": 1172, + "length": 1 + }, + "confidence": 0.944, + "source": "D(1,0.5178,2.93,0.5945,2.9327,0.5948,3.0401,0.5183,3.0374)" + }, + { + "content": "/", + "span": { + "offset": 1173, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.5907,2.9327,0.6432,2.9327,0.6434,3.0401,0.5911,3.0401)" + }, + { + "content": "A", + "span": { + "offset": 1174, + "length": 1 + }, + "confidence": 0.927, + "source": "D(1,0.63,2.9327,0.7274,2.9299,0.7274,3.0374,0.6303,3.0401)" + }, + { + "content": "Foreign", + "span": { + "offset": 1177, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,3.6378,2.7771,3.9752,2.7767,3.9752,2.8948,3.6378,2.8953)" + }, + { + "content": "province", + "span": { + "offset": 1185, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,4.0048,2.7766,4.3758,2.7765,4.3758,2.8947,4.0048,2.8948)" + }, + { + "content": "/", + "span": { + "offset": 1193, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.3739,2.7765,4.4153,2.7765,4.4153,2.8947,4.3739,2.8947)" + }, + { + "content": "state", + "span": { + "offset": 1194, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,4.4094,2.7765,4.6264,2.7766,4.6264,2.8948,4.4094,2.8947)" + }, + { + "content": "/", + "span": { + "offset": 1199, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.6205,2.7766,4.6639,2.7766,4.6639,2.8948,4.6205,2.8948)" + }, + { + "content": "county", + "span": { + "offset": 1200, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,4.658,2.7766,4.9639,2.777,4.9639,2.8951,4.658,2.8948)" + }, + { + "content": "N", + "span": { + "offset": 1207, + "length": 1 + }, + "confidence": 0.956, + "source": "D(1,3.6357,2.9318,3.7076,2.9332,3.7076,3.04,3.6357,3.0389)" + }, + { + "content": "/", + "span": { + "offset": 1208, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.7058,2.9332,3.7562,2.9333,3.7562,3.0402,3.7058,3.04)" + }, + { + "content": "A", + "span": { + "offset": 1209, + "length": 1 + }, + "confidence": 0.929, + "source": "D(1,3.7454,2.9333,3.837,2.9319,3.837,3.0398,3.7454,3.0402)" + }, + { + "content": "Foreign", + "span": { + "offset": 1212, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,5.6445,2.7812,5.9478,2.7823,5.9478,2.8901,5.6445,2.8886)" + }, + { + "content": "postal", + "span": { + "offset": 1220, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,5.975,2.7823,6.222,2.7817,6.222,2.8893,5.975,2.89)" + }, + { + "content": "code", + "span": { + "offset": 1227, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,6.2456,2.7816,6.458,2.78,6.458,2.8872,6.2456,2.8891)" + }, + { + "content": "N", + "span": { + "offset": 1232, + "length": 1 + }, + "confidence": 0.968, + "source": "D(1,5.9434,2.9342,6.0214,2.9353,6.0214,3.0373,5.9434,3.0362)" + }, + { + "content": "/", + "span": { + "offset": 1233, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.016,2.9353,6.0705,2.9355,6.0705,3.0376,6.016,3.0373)" + }, + { + "content": "A", + "span": { + "offset": 1234, + "length": 1 + }, + "confidence": 0.929, + "source": "D(1,6.0559,2.9354,6.1467,2.9351,6.1467,3.0371,6.0559,3.0375)" + }, + { + "content": "Presidential", + "span": { + "offset": 1237, + "length": 12 + }, + "confidence": 0.998, + "source": "D(1,6.5452,2.1135,7.093,2.1175,7.093,2.2353,6.5452,2.23)" + }, + { + "content": "Election", + "span": { + "offset": 1250, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,7.1268,2.1178,7.494,2.1205,7.494,2.2391,7.1268,2.2357)" + }, + { + "content": "Campaign", + "span": { + "offset": 1259, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,7.5238,2.1208,8.0061,2.1244,8.0061,2.2438,7.5238,2.2394)" + }, + { + "content": "Check", + "span": { + "offset": 1268, + "length": 5 + }, + "confidence": 0.996, + "source": "D(1,6.5452,2.2589,6.854,2.2579,6.854,2.3754,6.5452,2.3745)" + }, + { + "content": "here", + "span": { + "offset": 1274, + "length": 4 + }, + "confidence": 0.992, + "source": "D(1,6.8792,2.2578,7.0812,2.258,7.0812,2.376,6.8792,2.3755)" + }, + { + "content": "if", + "span": { + "offset": 1279, + "length": 2 + }, + "confidence": 0.994, + "source": "D(1,7.1123,2.2581,7.1706,2.2583,7.1705,2.3763,7.1123,2.3761)" + }, + { + "content": "you", + "span": { + "offset": 1282, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,7.19,2.2584,7.3589,2.259,7.3589,2.3768,7.19,2.3763)" + }, + { + "content": ",", + "span": { + "offset": 1285, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,7.3667,2.2591,7.39,2.2593,7.39,2.3768,7.3667,2.3768)" + }, + { + "content": "or", + "span": { + "offset": 1287, + "length": 2 + }, + "confidence": 0.973, + "source": "D(1,7.4211,2.2596,7.5221,2.2606,7.5221,2.3771,7.4211,2.3769)" + }, + { + "content": "your", + "span": { + "offset": 1290, + "length": 4 + }, + "confidence": 0.977, + "source": "D(1,7.5396,2.2608,7.7571,2.263,7.7571,2.3776,7.5396,2.3772)" + }, + { + "content": "spouse", + "span": { + "offset": 1295, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,6.5452,2.3951,6.89,2.393,6.89,2.5113,6.5452,2.5104)" + }, + { + "content": "if", + "span": { + "offset": 1302, + "length": 2 + }, + "confidence": 0.994, + "source": "D(1,6.9212,2.3929,6.9777,2.3925,6.9777,2.5116,6.9212,2.5114)" + }, + { + "content": "filing", + "span": { + "offset": 1305, + "length": 6 + }, + "confidence": 0.988, + "source": "D(1,6.9991,2.3924,7.2154,2.3908,7.2154,2.5105,6.9991,2.5116)" + }, + { + "content": "jointly", + "span": { + "offset": 1312, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,7.2407,2.3907,7.5252,2.3885,7.5252,2.5082,7.2407,2.5103)" + }, + { + "content": ",", + "span": { + "offset": 1319, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.5233,2.3885,7.5447,2.3884,7.5447,2.508,7.5232,2.5083)" + }, + { + "content": "want", + "span": { + "offset": 1321, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,7.5759,2.3881,7.8058,2.3861,7.8058,2.5041,7.5758,2.5075)" + }, + { + "content": "$", + "span": { + "offset": 1326, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.8291,2.3859,7.8837,2.3854,7.8837,2.503,7.8291,2.5038)" + }, + { + "content": "3", + "span": { + "offset": 1327, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.8895,2.3854,7.948,2.3849,7.948,2.502,7.8895,2.5029)" + }, + { + "content": "to", + "span": { + "offset": 1329, + "length": 2 + }, + "confidence": 0.992, + "source": "D(1,6.5327,2.5122,6.6414,2.5118,6.6414,2.6267,6.5327,2.6269)" + }, + { + "content": "go", + "span": { + "offset": 1332, + "length": 2 + }, + "confidence": 0.982, + "source": "D(1,6.668,2.5117,6.7881,2.5113,6.7881,2.6265,6.668,2.6267)" + }, + { + "content": "to", + "span": { + "offset": 1335, + "length": 2 + }, + "confidence": 0.955, + "source": "D(1,6.8148,2.5112,6.9101,2.5109,6.9101,2.6263,6.8148,2.6265)" + }, + { + "content": "this", + "span": { + "offset": 1338, + "length": 4 + }, + "confidence": 0.983, + "source": "D(1,6.9368,2.5108,7.1045,2.5107,7.1045,2.6264,6.9368,2.6263)" + }, + { + "content": "fund", + "span": { + "offset": 1343, + "length": 4 + }, + "confidence": 0.984, + "source": "D(1,7.1312,2.5107,7.3409,2.5109,7.3409,2.6268,7.1312,2.6264)" + }, + { + "content": ".", + "span": { + "offset": 1347, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,7.3485,2.5109,7.3695,2.5109,7.3695,2.6268,7.3485,2.6268)" + }, + { + "content": "Checking", + "span": { + "offset": 1349, + "length": 8 + }, + "confidence": 0.94, + "source": "D(1,7.4019,2.5109,7.8422,2.5131,7.8422,2.629,7.4019,2.6269)" + }, + { + "content": "a", + "span": { + "offset": 1358, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,7.8726,2.5133,7.9355,2.5136,7.9355,2.6295,7.8726,2.6292)" + }, + { + "content": "box", + "span": { + "offset": 1360, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,6.5452,2.6413,6.725,2.6413,6.725,2.7537,6.5452,2.7528)" + }, + { + "content": "below", + "span": { + "offset": 1364, + "length": 5 + }, + "confidence": 0.997, + "source": "D(1,6.7556,2.6412,7.033,2.6411,7.033,2.755,6.7556,2.7539)" + }, + { + "content": "will", + "span": { + "offset": 1370, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,7.0579,2.6411,7.2109,2.6411,7.2109,2.7553,7.0579,2.755)" + }, + { + "content": "not", + "span": { + "offset": 1375, + "length": 3 + }, + "confidence": 0.994, + "source": "D(1,7.2434,2.6411,7.3927,2.6411,7.3927,2.7556,7.2434,2.7554)" + }, + { + "content": "change", + "span": { + "offset": 1379, + "length": 6 + }, + "confidence": 0.994, + "source": "D(1,7.4156,2.6411,7.7695,2.6411,7.7695,2.7551,7.4156,2.7555)" + }, + { + "content": "your", + "span": { + "offset": 1386, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,6.5286,2.7717,6.7592,2.771,6.7592,2.878,6.5286,2.8797)" + }, + { + "content": "tax", + "span": { + "offset": 1391, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,6.7805,2.7709,6.9259,2.7708,6.9259,2.877,6.7805,2.8778)" + }, + { + "content": "or", + "span": { + "offset": 1395, + "length": 2 + }, + "confidence": 0.995, + "source": "D(1,6.9525,2.7708,7.0554,2.7709,7.0554,2.8765,6.9525,2.8769)" + }, + { + "content": "refund", + "span": { + "offset": 1398, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,7.082,2.7709,7.3747,2.7718,7.3747,2.8759,7.082,2.8763)" + }, + { + "content": ".", + "span": { + "offset": 1404, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.3801,2.7718,7.4084,2.7719,7.4084,2.8758,7.3801,2.8758)" + }, + { + "content": "☐", + "span": { + "offset": 1407, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,6.9851,2.9165,7.1096,2.9165,7.1096,3.0454,6.9851,3.0427)" + }, + { + "content": "You", + "span": { + "offset": 1409, + "length": 3 + }, + "confidence": 0.982, + "source": "D(1,7.147,2.9272,7.3337,2.9272,7.3337,3.0186,7.147,3.0186)" + }, + { + "content": "☐", + "span": { + "offset": 1413, + "length": 1 + }, + "confidence": 0.988, + "source": "D(1,7.4956,2.9165,7.6367,2.9192,7.6367,3.0427,7.4956,3.0454)" + }, + { + "content": "Spouse", + "span": { + "offset": 1415, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,7.6492,2.9345,7.9937,2.9354,7.9937,3.0317,7.6492,3.0314)" + }, + { + "content": "At", + "span": { + "offset": 1423, + "length": 2 + }, + "confidence": 0.946, + "source": "D(1,0.4936,3.1441,0.6055,3.1443,0.6065,3.2685,0.4947,3.2682)" + }, + { + "content": "any", + "span": { + "offset": 1426, + "length": 3 + }, + "confidence": 0.942, + "source": "D(1,0.633,3.1443,0.8124,3.1445,0.8134,3.2693,0.634,3.2686)" + }, + { + "content": "time", + "span": { + "offset": 1430, + "length": 4 + }, + "confidence": 0.986, + "source": "D(1,0.8377,3.1445,1.053,3.1448,1.054,3.2701,0.8387,3.2693)" + }, + { + "content": "during", + "span": { + "offset": 1435, + "length": 6 + }, + "confidence": 0.945, + "source": "D(1,1.0826,3.1448,1.3971,3.1452,1.398,3.2713,1.0835,3.2702)" + }, + { + "content": "2020", + "span": { + "offset": 1442, + "length": 4 + }, + "confidence": 0.701, + "source": "D(1,1.4267,3.1452,1.6779,3.1455,1.6787,3.2723,1.4276,3.2714)" + }, + { + "content": ",", + "span": { + "offset": 1446, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,1.6779,3.1455,1.7032,3.1456,1.7041,3.2723,1.6787,3.2723)" + }, + { + "content": "did", + "span": { + "offset": 1448, + "length": 3 + }, + "confidence": 0.94, + "source": "D(1,1.737,3.1456,1.8932,3.1458,1.894,3.273,1.7378,3.2725)" + }, + { + "content": "you", + "span": { + "offset": 1452, + "length": 3 + }, + "confidence": 0.987, + "source": "D(1,1.9228,3.1458,2.1022,3.146,2.103,3.2737,1.9236,3.2731)" + }, + { + "content": "receive", + "span": { + "offset": 1456, + "length": 7 + }, + "confidence": 0.98, + "source": "D(1,2.1402,3.1461,2.4948,3.1465,2.4955,3.2751,2.141,3.2739)" + }, + { + "content": ",", + "span": { + "offset": 1463, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.4927,3.1465,2.5181,3.1465,2.5188,3.2752,2.4934,3.2751)" + }, + { + "content": "sell", + "span": { + "offset": 1465, + "length": 4 + }, + "confidence": 0.988, + "source": "D(1,2.5539,3.1466,2.7144,3.1467,2.7151,3.2756,2.5546,3.2753)" + }, + { + "content": ",", + "span": { + "offset": 1469, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.7186,3.1467,2.7418,3.1467,2.7425,3.2756,2.7193,3.2756)" + }, + { + "content": "send", + "span": { + "offset": 1471, + "length": 4 + }, + "confidence": 0.993, + "source": "D(1,2.7798,3.1467,3.0141,3.1469,3.0148,3.2758,2.7805,3.2756)" + }, + { + "content": ",", + "span": { + "offset": 1475, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.0247,3.1469,3.05,3.1469,3.0506,3.2759,3.0253,3.2758)" + }, + { + "content": "exchange", + "span": { + "offset": 1477, + "length": 8 + }, + "confidence": 0.98, + "source": "D(1,3.0838,3.1469,3.5672,3.1472,3.5677,3.2762,3.0844,3.2759)" + }, + { + "content": ",", + "span": { + "offset": 1485, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.5693,3.1472,3.5946,3.1472,3.5952,3.2763,3.5699,3.2762)" + }, + { + "content": "or", + "span": { + "offset": 1487, + "length": 2 + }, + "confidence": 0.991, + "source": "D(1,3.6326,3.1473,3.7361,3.1473,3.7366,3.2764,3.6332,3.2763)" + }, + { + "content": "otherwise", + "span": { + "offset": 1490, + "length": 9 + }, + "confidence": 0.96, + "source": "D(1,3.7635,3.1473,4.2427,3.1476,4.2431,3.2768,3.764,3.2764)" + }, + { + "content": "acquire", + "span": { + "offset": 1500, + "length": 7 + }, + "confidence": 0.963, + "source": "D(1,4.2765,3.1477,4.6417,3.1479,4.6421,3.2771,4.2769,3.2768)" + }, + { + "content": "any", + "span": { + "offset": 1508, + "length": 3 + }, + "confidence": 0.981, + "source": "D(1,4.6712,3.1479,4.8507,3.1479,4.851,3.2769,4.6716,3.2771)" + }, + { + "content": "financial", + "span": { + "offset": 1512, + "length": 9 + }, + "confidence": 0.94, + "source": "D(1,4.8802,3.1479,5.2855,3.148,5.2858,3.2761,4.8806,3.2769)" + }, + { + "content": "interest", + "span": { + "offset": 1522, + "length": 8 + }, + "confidence": 0.936, + "source": "D(1,5.3277,3.148,5.6929,3.148,5.6931,3.2753,5.328,3.276)" + }, + { + "content": "in", + "span": { + "offset": 1531, + "length": 2 + }, + "confidence": 0.972, + "source": "D(1,5.7267,3.148,5.809,3.148,5.8092,3.2751,5.7269,3.2752)" + }, + { + "content": "any", + "span": { + "offset": 1534, + "length": 3 + }, + "confidence": 0.944, + "source": "D(1,5.8386,3.148,6.0223,3.148,6.0224,3.2746,5.8388,3.275)" + }, + { + "content": "virtual", + "span": { + "offset": 1538, + "length": 7 + }, + "confidence": 0.551, + "source": "D(1,6.0476,3.148,6.3389,3.148,6.339,3.274,6.0477,3.2746)" + }, + { + "content": "currency", + "span": { + "offset": 1546, + "length": 8 + }, + "confidence": 0.458, + "source": "D(1,6.3769,3.148,6.8118,3.148,6.8118,3.2731,6.377,3.274)" + }, + { + "content": "?", + "span": { + "offset": 1554, + "length": 1 + }, + "confidence": 0.981, + "source": "D(1,6.816,3.148,6.8772,3.148,6.8772,3.273,6.816,3.2731)" + }, + { + "content": "☐", + "span": { + "offset": 1557, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,6.9976,3.1394,7.1096,3.1421,7.1096,3.2656,6.9976,3.2629)" + }, + { + "content": "Yes", + "span": { + "offset": 1559, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,7.1345,3.15,7.3379,3.1499,7.3379,3.252,7.1345,3.2521)" + }, + { + "content": "☑", + "span": { + "offset": 1563, + "length": 1 + }, + "confidence": 0.964, + "source": "D(1,7.4956,3.1501,7.616,3.1448,7.616,3.2683,7.4956,3.2737)" + }, + { + "content": "No", + "span": { + "offset": 1565, + "length": 2 + }, + "confidence": 0.992, + "source": "D(1,7.6409,3.1525,7.7986,3.1522,7.7986,3.2487,7.6409,3.2555)" + }, + { + "content": "Standard", + "span": { + "offset": 1569, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,0.4921,3.373,1.1123,3.373,1.1123,3.502,0.4926,3.502)" + }, + { + "content": "Deduction", + "span": { + "offset": 1578, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,0.4936,3.5154,1.1849,3.5154,1.1849,3.6389,0.4944,3.6389)" + }, + { + "content": "Someone", + "span": { + "offset": 1589, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,1.2887,3.3596,1.7937,3.3673,1.7937,3.4804,1.2887,3.4722)" + }, + { + "content": "can", + "span": { + "offset": 1597, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,1.8258,3.3674,2.0188,3.3683,2.0188,3.4814,1.8259,3.4806)" + }, + { + "content": "claim", + "span": { + "offset": 1601, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,2.0509,3.368,2.3309,3.3654,2.3309,3.4781,2.051,3.4811)" + }, + { + "content": ":", + "span": { + "offset": 1606, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.3385,3.3653,2.3782,3.3649,2.3782,3.4776,2.3385,3.478)" + }, + { + "content": "☐", + "span": { + "offset": 1609, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,2.5234,3.3569,2.6438,3.3569,2.6438,3.4805,2.5234,3.4805)" + }, + { + "content": "You", + "span": { + "offset": 1611, + "length": 3 + }, + "confidence": 0.981, + "source": "D(1,2.6874,3.3656,2.8904,3.3664,2.8904,3.4846,2.6874,3.4836)" + }, + { + "content": "as", + "span": { + "offset": 1615, + "length": 2 + }, + "confidence": 0.981, + "source": "D(1,2.9202,3.3665,3.0356,3.3669,3.0356,3.4852,2.9202,3.4847)" + }, + { + "content": "a", + "span": { + "offset": 1618, + "length": 1 + }, + "confidence": 0.986, + "source": "D(1,3.0635,3.367,3.1252,3.3671,3.1252,3.4854,3.0635,3.4853)" + }, + { + "content": "dependent", + "span": { + "offset": 1620, + "length": 9 + }, + "confidence": 0.987, + "source": "D(1,3.1531,3.3671,3.7063,3.3672,3.7063,3.4858,3.1531,3.4855)" + }, + { + "content": "☐", + "span": { + "offset": 1630, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,3.92,3.3569,4.0446,3.3569,4.0446,3.4805,3.92,3.4805)" + }, + { + "content": "Your", + "span": { + "offset": 1632, + "length": 4 + }, + "confidence": 0.992, + "source": "D(1,4.0861,3.365,4.3339,3.365,4.3339,3.4858,4.0861,3.4859)" + }, + { + "content": "spouse", + "span": { + "offset": 1637, + "length": 6 + }, + "confidence": 0.987, + "source": "D(1,4.358,3.365,4.7247,3.365,4.7247,3.4859,4.358,3.4858)" + }, + { + "content": "as", + "span": { + "offset": 1644, + "length": 2 + }, + "confidence": 0.978, + "source": "D(1,4.7529,3.365,4.8678,3.365,4.8678,3.4861,4.7529,3.4859)" + }, + { + "content": "a", + "span": { + "offset": 1647, + "length": 1 + }, + "confidence": 0.981, + "source": "D(1,4.896,3.365,4.9544,3.365,4.9544,3.4861,4.896,3.4861)" + }, + { + "content": "dependent", + "span": { + "offset": 1649, + "length": 9 + }, + "confidence": 0.989, + "source": "D(1,4.9846,3.365,5.5366,3.365,5.5366,3.4874,4.9846,3.4862)" + }, + { + "content": "☐", + "span": { + "offset": 1659, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,1.3209,3.5208,1.4454,3.5208,1.4454,3.6497,1.3209,3.6497)" + }, + { + "content": "Spouse", + "span": { + "offset": 1661, + "length": 6 + }, + "confidence": 0.996, + "source": "D(1,1.4879,3.5303,1.8692,3.53,1.8701,3.6512,1.489,3.6509)" + }, + { + "content": "itemizes", + "span": { + "offset": 1668, + "length": 8 + }, + "confidence": 0.99, + "source": "D(1,1.9052,3.53,2.3084,3.5297,2.3092,3.6516,1.9061,3.6513)" + }, + { + "content": "on", + "span": { + "offset": 1677, + "length": 2 + }, + "confidence": 0.924, + "source": "D(1,2.3404,3.5297,2.4662,3.5296,2.4669,3.6518,2.3412,3.6517)" + }, + { + "content": "a", + "span": { + "offset": 1680, + "length": 1 + }, + "confidence": 0.923, + "source": "D(1,2.5001,3.5295,2.556,3.5295,2.5567,3.6518,2.5008,3.6518)" + }, + { + "content": "separate", + "span": { + "offset": 1682, + "length": 8 + }, + "confidence": 0.925, + "source": "D(1,2.5899,3.5295,3.0192,3.5294,3.0197,3.6515,2.5906,3.6519)" + }, + { + "content": "return", + "span": { + "offset": 1691, + "length": 6 + }, + "confidence": 0.956, + "source": "D(1,3.0511,3.5294,3.3406,3.5294,3.3411,3.6511,3.0517,3.6514)" + }, + { + "content": "or", + "span": { + "offset": 1698, + "length": 2 + }, + "confidence": 0.953, + "source": "D(1,3.3725,3.5294,3.4783,3.5294,3.4788,3.6509,3.373,3.6511)" + }, + { + "content": "you", + "span": { + "offset": 1701, + "length": 3 + }, + "confidence": 0.886, + "source": "D(1,3.5003,3.5294,3.682,3.5294,3.6823,3.6507,3.5007,3.6509)" + }, + { + "content": "were", + "span": { + "offset": 1705, + "length": 4 + }, + "confidence": 0.714, + "source": "D(1,3.7159,3.5294,3.9595,3.5296,3.9598,3.65,3.7163,3.6507)" + }, + { + "content": "a", + "span": { + "offset": 1710, + "length": 1 + }, + "confidence": 0.905, + "source": "D(1,3.9874,3.5296,4.0453,3.5297,4.0456,3.6497,3.9877,3.6499)" + }, + { + "content": "dual", + "span": { + "offset": 1712, + "length": 4 + }, + "confidence": 0.843, + "source": "D(1,4.0812,3.5297,4.2849,3.5298,4.2851,3.649,4.0815,3.6496)" + }, + { + "content": "-", + "span": { + "offset": 1716, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.2969,3.5298,4.3328,3.5299,4.333,3.6488,4.297,3.6489)" + }, + { + "content": "status", + "span": { + "offset": 1717, + "length": 6 + }, + "confidence": 0.943, + "source": "D(1,4.3328,3.5299,4.6362,3.5301,4.6363,3.6478,4.333,3.6488)" + }, + { + "content": "alien", + "span": { + "offset": 1724, + "length": 5 + }, + "confidence": 0.978, + "source": "D(1,4.6662,3.5301,4.9058,3.5303,4.9058,3.647,4.6663,3.6478)" + }, + { + "content": "Age", + "span": { + "offset": 1731, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,0.4895,3.7778,0.6928,3.7773,0.6931,3.8996,0.49,3.9024)" + }, + { + "content": "/", + "span": { + "offset": 1734, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.6907,3.7773,0.74,3.7772,0.7403,3.899,0.6911,3.8997)" + }, + { + "content": "Blindness", + "span": { + "offset": 1735, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,0.7359,3.7772,1.2451,3.7841,1.2451,3.9041,0.7362,3.8991)" + }, + { + "content": "You", + "span": { + "offset": 1746, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,1.2949,3.7792,1.5007,3.7826,1.5007,3.8873,1.2949,3.8839)" + }, + { + "content": ":", + "span": { + "offset": 1749, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.5042,3.7824,1.5439,3.7811,1.5439,3.8859,1.5042,3.8872)" + }, + { + "content": "☑", + "span": { + "offset": 1752, + "length": 1 + }, + "confidence": 0.964, + "source": "D(1,1.6135,3.7544,1.7432,3.7544,1.7432,3.8779,1.6135,3.8779)" + }, + { + "content": "Were", + "span": { + "offset": 1754, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,1.7867,3.7707,2.0496,3.7732,2.0496,3.8947,1.7867,3.891)" + }, + { + "content": "born", + "span": { + "offset": 1759, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,2.0822,3.7735,2.3043,3.7756,2.3043,3.8982,2.0822,3.8951)" + }, + { + "content": "before", + "span": { + "offset": 1764, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,2.343,3.776,2.6508,3.7761,2.6508,3.8994,2.3431,3.8987)" + }, + { + "content": "January", + "span": { + "offset": 1771, + "length": 7 + }, + "confidence": 0.924, + "source": "D(1,2.6834,3.7761,3.0828,3.7745,3.0828,3.8981,2.6834,3.8994)" + }, + { + "content": "2", + "span": { + "offset": 1779, + "length": 1 + }, + "confidence": 0.912, + "source": "D(1,3.1052,3.7743,3.1663,3.7737,3.1663,3.8972,3.1052,3.8979)" + }, + { + "content": ",", + "span": { + "offset": 1780, + "length": 1 + }, + "confidence": 0.949, + "source": "D(1,3.1684,3.7737,3.1949,3.7734,3.1949,3.8969,3.1684,3.8972)" + }, + { + "content": "1956", + "span": { + "offset": 1782, + "length": 4 + }, + "confidence": 0.872, + "source": "D(1,3.2336,3.7731,3.4822,3.7707,3.4822,3.894,3.2336,3.8965)" + }, + { + "content": "☐", + "span": { + "offset": 1787, + "length": 1 + }, + "confidence": 0.988, + "source": "D(1,3.6171,3.7678,3.7395,3.7678,3.7395,3.8967,3.6171,3.8967)" + }, + { + "content": "Are", + "span": { + "offset": 1789, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,3.7914,3.7785,3.9618,3.7815,3.9618,3.8916,3.7914,3.8885)" + }, + { + "content": "blind", + "span": { + "offset": 1793, + "length": 5 + }, + "confidence": 0.999, + "source": "D(1,3.992,3.7815,4.2458,3.7792,4.2458,3.8877,3.992,3.8916)" + }, + { + "content": "Spouse", + "span": { + "offset": 1800, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,4.4866,3.7786,4.8868,3.7786,4.8868,3.8967,4.4866,3.8967)" + }, + { + "content": ":", + "span": { + "offset": 1806, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,4.8908,3.7786,4.9348,3.7786,4.9348,3.8967,4.8908,3.8967)" + }, + { + "content": "☐", + "span": { + "offset": 1809, + "length": 1 + }, + "confidence": 0.994, + "source": "D(1,5.0178,3.7625,5.1631,3.7651,5.1631,3.8994,5.0178,3.8994)" + }, + { + "content": "Was", + "span": { + "offset": 1811, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,5.1921,3.7686,5.4073,3.7711,5.4073,3.8931,5.1921,3.8899)" + }, + { + "content": "born", + "span": { + "offset": 1815, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,5.4401,3.7715,5.6614,3.7741,5.6614,3.8968,5.4401,3.8935)" + }, + { + "content": "before", + "span": { + "offset": 1820, + "length": 6 + }, + "confidence": 0.996, + "source": "D(1,5.6983,3.7746,6.0118,3.7755,6.0119,3.8987,5.6983,3.8974)" + }, + { + "content": "January", + "span": { + "offset": 1827, + "length": 7 + }, + "confidence": 0.884, + "source": "D(1,6.0426,3.7755,6.436,3.7745,6.4361,3.8981,6.0426,3.8988)" + }, + { + "content": "2", + "span": { + "offset": 1835, + "length": 1 + }, + "confidence": 0.922, + "source": "D(1,6.4647,3.7743,6.5242,3.7737,6.5242,3.8973,6.4647,3.8978)" + }, + { + "content": ",", + "span": { + "offset": 1836, + "length": 1 + }, + "confidence": 0.968, + "source": "D(1,6.5262,3.7737,6.5508,3.7735,6.5508,3.897,6.5262,3.8973)" + }, + { + "content": "1956", + "span": { + "offset": 1838, + "length": 4 + }, + "confidence": 0.878, + "source": "D(1,6.5918,3.7732,6.8315,3.771,6.8315,3.8944,6.5918,3.8967)" + }, + { + "content": "☑", + "span": { + "offset": 1843, + "length": 1 + }, + "confidence": 0.964, + "source": "D(1,7.0142,3.7651,7.1594,3.7651,7.1594,3.8994,7.0142,3.8994)" + }, + { + "content": "Is", + "span": { + "offset": 1845, + "length": 2 + }, + "confidence": 0.876, + "source": "D(1,7.1802,3.7774,7.2771,3.7816,7.2771,3.8909,7.1802,3.8882)" + }, + { + "content": "blind", + "span": { + "offset": 1848, + "length": 5 + }, + "confidence": 0.997, + "source": "D(1,7.3058,3.7828,7.5537,3.7773,7.5537,3.8845,7.3058,3.8917)" + }, + { + "content": "Dependents", + "span": { + "offset": 1885, + "length": 10 + }, + "confidence": 0.998, + "source": "D(1,0.4939,3.9592,1.2545,3.9576,1.2545,4.0894,0.4942,4.0928)" + }, + { + "content": "If", + "span": { + "offset": 1896, + "length": 2 + }, + "confidence": 0.934, + "source": "D(1,0.4921,4.1511,0.5681,4.1534,0.5683,4.2575,0.4923,4.2552)" + }, + { + "content": "more", + "span": { + "offset": 1899, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,0.5871,4.1539,0.8513,4.1548,0.8513,4.2586,0.5873,4.258)" + }, + { + "content": "than", + "span": { + "offset": 1904, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,0.4897,4.2795,0.7099,4.2796,0.7109,4.3821,0.491,4.3816)" + }, + { + "content": "four", + "span": { + "offset": 1909, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,0.7404,4.2794,0.9504,4.2771,0.951,4.3826,0.7413,4.3821)" + }, + { + "content": "dependents", + "span": { + "offset": 1914, + "length": 10 + }, + "confidence": 0.999, + "source": "D(1,0.4916,4.4013,1.0825,4.4006,1.0826,4.509,0.4931,4.509)" + }, + { + "content": ",", + "span": { + "offset": 1924, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.0861,4.4005,1.1144,4.4004,1.1144,4.509,1.0861,4.509)" + }, + { + "content": "see", + "span": { + "offset": 1926, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,0.4903,4.5251,0.6601,4.5251,0.6615,4.6299,0.4921,4.6299)" + }, + { + "content": "instructions", + "span": { + "offset": 1930, + "length": 12 + }, + "confidence": 0.997, + "source": "D(1,0.6937,4.5251,1.2545,4.5251,1.2545,4.6299,0.695,4.6299)" + }, + { + "content": "and", + "span": { + "offset": 1943, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,0.4905,4.647,0.677,4.6449,0.6779,4.7469,0.4918,4.7491)" + }, + { + "content": "check", + "span": { + "offset": 1947, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,0.7119,4.6447,1.0205,4.6439,1.0205,4.746,0.7127,4.7467)" + }, + { + "content": "here", + "span": { + "offset": 1953, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,0.4923,4.7642,0.7258,4.7642,0.7253,4.8608,0.4923,4.8608)" + }, + { + "content": "☐", + "span": { + "offset": 1958, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,0.8913,4.7507,1.0303,4.7507,1.0303,4.8743,0.8913,4.8743)" + }, + { + "content": "(", + "span": { + "offset": 1981, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.2949,3.9619,1.3272,3.9621,1.3272,4.0845,1.2949,4.0846)" + }, + { + "content": "see", + "span": { + "offset": 1982, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,1.3232,3.9621,1.4947,3.9629,1.4947,4.084,1.3232,4.0845)" + }, + { + "content": "instructions", + "span": { + "offset": 1986, + "length": 12 + }, + "confidence": 0.994, + "source": "D(1,1.531,3.9631,2.1019,3.9606,2.1019,4.0851,1.531,4.0839)" + }, + { + "content": ")", + "span": { + "offset": 1998, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.1019,3.9606,2.1342,3.9603,2.1342,4.0852,2.1019,4.0851)" + }, + { + "content": ":", + "span": { + "offset": 1999, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.1362,3.9603,2.1665,3.96,2.1665,4.0854,2.1362,4.0853)" + }, + { + "content": "(", + "span": { + "offset": 2034, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.9034,3.9664,3.9413,3.967,3.9413,4.079,3.9034,4.0783)" + }, + { + "content": "2", + "span": { + "offset": 2035, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.9337,3.9669,3.9904,3.9678,3.9904,4.0799,3.9337,4.0789)" + }, + { + "content": ")", + "span": { + "offset": 2036, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.9847,3.9677,4.0188,3.9682,4.0188,4.0805,3.9847,4.0798)" + }, + { + "content": "Social", + "span": { + "offset": 2038, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,4.0471,3.9687,4.3118,3.9715,4.3118,4.0843,4.0471,4.081)" + }, + { + "content": "security", + "span": { + "offset": 2045, + "length": 8 + }, + "confidence": 0.999, + "source": "D(1,4.3364,3.9717,4.6899,3.9715,4.6899,4.0842,4.3364,4.0845)" + }, + { + "content": "number", + "span": { + "offset": 2054, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,4.1213,4.0955,4.47,4.0955,4.47,4.1868,4.1213,4.1868)" + }, + { + "content": "(", + "span": { + "offset": 2082, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,5.0012,3.9704,5.0405,3.9702,5.0405,4.083,5.0012,4.0832)" + }, + { + "content": "3", + "span": { + "offset": 2083, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,5.033,3.9703,5.0873,3.9701,5.0873,4.0828,5.033,4.0831)" + }, + { + "content": ")", + "span": { + "offset": 2084, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,5.0855,3.9701,5.1154,3.9699,5.1154,4.0827,5.0855,4.0828)" + }, + { + "content": "Relationship", + "span": { + "offset": 2086, + "length": 12 + }, + "confidence": 0.997, + "source": "D(1,5.151,3.9698,5.6902,3.9731,5.6902,4.0859,5.151,4.0826)" + }, + { + "content": "to", + "span": { + "offset": 2099, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,5.2004,4.0981,5.2964,4.0981,5.2964,4.1948,5.2004,4.1948)" + }, + { + "content": "you", + "span": { + "offset": 2102, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,5.316,4.0981,5.4868,4.0981,5.4868,4.1948,5.316,4.1948)" + }, + { + "content": "(", + "span": { + "offset": 2127, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.0762,3.9784,6.1053,3.9766,6.1054,4.0786,6.0762,4.0804)" + }, + { + "content": "4", + "span": { + "offset": 2128, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.0956,3.9772,6.1524,3.9743,6.1524,4.0764,6.0956,4.0792)" + }, + { + "content": ")", + "span": { + "offset": 2129, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.1475,3.9745,6.1799,3.9733,6.1799,4.0754,6.1475,4.0765)" + }, + { + "content": "✓", + "span": { + "offset": 2131, + "length": 1 + }, + "confidence": 0.64, + "source": "D(1,6.209,3.9585,6.3252,3.9666,6.3252,4.0686,6.209,4.0552)" + }, + { + "content": "if", + "span": { + "offset": 2133, + "length": 2 + }, + "confidence": 0.991, + "source": "D(1,6.3501,3.9668,6.4051,3.967,6.4051,4.0822,6.3501,4.0823)" + }, + { + "content": "qualifies", + "span": { + "offset": 2136, + "length": 9 + }, + "confidence": 0.99, + "source": "D(1,6.426,3.9671,6.7844,3.9686,6.7844,4.0815,6.426,4.0822)" + }, + { + "content": "for", + "span": { + "offset": 2146, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,6.8109,3.9687,6.9342,3.969,6.9342,4.0816,6.8109,4.0814)" + }, + { + "content": "(", + "span": { + "offset": 2150, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.957,3.969,6.9854,3.9691,6.9854,4.0817,6.957,4.0816)" + }, + { + "content": "see", + "span": { + "offset": 2151, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,6.9854,3.9691,7.1333,3.9694,7.1333,4.0819,6.9854,4.0817)" + }, + { + "content": "instructions", + "span": { + "offset": 2155, + "length": 12 + }, + "confidence": 0.994, + "source": "D(1,7.1637,3.9695,7.6625,3.9696,7.6625,4.084,7.1637,4.0819)" + }, + { + "content": ")", + "span": { + "offset": 2167, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.6606,3.9696,7.689,3.9696,7.689,4.0841,7.6606,4.084)" + }, + { + "content": ":", + "span": { + "offset": 2168, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,7.6928,3.9696,7.7156,3.9696,7.7156,4.0842,7.6928,4.0841)" + }, + { + "content": "(", + "span": { + "offset": 2190, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3198,4.1116,1.356,4.1116,1.358,4.219,1.3219,4.219)" + }, + { + "content": "1", + "span": { + "offset": 2191, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3524,4.1116,1.394,4.1116,1.3958,4.219,1.3544,4.219)" + }, + { + "content": ")", + "span": { + "offset": 2192, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3976,4.1116,1.432,4.1116,1.4337,4.219,1.3994,4.219)" + }, + { + "content": "First", + "span": { + "offset": 2194, + "length": 5 + }, + "confidence": 0.997, + "source": "D(1,1.4628,4.1116,1.651,4.1116,1.6519,4.219,1.4644,4.219)" + }, + { + "content": "name", + "span": { + "offset": 2200, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,1.6763,4.1116,1.9279,4.1116,1.9279,4.219,1.6772,4.219)" + }, + { + "content": "Last", + "span": { + "offset": 2214, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,2.4757,4.1169,2.6695,4.1169,2.6695,4.2136,2.4757,4.2136)" + }, + { + "content": "name", + "span": { + "offset": 2219, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,2.6923,4.1169,2.9447,4.1169,2.9447,4.2136,2.6923,4.2136)" + }, + { + "content": "Child", + "span": { + "offset": 2233, + "length": 5 + }, + "confidence": 0.999, + "source": "D(1,6.0098,4.1143,6.2364,4.1143,6.2364,4.2158,6.0098,4.2138)" + }, + { + "content": "tax", + "span": { + "offset": 2239, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,6.2635,4.1143,6.4021,4.1143,6.4021,4.2164,6.2635,4.2159)" + }, + { + "content": "credit", + "span": { + "offset": 2243, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,6.4275,4.1143,6.6863,4.1143,6.6863,4.216,6.4275,4.2164)" + }, + { + "content": "Credit", + "span": { + "offset": 2259, + "length": 6 + }, + "confidence": 0.995, + "source": "D(1,6.9187,4.1104,7.1603,4.1093,7.1603,4.2217,6.9187,4.2217)" + }, + { + "content": "for", + "span": { + "offset": 2266, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,7.1811,4.1092,7.2925,4.1087,7.2925,4.2217,7.1811,4.2217)" + }, + { + "content": "other", + "span": { + "offset": 2270, + "length": 5 + }, + "confidence": 0.996, + "source": "D(1,7.3114,4.1087,7.5209,4.1087,7.5209,4.2217,7.3114,4.2217)" + }, + { + "content": "dependents", + "span": { + "offset": 2276, + "length": 10 + }, + "confidence": 0.998, + "source": "D(1,7.5379,4.1087,8.0061,4.1104,8.0061,4.2217,7.5379,4.2217)" + }, + { + "content": "Evelyn", + "span": { + "offset": 2307, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,1.4807,4.2692,1.8438,4.2712,1.8438,4.3893,1.4807,4.3874)" + }, + { + "content": "Collins", + "span": { + "offset": 2323, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,2.5234,4.2962,2.816,4.2977,2.816,4.3944,2.5234,4.3929)" + }, + { + "content": "005", + "span": { + "offset": 2340, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,3.864,4.262,4.0217,4.262,4.0217,4.348,3.864,4.3445)" + }, + { + "content": "78", + "span": { + "offset": 2353, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,4.113,4.2646,4.2126,4.2646,4.2126,4.3452,4.113,4.3452)" + }, + { + "content": "5758", + "span": { + "offset": 2365, + "length": 4 + }, + "confidence": 0.994, + "source": "D(1,4.4368,4.28,4.636,4.2748,4.636,4.3661,4.4368,4.3713)" + }, + { + "content": "friend", + "span": { + "offset": 2379, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,5.2834,4.2695,5.5283,4.2635,5.5283,4.3601,5.2834,4.3662)" + }, + { + "content": "☐", + "span": { + "offset": 2395, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,6.2878,4.2673,6.3999,4.27,6.3999,4.3962,6.2878,4.3962)" + }, + { + "content": "☐", + "span": { + "offset": 2406, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,7.3877,4.2673,7.5081,4.2673,7.5081,4.3962,7.3877,4.3962)" + }, + { + "content": "☐", + "span": { + "offset": 2488, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,6.2878,4.4338,6.3999,4.4338,6.3999,4.5627,6.2878,4.5627)" + }, + { + "content": "☐", + "span": { + "offset": 2499, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,7.3877,4.4338,7.5081,4.4338,7.5081,4.5627,7.3877,4.5627)" + }, + { + "content": "☐", + "span": { + "offset": 2581, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,6.2878,4.6057,6.3999,4.5977,6.3999,4.7266,6.2878,4.7346)" + }, + { + "content": "☐", + "span": { + "offset": 2592, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,7.3877,4.603,7.5081,4.6057,7.5081,4.7346,7.3877,4.7346)" + }, + { + "content": "☐", + "span": { + "offset": 2674, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,6.2878,4.7749,6.3999,4.7695,6.3999,4.8958,6.2878,4.9011)" + }, + { + "content": "☐", + "span": { + "offset": 2685, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,7.3877,4.7695,7.5081,4.7695,7.5081,4.8984,7.3877,4.8958)" + }, + { + "content": "Attach", + "span": { + "offset": 2738, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,0.5139,5.0776,0.8327,5.0784,0.8327,5.1805,0.5144,5.1797)" + }, + { + "content": "Sch", + "span": { + "offset": 2745, + "length": 3 + }, + "confidence": 0.991, + "source": "D(1,0.5185,5.2207,0.7016,5.2207,0.7022,5.3261,0.5196,5.3252)" + }, + { + "content": ".", + "span": { + "offset": 2748, + "length": 1 + }, + "confidence": 0.992, + "source": "D(1,0.705,5.2207,0.729,5.2207,0.7295,5.3263,0.7056,5.3261)" + }, + { + "content": "B", + "span": { + "offset": 2750, + "length": 1 + }, + "confidence": 0.972, + "source": "D(1,0.7615,5.2207,0.8282,5.2207,0.8285,5.3274,0.7619,5.3266)" + }, + { + "content": "if", + "span": { + "offset": 2752, + "length": 2 + }, + "confidence": 0.983, + "source": "D(1,0.8607,5.2207,0.9292,5.2207,0.9292,5.3289,0.8609,5.3279)" + }, + { + "content": "required", + "span": { + "offset": 2755, + "length": 8 + }, + "confidence": 0.999, + "source": "D(1,0.5159,5.3625,0.9039,5.3606,0.906,5.4678,0.518,5.4678)" + }, + { + "content": ".", + "span": { + "offset": 2763, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.911,5.3606,0.9411,5.3608,0.9432,5.4678,0.9131,5.4678)" + }, + { + "content": "1", + "span": { + "offset": 2786, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3395,4.9634,1.3945,4.9628,1.3945,5.0569,1.3395,5.0569)" + }, + { + "content": "Wages", + "span": { + "offset": 2788, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,1.5834,4.9519,1.9322,4.9508,1.9331,5.0744,1.5844,5.0751)" + }, + { + "content": ",", + "span": { + "offset": 2793, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.9363,4.9508,1.9608,4.9507,1.9616,5.0743,1.9372,5.0744)" + }, + { + "content": "salaries", + "span": { + "offset": 2795, + "length": 8 + }, + "confidence": 0.997, + "source": "D(1,1.9955,4.9506,2.3708,4.9495,2.3715,5.0736,1.9963,5.0743)" + }, + { + "content": ",", + "span": { + "offset": 2803, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.3769,4.9495,2.3994,4.9494,2.4,5.0735,2.3776,5.0736)" + }, + { + "content": "tips", + "span": { + "offset": 2805, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,2.434,4.9494,2.6115,4.9494,2.6121,5.0734,2.4347,5.0735)" + }, + { + "content": ",", + "span": { + "offset": 2809, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.6156,4.9494,2.638,4.9494,2.6386,5.0734,2.6162,5.0734)" + }, + { + "content": "etc", + "span": { + "offset": 2811, + "length": 3 + }, + "confidence": 0.931, + "source": "D(1,2.6768,4.9493,2.8318,4.9493,2.8323,5.0732,2.6774,5.0733)" + }, + { + "content": ".", + "span": { + "offset": 2814, + "length": 1 + }, + "confidence": 0.983, + "source": "D(1,2.8339,4.9493,2.8563,4.9493,2.8568,5.0732,2.8344,5.0732)" + }, + { + "content": "Attach", + "span": { + "offset": 2816, + "length": 6 + }, + "confidence": 0.888, + "source": "D(1,2.889,4.9493,3.2174,4.9495,3.2177,5.073,2.8894,5.0731)" + }, + { + "content": "Form", + "span": { + "offset": 2823, + "length": 4 + }, + "confidence": 0.99, + "source": "D(1,3.2541,4.9496,3.4969,4.9502,3.4971,5.0731,3.2544,5.073)" + }, + { + "content": "(", + "span": { + "offset": 2827, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.5091,4.9502,3.5418,4.9503,3.5419,5.0731,3.5093,5.0731)" + }, + { + "content": "s", + "span": { + "offset": 2828, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.5377,4.9503,3.5928,4.9504,3.5929,5.0731,3.5378,5.0731)" + }, + { + "content": ")", + "span": { + "offset": 2829, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.5907,4.9504,3.6234,4.9505,3.6235,5.0731,3.5909,5.0731)" + }, + { + "content": "W", + "span": { + "offset": 2831, + "length": 1 + }, + "confidence": 0.995, + "source": "D(1,3.6458,4.9506,3.756,4.9508,3.756,5.0732,3.6459,5.0731)" + }, + { + "content": "-", + "span": { + "offset": 2832, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.7539,4.9508,3.7927,4.9509,3.7927,5.0732,3.754,5.0732)" + }, + { + "content": "2", + "span": { + "offset": 2833, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,3.7927,4.9509,3.8682,4.9511,3.8682,5.0732,3.7927,5.0732)" + }, + { + "content": "1", + "span": { + "offset": 2844, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.8232,4.9629,6.8689,4.9629,6.8689,5.0569,6.8232,5.0569)" + }, + { + "content": "2501", + "span": { + "offset": 2855, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,7.7156,4.9495,7.9563,4.9495,7.9563,5.055,7.7156,5.0529)" + }, + { + "content": "2a", + "span": { + "offset": 2880, + "length": 2 + }, + "confidence": 0.952, + "source": "D(1,1.3292,5.1264,1.4692,5.1258,1.4692,5.2288,1.3292,5.2288)" + }, + { + "content": "Tax", + "span": { + "offset": 2883, + "length": 3 + }, + "confidence": 0.999, + "source": "D(1,1.5865,5.1271,1.7739,5.1267,1.7739,5.2449,1.5865,5.2445)" + }, + { + "content": "-", + "span": { + "offset": 2886, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.7777,5.1267,1.8144,5.1266,1.8144,5.245,1.7777,5.2449)" + }, + { + "content": "exempt", + "span": { + "offset": 2887, + "length": 6 + }, + "confidence": 0.993, + "source": "D(1,1.8144,5.1266,2.1931,5.1268,2.1931,5.2448,1.8144,5.245)" + }, + { + "content": "interest", + "span": { + "offset": 2894, + "length": 8 + }, + "confidence": 0.986, + "source": "D(1,2.224,5.1269,2.6064,5.1289,2.6064,5.2427,2.224,5.2447)" + }, + { + "content": ".", + "span": { + "offset": 2903, + "length": 1 + }, + "confidence": 1, + "source": "D(1,2.8426,5.2059,2.8549,5.2059,2.8549,5.2182,2.8426,5.2182)" + }, + { + "content": ".", + "span": { + "offset": 2905, + "length": 1 + }, + "confidence": 1, + "source": "D(1,3.0093,5.2059,3.0216,5.2059,3.0216,5.2182,3.0093,5.2182)" + }, + { + "content": "2a", + "span": { + "offset": 2916, + "length": 2 + }, + "confidence": 0.918, + "source": "D(1,3.2788,5.1302,3.4158,5.1397,3.4158,5.236,3.2788,5.2249)" + }, + { + "content": "2010", + "span": { + "offset": 2928, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,4.2043,5.116,4.4617,5.116,4.4617,5.218,4.2043,5.218)" + }, + { + "content": "b", + "span": { + "offset": 2954, + "length": 1 + }, + "confidence": 0.986, + "source": "D(1,4.6858,5.1394,4.7609,5.14,4.7609,5.2499,4.6858,5.2493)" + }, + { + "content": "Taxable", + "span": { + "offset": 2956, + "length": 7 + }, + "confidence": 0.996, + "source": "D(1,4.8195,5.1404,5.2097,5.1425,5.2097,5.2522,4.8195,5.2505)" + }, + { + "content": "interest", + "span": { + "offset": 2964, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,5.2409,5.1426,5.6238,5.1428,5.6238,5.2497,5.2409,5.2522)" + }, + { + "content": "2b", + "span": { + "offset": 2982, + "length": 2 + }, + "confidence": 0.952, + "source": "D(1,6.7734,5.1271,6.9146,5.1282,6.9146,5.2288,6.7734,5.2288)" + }, + { + "content": "5202", + "span": { + "offset": 2994, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,7.7156,5.1159,7.9646,5.1126,7.9646,5.2209,7.7156,5.2205)" + }, + { + "content": "3a", + "span": { + "offset": 3019, + "length": 2 + }, + "confidence": 0.935, + "source": "D(1,1.3292,5.3013,1.4682,5.3013,1.4682,5.4035,1.3292,5.3999)" + }, + { + "content": "Qualified", + "span": { + "offset": 3022, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,1.5875,5.2917,2.0263,5.2895,2.0262,5.4057,1.5875,5.4071)" + }, + { + "content": "dividends", + "span": { + "offset": 3032, + "length": 9 + }, + "confidence": 0.999, + "source": "D(1,2.0593,5.2894,2.5504,5.2878,2.5504,5.3996,2.0592,5.4055)" + }, + { + "content": ".", + "span": { + "offset": 3042, + "length": 1 + }, + "confidence": 1, + "source": "D(1,2.6759,5.3725,2.6883,5.3725,2.6883,5.3849,2.6759,5.3849)" + }, + { + "content": ".", + "span": { + "offset": 3044, + "length": 1 + }, + "confidence": 1, + "source": "D(1,2.8426,5.3725,2.8549,5.3725,2.8549,5.3849,2.8426,5.3849)" + }, + { + "content": ".", + "span": { + "offset": 3046, + "length": 1 + }, + "confidence": 1, + "source": "D(1,3.0093,5.3725,3.0216,5.3725,3.0216,5.3849,3.0093,5.3849)" + }, + { + "content": "3a", + "span": { + "offset": 3057, + "length": 2 + }, + "confidence": 0.895, + "source": "D(1,3.2788,5.3043,3.4158,5.3034,3.4158,5.4008,3.2788,5.4018)" + }, + { + "content": "1007", + "span": { + "offset": 3069, + "length": 4 + }, + "confidence": 0.983, + "source": "D(1,4.2085,5.2798,4.4575,5.2798,4.4575,5.3872,4.2085,5.3872)" + }, + { + "content": "b", + "span": { + "offset": 3095, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,4.6899,5.3024,4.7631,5.303,4.763,5.4209,4.6899,5.4201)" + }, + { + "content": "Ordinary", + "span": { + "offset": 3097, + "length": 8 + }, + "confidence": 0.997, + "source": "D(1,4.8223,5.3034,5.2531,5.3041,5.2531,5.4223,4.8223,5.4215)" + }, + { + "content": "dividends", + "span": { + "offset": 3106, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,5.2808,5.3039,5.7649,5.2962,5.7649,5.4123,5.2807,5.4221)" + }, + { + "content": "3b", + "span": { + "offset": 3125, + "length": 2 + }, + "confidence": 0.91, + "source": "D(1,6.7776,5.2932,6.9146,5.2932,6.9146,5.3953,6.7776,5.3953)" + }, + { + "content": "3405", + "span": { + "offset": 3137, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,7.7156,5.2831,7.9771,5.2799,7.9771,5.3872,7.7156,5.3872)" + }, + { + "content": "4a", + "span": { + "offset": 3162, + "length": 2 + }, + "confidence": 0.943, + "source": "D(1,1.3302,5.4651,1.4672,5.4651,1.4672,5.5645,1.3302,5.5645)" + }, + { + "content": "IRA", + "span": { + "offset": 3165, + "length": 3 + }, + "confidence": 0.994, + "source": "D(1,1.5896,5.4583,1.7702,5.4583,1.7702,5.5703,1.5896,5.5699)" + }, + { + "content": "distributions", + "span": { + "offset": 3169, + "length": 13 + }, + "confidence": 0.995, + "source": "D(1,1.8,5.4583,2.4238,5.4603,2.4238,5.5693,1.8,5.5704)" + }, + { + "content": "4a", + "span": { + "offset": 3192, + "length": 2 + }, + "confidence": 0.947, + "source": "D(1,3.2747,5.4678,3.4158,5.4678,3.4158,5.5645,3.2747,5.5645)" + }, + { + "content": "3524", + "span": { + "offset": 3204, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,4.2085,5.4513,4.4617,5.4458,4.4617,5.5532,4.2085,5.5588)" + }, + { + "content": "b", + "span": { + "offset": 3230, + "length": 1 + }, + "confidence": 0.985, + "source": "D(1,4.6858,5.4597,4.7612,5.4597,4.7612,5.5698,4.6858,5.5698)" + }, + { + "content": "Taxable", + "span": { + "offset": 3232, + "length": 7 + }, + "confidence": 0.996, + "source": "D(1,4.8201,5.4597,5.2137,5.4597,5.2137,5.5698,4.8201,5.5698)" + }, + { + "content": "amount", + "span": { + "offset": 3240, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,5.2431,5.4597,5.657,5.4597,5.657,5.5698,5.2431,5.5698)" + }, + { + "content": "4b", + "span": { + "offset": 3256, + "length": 2 + }, + "confidence": 0.98, + "source": "D(1,6.7776,5.4625,6.9146,5.4622,6.9146,5.5587,6.7776,5.5592)" + }, + { + "content": "4508", + "span": { + "offset": 3268, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,7.7156,5.4526,7.9646,5.4531,7.9646,5.5605,7.7156,5.5601)" + }, + { + "content": "5a", + "span": { + "offset": 3293, + "length": 2 + }, + "confidence": 0.571, + "source": "D(1,1.3302,5.6237,1.4672,5.6218,1.4672,5.7239,1.3302,5.7258)" + }, + { + "content": "Pensions", + "span": { + "offset": 3296, + "length": 8 + }, + "confidence": 0.995, + "source": "D(1,1.5886,5.6248,2.0458,5.6185,2.0458,5.737,1.5886,5.7395)" + }, + { + "content": "and", + "span": { + "offset": 3305, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,2.0783,5.6186,2.2601,5.6193,2.2601,5.7364,2.0783,5.7369)" + }, + { + "content": "annuities", + "span": { + "offset": 3309, + "length": 9 + }, + "confidence": 0.994, + "source": "D(1,2.2964,5.6194,2.7517,5.6291,2.7517,5.7365,2.2964,5.7363)" + }, + { + "content": ".", + "span": { + "offset": 3319, + "length": 1 + }, + "confidence": 1, + "source": "D(1,2.8426,5.7059,2.8549,5.7059,2.8549,5.7182,2.8426,5.7182)" + }, + { + "content": ".", + "span": { + "offset": 3321, + "length": 1 + }, + "confidence": 1, + "source": "D(1,3.0093,5.7059,3.0216,5.7059,3.0216,5.7182,3.0093,5.7182)" + }, + { + "content": "5a", + "span": { + "offset": 3332, + "length": 2 + }, + "confidence": 0.527, + "source": "D(1,3.2788,5.6275,3.4116,5.6252,3.4116,5.7218,3.2788,5.7242)" + }, + { + "content": "2535", + "span": { + "offset": 3344, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,4.2002,5.6128,4.4575,5.6128,4.4575,5.7202,4.2002,5.7202)" + }, + { + "content": "b", + "span": { + "offset": 3370, + "length": 1 + }, + "confidence": 0.986, + "source": "D(1,4.6899,5.6216,4.7611,5.6223,4.761,5.7304,4.6899,5.7287)" + }, + { + "content": "Taxable", + "span": { + "offset": 3372, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,4.8194,5.6229,5.2133,5.6243,5.2133,5.7354,4.8194,5.7318)" + }, + { + "content": "amount", + "span": { + "offset": 3380, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,5.2425,5.6242,5.6528,5.6191,5.6528,5.7237,5.2425,5.7353)" + }, + { + "content": "5b", + "span": { + "offset": 3396, + "length": 2 + }, + "confidence": 0.96, + "source": "D(1,6.7776,5.6285,6.9146,5.6284,6.9146,5.7251,6.7776,5.7252)" + }, + { + "content": "1008", + "span": { + "offset": 3408, + "length": 4 + }, + "confidence": 0.985, + "source": "D(1,7.7239,5.6119,7.9646,5.6083,7.9646,5.7158,7.7239,5.7193)" + }, + { + "content": "Standard", + "span": { + "offset": 3446, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,0.4482,5.8071,0.8814,5.8066,0.8814,5.9033,0.4493,5.9038)" + }, + { + "content": "Deduction", + "span": { + "offset": 3455, + "length": 9 + }, + "confidence": 0.997, + "source": "D(1,0.4501,5.9132,0.9203,5.9143,0.9205,6.0109,0.4508,6.0099)" + }, + { + "content": "for", + "span": { + "offset": 3465, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,0.9492,5.9142,1.0877,5.9136,1.0878,6.0102,0.9495,6.0109)" + }, + { + "content": "-", + "span": { + "offset": 3468, + "length": 1 + }, + "confidence": 0.978, + "source": "D(1,1.0845,5.9136,1.1714,5.9132,1.1714,6.0099,1.0846,6.0103)" + }, + { + "content": ".", + "span": { + "offset": 3470, + "length": 1 + }, + "confidence": 0.933, + "source": "D(1,0.4578,6.0522,0.496,6.0523,0.4966,6.149,0.4586,6.1488)" + }, + { + "content": "Single", + "span": { + "offset": 3472, + "length": 6 + }, + "confidence": 0.988, + "source": "D(1,0.5198,6.0524,0.7755,6.0488,0.7756,6.1454,0.5204,6.1491)" + }, + { + "content": "or", + "span": { + "offset": 3479, + "length": 2 + }, + "confidence": 0.998, + "source": "D(1,0.7977,6.0478,0.8897,6.0439,0.8897,6.1406,0.7978,6.1445)" + }, + { + "content": "Married", + "span": { + "offset": 3482, + "length": 7 + }, + "confidence": 0.998, + "source": "D(1,0.5178,6.1499,0.826,6.1499,0.8256,6.2466,0.5183,6.2466)" + }, + { + "content": "filing", + "span": { + "offset": 3490, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,0.853,6.1499,1.0516,6.1499,1.0506,6.2466,0.8525,6.2466)" + }, + { + "content": "separately", + "span": { + "offset": 3497, + "length": 10 + }, + "confidence": 0.998, + "source": "D(1,0.5157,6.2596,0.9418,6.2557,0.9419,6.3492,0.5167,6.342)" + }, + { + "content": ",", + "span": { + "offset": 3507, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,0.9418,6.2557,0.967,6.2563,0.967,6.3495,0.9419,6.3492)" + }, + { + "content": "$", + "span": { + "offset": 3509, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,0.5128,6.3433,0.5692,6.3433,0.5696,6.4399,0.5134,6.4399)" + }, + { + "content": "12,400", + "span": { + "offset": 3510, + "length": 6 + }, + "confidence": 0.964, + "source": "D(1,0.5742,6.3433,0.8576,6.3433,0.8576,6.4399,0.5746,6.4399)" + }, + { + "content": ".", + "span": { + "offset": 3517, + "length": 1 + }, + "confidence": 0.892, + "source": "D(1,0.4578,6.4598,0.4966,6.4608,0.4973,6.5575,0.4586,6.5564)" + }, + { + "content": "Married", + "span": { + "offset": 3519, + "length": 7 + }, + "confidence": 0.993, + "source": "D(1,0.5257,6.4616,0.8293,6.4691,0.8296,6.5658,0.5264,6.5582)" + }, + { + "content": "filing", + "span": { + "offset": 3527, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,0.8567,6.4697,1.0521,6.4737,1.0521,6.5704,0.857,6.5664)" + }, + { + "content": "jointly", + "span": { + "offset": 3534, + "length": 7 + }, + "confidence": 0.992, + "source": "D(1,0.5113,6.5697,0.7612,6.5676,0.7614,6.6585,0.5121,6.6577)" + }, + { + "content": "or", + "span": { + "offset": 3542, + "length": 2 + }, + "confidence": 0.998, + "source": "D(1,0.7808,6.5679,0.8726,6.5694,0.8726,6.6551,0.781,6.6579)" + }, + { + "content": "Qualifying", + "span": { + "offset": 3545, + "length": 10 + }, + "confidence": 0.991, + "source": "D(1,0.5159,6.6527,0.9307,6.6527,0.9307,6.7493,0.5165,6.7494)" + }, + { + "content": "widow", + "span": { + "offset": 3556, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,0.5159,6.7631,0.7814,6.7625,0.7815,6.8592,0.5165,6.8597)" + }, + { + "content": "(", + "span": { + "offset": 3561, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.7847,6.7626,0.8145,6.7631,0.8147,6.8598,0.7848,6.8592)" + }, + { + "content": "er", + "span": { + "offset": 3562, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,0.8063,6.7629,0.8875,6.7651,0.8876,6.8618,0.8064,6.8596)" + }, + { + "content": ")", + "span": { + "offset": 3564, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,0.8809,6.7649,0.9091,6.7657,0.9091,6.8624,0.8809,6.8616)" + }, + { + "content": ",", + "span": { + "offset": 3565, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,0.9124,6.7658,0.9406,6.7665,0.9406,6.8632,0.9124,6.8625)" + }, + { + "content": "$", + "span": { + "offset": 3567, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,0.5139,6.867,0.5685,6.864,0.569,6.9606,0.5144,6.9637)" + }, + { + "content": "24,800", + "span": { + "offset": 3568, + "length": 6 + }, + "confidence": 0.983, + "source": "D(1,0.5685,6.864,0.8586,6.8653,0.8586,6.962,0.569,6.9606)" + }, + { + "content": ".", + "span": { + "offset": 3575, + "length": 1 + }, + "confidence": 0.938, + "source": "D(1,0.4597,6.9829,0.4968,6.9805,0.4973,7.0684,0.4602,7.0684)" + }, + { + "content": "Head", + "span": { + "offset": 3577, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,0.5246,6.9787,0.7368,6.9737,0.737,7.0684,0.5251,7.0684)" + }, + { + "content": "of", + "span": { + "offset": 3582, + "length": 2 + }, + "confidence": 0.998, + "source": "D(1,0.7616,6.9749,0.856,6.9794,0.856,7.0684,0.7617,7.0684)" + }, + { + "content": "household", + "span": { + "offset": 3585, + "length": 9 + }, + "confidence": 0.999, + "source": "D(1,0.5126,7.0791,0.9419,7.0791,0.942,7.1758,0.5134,7.1758)" + }, + { + "content": ",", + "span": { + "offset": 3594, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,0.9451,7.0791,0.9722,7.0791,0.9722,7.1758,0.9451,7.1758)" + }, + { + "content": "$", + "span": { + "offset": 3596, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,0.5159,7.1703,0.567,7.1697,0.5675,7.2664,0.5165,7.2669)" + }, + { + "content": "18,650", + "span": { + "offset": 3597, + "length": 6 + }, + "confidence": 0.98, + "source": "D(1,0.5736,7.1696,0.8586,7.1713,0.8586,7.268,0.574,7.2663)" + }, + { + "content": ".", + "span": { + "offset": 3604, + "length": 1 + }, + "confidence": 0.841, + "source": "D(1,0.4578,7.3049,0.4957,7.3043,0.4964,7.3989,0.4586,7.3991)" + }, + { + "content": "If", + "span": { + "offset": 3606, + "length": 2 + }, + "confidence": 0.839, + "source": "D(1,0.5225,7.3039,0.5762,7.3031,0.5768,7.3985,0.5232,7.3988)" + }, + { + "content": "you", + "span": { + "offset": 3609, + "length": 3 + }, + "confidence": 0.987, + "source": "D(1,0.5888,7.3029,0.734,7.3006,0.7345,7.3973,0.5894,7.3985)" + }, + { + "content": "checked", + "span": { + "offset": 3613, + "length": 7 + }, + "confidence": 0.994, + "source": "D(1,0.7609,7.3001,1.1144,7.2942,1.1144,7.3902,0.7613,7.3969)" + }, + { + "content": "any", + "span": { + "offset": 3621, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,0.5162,7.4006,0.6643,7.3973,0.6655,7.4869,0.5178,7.4854)" + }, + { + "content": "box", + "span": { + "offset": 3625, + "length": 3 + }, + "confidence": 0.996, + "source": "D(1,0.6878,7.3968,0.836,7.3959,0.8367,7.4872,0.6889,7.4871)" + }, + { + "content": "under", + "span": { + "offset": 3629, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,0.8595,7.3958,1.103,7.3987,1.103,7.4848,0.8601,7.4872)" + }, + { + "content": "Standard", + "span": { + "offset": 3635, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,0.5159,7.498,0.8923,7.498,0.8923,7.584,0.5165,7.584)" + }, + { + "content": "Deduction", + "span": { + "offset": 3644, + "length": 9 + }, + "confidence": 0.999, + "source": "D(1,0.5167,7.5939,0.924,7.59,0.924,7.6871,0.517,7.6842)" + }, + { + "content": ",", + "span": { + "offset": 3653, + "length": 1 + }, + "confidence": 0.992, + "source": "D(1,0.9255,7.5899,0.9494,7.5891,0.9494,7.6866,0.9256,7.687)" + }, + { + "content": "see", + "span": { + "offset": 3655, + "length": 3 + }, + "confidence": 0.998, + "source": "D(1,0.5136,7.6916,0.659,7.6901,0.6598,7.7794,0.5146,7.7762)" + }, + { + "content": "instructions", + "span": { + "offset": 3659, + "length": 12 + }, + "confidence": 0.997, + "source": "D(1,0.6854,7.6899,1.145,7.6923,1.1451,7.7766,0.6862,7.78)" + }, + { + "content": ".", + "span": { + "offset": 3671, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.148,7.6924,1.1714,7.6927,1.1714,7.776,1.148,7.7765)" + }, + { + "content": "6a", + "span": { + "offset": 3682, + "length": 2 + }, + "confidence": 0.919, + "source": "D(1,1.3292,5.7999,1.4672,5.797,1.4672,5.8975,1.3292,5.8975)" + }, + { + "content": "Social", + "span": { + "offset": 3685, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,1.5875,5.79,1.9002,5.79,1.9002,5.9082,1.5875,5.9082)" + }, + { + "content": "security", + "span": { + "offset": 3692, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,1.9297,5.79,2.323,5.79,2.323,5.9082,1.9297,5.9082)" + }, + { + "content": "benefits", + "span": { + "offset": 3701, + "length": 8 + }, + "confidence": 0.998, + "source": "D(1,2.3505,5.79,2.7517,5.79,2.7517,5.9082,2.3505,5.9082)" + }, + { + "content": ".", + "span": { + "offset": 3710, + "length": 1 + }, + "confidence": 1, + "source": "D(1,3.0093,5.8725,3.0216,5.8725,3.0216,5.8849,3.0093,5.8849)" + }, + { + "content": "6a", + "span": { + "offset": 3721, + "length": 2 + }, + "confidence": 0.924, + "source": "D(1,3.2788,5.8008,3.4158,5.8008,3.4158,5.8975,3.2788,5.8975)" + }, + { + "content": "5328", + "span": { + "offset": 3733, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,4.2002,5.7739,4.47,5.7739,4.47,5.8813,4.2002,5.8813)" + }, + { + "content": "b", + "span": { + "offset": 3759, + "length": 1 + }, + "confidence": 0.985, + "source": "D(1,4.6858,5.7891,4.7612,5.7896,4.7612,5.9028,4.6858,5.9028)" + }, + { + "content": "Taxable", + "span": { + "offset": 3761, + "length": 7 + }, + "confidence": 0.997, + "source": "D(1,4.8201,5.79,5.2137,5.7927,5.2137,5.9028,4.8201,5.9028)" + }, + { + "content": "amount", + "span": { + "offset": 3769, + "length": 6 + }, + "confidence": 0.999, + "source": "D(1,5.2431,5.7929,5.657,5.7967,5.657,5.9028,5.2431,5.9028)" + }, + { + "content": "6b", + "span": { + "offset": 3785, + "length": 2 + }, + "confidence": 0.946, + "source": "D(1,6.7776,5.8008,6.9146,5.8008,6.9146,5.8975,6.7776,5.8975)" + }, + { + "content": "2004", + "span": { + "offset": 3797, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,7.7156,5.7869,7.9646,5.7916,7.9646,5.899,7.7156,5.8944)" + }, + { + "content": "7", + "span": { + "offset": 3834, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,1.3312,5.9565,1.4018,5.9565,1.4018,6.0532,1.3312,6.0532)" + }, + { + "content": "Capital", + "span": { + "offset": 3836, + "length": 7 + }, + "confidence": 0.995, + "source": "D(1,1.5906,5.9498,1.9394,5.9497,1.9394,6.0782,1.5906,6.0778)" + }, + { + "content": "gain", + "span": { + "offset": 3844, + "length": 4 + }, + "confidence": 0.996, + "source": "D(1,1.9713,5.9497,2.1797,5.9496,2.1797,6.0784,1.9713,6.0782)" + }, + { + "content": "or", + "span": { + "offset": 3849, + "length": 2 + }, + "confidence": 0.995, + "source": "D(1,2.2137,5.9496,2.3179,5.9496,2.3179,6.0785,2.2137,6.0784)" + }, + { + "content": "(", + "span": { + "offset": 3852, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.3413,5.9496,2.3732,5.9496,2.3732,6.0786,2.3413,6.0786)" + }, + { + "content": "loss", + "span": { + "offset": 3853, + "length": 4 + }, + "confidence": 0.989, + "source": "D(1,2.3774,5.9496,2.5646,5.9496,2.5646,6.0788,2.3774,6.0786)" + }, + { + "content": ")", + "span": { + "offset": 3857, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,2.5688,5.9496,2.6029,5.9496,2.6029,6.0788,2.5688,6.0788)" + }, + { + "content": ".", + "span": { + "offset": 3858, + "length": 1 + }, + "confidence": 0.991, + "source": "D(1,2.6071,5.9496,2.6284,5.9496,2.6284,6.0788,2.6071,6.0788)" + }, + { + "content": "Attach", + "span": { + "offset": 3860, + "length": 6 + }, + "confidence": 0.972, + "source": "D(1,2.6603,5.9496,2.9814,5.9496,2.9814,6.0791,2.6603,6.0789)" + }, + { + "content": "Schedule", + "span": { + "offset": 3867, + "length": 8 + }, + "confidence": 0.982, + "source": "D(1,3.0154,5.9496,3.4875,5.95,3.4875,6.0791,3.0154,6.0791)" + }, + { + "content": "D", + "span": { + "offset": 3876, + "length": 1 + }, + "confidence": 0.977, + "source": "D(1,3.5151,5.95,3.5896,5.9501,3.5896,6.0791,3.5151,6.0791)" + }, + { + "content": "if", + "span": { + "offset": 3878, + "length": 2 + }, + "confidence": 0.932, + "source": "D(1,3.6257,5.9501,3.6874,5.9502,3.6874,6.0791,3.6257,6.0791)" + }, + { + "content": "required", + "span": { + "offset": 3881, + "length": 8 + }, + "confidence": 0.523, + "source": "D(1,3.715,5.9502,4.1191,5.9505,4.1191,6.079,3.715,6.0791)" + }, + { + "content": ".", + "span": { + "offset": 3889, + "length": 1 + }, + "confidence": 0.963, + "source": "D(1,4.1254,5.9505,4.1488,5.9506,4.1488,6.079,4.1254,6.079)" + }, + { + "content": "If", + "span": { + "offset": 3891, + "length": 2 + }, + "confidence": 0.845, + "source": "D(1,4.1892,5.9506,4.253,5.9507,4.253,6.079,4.1892,6.079)" + }, + { + "content": "not", + "span": { + "offset": 3894, + "length": 3 + }, + "confidence": 0.877, + "source": "D(1,4.2785,5.9507,4.4402,5.951,4.4402,6.0787,4.2785,6.0789)" + }, + { + "content": "required", + "span": { + "offset": 3898, + "length": 8 + }, + "confidence": 0.878, + "source": "D(1,4.4721,5.9511,4.8761,5.9518,4.8761,6.0783,4.4721,6.0787)" + }, + { + "content": ",", + "span": { + "offset": 3906, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,4.8846,5.9518,4.908,5.9519,4.908,6.0782,4.8846,6.0783)" + }, + { + "content": "check", + "span": { + "offset": 3908, + "length": 5 + }, + "confidence": 0.963, + "source": "D(1,4.9399,5.952,5.2504,5.9525,5.2504,6.0778,4.9399,6.0782)" + }, + { + "content": "here", + "span": { + "offset": 3914, + "length": 4 + }, + "confidence": 0.946, + "source": "D(1,5.2738,5.9526,5.5034,5.953,5.5034,6.0775,5.2738,6.0778)" + }, + { + "content": "☐", + "span": { + "offset": 3919, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,6.458,5.9351,6.5825,5.9404,6.5825,6.0586,6.458,6.0586)" + }, + { + "content": "7", + "span": { + "offset": 3930, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,6.8149,5.9619,6.8813,5.9619,6.8813,6.0527,6.8149,6.0527)" + }, + { + "content": "3006", + "span": { + "offset": 3941, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,7.7156,5.9501,7.9646,5.9466,7.9646,6.054,7.7156,6.0575)" + }, + { + "content": "8", + "span": { + "offset": 3978, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3271,6.1284,1.408,6.1284,1.408,6.2251,1.3271,6.2251)" + }, + { + "content": "Other", + "span": { + "offset": 3980, + "length": 5 + }, + "confidence": 0.998, + "source": "D(1,1.5886,6.1233,1.8737,6.1187,1.8746,6.2404,1.5896,6.2422)" + }, + { + "content": "income", + "span": { + "offset": 3986, + "length": 6 + }, + "confidence": 0.997, + "source": "D(1,1.9044,6.1182,2.2634,6.1132,2.2641,6.2383,1.9053,6.2402)" + }, + { + "content": "from", + "span": { + "offset": 3993, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,2.2942,6.1132,2.5219,6.113,2.5224,6.2384,2.2948,6.2383)" + }, + { + "content": "Schedule", + "span": { + "offset": 3998, + "length": 8 + }, + "confidence": 0.947, + "source": "D(1,2.5547,6.113,3.0265,6.1155,3.0268,6.2401,2.5552,6.2385)" + }, + { + "content": "1", + "span": { + "offset": 4007, + "length": 1 + }, + "confidence": 0.953, + "source": "D(1,3.0614,6.116,3.1004,6.1165,3.1006,6.2407,3.0616,6.2404)" + }, + { + "content": ",", + "span": { + "offset": 4008, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,3.1147,6.1167,3.1394,6.1171,3.1395,6.241,3.1149,6.2408)" + }, + { + "content": "line", + "span": { + "offset": 4010, + "length": 4 + }, + "confidence": 0.792, + "source": "D(1,3.1804,6.1177,3.3486,6.1201,3.3486,6.2427,3.1805,6.2414)" + }, + { + "content": "9", + "span": { + "offset": 4015, + "length": 1 + }, + "confidence": 0.89, + "source": "D(1,3.3752,6.1205,3.4594,6.1217,3.4594,6.2435,3.3753,6.2429)" + }, + { + "content": "8", + "span": { + "offset": 4026, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.8149,6.1284,6.8855,6.1284,6.8855,6.2251,6.8149,6.2251)" + }, + { + "content": "4006", + "span": { + "offset": 4037, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,7.7156,6.113,7.9646,6.1164,7.9646,6.2184,7.7156,6.2136)" + }, + { + "content": "9", + "span": { + "offset": 4074, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,1.3333,6.2949,1.4018,6.2949,1.4018,6.3916,1.3333,6.3916)" + }, + { + "content": "Add", + "span": { + "offset": 4076, + "length": 3 + }, + "confidence": 0.995, + "source": "D(1,1.5865,6.2871,1.7929,6.2857,1.7929,6.404,1.5865,6.4032)" + }, + { + "content": "lines", + "span": { + "offset": 4080, + "length": 5 + }, + "confidence": 0.941, + "source": "D(1,1.8297,6.2854,2.0525,6.2839,2.0525,6.4051,1.8297,6.4042)" + }, + { + "content": "1", + "span": { + "offset": 4086, + "length": 1 + }, + "confidence": 0.878, + "source": "D(1,2.0933,6.2836,2.126,6.2834,2.126,6.4055,2.0933,6.4053)" + }, + { + "content": ",", + "span": { + "offset": 4087, + "length": 1 + }, + "confidence": 0.934, + "source": "D(1,2.1444,6.2832,2.169,6.2831,2.169,6.4056,2.1444,6.4055)" + }, + { + "content": "2b", + "span": { + "offset": 4089, + "length": 2 + }, + "confidence": 0.892, + "source": "D(1,2.2057,6.2828,2.3325,6.282,2.3325,6.4063,2.2057,6.4058)" + }, + { + "content": ",", + "span": { + "offset": 4091, + "length": 1 + }, + "confidence": 0.988, + "source": "D(1,2.3386,6.2819,2.3611,6.2818,2.3611,6.4065,2.3386,6.4064)" + }, + { + "content": "3b", + "span": { + "offset": 4093, + "length": 2 + }, + "confidence": 0.947, + "source": "D(1,2.3958,6.2815,2.5246,6.2806,2.5246,6.4071,2.3958,6.4066)" + }, + { + "content": ",", + "span": { + "offset": 4095, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,2.5266,6.2806,2.5491,6.2805,2.5491,6.4073,2.5266,6.4072)" + }, + { + "content": "4b", + "span": { + "offset": 4097, + "length": 2 + }, + "confidence": 0.958, + "source": "D(1,2.5818,6.2802,2.7126,6.2796,2.7126,6.4079,2.5818,6.4074)" + }, + { + "content": ",", + "span": { + "offset": 4099, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,2.7167,6.2796,2.7392,6.2796,2.7392,6.4079,2.7167,6.4079)" + }, + { + "content": "5b", + "span": { + "offset": 4101, + "length": 2 + }, + "confidence": 0.954, + "source": "D(1,2.7739,6.2796,2.9006,6.2798,2.9006,6.4082,2.7739,6.408)" + }, + { + "content": ",", + "span": { + "offset": 4103, + "length": 1 + }, + "confidence": 0.99, + "source": "D(1,2.9047,6.2798,2.9292,6.2799,2.9292,6.4082,2.9047,6.4082)" + }, + { + "content": "6b", + "span": { + "offset": 4105, + "length": 2 + }, + "confidence": 0.943, + "source": "D(1,2.966,6.2799,3.0927,6.2801,3.0927,6.4084,2.966,6.4083)" + }, + { + "content": ",", + "span": { + "offset": 4107, + "length": 1 + }, + "confidence": 0.984, + "source": "D(1,3.0968,6.2801,3.1193,6.2802,3.1193,6.4085,3.0968,6.4084)" + }, + { + "content": "7", + "span": { + "offset": 4109, + "length": 1 + }, + "confidence": 0.945, + "source": "D(1,3.154,6.2802,3.2113,6.2803,3.2113,6.4086,3.154,6.4085)" + }, + { + "content": ",", + "span": { + "offset": 4110, + "length": 1 + }, + "confidence": 0.983, + "source": "D(1,3.2174,6.2803,3.2399,6.2803,3.2399,6.4086,3.2174,6.4086)" + }, + { + "content": "and", + "span": { + "offset": 4112, + "length": 3 + }, + "confidence": 0.849, + "source": "D(1,3.2787,6.2804,3.4606,6.2807,3.4606,6.409,3.2787,6.4087)" + }, + { + "content": "8", + "span": { + "offset": 4116, + "length": 1 + }, + "confidence": 0.859, + "source": "D(1,3.4974,6.2807,3.5567,6.2808,3.5567,6.4091,3.4974,6.409)" + }, + { + "content": ".", + "span": { + "offset": 4117, + "length": 1 + }, + "confidence": 0.961, + "source": "D(1,3.5628,6.2808,3.5853,6.2809,3.5853,6.4092,3.5628,6.4091)" + }, + { + "content": "This", + "span": { + "offset": 4119, + "length": 4 + }, + "confidence": 0.71, + "source": "D(1,3.62,6.2809,3.8264,6.2815,3.8264,6.4094,3.62,6.4092)" + }, + { + "content": "is", + "span": { + "offset": 4124, + "length": 2 + }, + "confidence": 0.991, + "source": "D(1,3.8612,6.2819,3.9388,6.2826,3.9388,6.4092,3.8612,6.4094)" + }, + { + "content": "your", + "span": { + "offset": 4127, + "length": 4 + }, + "confidence": 0.976, + "source": "D(1,3.9675,6.2829,4.1923,6.2851,4.1923,6.4089,3.9674,6.4092)" + }, + { + "content": "total", + "span": { + "offset": 4132, + "length": 5 + }, + "confidence": 0.942, + "source": "D(1,4.2168,6.2854,4.4539,6.2877,4.4538,6.4086,4.2168,6.4089)" + }, + { + "content": "income", + "span": { + "offset": 4138, + "length": 6 + }, + "confidence": 0.822, + "source": "D(1,4.4886,6.288,4.8892,6.292,4.8892,6.408,4.4886,6.4085)" + }, + { + "content": "9", + "span": { + "offset": 4154, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,6.8232,6.2949,6.8813,6.2949,6.8813,6.3916,6.8232,6.3916)" + }, + { + "content": "46708", + "span": { + "offset": 4165, + "length": 5 + }, + "confidence": 0.95, + "source": "D(1,7.6616,6.2715,7.9646,6.2747,7.9646,6.3821,7.6616,6.3789)" + }, + { + "content": "10", + "span": { + "offset": 4203, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2762,6.4614,1.4018,6.4614,1.4018,6.5581,1.2762,6.5581)" + }, + { + "content": "Adjustments", + "span": { + "offset": 4206, + "length": 11 + }, + "confidence": 0.994, + "source": "D(1,1.5854,6.447,2.2182,6.4601,2.2188,6.5783,1.5865,6.5652)" + }, + { + "content": "to", + "span": { + "offset": 4218, + "length": 2 + }, + "confidence": 0.996, + "source": "D(1,2.2457,6.4602,2.3456,6.4604,2.346,6.5785,2.2462,6.5784)" + }, + { + "content": "income", + "span": { + "offset": 4221, + "length": 6 + }, + "confidence": 0.994, + "source": "D(1,2.3789,6.4604,2.7414,6.4502,2.7414,6.5684,2.3793,6.5786)" + }, + { + "content": ":", + "span": { + "offset": 4227, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,2.7433,6.4502,2.7766,6.4492,2.7766,6.5674,2.7433,6.5683)" + }, + { + "content": "6455", + "span": { + "offset": 4272, + "length": 4 + }, + "confidence": 0.999, + "source": "D(1,7.7156,6.9505,7.9687,6.9494,7.9687,7.0566,7.7156,7.056)" + }, + { + "content": "a", + "span": { + "offset": 4309, + "length": 1 + }, + "confidence": 0.965, + "source": "D(1,1.3935,6.644,1.4672,6.644,1.4672,6.7298,1.3935,6.7283)" + }, + { + "content": "From", + "span": { + "offset": 4311, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,1.5865,6.6226,1.8428,6.6226,1.8428,6.7407,1.5865,6.7407)" + }, + { + "content": "Schedule", + "span": { + "offset": 4316, + "length": 8 + }, + "confidence": 0.991, + "source": "D(1,1.8761,6.6226,2.3477,6.6226,2.3477,6.7407,1.8761,6.7407)" + }, + { + "content": "1", + "span": { + "offset": 4325, + "length": 1 + }, + "confidence": 0.975, + "source": "D(1,2.381,6.6226,2.4201,6.6226,2.4201,6.7407,2.381,6.7407)" + }, + { + "content": ",", + "span": { + "offset": 4326, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,2.4377,6.6226,2.4632,6.6226,2.4632,6.7407,2.4377,6.7407)" + }, + { + "content": "line", + "span": { + "offset": 4328, + "length": 4 + }, + "confidence": 0.948, + "source": "D(1,2.4984,6.6226,2.6706,6.6226,2.6706,6.7407,2.4984,6.7407)" + }, + { + "content": "22", + "span": { + "offset": 4333, + "length": 2 + }, + "confidence": 0.974, + "source": "D(1,2.696,6.6226,2.8389,6.6226,2.8389,6.7407,2.696,6.7407)" + }, + { + "content": "10a", + "span": { + "offset": 4345, + "length": 3 + }, + "confidence": 0.989, + "source": "D(1,5.4453,6.6333,5.6445,6.6333,5.6445,6.73,5.4453,6.73)" + }, + { + "content": "6538", + "span": { + "offset": 4358, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,6.4041,6.6172,6.6655,6.6172,6.6655,6.7246,6.4041,6.7246)" + }, + { + "content": "b", + "span": { + "offset": 4395, + "length": 1 + }, + "confidence": 0.979, + "source": "D(1,1.3914,6.8052,1.4641,6.8052,1.4641,6.9019,1.3914,6.9019)" + }, + { + "content": "Charitable", + "span": { + "offset": 4397, + "length": 10 + }, + "confidence": 0.997, + "source": "D(1,1.5875,6.7944,2.0867,6.7941,2.0876,6.9126,1.5886,6.9126)" + }, + { + "content": "contributions", + "span": { + "offset": 4408, + "length": 13 + }, + "confidence": 0.998, + "source": "D(1,2.1162,6.7941,2.7432,6.7938,2.7439,6.9126,2.1171,6.9126)" + }, + { + "content": "if", + "span": { + "offset": 4422, + "length": 2 + }, + "confidence": 0.998, + "source": "D(1,2.7786,6.7938,2.8434,6.7937,2.8441,6.9126,2.7793,6.9126)" + }, + { + "content": "you", + "span": { + "offset": 4425, + "length": 3 + }, + "confidence": 0.985, + "source": "D(1,2.8611,6.7937,3.0341,6.7938,3.0347,6.9126,2.8618,6.9126)" + }, + { + "content": "take", + "span": { + "offset": 4429, + "length": 4 + }, + "confidence": 0.982, + "source": "D(1,3.0695,6.7938,3.2778,6.7938,3.2784,6.9126,3.0701,6.9126)" + }, + { + "content": "the", + "span": { + "offset": 4434, + "length": 3 + }, + "confidence": 0.984, + "source": "D(1,3.3053,6.7938,3.4567,6.7938,3.4572,6.9126,3.3059,6.9126)" + }, + { + "content": "standard", + "span": { + "offset": 4438, + "length": 8 + }, + "confidence": 0.985, + "source": "D(1,3.4861,6.7938,3.9087,6.7939,3.9091,6.9126,3.4867,6.9126)" + }, + { + "content": "deduction", + "span": { + "offset": 4447, + "length": 9 + }, + "confidence": 0.913, + "source": "D(1,3.9421,6.7939,4.4237,6.7942,4.4239,6.9126,3.9425,6.9126)" + }, + { + "content": ".", + "span": { + "offset": 4456, + "length": 1 + }, + "confidence": 0.984, + "source": "D(1,4.4296,6.7942,4.4512,6.7943,4.4514,6.9126,4.4298,6.9126)" + }, + { + "content": "See", + "span": { + "offset": 4458, + "length": 3 + }, + "confidence": 0.873, + "source": "D(1,4.4866,6.7943,4.6733,6.7944,4.6734,6.9126,4.4868,6.9126)" + }, + { + "content": "instructions", + "span": { + "offset": 4462, + "length": 12 + }, + "confidence": 0.923, + "source": "D(1,4.7047,6.7945,5.2668,6.7949,5.2668,6.9126,4.7049,6.9126)" + }, + { + "content": "10b", + "span": { + "offset": 4484, + "length": 3 + }, + "confidence": 0.965, + "source": "D(1,5.4453,6.8007,5.6445,6.7933,5.6445,6.8963,5.4453,6.9092)" + }, + { + "content": "6536", + "span": { + "offset": 4497, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,6.4041,6.7837,6.6655,6.7837,6.6655,6.8911,6.4041,6.8911)" + }, + { + "content": "c", + "span": { + "offset": 4534, + "length": 1 + }, + "confidence": 1, + "source": "D(1,1.4042,6.9925,1.4609,6.9925,1.4609,7.053,1.4042,7.053)" + }, + { + "content": "Add", + "span": { + "offset": 4536, + "length": 3 + }, + "confidence": 0.972, + "source": "D(1,1.5813,6.9554,1.7929,6.9551,1.7948,7.0729,1.5834,7.0719)" + }, + { + "content": "lines", + "span": { + "offset": 4540, + "length": 5 + }, + "confidence": 0.903, + "source": "D(1,1.8268,6.955,2.0464,6.9546,2.0481,7.0742,1.8287,7.0731)" + }, + { + "content": "10a", + "span": { + "offset": 4546, + "length": 3 + }, + "confidence": 0.878, + "source": "D(1,2.0863,6.9546,2.2619,6.9543,2.2636,7.0752,2.088,7.0743)" + }, + { + "content": "and", + "span": { + "offset": 4550, + "length": 3 + }, + "confidence": 0.911, + "source": "D(1,2.2919,6.9542,2.4735,6.9539,2.475,7.0763,2.2935,7.0754)" + }, + { + "content": "10b", + "span": { + "offset": 4554, + "length": 3 + }, + "confidence": 0.657, + "source": "D(1,2.5174,6.9538,2.699,6.9535,2.7004,7.0774,2.5189,7.0765)" + }, + { + "content": ".", + "span": { + "offset": 4557, + "length": 1 + }, + "confidence": 0.948, + "source": "D(1,2.703,6.9535,2.725,6.9534,2.7264,7.0775,2.7044,7.0774)" + }, + { + "content": "These", + "span": { + "offset": 4559, + "length": 5 + }, + "confidence": 0.812, + "source": "D(1,2.7589,6.9535,3.0643,6.9542,3.0655,7.0782,2.7603,7.0776)" + }, + { + "content": "are", + "span": { + "offset": 4565, + "length": 3 + }, + "confidence": 0.987, + "source": "D(1,3.0922,6.9543,3.2499,6.9547,3.251,7.0786,3.0934,7.0783)" + }, + { + "content": "your", + "span": { + "offset": 4569, + "length": 4 + }, + "confidence": 0.975, + "source": "D(1,3.2779,6.9548,3.5074,6.9553,3.5083,7.0791,3.2789,7.0786)" + }, + { + "content": "total", + "span": { + "offset": 4574, + "length": 5 + }, + "confidence": 0.974, + "source": "D(1,3.5313,6.9554,3.7649,6.9559,3.7656,7.0796,3.5322,7.0791)" + }, + { + "content": "adjustments", + "span": { + "offset": 4580, + "length": 11 + }, + "confidence": 0.903, + "source": "D(1,3.7988,6.956,4.4555,6.96,4.4558,7.0793,3.7995,7.0797)" + }, + { + "content": "to", + "span": { + "offset": 4592, + "length": 2 + }, + "confidence": 0.964, + "source": "D(1,4.4834,6.9602,4.5932,6.9609,4.5934,7.0792,4.4837,7.0793)" + }, + { + "content": "income", + "span": { + "offset": 4595, + "length": 6 + }, + "confidence": 0.879, + "source": "D(1,4.6291,6.9611,5.0303,6.9638,5.0303,7.0788,4.6293,7.0792)" + }, + { + "content": "10c", + "span": { + "offset": 4611, + "length": 3 + }, + "confidence": 0.986, + "source": "D(1,6.7527,6.9663,6.9478,6.9663,6.9478,7.063,6.7527,7.063)" + }, + { + "content": "11", + "span": { + "offset": 4647, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2711,7.1328,1.3987,7.1328,1.3987,7.2295,1.2711,7.2295)" + }, + { + "content": "Subtract", + "span": { + "offset": 4650, + "length": 8 + }, + "confidence": 0.993, + "source": "D(1,1.5875,7.1232,2.0227,7.1207,2.0245,7.2444,1.5896,7.2438)" + }, + { + "content": "line", + "span": { + "offset": 4659, + "length": 4 + }, + "confidence": 0.982, + "source": "D(1,2.0562,7.1205,2.2215,7.1196,2.2232,7.2446,2.058,7.2444)" + }, + { + "content": "10c", + "span": { + "offset": 4664, + "length": 3 + }, + "confidence": 0.955, + "source": "D(1,2.2592,7.1194,2.4328,7.1184,2.4344,7.2449,2.2608,7.2447)" + }, + { + "content": "from", + "span": { + "offset": 4668, + "length": 4 + }, + "confidence": 0.966, + "source": "D(1,2.4621,7.1182,2.6881,7.117,2.6895,7.2453,2.4637,7.245)" + }, + { + "content": "line", + "span": { + "offset": 4673, + "length": 4 + }, + "confidence": 0.94, + "source": "D(1,2.7258,7.1169,2.8953,7.1169,2.8965,7.2454,2.7271,7.2453)" + }, + { + "content": "9", + "span": { + "offset": 4678, + "length": 1 + }, + "confidence": 0.878, + "source": "D(1,2.9267,7.1169,2.9832,7.1168,2.9843,7.2454,2.9279,7.2454)" + }, + { + "content": ".", + "span": { + "offset": 4679, + "length": 1 + }, + "confidence": 0.95, + "source": "D(1,2.9936,7.1168,3.0145,7.1168,3.0157,7.2454,2.9948,7.2454)" + }, + { + "content": "This", + "span": { + "offset": 4681, + "length": 4 + }, + "confidence": 0.839, + "source": "D(1,3.048,7.1168,3.2573,7.1167,3.2583,7.2456,3.0492,7.2455)" + }, + { + "content": "is", + "span": { + "offset": 4686, + "length": 2 + }, + "confidence": 0.994, + "source": "D(1,3.2886,7.1167,3.3702,7.1167,3.3712,7.2456,3.2896,7.2456)" + }, + { + "content": "your", + "span": { + "offset": 4689, + "length": 4 + }, + "confidence": 0.987, + "source": "D(1,3.3954,7.1167,3.6276,7.1166,3.6284,7.2457,3.3963,7.2456)" + }, + { + "content": "adjusted", + "span": { + "offset": 4694, + "length": 8 + }, + "confidence": 0.983, + "source": "D(1,3.6485,7.1166,4.1026,7.1181,4.1031,7.2457,3.6493,7.2458)" + }, + { + "content": "gross", + "span": { + "offset": 4703, + "length": 5 + }, + "confidence": 0.978, + "source": "D(1,4.1361,7.1183,4.4353,7.1197,4.4356,7.2455,4.1365,7.2457)" + }, + { + "content": "income", + "span": { + "offset": 4709, + "length": 6 + }, + "confidence": 0.942, + "source": "D(1,4.4667,7.1199,4.8684,7.1218,4.8684,7.2454,4.4669,7.2455)" + }, + { + "content": "11", + "span": { + "offset": 4725, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.1263,6.8979,7.134,6.8979,7.2306,6.79,7.223)" + }, + { + "content": "7658", + "span": { + "offset": 4737, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,7.7156,7.1123,7.9646,7.1136,7.9646,7.2188,7.7156,7.2188)" + }, + { + "content": "12", + "span": { + "offset": 4774, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2794,7.2939,1.408,7.2939,1.408,7.3906,1.2794,7.3906)" + }, + { + "content": "Standard", + "span": { + "offset": 4777, + "length": 8 + }, + "confidence": 0.995, + "source": "D(1,1.5865,7.29,2.0725,7.2867,2.0743,7.4071,1.5886,7.4055)" + }, + { + "content": "deduction", + "span": { + "offset": 4786, + "length": 9 + }, + "confidence": 0.997, + "source": "D(1,2.1058,7.2865,2.6355,7.2829,2.6369,7.4089,2.1075,7.4072)" + }, + { + "content": "or", + "span": { + "offset": 4796, + "length": 2 + }, + "confidence": 0.992, + "source": "D(1,2.6666,7.2827,2.7829,7.2826,2.7843,7.4094,2.668,7.409)" + }, + { + "content": "itemized", + "span": { + "offset": 4799, + "length": 8 + }, + "confidence": 0.968, + "source": "D(1,2.812,7.2826,3.2586,7.2825,3.2596,7.4107,2.8133,7.4094)" + }, + { + "content": "deductions", + "span": { + "offset": 4808, + "length": 10 + }, + "confidence": 0.984, + "source": "D(1,3.2898,7.2825,3.8797,7.2832,3.8803,7.4123,3.2908,7.4108)" + }, + { + "content": "(", + "span": { + "offset": 4819, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,3.913,7.2834,3.9483,7.2837,3.9488,7.4124,3.9135,7.4124)" + }, + { + "content": "from", + "span": { + "offset": 4820, + "length": 4 + }, + "confidence": 0.969, + "source": "D(1,3.94,7.2836,4.1685,7.285,4.1689,7.4129,3.9405,7.4124)" + }, + { + "content": "Schedule", + "span": { + "offset": 4825, + "length": 8 + }, + "confidence": 0.637, + "source": "D(1,4.1975,7.2852,4.6711,7.2881,4.6712,7.4141,4.1979,7.413)" + }, + { + "content": "A", + "span": { + "offset": 4834, + "length": 1 + }, + "confidence": 0.986, + "source": "D(1,4.6898,7.2883,4.7729,7.2888,4.7729,7.4143,4.6899,7.4141)" + }, + { + "content": ")", + "span": { + "offset": 4835, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,4.7604,7.2887,4.8103,7.289,4.8103,7.4144,4.7605,7.4143)" + }, + { + "content": "12", + "span": { + "offset": 4846, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.2939,6.9146,7.2939,6.9146,7.3906,6.79,7.3906)" + }, + { + "content": "3427", + "span": { + "offset": 4858, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,7.7156,7.2778,7.9563,7.2778,7.9563,7.3853,7.7156,7.3853)" + }, + { + "content": "13", + "span": { + "offset": 4895, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2721,7.4614,1.408,7.4621,1.408,7.5588,1.2721,7.558)" + }, + { + "content": "Qualified", + "span": { + "offset": 4898, + "length": 9 + }, + "confidence": 0.998, + "source": "D(1,1.5875,7.4494,2.022,7.4525,2.0238,7.5707,1.5896,7.5676)" + }, + { + "content": "business", + "span": { + "offset": 4908, + "length": 8 + }, + "confidence": 0.999, + "source": "D(1,2.0613,7.4528,2.4997,7.456,2.5012,7.5741,2.0631,7.571)" + }, + { + "content": "income", + "span": { + "offset": 4917, + "length": 6 + }, + "confidence": 0.998, + "source": "D(1,2.5331,7.4562,2.9007,7.4579,2.902,7.5761,2.5346,7.5744)" + }, + { + "content": "deduction", + "span": { + "offset": 4924, + "length": 9 + }, + "confidence": 0.984, + "source": "D(1,2.9302,7.4578,3.4275,7.4569,3.4285,7.5751,2.9314,7.576)" + }, + { + "content": ".", + "span": { + "offset": 4933, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,3.4334,7.4569,3.4551,7.4569,3.456,7.575,3.4344,7.5751)" + }, + { + "content": "Attach", + "span": { + "offset": 4935, + "length": 6 + }, + "confidence": 0.967, + "source": "D(1,3.4826,7.4568,3.805,7.4562,3.8057,7.5744,3.4835,7.575)" + }, + { + "content": "Form", + "span": { + "offset": 4942, + "length": 4 + }, + "confidence": 0.964, + "source": "D(1,3.8404,7.4562,4.0979,7.4548,4.0985,7.5729,3.8411,7.5743)" + }, + { + "content": "8995", + "span": { + "offset": 4947, + "length": 4 + }, + "confidence": 0.526, + "source": "D(1,4.1333,7.4544,4.379,7.4517,4.3794,7.5699,4.1338,7.5726)" + }, + { + "content": "or", + "span": { + "offset": 4952, + "length": 2 + }, + "confidence": 0.778, + "source": "D(1,4.4104,7.4514,4.5166,7.4502,4.517,7.5684,4.4109,7.5695)" + }, + { + "content": "Form", + "span": { + "offset": 4955, + "length": 4 + }, + "confidence": 0.519, + "source": "D(1,4.5441,7.4499,4.7977,7.4471,4.7979,7.5653,4.5445,7.5681)" + }, + { + "content": "8995", + "span": { + "offset": 4960, + "length": 4 + }, + "confidence": 0.779, + "source": "D(1,4.8311,7.4468,5.0827,7.444,5.0828,7.5622,4.8313,7.5649)" + }, + { + "content": "-", + "span": { + "offset": 4964, + "length": 1 + }, + "confidence": 0.996, + "source": "D(1,5.0827,7.444,5.122,7.4436,5.1221,7.5618,5.0828,7.5622)" + }, + { + "content": "A", + "span": { + "offset": 4965, + "length": 1 + }, + "confidence": 0.993, + "source": "D(1,5.1181,7.4437,5.2046,7.4427,5.2046,7.5609,5.1181,7.5618)" + }, + { + "content": "13", + "span": { + "offset": 4976, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.4604,6.9062,7.4604,6.9062,7.5571,6.79,7.5571)" + }, + { + "content": "8009", + "span": { + "offset": 4988, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,7.7156,7.4437,7.9646,7.4466,7.9646,7.5509,7.7156,7.5525)" + }, + { + "content": "14", + "span": { + "offset": 5025, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2742,7.6402,1.408,7.6383,1.408,7.7317,1.2742,7.7306)" + }, + { + "content": "Add", + "span": { + "offset": 5028, + "length": 3 + }, + "confidence": 0.997, + "source": "D(1,1.5865,7.6262,1.7986,7.627,1.7985,7.7427,1.5865,7.7397)" + }, + { + "content": "lines", + "span": { + "offset": 5032, + "length": 5 + }, + "confidence": 0.985, + "source": "D(1,1.8339,7.6272,2.0519,7.626,2.0518,7.7436,1.8339,7.7433)" + }, + { + "content": "12", + "span": { + "offset": 5038, + "length": 2 + }, + "confidence": 0.981, + "source": "D(1,2.0912,7.6256,2.2051,7.6243,2.205,7.7426,2.0911,7.7434)" + }, + { + "content": "and", + "span": { + "offset": 5041, + "length": 3 + }, + "confidence": 0.954, + "source": "D(1,2.2366,7.624,2.425,7.6193,2.425,7.7374,2.2365,7.7423)" + }, + { + "content": "13", + "span": { + "offset": 5045, + "length": 2 + }, + "confidence": 0.991, + "source": "D(1,2.4643,7.6183,2.5919,7.615,2.5919,7.7327,2.4643,7.7363)" + }, + { + "content": "14", + "span": { + "offset": 5057, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.6377,6.9146,7.6377,6.9146,7.7344,6.79,7.7344)" + }, + { + "content": "6008", + "span": { + "offset": 5069, + "length": 4 + }, + "confidence": 0.998, + "source": "D(1,7.7156,7.6154,7.9646,7.6159,7.9646,7.7203,7.7156,7.718)" + }, + { + "content": "15", + "span": { + "offset": 5106, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,1.2752,7.7782,1.407,7.784,1.407,7.8807,1.2752,7.8748)" + }, + { + "content": "Taxable", + "span": { + "offset": 5109, + "length": 7 + }, + "confidence": 0.995, + "source": "D(1,1.5865,7.7752,2.0075,7.7738,2.0075,7.8901,1.5865,7.89)" + }, + { + "content": "income", + "span": { + "offset": 5117, + "length": 6 + }, + "confidence": 0.958, + "source": "D(1,2.0423,7.7737,2.4227,7.7725,2.4227,7.8901,2.0423,7.8901)" + }, + { + "content": ".", + "span": { + "offset": 5123, + "length": 1 + }, + "confidence": 0.938, + "source": "D(1,2.4305,7.7725,2.4536,7.7725,2.4536,7.8901,2.4305,7.8901)" + }, + { + "content": "Subtract", + "span": { + "offset": 5125, + "length": 8 + }, + "confidence": 0.925, + "source": "D(1,2.4903,7.7723,2.9229,7.7717,2.9229,7.8903,2.4903,7.8902)" + }, + { + "content": "line", + "span": { + "offset": 5134, + "length": 4 + }, + "confidence": 0.985, + "source": "D(1,2.9538,7.7717,3.1219,7.7719,3.1218,7.8905,2.9538,7.8903)" + }, + { + "content": "14", + "span": { + "offset": 5139, + "length": 2 + }, + "confidence": 0.939, + "source": "D(1,3.1585,7.772,3.2764,7.7721,3.2764,7.8906,3.1585,7.8905)" + }, + { + "content": "from", + "span": { + "offset": 5142, + "length": 4 + }, + "confidence": 0.936, + "source": "D(1,3.3034,7.7722,3.5294,7.7724,3.5293,7.8908,3.3034,7.8906)" + }, + { + "content": "line", + "span": { + "offset": 5147, + "length": 4 + }, + "confidence": 0.946, + "source": "D(1,3.5661,7.7725,3.736,7.7727,3.736,7.8909,3.566,7.8908)" + }, + { + "content": "11", + "span": { + "offset": 5152, + "length": 2 + }, + "confidence": 0.857, + "source": "D(1,3.7746,7.7727,3.8751,7.7729,3.875,7.891,3.7746,7.891)" + }, + { + "content": ".", + "span": { + "offset": 5154, + "length": 1 + }, + "confidence": 0.934, + "source": "D(1,3.8924,7.7729,3.9175,7.7729,3.9175,7.8911,3.8924,7.8911)" + }, + { + "content": "If", + "span": { + "offset": 5156, + "length": 2 + }, + "confidence": 0.753, + "source": "D(1,3.9523,7.773,4.0238,7.7734,4.0238,7.8912,3.9523,7.8911)" + }, + { + "content": "zero", + "span": { + "offset": 5159, + "length": 4 + }, + "confidence": 0.848, + "source": "D(1,4.0431,7.7735,4.2594,7.7748,4.2594,7.8915,4.0431,7.8912)" + }, + { + "content": "or", + "span": { + "offset": 5164, + "length": 2 + }, + "confidence": 0.949, + "source": "D(1,4.2883,7.7749,4.3965,7.7755,4.3965,7.8917,4.2883,7.8916)" + }, + { + "content": "less", + "span": { + "offset": 5167, + "length": 4 + }, + "confidence": 0.879, + "source": "D(1,4.4216,7.7757,4.6128,7.7767,4.6128,7.892,4.4216,7.8917)" + }, + { + "content": ",", + "span": { + "offset": 5171, + "length": 1 + }, + "confidence": 0.997, + "source": "D(1,4.6147,7.7767,4.6398,7.7769,4.6398,7.892,4.6147,7.892)" + }, + { + "content": "enter", + "span": { + "offset": 5173, + "length": 5 + }, + "confidence": 0.952, + "source": "D(1,4.6727,7.7771,4.9392,7.7786,4.9392,7.8924,4.6727,7.8921)" + }, + { + "content": "-", + "span": { + "offset": 5179, + "length": 1 + }, + "confidence": 0.985, + "source": "D(1,4.9585,7.7787,5.001,7.7789,5.001,7.8925,4.9585,7.8925)" + }, + { + "content": "0", + "span": { + "offset": 5180, + "length": 1 + }, + "confidence": 0.971, + "source": "D(1,5.001,7.7789,5.0647,7.7793,5.0647,7.8926,5.001,7.8925)" + }, + { + "content": "-", + "span": { + "offset": 5181, + "length": 1 + }, + "confidence": 0.995, + "source": "D(1,5.0666,7.7793,5.1091,7.7795,5.1091,7.8927,5.0666,7.8926)" + }, + { + "content": "15", + "span": { + "offset": 5192, + "length": 2 + }, + "confidence": 0.999, + "source": "D(1,6.79,7.7827,6.9062,7.7827,6.9062,7.8794,6.79,7.8794)" + }, + { + "content": "1055", + "span": { + "offset": 5204, + "length": 4 + }, + "confidence": 0.997, + "source": "D(1,7.7239,7.7764,7.9646,7.773,7.9646,7.875,7.7239,7.8785)" + }, + { + "content": "For", + "span": { + "offset": 5248, + "length": 3 + }, + "confidence": 0.969, + "source": "D(1,0.4879,7.9662,0.6523,7.966,0.6536,8.0813,0.4892,8.081)" + }, + { + "content": "Disclosure", + "span": { + "offset": 5252, + "length": 10 + }, + "confidence": 0.973, + "source": "D(1,0.6755,7.966,1.1668,7.9655,1.1679,8.0821,0.6768,8.0813)" + }, + { + "content": ",", + "span": { + "offset": 5262, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.1668,7.9655,1.19,7.9654,1.1911,8.0822,1.1679,8.0821)" + }, + { + "content": "Privacy", + "span": { + "offset": 5264, + "length": 7 + }, + "confidence": 0.944, + "source": "D(1,1.2249,7.9654,1.5672,7.965,1.5682,8.0828,1.2259,8.0822)" + }, + { + "content": "Act", + "span": { + "offset": 5272, + "length": 3 + }, + "confidence": 0.935, + "source": "D(1,1.5846,7.965,1.749,7.9648,1.7499,8.0831,1.5856,8.0828)" + }, + { + "content": ",", + "span": { + "offset": 5275, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,1.7471,7.9648,1.7703,7.9648,1.7712,8.0831,1.748,8.0831)" + }, + { + "content": "and", + "span": { + "offset": 5277, + "length": 3 + }, + "confidence": 0.99, + "source": "D(1,1.7974,7.9648,1.9676,7.9647,1.9684,8.0834,1.7983,8.0831)" + }, + { + "content": "Paperwork", + "span": { + "offset": 5281, + "length": 9 + }, + "confidence": 0.964, + "source": "D(1,2.0024,7.9647,2.515,7.9651,2.5156,8.0836,2.0032,8.0834)" + }, + { + "content": "Reduction", + "span": { + "offset": 5291, + "length": 9 + }, + "confidence": 0.947, + "source": "D(1,2.5382,7.9651,3.0043,7.9655,3.0048,8.0838,2.5388,8.0836)" + }, + { + "content": "Act", + "span": { + "offset": 5301, + "length": 3 + }, + "confidence": 0.927, + "source": "D(1,3.0294,7.9656,3.1977,7.9657,3.1982,8.0839,3.03,8.0838)" + }, + { + "content": "Notice", + "span": { + "offset": 5305, + "length": 6 + }, + "confidence": 0.888, + "source": "D(1,3.219,7.9657,3.5207,7.9663,3.5211,8.0838,3.2195,8.0839)" + }, + { + "content": ",", + "span": { + "offset": 5311, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,3.5227,7.9663,3.5459,7.9663,3.5462,8.0838,3.523,8.0838)" + }, + { + "content": "see", + "span": { + "offset": 5313, + "length": 3 + }, + "confidence": 0.89, + "source": "D(1,3.5768,7.9664,3.7393,7.9668,3.7396,8.0837,3.5772,8.0838)" + }, + { + "content": "separate", + "span": { + "offset": 5317, + "length": 8 + }, + "confidence": 0.922, + "source": "D(1,3.7664,7.9669,4.1745,7.968,4.1747,8.0834,3.7667,8.0837)" + }, + { + "content": "instructions", + "span": { + "offset": 5326, + "length": 12 + }, + "confidence": 0.923, + "source": "D(1,4.2035,7.9681,4.7528,7.9696,4.7528,8.0829,4.2037,8.0833)" + }, + { + "content": ".", + "span": { + "offset": 5338, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,4.7547,7.9696,4.7896,7.9697,4.7896,8.0829,4.7547,8.0829)" + }, + { + "content": "Cat", + "span": { + "offset": 5362, + "length": 3 + }, + "confidence": 0.907, + "source": "D(1,5.6777,7.9761,5.8173,7.9761,5.8173,8.0674,5.6777,8.0674)" + }, + { + "content": ".", + "span": { + "offset": 5365, + "length": 1 + }, + "confidence": 0.958, + "source": "D(1,5.8157,7.9761,5.8339,7.9761,5.8339,8.0674,5.8157,8.0674)" + }, + { + "content": "No", + "span": { + "offset": 5367, + "length": 2 + }, + "confidence": 0.914, + "source": "D(1,5.8597,7.9761,5.9643,7.9761,5.9643,8.0674,5.8597,8.0674)" + }, + { + "content": ".", + "span": { + "offset": 5369, + "length": 1 + }, + "confidence": 0.998, + "source": "D(1,5.9674,7.9761,5.9856,7.9761,5.9856,8.0674,5.9674,8.0674)" + }, + { + "content": "11320B", + "span": { + "offset": 5371, + "length": 6 + }, + "confidence": 0.934, + "source": "D(1,6.0144,7.9761,6.3086,7.9761,6.3086,8.0674,6.0144,8.0674)" + }, + { + "content": "Form", + "span": { + "offset": 5400, + "length": 4 + }, + "confidence": 0.995, + "source": "D(1,7.2092,7.9576,7.4134,7.9591,7.4134,8.0762,7.2092,8.0722)" + }, + { + "content": "1040", + "span": { + "offset": 5405, + "length": 4 + }, + "confidence": 0.986, + "source": "D(1,7.457,7.9594,7.7245,7.9603,7.7245,8.0793,7.457,8.0771)" + }, + { + "content": "(", + "span": { + "offset": 5410, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.7522,7.9603,7.7879,7.9603,7.7879,8.0791,7.7523,8.0793)" + }, + { + "content": "2020", + "span": { + "offset": 5411, + "length": 4 + }, + "confidence": 0.994, + "source": "D(1,7.776,7.9603,7.9722,7.9601,7.9722,8.0783,7.7761,8.0792)" + }, + { + "content": ")", + "span": { + "offset": 5415, + "length": 1 + }, + "confidence": 0.999, + "source": "D(1,7.9623,7.9601,8.002,7.9601,8.002,8.0781,7.9623,8.0783)" + } + ], + "lines": [ + { + "content": "Form", + "source": "D(1,0.4981,0.7755,0.5084,0.5259,0.5977,0.5279,0.5883,0.7791)", + "span": { + "offset": 17, + "length": 4 + } + }, + { + "content": "1040", + "source": "D(1,0.6023,0.5018,1.2576,0.5018,1.2576,0.7684,0.6023,0.7684)", + "span": { + "offset": 22, + "length": 4 + } + }, + { + "content": "Department of the Treasury-Internal Revenue Service", + "source": "D(1,1.3427,0.5222,3.3951,0.5228,3.395,0.6252,1.3426,0.6246)", + "span": { + "offset": 49, + "length": 51 + } + }, + { + "content": "(99)", + "source": "D(1,3.7354,0.5157,3.9098,0.5191,3.9076,0.6311,3.7354,0.6278)", + "span": { + "offset": 101, + "length": 4 + } + }, + { + "content": "U.S. Individual Income Tax Return", + "source": "D(1,1.3489,0.6434,3.8954,0.6473,3.8951,0.8005,1.3486,0.7966)", + "span": { + "offset": 106, + "length": 33 + } + }, + { + "content": "2020", + "source": "D(1,4.1296,0.5311,4.8685,0.5315,4.8684,0.7729,4.1295,0.7726)", + "span": { + "offset": 162, + "length": 4 + } + }, + { + "content": "OMB No. 1545-0074", + "source": "D(1,4.939,0.6876,5.8521,0.6878,5.8521,0.7883,4.9389,0.7881)", + "span": { + "offset": 189, + "length": 17 + } + }, + { + "content": "IRS Use Only-Do not write or staple in this space.", + "source": "D(1,5.9849,0.6983,7.8901,0.7027,7.8899,0.807,5.9846,0.8026)", + "span": { + "offset": 229, + "length": 50 + } + }, + { + "content": "Filing Status", + "source": "D(1,0.4923,0.9131,1.2516,0.9148,1.2513,1.0546,0.492,1.053)", + "span": { + "offset": 286, + "length": 13 + } + }, + { + "content": "Check only", + "source": "D(1,0.4926,1.0765,1.0552,1.0817,1.0542,1.1989,0.4915,1.1937)", + "span": { + "offset": 300, + "length": 10 + } + }, + { + "content": "one box.", + "source": "D(1,0.4908,1.204,0.9324,1.2044,0.9323,1.3025,0.4907,1.302)", + "span": { + "offset": 311, + "length": 8 + } + }, + { + "content": "☐", + "source": "D(1,1.3209,0.9393,1.4454,0.9373,1.4454,1.0621,1.3209,1.0641)", + "span": { + "offset": 321, + "length": 1 + } + }, + { + "content": "Single", + "source": "D(1,1.4931,0.9422,1.8137,0.9422,1.8137,1.0619,1.4931,1.0619)", + "span": { + "offset": 323, + "length": 6 + } + }, + { + "content": "☑", + "source": "D(1,1.9227,0.9406,2.043,0.9406,2.043,1.0628,1.9227,1.0621)", + "span": { + "offset": 330, + "length": 1 + } + }, + { + "content": "Married filing jointly", + "source": "D(1,2.0845,0.9341,3.0701,0.9412,3.0692,1.0678,2.0836,1.0607)", + "span": { + "offset": 332, + "length": 22 + } + }, + { + "content": "☐", + "source": "D(1,3.2207,0.9393,3.3452,0.9393,3.3452,1.0635,3.2207,1.0635)", + "span": { + "offset": 355, + "length": 1 + } + }, + { + "content": "Married filing separately (MFS)", + "source": "D(1,3.3867,0.9368,4.8975,0.9372,4.8975,1.065,3.3867,1.0646)", + "span": { + "offset": 357, + "length": 31 + } + }, + { + "content": "☐", + "source": "D(1,5.0178,0.9379,5.1423,0.9379,5.1423,1.0648,5.0178,1.0648)", + "span": { + "offset": 389, + "length": 1 + } + }, + { + "content": "Head of household (HOH)", + "source": "D(1,5.188,0.935,6.3999,0.9353,6.3999,1.06,5.188,1.0597)", + "span": { + "offset": 391, + "length": 23 + } + }, + { + "content": "☐", + "source": "D(1,6.5203,0.9386,6.6448,0.9386,6.6448,1.0648,6.5203,1.0648)", + "span": { + "offset": 415, + "length": 1 + } + }, + { + "content": "Qualifying widow(er) (QW)", + "source": "D(1,6.6863,0.9337,7.9771,0.9337,7.9771,1.0693,6.6863,1.0694)", + "span": { + "offset": 417, + "length": 25 + } + }, + { + "content": "If you checked the MFS box, enter the name of your spouse. If you checked the HOH or QW box, enter the child's name if the qualifying", + "source": "D(1,1.3167,1.1128,7.9854,1.1129,7.9854,1.2389,1.3167,1.2388)", + "span": { + "offset": 444, + "length": 133 + } + }, + { + "content": "person is a child but not your dependent", + "source": "D(1,1.3146,1.261,3.3224,1.259,3.3225,1.3817,1.3148,1.3837)", + "span": { + "offset": 578, + "length": 40 + } + }, + { + "content": "Your first name and middle initial", + "source": "D(1,0.5421,1.4434,1.9849,1.4434,1.9849,1.5522,0.5421,1.5522)", + "span": { + "offset": 620, + "length": 34 + } + }, + { + "content": "Anthony", + "source": "D(1,0.5185,1.5983,0.9805,1.5989,0.9803,1.7247,0.5183,1.724)", + "span": { + "offset": 655, + "length": 7 + } + }, + { + "content": "Last name", + "source": "D(1,3.3452,1.4492,3.8105,1.4512,3.8101,1.5479,3.3448,1.5459)", + "span": { + "offset": 664, + "length": 9 + } + }, + { + "content": "Kelly", + "source": "D(1,3.3369,1.5999,3.6096,1.6014,3.6088,1.7241,3.3369,1.7223)", + "span": { + "offset": 674, + "length": 5 + } + }, + { + "content": "Your social security number", + "source": "D(1,6.545,1.4456,7.8567,1.4438,7.8568,1.5541,6.5452,1.5559)", + "span": { + "offset": 681, + "length": 27 + } + }, + { + "content": "980 9 7 0 2 0 0", + "source": "D(1,6.5535,1.5764,7.9647,1.5777,7.9646,1.7272,6.5533,1.7264)", + "span": { + "offset": 709, + "length": 15 + } + }, + { + "content": "If joint return, spouse's first name and middle initial", + "source": "D(1,0.5421,1.7791,2.7745,1.7715,2.775,1.8855,0.5426,1.8933)", + "span": { + "offset": 726, + "length": 55 + } + }, + { + "content": "Lauren", + "source": "D(1,0.5209,1.9321,0.9025,1.9333,0.9022,2.0411,0.5205,2.0399)", + "span": { + "offset": 782, + "length": 6 + } + }, + { + "content": "Last name", + "source": "D(1,3.3431,1.7797,3.8108,1.7833,3.8101,1.8806,3.3424,1.877)", + "span": { + "offset": 790, + "length": 9 + } + }, + { + "content": "Watson", + "source": "D(1,3.3265,1.9321,3.746,1.9327,3.7457,2.0408,3.3263,2.0399)", + "span": { + "offset": 800, + "length": 6 + } + }, + { + "content": "Spouse's social security number", + "source": "D(1,6.5327,1.7743,8.0061,1.7743,8.0061,1.8895,6.5327,1.8895)", + "span": { + "offset": 808, + "length": 31 + } + }, + { + "content": "0 5 6 0 4 1 0 8 5", + "source": "D(1,6.5452,1.9091,7.9646,1.9091,7.9646,2.0584,6.5452,2.0584)", + "span": { + "offset": 840, + "length": 17 + } + }, + { + "content": "Home address (number and street). If you have a P.O. box, see instructions.", + "source": "D(1,0.5453,2.107,3.8516,2.1052,3.8516,2.2209,0.5453,2.2227)", + "span": { + "offset": 859, + "length": 75 + } + }, + { + "content": "10221 COMPTON LOS ANGELES CA 90002-2805 USA", + "source": "D(1,0.5274,2.2515,3.3452,2.2515,3.3452,2.373,0.5274,2.373)", + "span": { + "offset": 935, + "length": 43 + } + }, + { + "content": "Apt. no.", + "source": "D(1,5.8396,2.1144,6.2013,2.1165,6.2007,2.2188,5.839,2.2166)", + "span": { + "offset": 980, + "length": 8 + } + }, + { + "content": "10221", + "source": "D(1,5.9891,2.2587,6.2975,2.2619,6.2961,2.3746,5.9878,2.371)", + "span": { + "offset": 989, + "length": 5 + } + }, + { + "content": "City, town, or post office. If you have a foreign address, also complete spaces below.", + "source": "D(1,0.5453,2.4481,4.2542,2.4481,4.2542,2.5631,0.5453,2.5631)", + "span": { + "offset": 996, + "length": 86 + } + }, + { + "content": "615 E 80TH LOS ANGELES CA 90001-3255 USA", + "source": "D(1,0.5193,2.5919,3.0298,2.5919,3.0298,2.7134,0.5193,2.7134)", + "span": { + "offset": 1083, + "length": 40 + } + }, + { + "content": "State", + "source": "D(1,4.7397,2.4532,4.968,2.4532,4.968,2.5446,4.7397,2.5446)", + "span": { + "offset": 1125, + "length": 5 + } + }, + { + "content": "LA", + "source": "D(1,5.0593,2.5995,5.2253,2.5995,5.2253,2.7064,5.0593,2.7064)", + "span": { + "offset": 1131, + "length": 2 + } + }, + { + "content": "ZIP code", + "source": "D(1,5.6362,2.4473,6.0098,2.451,6.0098,2.5491,5.6353,2.5455)", + "span": { + "offset": 1135, + "length": 8 + } + }, + { + "content": "61500", + "source": "D(1,5.8894,2.6016,6.2007,2.6017,6.2007,2.7077,5.8894,2.7075)", + "span": { + "offset": 1144, + "length": 5 + } + }, + { + "content": "Foreign country name", + "source": "D(1,0.5442,2.7798,1.5118,2.7798,1.5118,2.8926,0.5442,2.8926)", + "span": { + "offset": 1151, + "length": 20 + } + }, + { + "content": "N/A", + "source": "D(1,0.5178,2.93,0.7274,2.9299,0.7274,3.0401,0.5178,3.0402)", + "span": { + "offset": 1172, + "length": 3 + } + }, + { + "content": "Foreign province/state/county", + "source": "D(1,3.6378,2.7766,4.9639,2.7765,4.9639,2.8951,3.6378,2.8953)", + "span": { + "offset": 1177, + "length": 29 + } + }, + { + "content": "N/A", + "source": "D(1,3.6357,2.9318,3.8371,2.9319,3.837,3.0403,3.6357,3.0402)", + "span": { + "offset": 1207, + "length": 3 + } + }, + { + "content": "Foreign postal code", + "source": "D(1,5.6445,2.7812,6.458,2.78,6.458,2.8894,5.6445,2.8905)", + "span": { + "offset": 1212, + "length": 19 + } + }, + { + "content": "N/A", + "source": "D(1,5.9434,2.9342,6.1472,2.9351,6.1467,3.0379,5.9434,3.037)", + "span": { + "offset": 1232, + "length": 3 + } + }, + { + "content": "Presidential Election Campaign", + "source": "D(1,6.5452,2.1133,8.007,2.1245,8.0061,2.2438,6.5443,2.2326)", + "span": { + "offset": 1237, + "length": 30 + } + }, + { + "content": "Check here if you, or your", + "source": "D(1,6.5452,2.2565,7.7574,2.2597,7.7571,2.3778,6.5449,2.3747)", + "span": { + "offset": 1268, + "length": 26 + } + }, + { + "content": "spouse if filing jointly, want $3", + "source": "D(1,6.5443,2.3951,7.948,2.3849,7.9489,2.5055,6.5452,2.5133)", + "span": { + "offset": 1295, + "length": 33 + } + }, + { + "content": "to go to this fund. Checking a", + "source": "D(1,6.5327,2.5093,7.9355,2.5119,7.9355,2.6295,6.5325,2.6269)", + "span": { + "offset": 1329, + "length": 30 + } + }, + { + "content": "box below will not change", + "source": "D(1,6.5452,2.6411,7.7695,2.6411,7.7695,2.7556,6.5452,2.7556)", + "span": { + "offset": 1360, + "length": 25 + } + }, + { + "content": "your tax or refund.", + "source": "D(1,6.5282,2.7717,7.4084,2.7691,7.4088,2.8772,6.5286,2.8797)", + "span": { + "offset": 1386, + "length": 19 + } + }, + { + "content": "☐", + "source": "D(1,6.9851,2.9165,7.1096,2.9165,7.1096,3.0454,6.9851,3.0427)", + "span": { + "offset": 1407, + "length": 1 + } + }, + { + "content": "You", + "source": "D(1,7.147,2.9272,7.3337,2.9272,7.3337,3.0186,7.147,3.0186)", + "span": { + "offset": 1409, + "length": 3 + } + }, + { + "content": "☐", + "source": "D(1,7.4956,2.9165,7.6367,2.9192,7.6367,3.0427,7.4956,3.0454)", + "span": { + "offset": 1413, + "length": 1 + } + }, + { + "content": "Spouse", + "source": "D(1,7.6492,2.9345,7.9939,2.9354,7.9936,3.0348,7.6489,3.0339)", + "span": { + "offset": 1415, + "length": 6 + } + }, + { + "content": "At any time during 2020, did you receive, sell, send, exchange, or otherwise acquire any financial interest in any virtual currency?", + "source": "D(1,0.4936,3.1441,6.8773,3.148,6.8772,3.2773,0.4936,3.2745)", + "span": { + "offset": 1423, + "length": 132 + } + }, + { + "content": "☐", + "source": "D(1,6.9976,3.1394,7.1096,3.1421,7.1096,3.2656,6.9976,3.2629)", + "span": { + "offset": 1557, + "length": 1 + } + }, + { + "content": "Yes", + "source": "D(1,7.1345,3.15,7.3379,3.1499,7.3379,3.2525,7.1345,3.2526)", + "span": { + "offset": 1559, + "length": 3 + } + }, + { + "content": "☑", + "source": "D(1,7.4956,3.1501,7.616,3.1448,7.616,3.2683,7.4956,3.2737)", + "span": { + "offset": 1563, + "length": 1 + } + }, + { + "content": "No", + "source": "D(1,7.6407,3.1525,7.7986,3.1522,7.7988,3.2552,7.6409,3.2555)", + "span": { + "offset": 1565, + "length": 2 + } + }, + { + "content": "Standard", + "source": "D(1,0.4921,3.373,1.1123,3.373,1.1123,3.502,0.4921,3.502)", + "span": { + "offset": 1569, + "length": 8 + } + }, + { + "content": "Deduction", + "source": "D(1,0.4936,3.5154,1.1849,3.5154,1.1849,3.6389,0.4936,3.6389)", + "span": { + "offset": 1578, + "length": 9 + } + }, + { + "content": "Someone can claim:", + "source": "D(1,1.2887,3.3596,2.3787,3.365,2.3781,3.4821,1.2881,3.4779)", + "span": { + "offset": 1589, + "length": 18 + } + }, + { + "content": "☐", + "source": "D(1,2.5234,3.3569,2.6438,3.3569,2.6438,3.4805,2.5234,3.4805)", + "span": { + "offset": 1609, + "length": 1 + } + }, + { + "content": "You as a dependent", + "source": "D(1,2.6874,3.3656,3.7065,3.3672,3.7063,3.4865,2.6872,3.4848)", + "span": { + "offset": 1611, + "length": 18 + } + }, + { + "content": "☐", + "source": "D(1,3.92,3.3569,4.0446,3.3569,4.0446,3.4805,3.92,3.4805)", + "span": { + "offset": 1630, + "length": 1 + } + }, + { + "content": "Your spouse as a dependent", + "source": "D(1,4.0861,3.365,5.5366,3.365,5.5366,3.4874,4.0861,3.4874)", + "span": { + "offset": 1632, + "length": 26 + } + }, + { + "content": "☐", + "source": "D(1,1.3209,3.5208,1.4454,3.5208,1.4454,3.6497,1.3209,3.6497)", + "span": { + "offset": 1659, + "length": 1 + } + }, + { + "content": "Spouse itemizes on a separate return or you were a dual-status alien", + "source": "D(1,1.4879,3.5294,4.9058,3.5294,4.9058,3.6519,1.4879,3.6519)", + "span": { + "offset": 1661, + "length": 68 + } + }, + { + "content": "Age/Blindness", + "source": "D(1,0.4895,3.7766,1.2451,3.7784,1.2451,3.9041,0.4892,3.9024)", + "span": { + "offset": 1731, + "length": 13 + } + }, + { + "content": "You:", + "source": "D(1,1.2949,3.7792,1.5439,3.7811,1.5439,3.8893,1.2949,3.8873)", + "span": { + "offset": 1746, + "length": 4 + } + }, + { + "content": "☑", + "source": "D(1,1.6135,3.7544,1.7432,3.7544,1.7432,3.8779,1.6135,3.8779)", + "span": { + "offset": 1752, + "length": 1 + } + }, + { + "content": "Were born before January 2, 1956", + "source": "D(1,1.7867,3.7707,3.4822,3.7707,3.4822,3.8998,1.7867,3.8999)", + "span": { + "offset": 1754, + "length": 32 + } + }, + { + "content": "☐", + "source": "D(1,3.6171,3.7678,3.7395,3.7678,3.7395,3.8967,3.6171,3.8967)", + "span": { + "offset": 1787, + "length": 1 + } + }, + { + "content": "Are blind", + "source": "D(1,3.7914,3.7785,4.246,3.7792,4.2458,3.8918,3.7912,3.8914)", + "span": { + "offset": 1789, + "length": 9 + } + }, + { + "content": "Spouse:", + "source": "D(1,4.4866,3.7786,4.9348,3.7786,4.9348,3.8967,4.4866,3.8967)", + "span": { + "offset": 1800, + "length": 7 + } + }, + { + "content": "☐", + "source": "D(1,5.0178,3.7625,5.1631,3.7651,5.1631,3.8994,5.0178,3.8994)", + "span": { + "offset": 1809, + "length": 1 + } + }, + { + "content": "Was born before January 2, 1956", + "source": "D(1,5.1921,3.7686,6.8317,3.771,6.8315,3.9003,5.1919,3.8979)", + "span": { + "offset": 1811, + "length": 31 + } + }, + { + "content": "☑", + "source": "D(1,7.0142,3.7651,7.1594,3.7651,7.1594,3.8994,7.0142,3.8994)", + "span": { + "offset": 1843, + "length": 1 + } + }, + { + "content": "Is blind", + "source": "D(1,7.1801,3.7774,7.5537,3.7773,7.5537,3.8916,7.1802,3.8917)", + "span": { + "offset": 1845, + "length": 8 + } + }, + { + "content": "Dependents", + "source": "D(1,0.4939,3.9592,1.2545,3.9576,1.2547,4.0943,0.4942,4.0959)", + "span": { + "offset": 1885, + "length": 10 + } + }, + { + "content": "If more", + "source": "D(1,0.4921,4.1511,0.8522,4.1548,0.8513,4.2611,0.491,4.2575)", + "span": { + "offset": 1896, + "length": 7 + } + }, + { + "content": "than four", + "source": "D(1,0.4897,4.2794,0.9504,4.2771,0.951,4.3826,0.4903,4.3845)", + "span": { + "offset": 1904, + "length": 9 + } + }, + { + "content": "dependents,", + "source": "D(1,0.4916,4.4013,1.1144,4.4004,1.1145,4.509,0.4917,4.51)", + "span": { + "offset": 1914, + "length": 11 + } + }, + { + "content": "see instructions", + "source": "D(1,0.4903,4.5251,1.2545,4.5251,1.2545,4.6299,0.4903,4.6299)", + "span": { + "offset": 1926, + "length": 16 + } + }, + { + "content": "and check", + "source": "D(1,0.4905,4.646,1.0205,4.6429,1.0211,4.746,0.4911,4.7491)", + "span": { + "offset": 1943, + "length": 9 + } + }, + { + "content": "here", + "source": "D(1,0.4923,4.7642,0.7258,4.7642,0.7258,4.8608,0.4923,4.8608)", + "span": { + "offset": 1953, + "length": 4 + } + }, + { + "content": "☐", + "source": "D(1,0.8913,4.7507,1.0303,4.7507,1.0303,4.8743,0.8913,4.8743)", + "span": { + "offset": 1958, + "length": 1 + } + }, + { + "content": "(see instructions):", + "source": "D(1,1.2949,3.96,2.1665,3.96,2.1665,4.0854,1.2949,4.0854)", + "span": { + "offset": 1981, + "length": 19 + } + }, + { + "content": "(2) Social security", + "source": "D(1,3.9034,3.9664,4.6907,3.9715,4.6899,4.0856,3.9027,4.0818)", + "span": { + "offset": 2034, + "length": 19 + } + }, + { + "content": "number", + "source": "D(1,4.1213,4.0955,4.47,4.0955,4.47,4.1868,4.1213,4.1868)", + "span": { + "offset": 2054, + "length": 6 + } + }, + { + "content": "(3) Relationship", + "source": "D(1,5.0012,3.9693,5.6906,3.9713,5.6902,4.0859,5.0008,4.0832)", + "span": { + "offset": 2082, + "length": 16 + } + }, + { + "content": "to you", + "source": "D(1,5.2004,4.0981,5.4868,4.0981,5.4868,4.1948,5.2004,4.1948)", + "span": { + "offset": 2099, + "length": 6 + } + }, + { + "content": "(4)", + "source": "D(1,6.0762,3.9772,6.1799,3.9733,6.1813,4.0766,6.0762,4.0804)", + "span": { + "offset": 2127, + "length": 3 + } + }, + { + "content": "✓", + "source": "D(1,6.209,3.9585,6.3252,3.9666,6.3252,4.0686,6.209,4.0552)", + "span": { + "offset": 2131, + "length": 1 + } + }, + { + "content": "if qualifies for (see instructions):", + "source": "D(1,6.3501,3.9668,7.7157,3.9687,7.7156,4.0842,6.3499,4.0823)", + "span": { + "offset": 2133, + "length": 36 + } + }, + { + "content": "(1) First name", + "source": "D(1,1.3198,4.1116,1.9279,4.1116,1.9279,4.219,1.3198,4.219)", + "span": { + "offset": 2190, + "length": 14 + } + }, + { + "content": "Last name", + "source": "D(1,2.4757,4.1169,2.9447,4.1169,2.9447,4.2136,2.4757,4.2136)", + "span": { + "offset": 2214, + "length": 9 + } + }, + { + "content": "Child tax credit", + "source": "D(1,6.0098,4.1143,6.6863,4.1143,6.6863,4.2166,6.0098,4.2166)", + "span": { + "offset": 2233, + "length": 16 + } + }, + { + "content": "Credit for other dependents", + "source": "D(1,6.9187,4.1087,8.0061,4.1087,8.0061,4.2217,6.9187,4.2217)", + "span": { + "offset": 2259, + "length": 27 + } + }, + { + "content": "Evelyn", + "source": "D(1,1.4807,4.2692,1.8444,4.2712,1.8438,4.3917,1.48,4.3897)", + "span": { + "offset": 2307, + "length": 6 + } + }, + { + "content": "Collins", + "source": "D(1,2.5234,4.294,2.8166,4.2956,2.816,4.3944,2.5234,4.3929)", + "span": { + "offset": 2323, + "length": 7 + } + }, + { + "content": "005", + "source": "D(1,3.864,4.262,4.0217,4.262,4.0217,4.348,3.864,4.348)", + "span": { + "offset": 2340, + "length": 3 + } + }, + { + "content": "78", + "source": "D(1,4.113,4.2646,4.2126,4.2646,4.2126,4.3452,4.113,4.3452)", + "span": { + "offset": 2353, + "length": 2 + } + }, + { + "content": "5758", + "source": "D(1,4.4344,4.28,4.636,4.2748,4.6374,4.3718,4.4369,4.377)", + "span": { + "offset": 2365, + "length": 4 + } + }, + { + "content": "friend", + "source": "D(1,5.281,4.2696,5.5283,4.2635,5.5283,4.363,5.2835,4.3679)", + "span": { + "offset": 2379, + "length": 6 + } + }, + { + "content": "☐", + "source": "D(1,6.2878,4.2673,6.3999,4.27,6.3999,4.3962,6.2878,4.3962)", + "span": { + "offset": 2395, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,7.3877,4.2673,7.5081,4.2673,7.5081,4.3962,7.3877,4.3962)", + "span": { + "offset": 2406, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.2878,4.4338,6.3999,4.4338,6.3999,4.5627,6.2878,4.5627)", + "span": { + "offset": 2488, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,7.3877,4.4338,7.5081,4.4338,7.5081,4.5627,7.3877,4.5627)", + "span": { + "offset": 2499, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.2878,4.6057,6.3999,4.5977,6.3999,4.7266,6.2878,4.7346)", + "span": { + "offset": 2581, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,7.3877,4.603,7.5081,4.6057,7.5081,4.7346,7.3877,4.7346)", + "span": { + "offset": 2592, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.2878,4.7749,6.3999,4.7695,6.3999,4.8958,6.2878,4.9011)", + "span": { + "offset": 2674, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,7.3877,4.7695,7.5081,4.7695,7.5081,4.8984,7.3877,4.8958)", + "span": { + "offset": 2685, + "length": 1 + } + }, + { + "content": "Attach", + "source": "D(1,0.5139,5.0776,0.8329,5.0784,0.8327,5.1817,0.5136,5.1809)", + "span": { + "offset": 2738, + "length": 6 + } + }, + { + "content": "Sch. B if", + "source": "D(1,0.5185,5.2207,0.9292,5.2207,0.9292,5.3289,0.5185,5.3289)", + "span": { + "offset": 2745, + "length": 9 + } + }, + { + "content": "required.", + "source": "D(1,0.5159,5.36,0.9432,5.36,0.9432,5.4678,0.5159,5.4678)", + "span": { + "offset": 2755, + "length": 9 + } + }, + { + "content": "1", + "source": "D(1,1.3395,4.9628,1.3945,4.9628,1.3945,5.0569,1.3395,5.0569)", + "span": { + "offset": 2786, + "length": 1 + } + }, + { + "content": "Wages, salaries, tips, etc. Attach Form(s) W-2", + "source": "D(1,1.5834,4.9501,3.8682,4.9492,3.8682,5.0732,1.5835,5.0751)", + "span": { + "offset": 2788, + "length": 46 + } + }, + { + "content": "1", + "source": "D(1,6.8232,4.9629,6.8689,4.9629,6.8689,5.0569,6.8232,5.0569)", + "span": { + "offset": 2844, + "length": 1 + } + }, + { + "content": "2501", + "source": "D(1,7.7156,4.9495,7.9563,4.9495,7.9563,5.055,7.7156,5.055)", + "span": { + "offset": 2855, + "length": 4 + } + }, + { + "content": "2a", + "source": "D(1,1.3292,5.1258,1.4692,5.1258,1.4692,5.2288,1.3292,5.2288)", + "span": { + "offset": 2880, + "length": 2 + } + }, + { + "content": "Tax-exempt interest", + "source": "D(1,1.5865,5.1264,2.6064,5.1264,2.6064,5.2452,1.5865,5.2452)", + "span": { + "offset": 2883, + "length": 19 + } + }, + { + "content": ".", + "source": "D(1,2.8426,5.2059,2.8549,5.2059,2.8549,5.2182,2.8426,5.2182)", + "span": { + "offset": 2903, + "length": 1 + } + }, + { + "content": ".", + "source": "D(1,3.0093,5.2059,3.0216,5.2059,3.0216,5.2182,3.0093,5.2182)", + "span": { + "offset": 2905, + "length": 1 + } + }, + { + "content": "2a", + "source": "D(1,3.2789,5.1282,3.4199,5.1382,3.4158,5.236,3.276,5.226)", + "span": { + "offset": 2916, + "length": 2 + } + }, + { + "content": "2010", + "source": "D(1,4.2043,5.116,4.4617,5.116,4.4617,5.218,4.2043,5.218)", + "span": { + "offset": 2928, + "length": 4 + } + }, + { + "content": "b Taxable interest", + "source": "D(1,4.6858,5.1394,5.6242,5.1428,5.6238,5.2536,4.6854,5.2509)", + "span": { + "offset": 2954, + "length": 18 + } + }, + { + "content": "2b", + "source": "D(1,6.7734,5.1264,6.9146,5.1264,6.9146,5.2288,6.7734,5.2288)", + "span": { + "offset": 2982, + "length": 2 + } + }, + { + "content": "5202", + "source": "D(1,7.7156,5.1126,7.9646,5.1126,7.9646,5.2209,7.7156,5.2209)", + "span": { + "offset": 2994, + "length": 4 + } + }, + { + "content": "3a", + "source": "D(1,1.3292,5.3013,1.4682,5.3013,1.4682,5.4035,1.3292,5.4035)", + "span": { + "offset": 3019, + "length": 2 + } + }, + { + "content": "Qualified dividends", + "source": "D(1,1.5871,5.2913,2.5504,5.2874,2.5509,5.404,1.5875,5.4079)", + "span": { + "offset": 3022, + "length": 19 + } + }, + { + "content": ".", + "source": "D(1,2.6759,5.3725,2.6883,5.3725,2.6883,5.3849,2.6759,5.3849)", + "span": { + "offset": 3042, + "length": 1 + } + }, + { + "content": ".", + "source": "D(1,2.8426,5.3725,2.8549,5.3725,2.8549,5.3849,2.8426,5.3849)", + "span": { + "offset": 3044, + "length": 1 + } + }, + { + "content": ".", + "source": "D(1,3.0093,5.3725,3.0216,5.3725,3.0216,5.3849,3.0093,5.3849)", + "span": { + "offset": 3046, + "length": 1 + } + }, + { + "content": "3a", + "source": "D(1,3.2781,5.3006,3.4157,5.2997,3.4164,5.4009,3.2788,5.4018)", + "span": { + "offset": 3057, + "length": 2 + } + }, + { + "content": "1007", + "source": "D(1,4.2085,5.2798,4.4575,5.2798,4.4575,5.3872,4.2085,5.3872)", + "span": { + "offset": 3069, + "length": 4 + } + }, + { + "content": "b Ordinary dividends", + "source": "D(1,4.6893,5.3024,5.7649,5.2962,5.7656,5.4197,4.69,5.4253)", + "span": { + "offset": 3095, + "length": 20 + } + }, + { + "content": "3b", + "source": "D(1,6.7776,5.2932,6.9146,5.2932,6.9146,5.3953,6.7776,5.3953)", + "span": { + "offset": 3125, + "length": 2 + } + }, + { + "content": "3405", + "source": "D(1,7.7156,5.2797,7.9771,5.2797,7.9771,5.3872,7.7156,5.3872)", + "span": { + "offset": 3137, + "length": 4 + } + }, + { + "content": "4a", + "source": "D(1,1.3302,5.4651,1.4672,5.4651,1.4672,5.5645,1.3302,5.5645)", + "span": { + "offset": 3162, + "length": 2 + } + }, + { + "content": "IRA distributions", + "source": "D(1,1.5896,5.4583,2.4238,5.4583,2.4238,5.5705,1.5896,5.5705)", + "span": { + "offset": 3165, + "length": 17 + } + }, + { + "content": "4a", + "source": "D(1,3.2747,5.4678,3.4158,5.4678,3.4158,5.5645,3.2747,5.5645)", + "span": { + "offset": 3192, + "length": 2 + } + }, + { + "content": "3524", + "source": "D(1,4.2061,5.4514,4.4617,5.4458,4.4641,5.5555,4.2085,5.5611)", + "span": { + "offset": 3204, + "length": 4 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.6858,5.4597,5.657,5.4597,5.657,5.5698,4.6858,5.5698)", + "span": { + "offset": 3230, + "length": 16 + } + }, + { + "content": "4b", + "source": "D(1,6.7774,5.4625,6.9146,5.4622,6.9147,5.56,6.7776,5.5603)", + "span": { + "offset": 3256, + "length": 2 + } + }, + { + "content": "4508", + "source": "D(1,7.7156,5.4478,7.9648,5.4483,7.9646,5.5605,7.7154,5.5601)", + "span": { + "offset": 3268, + "length": 4 + } + }, + { + "content": "5a", + "source": "D(1,1.3288,5.6237,1.4672,5.6218,1.4686,5.7279,1.3303,5.7297)", + "span": { + "offset": 3293, + "length": 2 + } + }, + { + "content": "Pensions and annuities", + "source": "D(1,1.5883,5.6192,2.7517,5.6163,2.752,5.7365,1.5886,5.7395)", + "span": { + "offset": 3296, + "length": 22 + } + }, + { + "content": ".", + "source": "D(1,2.8426,5.7059,2.8549,5.7059,2.8549,5.7182,2.8426,5.7182)", + "span": { + "offset": 3319, + "length": 1 + } + }, + { + "content": ".", + "source": "D(1,3.0093,5.7059,3.0216,5.7059,3.0216,5.7182,3.0093,5.7182)", + "span": { + "offset": 3321, + "length": 1 + } + }, + { + "content": "5a", + "source": "D(1,3.2771,5.6275,3.4116,5.6252,3.4134,5.7241,3.2788,5.7264)", + "span": { + "offset": 3332, + "length": 2 + } + }, + { + "content": "2535", + "source": "D(1,4.2002,5.6128,4.4575,5.6128,4.4575,5.7202,4.2002,5.7202)", + "span": { + "offset": 3344, + "length": 4 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.6897,5.6216,5.6528,5.6191,5.6531,5.7348,4.69,5.7373)", + "span": { + "offset": 3370, + "length": 16 + } + }, + { + "content": "5b", + "source": "D(1,6.7775,5.6282,6.9146,5.628,6.9146,5.7251,6.7776,5.7252)", + "span": { + "offset": 3396, + "length": 2 + } + }, + { + "content": "1008", + "source": "D(1,7.7223,5.6119,7.9646,5.6083,7.9662,5.7185,7.7239,5.7221)", + "span": { + "offset": 3408, + "length": 4 + } + }, + { + "content": "Standard", + "source": "D(1,0.4482,5.803,0.8814,5.8025,0.8815,5.9033,0.4483,5.9038)", + "span": { + "offset": 3446, + "length": 8 + } + }, + { + "content": "Deduction for-", + "source": "D(1,0.4501,5.9132,1.1714,5.9132,1.1714,6.0109,0.4501,6.0109)", + "span": { + "offset": 3455, + "length": 14 + } + }, + { + "content": ". Single or", + "source": "D(1,0.4568,6.0522,0.8897,6.0439,0.891,6.1439,0.4587,6.1505)", + "span": { + "offset": 3470, + "length": 11 + } + }, + { + "content": "Married filing", + "source": "D(1,0.5178,6.1499,1.0516,6.1499,1.0516,6.2466,0.5178,6.2466)", + "span": { + "offset": 3482, + "length": 14 + } + }, + { + "content": "separately,", + "source": "D(1,0.5158,6.2501,0.9683,6.2543,0.967,6.3495,0.5146,6.3437)", + "span": { + "offset": 3497, + "length": 11 + } + }, + { + "content": "$12,400", + "source": "D(1,0.5128,6.3433,0.8576,6.3433,0.8576,6.4399,0.5128,6.4399)", + "span": { + "offset": 3509, + "length": 7 + } + }, + { + "content": ". Married filing", + "source": "D(1,0.4578,6.4598,1.0544,6.4738,1.0521,6.571,0.4556,6.557)", + "span": { + "offset": 3517, + "length": 16 + } + }, + { + "content": "jointly or", + "source": "D(1,0.5113,6.5684,0.8726,6.5658,0.8733,6.658,0.5119,6.6598)", + "span": { + "offset": 3534, + "length": 10 + } + }, + { + "content": "Qualifying", + "source": "D(1,0.5159,6.6527,0.9307,6.6527,0.9307,6.7555,0.5159,6.7555)", + "span": { + "offset": 3545, + "length": 10 + } + }, + { + "content": "widow(er),", + "source": "D(1,0.516,6.7603,0.9408,6.7639,0.9406,6.8632,0.5152,6.8597)", + "span": { + "offset": 3556, + "length": 10 + } + }, + { + "content": "$24,800", + "source": "D(1,0.5138,6.8612,0.8586,6.8595,0.8591,6.962,0.5143,6.9637)", + "span": { + "offset": 3567, + "length": 7 + } + }, + { + "content": ". Head of", + "source": "D(1,0.4597,6.9731,0.856,6.9731,0.856,7.0684,0.4597,7.0684)", + "span": { + "offset": 3575, + "length": 9 + } + }, + { + "content": "household,", + "source": "D(1,0.5126,7.0791,0.9722,7.0791,0.9722,7.1758,0.5126,7.1758)", + "span": { + "offset": 3585, + "length": 10 + } + }, + { + "content": "$18,650", + "source": "D(1,0.516,7.1687,0.8589,7.1697,0.8586,7.268,0.5157,7.2669)", + "span": { + "offset": 3596, + "length": 7 + } + }, + { + "content": ". If you checked", + "source": "D(1,0.4571,7.3049,1.1144,7.2942,1.116,7.3915,0.4587,7.4016)", + "span": { + "offset": 3604, + "length": 16 + } + }, + { + "content": "any box under", + "source": "D(1,0.5162,7.396,1.103,7.3955,1.1031,7.4869,0.5163,7.4875)", + "span": { + "offset": 3621, + "length": 13 + } + }, + { + "content": "Standard", + "source": "D(1,0.5159,7.498,0.8923,7.498,0.8923,7.584,0.5159,7.584)", + "span": { + "offset": 3635, + "length": 8 + } + }, + { + "content": "Deduction,", + "source": "D(1,0.516,7.5939,0.9494,7.5891,0.9505,7.6877,0.5171,7.6895)", + "span": { + "offset": 3644, + "length": 10 + } + }, + { + "content": "see instructions.", + "source": "D(1,0.5136,7.6894,1.1714,7.6894,1.1714,7.781,0.5136,7.781)", + "span": { + "offset": 3655, + "length": 17 + } + }, + { + "content": "6a", + "source": "D(1,1.3292,5.797,1.4672,5.797,1.4672,5.8975,1.3292,5.8975)", + "span": { + "offset": 3682, + "length": 2 + } + }, + { + "content": "Social security benefits", + "source": "D(1,1.5875,5.79,2.7517,5.79,2.7517,5.9082,1.5875,5.9082)", + "span": { + "offset": 3685, + "length": 24 + } + }, + { + "content": ".", + "source": "D(1,3.0093,5.8725,3.0216,5.8725,3.0216,5.8849,3.0093,5.8849)", + "span": { + "offset": 3710, + "length": 1 + } + }, + { + "content": "6a", + "source": "D(1,3.2788,5.8008,3.4158,5.8008,3.4158,5.8975,3.2788,5.8975)", + "span": { + "offset": 3721, + "length": 2 + } + }, + { + "content": "5328", + "source": "D(1,4.2002,5.7739,4.47,5.7739,4.47,5.8813,4.2002,5.8813)", + "span": { + "offset": 3733, + "length": 4 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.6858,5.7891,5.657,5.7891,5.657,5.9028,4.6858,5.9028)", + "span": { + "offset": 3759, + "length": 16 + } + }, + { + "content": "6b", + "source": "D(1,6.7776,5.8008,6.9146,5.8008,6.9146,5.8975,6.7776,5.8975)", + "span": { + "offset": 3785, + "length": 2 + } + }, + { + "content": "2004", + "source": "D(1,7.7157,5.7799,7.9667,5.7846,7.9646,5.899,7.7142,5.8943)", + "span": { + "offset": 3797, + "length": 4 + } + }, + { + "content": "7", + "source": "D(1,1.3312,5.9565,1.4018,5.9565,1.4018,6.0532,1.3312,6.0532)", + "span": { + "offset": 3834, + "length": 1 + } + }, + { + "content": "Capital gain or (loss). Attach Schedule D if required. If not required, check here", + "source": "D(1,1.5906,5.9495,5.5034,5.9495,5.5034,6.0791,1.5906,6.0791)", + "span": { + "offset": 3836, + "length": 82 + } + }, + { + "content": "☐", + "source": "D(1,6.458,5.9351,6.5825,5.9404,6.5825,6.0586,6.458,6.0586)", + "span": { + "offset": 3919, + "length": 1 + } + }, + { + "content": "7", + "source": "D(1,6.8149,5.9619,6.8813,5.9619,6.8813,6.0539,6.8149,6.0539)", + "span": { + "offset": 3930, + "length": 1 + } + }, + { + "content": "3006", + "source": "D(1,7.7142,5.9474,7.9646,5.9439,7.9661,6.054,7.7156,6.0575)", + "span": { + "offset": 3941, + "length": 4 + } + }, + { + "content": "8", + "source": "D(1,1.3271,6.1284,1.408,6.1284,1.408,6.2251,1.3271,6.2251)", + "span": { + "offset": 3978, + "length": 1 + } + }, + { + "content": "Other income from Schedule 1, line 9", + "source": "D(1,1.5886,6.1119,3.4594,6.1132,3.4594,6.2435,1.5885,6.2422)", + "span": { + "offset": 3980, + "length": 36 + } + }, + { + "content": "8", + "source": "D(1,6.8149,6.1284,6.8855,6.1284,6.8855,6.2251,6.8149,6.2251)", + "span": { + "offset": 4026, + "length": 1 + } + }, + { + "content": "4006", + "source": "D(1,7.7156,6.1096,7.9666,6.1144,7.9646,6.2184,7.7142,6.2136)", + "span": { + "offset": 4037, + "length": 4 + } + }, + { + "content": "9", + "source": "D(1,1.3333,6.2949,1.4018,6.2949,1.4018,6.3916,1.3333,6.3916)", + "span": { + "offset": 4074, + "length": 1 + } + }, + { + "content": "Add lines 1, 2b, 3b, 4b, 5b, 6b, 7, and 8. This is your total income", + "source": "D(1,1.5865,6.2779,4.8893,6.2827,4.8892,6.4107,1.5863,6.4062)", + "span": { + "offset": 4076, + "length": 68 + } + }, + { + "content": "9", + "source": "D(1,6.8232,6.2949,6.8813,6.2949,6.8813,6.3916,6.8232,6.3916)", + "span": { + "offset": 4154, + "length": 1 + } + }, + { + "content": "46708", + "source": "D(1,7.6616,6.2715,7.9657,6.2747,7.9645,6.39,7.6604,6.3868)", + "span": { + "offset": 4165, + "length": 5 + } + }, + { + "content": "10", + "source": "D(1,1.2762,6.4614,1.4018,6.4614,1.4018,6.5581,1.2762,6.5581)", + "span": { + "offset": 4203, + "length": 2 + } + }, + { + "content": "Adjustments to income:", + "source": "D(1,1.5854,6.447,2.7768,6.4492,2.7766,6.5793,1.5852,6.5771)", + "span": { + "offset": 4206, + "length": 22 + } + }, + { + "content": "6455", + "source": "D(1,7.7154,6.9499,7.9687,6.9494,7.9687,7.0571,7.7156,7.0576)", + "span": { + "offset": 4272, + "length": 4 + } + }, + { + "content": "a", + "source": "D(1,1.3935,6.644,1.4672,6.644,1.4672,6.7302,1.3935,6.7302)", + "span": { + "offset": 4309, + "length": 1 + } + }, + { + "content": "From Schedule 1, line 22", + "source": "D(1,1.5865,6.6226,2.8389,6.6226,2.8389,6.7407,1.5865,6.7407)", + "span": { + "offset": 4311, + "length": 24 + } + }, + { + "content": "10a", + "source": "D(1,5.4453,6.6333,5.6445,6.6333,5.6445,6.73,5.4453,6.73)", + "span": { + "offset": 4345, + "length": 3 + } + }, + { + "content": "6538", + "source": "D(1,6.4041,6.6172,6.6655,6.6172,6.6655,6.7246,6.4041,6.7246)", + "span": { + "offset": 4358, + "length": 4 + } + }, + { + "content": "b", + "source": "D(1,1.3914,6.8052,1.4641,6.8052,1.4641,6.9019,1.3914,6.9019)", + "span": { + "offset": 4395, + "length": 1 + } + }, + { + "content": "Charitable contributions if you take the standard deduction. See instructions", + "source": "D(1,1.5875,6.7937,5.2668,6.7937,5.2668,6.9126,1.5875,6.9126)", + "span": { + "offset": 4397, + "length": 77 + } + }, + { + "content": "10b", + "source": "D(1,5.4453,6.8004,5.6441,6.7927,5.6445,6.8959,5.4453,6.9092)", + "span": { + "offset": 4484, + "length": 3 + } + }, + { + "content": "6536", + "source": "D(1,6.4041,6.7837,6.6655,6.7837,6.6655,6.8911,6.4041,6.8911)", + "span": { + "offset": 4497, + "length": 4 + } + }, + { + "content": "c", + "source": "D(1,1.4042,6.9925,1.4609,6.9925,1.4609,7.053,1.4042,7.053)", + "span": { + "offset": 4534, + "length": 1 + } + }, + { + "content": "Add lines 10a and 10b. These are your total adjustments to income", + "source": "D(1,1.5813,6.9532,5.0303,6.9581,5.0303,7.0805,1.5811,7.0752)", + "span": { + "offset": 4536, + "length": 65 + } + }, + { + "content": "10c", + "source": "D(1,6.7527,6.9663,6.9478,6.9663,6.9478,7.063,6.7527,7.063)", + "span": { + "offset": 4611, + "length": 3 + } + }, + { + "content": "11", + "source": "D(1,1.2711,7.1328,1.3987,7.1328,1.3987,7.2295,1.2711,7.2295)", + "span": { + "offset": 4647, + "length": 2 + } + }, + { + "content": "Subtract line 10c from line 9. This is your adjusted gross income", + "source": "D(1,1.5875,7.1165,4.8684,7.1165,4.8684,7.2458,1.5875,7.2458)", + "span": { + "offset": 4650, + "length": 65 + } + }, + { + "content": "11", + "source": "D(1,6.79,7.1263,6.9007,7.1343,6.8979,7.2306,6.79,7.2227)", + "span": { + "offset": 4725, + "length": 2 + } + }, + { + "content": "7658", + "source": "D(1,7.7156,7.1123,7.9646,7.1123,7.9646,7.2188,7.7156,7.2188)", + "span": { + "offset": 4737, + "length": 4 + } + }, + { + "content": "12", + "source": "D(1,1.2794,7.2939,1.408,7.2939,1.408,7.3906,1.2794,7.3906)", + "span": { + "offset": 4774, + "length": 2 + } + }, + { + "content": "Standard deduction or itemized deductions (from Schedule A)", + "source": "D(1,1.5865,7.2798,4.8106,7.2848,4.8103,7.4144,1.5862,7.4072)", + "span": { + "offset": 4777, + "length": 59 + } + }, + { + "content": "12", + "source": "D(1,6.79,7.2939,6.9146,7.2939,6.9146,7.3906,6.79,7.3906)", + "span": { + "offset": 4846, + "length": 2 + } + }, + { + "content": "3427", + "source": "D(1,7.7156,7.2778,7.9563,7.2778,7.9563,7.3853,7.7156,7.3853)", + "span": { + "offset": 4858, + "length": 4 + } + }, + { + "content": "13", + "source": "D(1,1.2721,7.4575,1.4086,7.4582,1.408,7.5588,1.2716,7.558)", + "span": { + "offset": 4895, + "length": 2 + } + }, + { + "content": "Qualified business income deduction. Attach Form 8995 or Form 8995-A", + "source": "D(1,1.5875,7.4494,5.2046,7.4427,5.2048,7.5718,1.5878,7.5785)", + "span": { + "offset": 4898, + "length": 68 + } + }, + { + "content": "13", + "source": "D(1,6.79,7.4604,6.9062,7.4604,6.9062,7.5571,6.79,7.5571)", + "span": { + "offset": 4976, + "length": 2 + } + }, + { + "content": "8009", + "source": "D(1,7.7156,7.4437,7.9646,7.4437,7.9646,7.5525,7.7156,7.5525)", + "span": { + "offset": 4988, + "length": 4 + } + }, + { + "content": "14", + "source": "D(1,1.2742,7.6372,1.408,7.6372,1.408,7.7344,1.2742,7.7344)", + "span": { + "offset": 5025, + "length": 2 + } + }, + { + "content": "Add lines 12 and 13", + "source": "D(1,1.5852,7.6262,2.5919,7.615,2.5933,7.7384,1.5866,7.7448)", + "span": { + "offset": 5028, + "length": 19 + } + }, + { + "content": "14", + "source": "D(1,6.79,7.6377,6.9146,7.6377,6.9146,7.7344,6.79,7.7344)", + "span": { + "offset": 5057, + "length": 2 + } + }, + { + "content": "6008", + "source": "D(1,7.7156,7.6154,7.9648,7.6159,7.9646,7.7203,7.7154,7.7198)", + "span": { + "offset": 5069, + "length": 4 + } + }, + { + "content": "15", + "source": "D(1,1.2753,7.776,1.4111,7.782,1.407,7.8807,1.2728,7.8746)", + "span": { + "offset": 5106, + "length": 2 + } + }, + { + "content": "Taxable income. Subtract line 14 from line 11. If zero or less, enter -0-", + "source": "D(1,1.5865,7.7706,5.1092,7.7733,5.1091,7.8927,1.5864,7.89)", + "span": { + "offset": 5109, + "length": 73 + } + }, + { + "content": "15", + "source": "D(1,6.79,7.7827,6.9062,7.7827,6.9062,7.8794,6.79,7.8794)", + "span": { + "offset": 5192, + "length": 2 + } + }, + { + "content": "1055", + "source": "D(1,7.7224,7.7765,7.9646,7.773,7.9661,7.8778,7.7239,7.8813)", + "span": { + "offset": 5204, + "length": 4 + } + }, + { + "content": "For Disclosure, Privacy Act, and Paperwork Reduction Act Notice, see separate instructions.", + "source": "D(1,0.4879,7.964,4.7896,7.9659,4.7895,8.0846,0.4879,8.0827)", + "span": { + "offset": 5248, + "length": 91 + } + }, + { + "content": "Cat. No. 11320B", + "source": "D(1,5.6777,7.9761,6.3086,7.9761,6.3086,8.0674,5.6777,8.0674)", + "span": { + "offset": 5362, + "length": 15 + } + }, + { + "content": "Form 1040 (2020)", + "source": "D(1,7.2092,7.9576,8.002,7.9601,8.0019,8.0802,7.2089,8.0777)", + "span": { + "offset": 5400, + "length": 16 + } + } + ] + }, + { + "pageNumber": 2, + "angle": 0, + "width": 8.5, + "height": 11, + "spans": [ + { + "offset": 5442, + "length": 5157 + } + ], + "words": [ + { + "content": "Page", + "span": { + "offset": 5459, + "length": 4 + }, + "confidence": 0.959, + "source": "D(2,7.6616,0.3487,7.8956,0.3422,7.8956,0.4739,7.6616,0.4764)" + }, + { + "content": "2", + "span": { + "offset": 5464, + "length": 1 + }, + "confidence": 0.962, + "source": "D(2,7.9126,0.3418,8.002,0.3396,8.002,0.4727,7.9126,0.4737)" + }, + { + "content": "Form", + "span": { + "offset": 5488, + "length": 4 + }, + "confidence": 0.99, + "source": "D(2,0.4884,0.346,0.7142,0.346,0.714,0.4601,0.489,0.4586)" + }, + { + "content": "1040", + "span": { + "offset": 5493, + "length": 4 + }, + "confidence": 0.985, + "source": "D(2,0.7512,0.346,0.9672,0.3466,0.9661,0.4618,0.7508,0.4604)" + }, + { + "content": "(", + "span": { + "offset": 5498, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,0.9906,0.3466,1.0236,0.3468,1.0224,0.4621,0.9894,0.4619)" + }, + { + "content": "2020", + "span": { + "offset": 5499, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,1.0178,0.3467,1.2338,0.3479,1.2319,0.4634,1.0166,0.4621)" + }, + { + "content": ")", + "span": { + "offset": 5503, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.228,0.3478,1.2669,0.348,1.2648,0.4636,1.226,0.4633)" + }, + { + "content": "16", + "span": { + "offset": 5564, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.27,0.5459,1.4039,0.5458,1.4039,0.6482,1.27,0.6474)" + }, + { + "content": "Tax", + "span": { + "offset": 5567, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,1.5803,0.5364,1.7745,0.536,1.7745,0.6665,1.5803,0.6666)" + }, + { + "content": "(", + "span": { + "offset": 5571, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.805,0.536,1.8356,0.5359,1.8356,0.6664,1.805,0.6665)" + }, + { + "content": "see", + "span": { + "offset": 5572, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,1.8356,0.5359,1.9992,0.5356,1.9992,0.6663,1.8356,0.6664)" + }, + { + "content": "instructions", + "span": { + "offset": 5576, + "length": 12 + }, + "confidence": 0.996, + "source": "D(2,2.0341,0.5355,2.5818,0.5349,2.5818,0.6662,2.0341,0.6663)" + }, + { + "content": ")", + "span": { + "offset": 5588, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,2.5818,0.5349,2.6146,0.535,2.6146,0.6662,2.5818,0.6662)" + }, + { + "content": ".", + "span": { + "offset": 5589, + "length": 1 + }, + "confidence": 0.993, + "source": "D(2,2.6146,0.535,2.6364,0.535,2.6364,0.6662,2.6146,0.6662)" + }, + { + "content": "Check", + "span": { + "offset": 5591, + "length": 5 + }, + "confidence": 0.981, + "source": "D(2,2.6713,0.5351,2.9811,0.5355,2.9811,0.6664,2.6713,0.6662)" + }, + { + "content": "if", + "span": { + "offset": 5597, + "length": 2 + }, + "confidence": 0.995, + "source": "D(2,3.0095,0.5355,3.0706,0.5356,3.0706,0.6664,3.0095,0.6664)" + }, + { + "content": "any", + "span": { + "offset": 5600, + "length": 3 + }, + "confidence": 0.969, + "source": "D(2,3.0924,0.5356,3.2648,0.536,3.2648,0.6666,3.0924,0.6664)" + }, + { + "content": "from", + "span": { + "offset": 5604, + "length": 4 + }, + "confidence": 0.981, + "source": "D(2,3.291,0.5361,3.5092,0.5371,3.5092,0.6669,3.291,0.6666)" + }, + { + "content": "Form", + "span": { + "offset": 5609, + "length": 4 + }, + "confidence": 0.992, + "source": "D(2,3.5463,0.5373,3.7798,0.5384,3.7798,0.6673,3.5463,0.667)" + }, + { + "content": "(", + "span": { + "offset": 5613, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.7907,0.5385,3.8234,0.5387,3.8234,0.6674,3.7907,0.6674)" + }, + { + "content": "s", + "span": { + "offset": 5614, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.8212,0.5386,3.8736,0.5389,3.8736,0.6675,3.8212,0.6674)" + }, + { + "content": ")", + "span": { + "offset": 5615, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.8714,0.5389,3.9063,0.539,3.9063,0.6675,3.8714,0.6675)" + }, + { + "content": ":", + "span": { + "offset": 5616, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.9042,0.539,3.9303,0.5392,3.9303,0.6676,3.9042,0.6675)" + }, + { + "content": "1", + "span": { + "offset": 5618, + "length": 1 + }, + "confidence": 0.994, + "source": "D(2,3.9958,0.5395,4.0591,0.5398,4.0591,0.6678,3.9958,0.6677)" + }, + { + "content": "☑", + "span": { + "offset": 5620, + "length": 1 + }, + "confidence": 0.964, + "source": "D(2,4.1213,0.5371,4.2417,0.5358,4.2417,0.661,4.1213,0.6617)" + }, + { + "content": "8814", + "span": { + "offset": 5622, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,4.2915,0.5455,4.553,0.544,4.553,0.6481,4.2915,0.649)" + }, + { + "content": "2", + "span": { + "offset": 5627, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,4.6899,0.5525,4.7563,0.5506,4.7563,0.643,4.6899,0.6445)" + }, + { + "content": "☐", + "span": { + "offset": 5629, + "length": 1 + }, + "confidence": 0.977, + "source": "D(2,4.8269,0.5371,4.9473,0.5354,4.9473,0.6573,4.8269,0.6613)" + }, + { + "content": "4972", + "span": { + "offset": 5631, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,4.9888,0.546,5.2544,0.5445,5.2544,0.6482,4.9888,0.6483)" + }, + { + "content": "3", + "span": { + "offset": 5636, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,5.4038,0.5526,5.4619,0.555,5.4619,0.6455,5.4038,0.6436)" + }, + { + "content": "☐", + "span": { + "offset": 5638, + "length": 1 + }, + "confidence": 0.988, + "source": "D(2,5.5242,0.5368,5.6487,0.5344,5.6487,0.658,5.5242,0.662)" + }, + { + "content": ".", + "span": { + "offset": 5640, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.3414,0.6281,6.3522,0.6281,6.3522,0.6389,6.3414,0.6389)" + }, + { + "content": ".", + "span": { + "offset": 5642, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.5081,0.6281,6.5189,0.6281,6.5189,0.6389,6.5081,0.6389)" + }, + { + "content": "16", + "span": { + "offset": 5653, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.79,0.5473,6.9062,0.5471,6.9062,0.6456,6.79,0.6456)" + }, + { + "content": "2350", + "span": { + "offset": 5665, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,7.7156,0.5321,7.9771,0.5305,7.9771,0.6376,7.7156,0.6387)" + }, + { + "content": "17", + "span": { + "offset": 5702, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2721,0.713,1.4039,0.713,1.4039,0.8144,1.2721,0.8144)" + }, + { + "content": "Amount", + "span": { + "offset": 5705, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,1.5823,0.7011,1.9865,0.7022,1.9865,0.8236,1.5823,0.8218)" + }, + { + "content": "from", + "span": { + "offset": 5712, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,2.0128,0.7023,2.2331,0.7028,2.2331,0.8244,2.0128,0.8237)" + }, + { + "content": "Schedule", + "span": { + "offset": 5717, + "length": 8 + }, + "confidence": 0.97, + "source": "D(2,2.2654,0.7029,2.7444,0.704,2.7444,0.8251,2.2654,0.8244)" + }, + { + "content": "2", + "span": { + "offset": 5726, + "length": 1 + }, + "confidence": 0.956, + "source": "D(2,2.7706,0.7041,2.8293,0.7042,2.8293,0.825,2.7706,0.8251)" + }, + { + "content": ",", + "span": { + "offset": 5727, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,2.8333,0.7042,2.8575,0.7043,2.8575,0.825,2.8333,0.825)" + }, + { + "content": "line", + "span": { + "offset": 5729, + "length": 4 + }, + "confidence": 0.876, + "source": "D(2,2.8919,0.7043,3.0596,0.7047,3.0596,0.8248,2.8919,0.825)" + }, + { + "content": "3", + "span": { + "offset": 5734, + "length": 1 + }, + "confidence": 0.946, + "source": "D(2,3.09,0.7048,3.1667,0.7049,3.1667,0.8248,3.09,0.8248)" + }, + { + "content": "17", + "span": { + "offset": 5745, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.79,0.7111,6.9062,0.7131,6.9062,0.8106,6.79,0.8086)" + }, + { + "content": "5437", + "span": { + "offset": 5757, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,7.7156,0.6988,7.9646,0.699,7.9646,0.8028,7.7156,0.8019)" + }, + { + "content": "18", + "span": { + "offset": 5794, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2742,0.8805,1.4039,0.8801,1.4039,0.9781,1.2742,0.9792)" + }, + { + "content": "Add", + "span": { + "offset": 5797, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,1.5823,0.8713,1.7946,0.8709,1.7946,0.9869,1.5823,0.987)" + }, + { + "content": "lines", + "span": { + "offset": 5801, + "length": 5 + }, + "confidence": 0.992, + "source": "D(2,1.829,0.8708,2.0527,0.8708,2.0527,0.9867,1.829,0.9868)" + }, + { + "content": "16", + "span": { + "offset": 5807, + "length": 2 + }, + "confidence": 0.986, + "source": "D(2,2.091,0.8708,2.2076,0.8709,2.2076,0.9866,2.091,0.9867)" + }, + { + "content": "and", + "span": { + "offset": 5810, + "length": 3 + }, + "confidence": 0.968, + "source": "D(2,2.2382,0.871,2.4217,0.8718,2.4217,0.9864,2.2382,0.9866)" + }, + { + "content": "17", + "span": { + "offset": 5814, + "length": 2 + }, + "confidence": 0.993, + "source": "D(2,2.46,0.8719,2.5919,0.8726,2.5919,0.9863,2.46,0.9864)" + }, + { + "content": "18", + "span": { + "offset": 5826, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.79,0.8789,6.9062,0.8797,6.9062,0.9778,6.79,0.9772)" + }, + { + "content": "1000", + "span": { + "offset": 5838, + "length": 4 + }, + "confidence": 0.961, + "source": "D(2,7.7239,0.8641,7.9646,0.8641,7.9646,0.9655,7.7239,0.9655)" + }, + { + "content": "19", + "span": { + "offset": 5875, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2742,1.0462,1.4018,1.0441,1.4018,1.1421,1.2742,1.1457)" + }, + { + "content": "Child", + "span": { + "offset": 5878, + "length": 5 + }, + "confidence": 0.995, + "source": "D(2,1.5823,1.0342,1.8487,1.0345,1.8487,1.1553,1.5823,1.1544)" + }, + { + "content": "tax", + "span": { + "offset": 5884, + "length": 3 + }, + "confidence": 0.984, + "source": "D(2,1.883,1.0346,2.0343,1.0348,2.0343,1.156,1.883,1.1554)" + }, + { + "content": "credit", + "span": { + "offset": 5888, + "length": 6 + }, + "confidence": 0.99, + "source": "D(2,2.0666,1.0348,2.3511,1.0352,2.3511,1.1571,2.0666,1.1561)" + }, + { + "content": "or", + "span": { + "offset": 5895, + "length": 2 + }, + "confidence": 0.984, + "source": "D(2,2.3793,1.0353,2.4842,1.0356,2.4842,1.1574,2.3793,1.1572)" + }, + { + "content": "credit", + "span": { + "offset": 5898, + "length": 6 + }, + "confidence": 0.98, + "source": "D(2,2.5084,1.0357,2.7929,1.0364,2.7929,1.1581,2.5084,1.1574)" + }, + { + "content": "for", + "span": { + "offset": 5905, + "length": 3 + }, + "confidence": 0.98, + "source": "D(2,2.8232,1.0365,2.9584,1.0368,2.9584,1.1584,2.8232,1.1581)" + }, + { + "content": "other", + "span": { + "offset": 5909, + "length": 5 + }, + "confidence": 0.988, + "source": "D(2,2.9826,1.0369,3.2509,1.0378,3.2509,1.1589,2.9826,1.1585)" + }, + { + "content": "dependents", + "span": { + "offset": 5915, + "length": 10 + }, + "confidence": 0.998, + "source": "D(2,3.2751,1.0379,3.8744,1.0402,3.8744,1.1594,3.2751,1.1589)" + }, + { + "content": "19", + "span": { + "offset": 5935, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,6.79,1.0422,6.9062,1.0431,6.9062,1.1409,6.79,1.1419)" + }, + { + "content": "753", + "span": { + "offset": 5947, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,7.7861,1.0328,7.9646,1.0319,7.9646,1.1336,7.7861,1.1334)" + }, + { + "content": "20", + "span": { + "offset": 5983, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,1.2072,1.4039,1.2091,1.4039,1.3104,1.2669,1.3104)" + }, + { + "content": "Amount", + "span": { + "offset": 5986, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,1.5792,1.2001,1.9872,1.1991,1.9872,1.3198,1.5792,1.3191)" + }, + { + "content": "from", + "span": { + "offset": 5993, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,2.0134,1.199,2.2356,1.1988,2.2356,1.32,2.0134,1.3198)" + }, + { + "content": "Schedule", + "span": { + "offset": 5998, + "length": 8 + }, + "confidence": 0.988, + "source": "D(2,2.2659,1.1988,2.7445,1.1991,2.7445,1.32,2.2659,1.32)" + }, + { + "content": "3", + "span": { + "offset": 6007, + "length": 1 + }, + "confidence": 0.982, + "source": "D(2,2.7728,1.1992,2.8314,1.1994,2.8314,1.3199,2.7728,1.3199)" + }, + { + "content": ",", + "span": { + "offset": 6008, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,2.8334,1.1994,2.8556,1.1994,2.8556,1.3198,2.8334,1.3199)" + }, + { + "content": "line", + "span": { + "offset": 6010, + "length": 4 + }, + "confidence": 0.877, + "source": "D(2,2.892,1.1995,3.0616,1.2,3.0616,1.3196,2.892,1.3198)" + }, + { + "content": "7", + "span": { + "offset": 6015, + "length": 1 + }, + "confidence": 0.946, + "source": "D(2,3.0899,1.2,3.1626,1.2002,3.1626,1.3195,3.0899,1.3196)" + }, + { + "content": "20", + "span": { + "offset": 6026, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.2079,6.9146,1.2105,6.9146,1.3085,6.7776,1.3077)" + }, + { + "content": "5430", + "span": { + "offset": 6038, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,7.7156,1.1969,7.9771,1.1953,7.9771,1.2999,7.7156,1.3014)" + }, + { + "content": "21", + "span": { + "offset": 6075, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2638,1.3763,1.3956,1.3763,1.3956,1.4782,1.2638,1.4796)" + }, + { + "content": "Add", + "span": { + "offset": 6078, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,1.5823,1.3658,1.7973,1.367,1.7973,1.4842,1.5823,1.4817)" + }, + { + "content": "lines", + "span": { + "offset": 6082, + "length": 5 + }, + "confidence": 0.984, + "source": "D(2,1.8328,1.3672,2.0516,1.3681,2.0516,1.4859,1.8328,1.4846)" + }, + { + "content": "19", + "span": { + "offset": 6088, + "length": 2 + }, + "confidence": 0.976, + "source": "D(2,2.0911,1.3682,2.2035,1.3685,2.2035,1.4862,2.0911,1.486)" + }, + { + "content": "and", + "span": { + "offset": 6091, + "length": 3 + }, + "confidence": 0.95, + "source": "D(2,2.237,1.3686,2.4243,1.3685,2.4243,1.4852,2.237,1.4863)" + }, + { + "content": "20", + "span": { + "offset": 6095, + "length": 2 + }, + "confidence": 0.984, + "source": "D(2,2.4539,1.3685,2.5919,1.3684,2.5919,1.484,2.4539,1.485)" + }, + { + "content": "21", + "span": { + "offset": 6107, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.3769,6.8979,1.3786,6.8979,1.4776,6.7776,1.4765)" + }, + { + "content": "15790", + "span": { + "offset": 6119, + "length": 5 + }, + "confidence": 0.991, + "source": "D(2,7.6699,1.3655,7.9646,1.3643,7.9646,1.467,7.6699,1.4675)" + }, + { + "content": "22", + "span": { + "offset": 6157, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,1.5416,1.408,1.5431,1.408,1.6439,1.2669,1.6423)" + }, + { + "content": "Subtract", + "span": { + "offset": 6160, + "length": 8 + }, + "confidence": 0.993, + "source": "D(2,1.5792,1.5371,2.0207,1.5366,2.0204,1.6565,1.5792,1.656)" + }, + { + "content": "line", + "span": { + "offset": 6169, + "length": 4 + }, + "confidence": 0.937, + "source": "D(2,2.0544,1.5366,2.2207,1.5364,2.2202,1.6567,2.054,1.6565)" + }, + { + "content": "21", + "span": { + "offset": 6174, + "length": 2 + }, + "confidence": 0.94, + "source": "D(2,2.2484,1.5363,2.3593,1.5362,2.3587,1.6569,2.2479,1.6567)" + }, + { + "content": "from", + "span": { + "offset": 6177, + "length": 4 + }, + "confidence": 0.927, + "source": "D(2,2.4048,1.5361,2.6305,1.5364,2.6297,1.657,2.4042,1.6569)" + }, + { + "content": "line", + "span": { + "offset": 6182, + "length": 4 + }, + "confidence": 0.966, + "source": "D(2,2.6682,1.5365,2.8345,1.5369,2.8335,1.657,2.6673,1.657)" + }, + { + "content": "18", + "span": { + "offset": 6187, + "length": 2 + }, + "confidence": 0.923, + "source": "D(2,2.876,1.537,2.9889,1.5372,2.9878,1.6571,2.875,1.6571)" + }, + { + "content": ".", + "span": { + "offset": 6189, + "length": 1 + }, + "confidence": 0.98, + "source": "D(2,2.9968,1.5372,3.0186,1.5373,3.0175,1.6571,2.9957,1.6571)" + }, + { + "content": "If", + "span": { + "offset": 6191, + "length": 2 + }, + "confidence": 0.895, + "source": "D(2,3.0582,1.5374,3.1235,1.5375,3.1223,1.6571,3.057,1.6571)" + }, + { + "content": "zero", + "span": { + "offset": 6194, + "length": 4 + }, + "confidence": 0.889, + "source": "D(2,3.1453,1.5376,3.3611,1.5381,3.3597,1.6571,3.1441,1.6571)" + }, + { + "content": "or", + "span": { + "offset": 6199, + "length": 2 + }, + "confidence": 0.933, + "source": "D(2,3.3908,1.5383,3.4977,1.5389,3.4962,1.657,3.3894,1.6571)" + }, + { + "content": "less", + "span": { + "offset": 6202, + "length": 4 + }, + "confidence": 0.941, + "source": "D(2,3.5254,1.5391,3.7155,1.5401,3.7138,1.6568,3.5239,1.657)" + }, + { + "content": ",", + "span": { + "offset": 6206, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.7175,1.5401,3.7432,1.5403,3.7415,1.6568,3.7158,1.6568)" + }, + { + "content": "enter", + "span": { + "offset": 6208, + "length": 5 + }, + "confidence": 0.981, + "source": "D(2,3.7769,1.5405,4.0402,1.5419,4.0383,1.6566,3.7751,1.6568)" + }, + { + "content": "-", + "span": { + "offset": 6214, + "length": 1 + }, + "confidence": 0.991, + "source": "D(2,4.062,1.5421,4.1016,1.5423,4.0996,1.6565,4.06,1.6566)" + }, + { + "content": "0", + "span": { + "offset": 6215, + "length": 1 + }, + "confidence": 0.944, + "source": "D(2,4.1036,1.5423,4.1669,1.5426,4.1649,1.6565,4.1016,1.6565)" + }, + { + "content": "-", + "span": { + "offset": 6216, + "length": 1 + }, + "confidence": 0.988, + "source": "D(2,4.1669,1.5426,4.2085,1.5429,4.2064,1.6565,4.1649,1.6565)" + }, + { + "content": "22", + "span": { + "offset": 6227, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.5404,6.9146,1.548,6.9146,1.6459,6.7776,1.6401)" + }, + { + "content": "5436", + "span": { + "offset": 6239, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,7.7156,1.5291,7.9646,1.5311,7.9646,1.6317,7.7156,1.6309)" + }, + { + "content": "23", + "span": { + "offset": 6276, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2679,1.7107,1.408,1.71,1.408,1.8101,1.2679,1.8101)" + }, + { + "content": "Other", + "span": { + "offset": 6279, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,1.5865,1.7016,1.8782,1.7013,1.8782,1.8263,1.5865,1.8261)" + }, + { + "content": "taxes", + "span": { + "offset": 6285, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,1.9029,1.7013,2.1659,1.7011,2.1659,1.8265,1.9029,1.8264)" + }, + { + "content": ",", + "span": { + "offset": 6290, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.17,1.7011,2.1905,1.7011,2.1905,1.8265,2.17,1.8265)" + }, + { + "content": "including", + "span": { + "offset": 6292, + "length": 9 + }, + "confidence": 0.998, + "source": "D(2,2.2316,1.7011,2.6754,1.7008,2.6754,1.8269,2.2316,1.8266)" + }, + { + "content": "self", + "span": { + "offset": 6302, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,2.7124,1.7007,2.8953,1.7007,2.8953,1.8266,2.7124,1.8269)" + }, + { + "content": "-", + "span": { + "offset": 6306, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.8912,1.7007,2.924,1.7007,2.924,1.8266,2.8912,1.8267)" + }, + { + "content": "employment", + "span": { + "offset": 6307, + "length": 10 + }, + "confidence": 0.994, + "source": "D(2,2.9282,1.7007,3.5445,1.7008,3.5445,1.8257,2.9281,1.8266)" + }, + { + "content": "tax", + "span": { + "offset": 6318, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,3.5712,1.7008,3.7274,1.7009,3.7274,1.8255,3.5712,1.8257)" + }, + { + "content": ",", + "span": { + "offset": 6321, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.7295,1.7009,3.7541,1.7009,3.7541,1.8254,3.7295,1.8255)" + }, + { + "content": "from", + "span": { + "offset": 6323, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,3.787,1.7009,4.015,1.7011,4.015,1.8248,3.787,1.8254)" + }, + { + "content": "Schedule", + "span": { + "offset": 6328, + "length": 8 + }, + "confidence": 0.8, + "source": "D(2,4.0459,1.7011,4.5123,1.7016,4.5123,1.823,4.0459,1.8246)" + }, + { + "content": "2", + "span": { + "offset": 6337, + "length": 1 + }, + "confidence": 0.958, + "source": "D(2,4.541,1.7016,4.6006,1.7017,4.6006,1.8227,4.541,1.8229)" + }, + { + "content": ",", + "span": { + "offset": 6338, + "length": 1 + }, + "confidence": 0.994, + "source": "D(2,4.6027,1.7017,4.6273,1.7017,4.6273,1.8226,4.6027,1.8227)" + }, + { + "content": "line", + "span": { + "offset": 6340, + "length": 4 + }, + "confidence": 0.336, + "source": "D(2,4.6684,1.7017,4.841,1.7019,4.841,1.8219,4.6684,1.8225)" + }, + { + "content": "10", + "span": { + "offset": 6345, + "length": 2 + }, + "confidence": 0.531, + "source": "D(2,4.8739,1.702,5.0054,1.7021,5.0054,1.8213,4.8739,1.8218)" + }, + { + "content": "23", + "span": { + "offset": 6357, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.7103,6.9062,1.7127,6.9062,1.8089,6.7776,1.8085)" + }, + { + "content": "7650", + "span": { + "offset": 6369, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,7.7156,1.6946,7.9646,1.6945,7.9646,1.7977,7.7156,1.798)" + }, + { + "content": "24", + "span": { + "offset": 6406, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.27,1.8769,1.4059,1.8841,1.4059,1.9848,1.27,1.9776)" + }, + { + "content": "Add", + "span": { + "offset": 6409, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,1.5792,1.8695,1.7945,1.8695,1.7945,1.9951,1.5792,1.9945)" + }, + { + "content": "lines", + "span": { + "offset": 6413, + "length": 5 + }, + "confidence": 0.977, + "source": "D(2,1.8321,1.8695,2.0536,1.8694,2.0536,1.9957,1.8321,1.9952)" + }, + { + "content": "22", + "span": { + "offset": 6419, + "length": 2 + }, + "confidence": 0.918, + "source": "D(2,2.0849,1.8694,2.2061,1.8693,2.2061,1.9961,2.0849,1.9958)" + }, + { + "content": "and", + "span": { + "offset": 6422, + "length": 3 + }, + "confidence": 0.947, + "source": "D(2,2.2395,1.8693,2.4213,1.8695,2.4213,1.9964,2.2395,1.9962)" + }, + { + "content": "23", + "span": { + "offset": 6426, + "length": 2 + }, + "confidence": 0.917, + "source": "D(2,2.4569,1.8696,2.5801,1.8697,2.5801,1.9965,2.4569,1.9964)" + }, + { + "content": ".", + "span": { + "offset": 6428, + "length": 1 + }, + "confidence": 0.968, + "source": "D(2,2.5864,1.8697,2.6073,1.8698,2.6073,1.9965,2.5864,1.9965)" + }, + { + "content": "This", + "span": { + "offset": 6430, + "length": 4 + }, + "confidence": 0.942, + "source": "D(2,2.6407,1.8698,2.8476,1.8701,2.8476,1.9966,2.6407,1.9965)" + }, + { + "content": "is", + "span": { + "offset": 6435, + "length": 2 + }, + "confidence": 0.995, + "source": "D(2,2.8811,1.8701,2.9605,1.8702,2.9605,1.9967,2.881,1.9966)" + }, + { + "content": "your", + "span": { + "offset": 6438, + "length": 4 + }, + "confidence": 0.981, + "source": "D(2,2.9876,1.8703,3.2175,1.8709,3.2175,1.9963,2.9876,1.9967)" + }, + { + "content": "total", + "span": { + "offset": 6443, + "length": 5 + }, + "confidence": 0.975, + "source": "D(2,3.2426,1.871,3.4766,1.8717,3.4766,1.996,3.2426,1.9963)" + }, + { + "content": "tax", + "span": { + "offset": 6449, + "length": 3 + }, + "confidence": 0.986, + "source": "D(2,3.51,1.8718,3.6855,1.8723,3.6855,1.9956,3.51,1.9959)" + }, + { + "content": "24", + "span": { + "offset": 6462, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,1.8799,6.9146,1.8836,6.9146,1.9785,6.7776,1.9759)" + }, + { + "content": "12780", + "span": { + "offset": 6474, + "length": 5 + }, + "confidence": 0.993, + "source": "D(2,7.6616,1.8664,7.9646,1.8669,7.9646,1.9716,7.6616,1.9711)" + }, + { + "content": "25", + "span": { + "offset": 6512, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,2.0433,1.408,2.0429,1.408,2.1412,1.2669,2.1425)" + }, + { + "content": "Federal", + "span": { + "offset": 6515, + "length": 7 + }, + "confidence": 0.997, + "source": "D(2,1.5865,2.0404,1.9614,2.041,1.9614,2.1581,1.5865,2.1578)" + }, + { + "content": "income", + "span": { + "offset": 6523, + "length": 6 + }, + "confidence": 0.989, + "source": "D(2,1.9981,2.0411,2.3576,2.0414,2.3576,2.1582,1.9981,2.1581)" + }, + { + "content": "tax", + "span": { + "offset": 6530, + "length": 3 + }, + "confidence": 0.979, + "source": "D(2,2.3885,2.0414,2.5431,2.0414,2.5431,2.1581,2.3885,2.1582)" + }, + { + "content": "withheld", + "span": { + "offset": 6534, + "length": 8 + }, + "confidence": 0.98, + "source": "D(2,2.5721,2.0414,2.9895,2.041,2.9895,2.1579,2.5721,2.1581)" + }, + { + "content": "from", + "span": { + "offset": 6543, + "length": 4 + }, + "confidence": 0.988, + "source": "D(2,3.0224,2.041,3.2446,2.0407,3.2446,2.1576,3.0224,2.1578)" + }, + { + "content": ":", + "span": { + "offset": 6547, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.2543,2.0407,3.2871,2.0406,3.2871,2.1576,3.2543,2.1576)" + }, + { + "content": "6220", + "span": { + "offset": 6592, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,7.7156,2.6931,7.9646,2.6943,7.9646,2.8017,7.7156,2.8005)" + }, + { + "content": "a", + "span": { + "offset": 6617, + "length": 1 + }, + "confidence": 0.924, + "source": "D(2,1.3873,2.2381,1.4641,2.2326,1.4641,2.3147,1.3873,2.3188)" + }, + { + "content": "Form", + "span": { + "offset": 6619, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,1.5875,2.2076,1.8411,2.2073,1.8411,2.3314,1.5875,2.3305)" + }, + { + "content": "(", + "span": { + "offset": 6623, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.8514,2.2073,1.8885,2.2074,1.8885,2.3314,1.8514,2.3314)" + }, + { + "content": "s", + "span": { + "offset": 6624, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.8823,2.2074,1.938,2.2074,1.938,2.3313,1.8823,2.3314)" + }, + { + "content": ")", + "span": { + "offset": 6625, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.9318,2.2074,1.9689,2.2074,1.9689,2.3313,1.9318,2.3313)" + }, + { + "content": "W", + "span": { + "offset": 6627, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.9916,2.2074,2.0967,2.2075,2.0967,2.3305,1.9916,2.3312)" + }, + { + "content": "-", + "span": { + "offset": 6628, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.0967,2.2075,2.138,2.2075,2.138,2.3302,2.0967,2.3305)" + }, + { + "content": "2", + "span": { + "offset": 6629, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,2.138,2.2075,2.2142,2.2076,2.2142,2.3297,2.138,2.3302)" + }, + { + "content": "25a", + "span": { + "offset": 6640, + "length": 3 + }, + "confidence": 0.977, + "source": "D(2,5.4412,2.2185,5.6445,2.2184,5.6445,2.3178,5.4412,2.318)" + }, + { + "content": "4220", + "span": { + "offset": 6653, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,6.4207,2.1979,6.6697,2.1998,6.6697,2.3024,6.4207,2.3028)" + }, + { + "content": "b", + "span": { + "offset": 6678, + "length": 1 + }, + "confidence": 0.975, + "source": "D(2,1.3893,2.3846,1.4641,2.3844,1.4641,2.4782,1.3893,2.4783)" + }, + { + "content": "Form", + "span": { + "offset": 6680, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,1.5875,2.3727,1.8399,2.3728,1.8399,2.4976,1.5875,2.4974)" + }, + { + "content": "(", + "span": { + "offset": 6684, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.8503,2.3728,1.8854,2.3729,1.8854,2.4975,1.8502,2.4976)" + }, + { + "content": "s", + "span": { + "offset": 6685, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,1.8771,2.3728,1.933,2.373,1.933,2.4974,1.8771,2.4975)" + }, + { + "content": ")", + "span": { + "offset": 6686, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.9309,2.373,1.9661,2.3731,1.9661,2.4973,1.9309,2.4974)" + }, + { + "content": "1099", + "span": { + "offset": 6688, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,2.0033,2.3732,2.2495,2.3744,2.2495,2.496,2.0033,2.4972)" + }, + { + "content": "25b", + "span": { + "offset": 6702, + "length": 3 + }, + "confidence": 0.969, + "source": "D(2,5.4412,2.3766,5.6445,2.3755,5.6445,2.4764,5.4412,2.4786)" + }, + { + "content": "1000", + "span": { + "offset": 6715, + "length": 4 + }, + "confidence": 0.984, + "source": "D(2,6.4248,2.3657,6.6697,2.3672,6.6697,2.472,6.4248,2.472)" + }, + { + "content": "c", + "span": { + "offset": 6740, + "length": 1 + }, + "confidence": 1, + "source": "D(2,1.4042,2.5759,1.4609,2.5759,1.4609,2.6363,1.4042,2.6363)" + }, + { + "content": "Other", + "span": { + "offset": 6742, + "length": 5 + }, + "confidence": 0.994, + "source": "D(2,1.5865,2.5371,1.8759,2.5364,1.8759,2.6627,1.5865,2.6629)" + }, + { + "content": "forms", + "span": { + "offset": 6748, + "length": 5 + }, + "confidence": 0.991, + "source": "D(2,1.9032,2.5363,2.1842,2.5361,2.1842,2.6626,1.9032,2.6627)" + }, + { + "content": "(", + "span": { + "offset": 6754, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.2178,2.5362,2.2513,2.5363,2.2513,2.6627,2.2178,2.6627)" + }, + { + "content": "see", + "span": { + "offset": 6755, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,2.2492,2.5363,2.4191,2.5367,2.4191,2.6628,2.2492,2.6627)" + }, + { + "content": "instructions", + "span": { + "offset": 6759, + "length": 12 + }, + "confidence": 0.995, + "source": "D(2,2.4548,2.5368,3.0231,2.5406,3.0231,2.664,2.4548,2.6629)" + }, + { + "content": ")", + "span": { + "offset": 6771, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,3.021,2.5405,3.063,2.5409,3.063,2.6641,3.021,2.664)" + }, + { + "content": "25c", + "span": { + "offset": 6782, + "length": 3 + }, + "confidence": 0.969, + "source": "D(2,5.4453,2.5461,5.6445,2.5436,5.6445,2.6419,5.4453,2.6452)" + }, + { + "content": "2000", + "span": { + "offset": 6795, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,6.4207,2.5344,6.6697,2.5267,6.6697,2.6329,6.4207,2.641)" + }, + { + "content": "d", + "span": { + "offset": 6832, + "length": 1 + }, + "confidence": 0.967, + "source": "D(2,1.3935,2.7151,1.4692,2.7151,1.4692,2.8118,1.3935,2.8118)" + }, + { + "content": "Add", + "span": { + "offset": 6834, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,1.5792,2.7006,1.7927,2.7008,1.7927,2.8269,1.5792,2.8252)" + }, + { + "content": "lines", + "span": { + "offset": 6838, + "length": 5 + }, + "confidence": 0.996, + "source": "D(2,1.829,2.7008,2.0553,2.7011,2.0553,2.8289,1.829,2.8272)" + }, + { + "content": "25a", + "span": { + "offset": 6844, + "length": 3 + }, + "confidence": 0.983, + "source": "D(2,2.0831,2.7011,2.2688,2.7014,2.2689,2.8296,2.0831,2.829)" + }, + { + "content": "through", + "span": { + "offset": 6848, + "length": 7 + }, + "confidence": 0.984, + "source": "D(2,2.2945,2.7015,2.683,2.7023,2.6831,2.8301,2.2945,2.8297)" + }, + { + "content": "25c", + "span": { + "offset": 6856, + "length": 3 + }, + "confidence": 0.985, + "source": "D(2,2.7108,2.7023,2.9115,2.7028,2.9115,2.8299,2.7108,2.8301)" + }, + { + "content": "25d", + "span": { + "offset": 6869, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,6.7361,2.7085,6.9519,2.7136,6.9519,2.8157,6.7361,2.8102)" + }, + { + "content": ".", + "span": { + "offset": 6905, + "length": 1 + }, + "confidence": 0.841, + "source": "D(2,0.455,2.9315,0.4949,2.9324,0.4956,3.0288,0.4558,3.0278)" + }, + { + "content": "If", + "span": { + "offset": 6907, + "length": 2 + }, + "confidence": 0.879, + "source": "D(2,0.522,2.933,0.5794,2.9344,0.58,3.0311,0.5226,3.0296)" + }, + { + "content": "you", + "span": { + "offset": 6910, + "length": 3 + }, + "confidence": 0.993, + "source": "D(2,0.5922,2.9347,0.7374,2.9366,0.7376,3.0333,0.5927,3.0315)" + }, + { + "content": "have", + "span": { + "offset": 6914, + "length": 4 + }, + "confidence": 0.977, + "source": "D(2,0.7678,2.9368,0.9609,2.9361,0.9606,3.0309,0.7679,3.0333)" + }, + { + "content": "a", + "span": { + "offset": 6919, + "length": 1 + }, + "confidence": 0.989, + "source": "D(2,0.9832,2.9359,1.0423,2.9352,1.0417,3.0291,0.9828,3.0304)" + }, + { + "content": "qualifying", + "span": { + "offset": 6921, + "length": 10 + }, + "confidence": 0.996, + "source": "D(2,0.5157,3.0347,0.904,3.0347,0.9044,3.1313,0.5167,3.1313)" + }, + { + "content": "child", + "span": { + "offset": 6932, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,0.9278,3.0347,1.118,3.0347,1.118,3.1313,0.9281,3.1313)" + }, + { + "content": ",", + "span": { + "offset": 6937, + "length": 1 + }, + "confidence": 0.994, + "source": "D(2,1.1227,3.0347,1.1497,3.0347,1.1497,3.1313,1.1228,3.1313)" + }, + { + "content": "attach", + "span": { + "offset": 6939, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,0.5136,3.1318,0.7697,3.1293,0.7703,3.2241,0.5146,3.2222)" + }, + { + "content": "Sch", + "span": { + "offset": 6946, + "length": 3 + }, + "confidence": 0.989, + "source": "D(2,0.7947,3.1293,0.9492,3.1289,0.9496,3.2246,0.7953,3.2242)" + }, + { + "content": ".", + "span": { + "offset": 6949, + "length": 1 + }, + "confidence": 0.991, + "source": "D(2,0.9539,3.1289,0.9727,3.1291,0.973,3.2245,0.9543,3.2246)" + }, + { + "content": "EIC", + "span": { + "offset": 6951, + "length": 3 + }, + "confidence": 0.948, + "source": "D(2,1.0039,3.1293,1.1397,3.1301,1.1398,3.2239,1.0041,3.2244)" + }, + { + "content": ".", + "span": { + "offset": 6954, + "length": 1 + }, + "confidence": 0.991, + "source": "D(2,1.1428,3.1301,1.1631,3.1302,1.1631,3.2238,1.1429,3.2239)" + }, + { + "content": ".", + "span": { + "offset": 6956, + "length": 1 + }, + "confidence": 0.848, + "source": "D(2,0.4586,3.2528,0.4966,3.2529,0.4973,3.3442,0.4594,3.3441)" + }, + { + "content": "If", + "span": { + "offset": 6958, + "length": 2 + }, + "confidence": 0.932, + "source": "D(2,0.5239,3.253,0.5816,3.2532,0.5821,3.3445,0.5246,3.3443)" + }, + { + "content": "you", + "span": { + "offset": 6961, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,0.5937,3.2533,0.7409,3.2546,0.7413,3.3459,0.5943,3.3446)" + }, + { + "content": "have", + "span": { + "offset": 6965, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,0.7698,3.2549,0.9686,3.2584,0.9686,3.3497,0.7701,3.3463)" + }, + { + "content": "nontaxable", + "span": { + "offset": 6970, + "length": 10 + }, + "confidence": 0.996, + "source": "D(2,0.5157,3.3521,0.9722,3.3478,0.9722,3.4389,0.5165,3.4411)" + }, + { + "content": "combat", + "span": { + "offset": 6981, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,0.5149,3.4514,0.8277,3.4539,0.8273,3.5506,0.5154,3.5481)" + }, + { + "content": "pay", + "span": { + "offset": 6988, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.8484,3.4539,0.9993,3.4533,0.9983,3.55,0.8479,3.5506)" + }, + { + "content": ",", + "span": { + "offset": 6991, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,0.9977,3.4533,1.0231,3.4532,1.022,3.5499,0.9967,3.55)" + }, + { + "content": "see", + "span": { + "offset": 6993, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.5126,3.5537,0.6626,3.5536,0.6632,3.6448,0.5134,3.6454)" + }, + { + "content": "instructions", + "span": { + "offset": 6997, + "length": 12 + }, + "confidence": 0.997, + "source": "D(2,0.6889,3.5535,1.1514,3.556,1.1514,3.6484,0.6895,3.6447)" + }, + { + "content": ".", + "span": { + "offset": 7009, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.1545,3.556,1.1808,3.5563,1.1808,3.6488,1.1545,3.6484)" + }, + { + "content": "26", + "span": { + "offset": 7032, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2659,2.8762,1.4039,2.8762,1.4039,2.9836,1.2659,2.9836)" + }, + { + "content": "2020", + "span": { + "offset": 7035, + "length": 4 + }, + "confidence": 0.975, + "source": "D(2,1.5865,2.8704,1.8373,2.8707,1.8373,2.9974,1.5865,2.9965)" + }, + { + "content": "estimated", + "span": { + "offset": 7040, + "length": 9 + }, + "confidence": 0.994, + "source": "D(2,1.8728,2.8707,2.3577,2.8712,2.3577,2.9992,1.8728,2.9975)" + }, + { + "content": "tax", + "span": { + "offset": 7050, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,2.3932,2.8712,2.5479,2.8713,2.5479,2.9999,2.3932,2.9994)" + }, + { + "content": "payments", + "span": { + "offset": 7054, + "length": 8 + }, + "confidence": 0.997, + "source": "D(2,2.5792,2.8714,3.0662,2.8714,3.0662,2.9996,2.5792,3)" + }, + { + "content": "and", + "span": { + "offset": 7063, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,3.0954,2.8714,3.2773,2.8714,3.2773,2.9991,3.0954,2.9995)" + }, + { + "content": "amount", + "span": { + "offset": 7067, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,3.3128,2.8714,3.6953,2.8713,3.6952,2.9981,3.3128,2.999)" + }, + { + "content": "applied", + "span": { + "offset": 7074, + "length": 7 + }, + "confidence": 0.994, + "source": "D(2,3.7182,2.8713,4.0819,2.871,4.0819,2.9957,3.7182,2.998)" + }, + { + "content": "from", + "span": { + "offset": 7082, + "length": 4 + }, + "confidence": 0.946, + "source": "D(2,4.1133,2.871,4.3411,2.8707,4.3411,2.9936,4.1132,2.9955)" + }, + { + "content": "2019", + "span": { + "offset": 7087, + "length": 4 + }, + "confidence": 0.795, + "source": "D(2,4.3724,2.8706,4.6211,2.8703,4.6211,2.9912,4.3724,2.9933)" + }, + { + "content": "return", + "span": { + "offset": 7092, + "length": 6 + }, + "confidence": 0.933, + "source": "D(2,4.6546,2.8703,4.9639,2.8699,4.9639,2.9884,4.6546,2.9909)" + }, + { + "content": "26", + "span": { + "offset": 7108, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,2.8769,6.9146,2.8825,6.9146,2.9796,6.7776,2.9751)" + }, + { + "content": "5438", + "span": { + "offset": 7120, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,7.7156,2.8555,7.9646,2.8688,7.9646,2.9764,7.7156,2.9623)" + }, + { + "content": "27", + "span": { + "offset": 7145, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2659,3.0444,1.4039,3.0453,1.4039,3.148,1.2659,3.1435)" + }, + { + "content": "Earned", + "span": { + "offset": 7148, + "length": 6 + }, + "confidence": 0.992, + "source": "D(2,1.5896,3.0307,1.9389,3.0338,1.9389,3.1597,1.5896,3.1557)" + }, + { + "content": "income", + "span": { + "offset": 7155, + "length": 6 + }, + "confidence": 0.976, + "source": "D(2,1.9768,3.0342,2.3409,3.0357,2.3409,3.1621,1.9768,3.1602)" + }, + { + "content": "credit", + "span": { + "offset": 7162, + "length": 6 + }, + "confidence": 0.979, + "source": "D(2,2.3745,3.0358,2.6607,3.0357,2.6607,3.162,2.3745,3.1622)" + }, + { + "content": "(", + "span": { + "offset": 7169, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.686,3.0357,2.7196,3.0356,2.7197,3.1618,2.686,3.1619)" + }, + { + "content": "EIC", + "span": { + "offset": 7170, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,2.7218,3.0356,2.8859,3.0351,2.8859,3.1611,2.7218,3.1617)" + }, + { + "content": ")", + "span": { + "offset": 7173, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.8859,3.0351,2.9364,3.035,2.9364,3.1609,2.8859,3.1611)" + }, + { + "content": "27", + "span": { + "offset": 7184, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4661,3.0442,5.6155,3.044,5.6155,3.1433,5.4661,3.1436)" + }, + { + "content": "4359", + "span": { + "offset": 7196, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,6.4082,3.0302,6.6655,3.0294,6.6655,3.1314,6.4082,3.1323)" + }, + { + "content": "6534", + "span": { + "offset": 7232, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,7.7156,3.8645,7.9646,3.8645,7.9646,3.9666,7.7156,3.9666)" + }, + { + "content": "28", + "span": { + "offset": 7257, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,3.2082,1.4039,3.2101,1.4039,3.3088,1.2669,3.3088)" + }, + { + "content": "Additional", + "span": { + "offset": 7260, + "length": 10 + }, + "confidence": 0.999, + "source": "D(2,1.5844,3.2015,2.0869,3.2009,2.0869,3.3203,1.5844,3.3212)" + }, + { + "content": "child", + "span": { + "offset": 7271, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,2.1225,3.2008,2.356,3.2005,2.356,3.3199,2.1225,3.3203)" + }, + { + "content": "tax", + "span": { + "offset": 7277, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,2.3896,3.2005,2.5439,3.2005,2.5439,3.3196,2.3896,3.3198)" + }, + { + "content": "credit", + "span": { + "offset": 7281, + "length": 6 + }, + "confidence": 0.993, + "source": "D(2,2.5736,3.2005,2.8545,3.2005,2.8545,3.3193,2.5736,3.3196)" + }, + { + "content": ".", + "span": { + "offset": 7287, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,2.8604,3.2005,2.8802,3.2005,2.8802,3.3193,2.8604,3.3193)" + }, + { + "content": "Attach", + "span": { + "offset": 7289, + "length": 6 + }, + "confidence": 0.994, + "source": "D(2,2.9099,3.2005,3.2363,3.2006,3.2363,3.3189,2.9099,3.3192)" + }, + { + "content": "Schedule", + "span": { + "offset": 7296, + "length": 8 + }, + "confidence": 0.99, + "source": "D(2,3.268,3.2006,3.7408,3.2012,3.7408,3.3187,3.268,3.3189)" + }, + { + "content": "8812", + "span": { + "offset": 7305, + "length": 4 + }, + "confidence": 0.968, + "source": "D(2,3.7626,3.2013,4.0217,3.2016,4.0217,3.3185,3.7626,3.3186)" + }, + { + "content": "28", + "span": { + "offset": 7319, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,3.2115,5.6155,3.2099,5.6155,3.3086,5.4744,3.3086)" + }, + { + "content": "5326", + "span": { + "offset": 7331, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,6.4041,3.1915,6.6655,3.203,6.6655,3.3104,6.4041,3.2989)" + }, + { + "content": "29", + "span": { + "offset": 7378, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,3.3757,1.407,3.3757,1.407,3.4778,1.2669,3.4778)" + }, + { + "content": "American", + "span": { + "offset": 7381, + "length": 8 + }, + "confidence": 0.999, + "source": "D(2,1.5823,3.3689,2.06,3.3669,2.06,3.4958,1.5823,3.4969)" + }, + { + "content": "opportunity", + "span": { + "offset": 7390, + "length": 11 + }, + "confidence": 0.999, + "source": "D(2,2.0917,3.3667,2.6687,3.3648,2.6687,3.4941,2.0917,3.4957)" + }, + { + "content": "credit", + "span": { + "offset": 7402, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,2.6962,3.3648,2.9773,3.3642,2.9773,3.4931,2.6962,3.494)" + }, + { + "content": "from", + "span": { + "offset": 7409, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,3.0027,3.3642,3.233,3.3637,3.2331,3.4922,3.0027,3.493)" + }, + { + "content": "Form", + "span": { + "offset": 7414, + "length": 4 + }, + "confidence": 0.992, + "source": "D(2,3.2711,3.3636,3.5226,3.3636,3.5226,3.491,3.2711,3.4921)" + }, + { + "content": "8863", + "span": { + "offset": 7419, + "length": 4 + }, + "confidence": 0.969, + "source": "D(2,3.5585,3.3636,3.8016,3.3636,3.8016,3.4897,3.5585,3.4908)" + }, + { + "content": ",", + "span": { + "offset": 7423, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.8037,3.3636,3.827,3.3636,3.827,3.4896,3.8037,3.4897)" + }, + { + "content": "line", + "span": { + "offset": 7425, + "length": 4 + }, + "confidence": 0.865, + "source": "D(2,3.8629,3.3636,4.0362,3.3636,4.0362,3.4887,3.8629,3.4895)" + }, + { + "content": "8", + "span": { + "offset": 7430, + "length": 1 + }, + "confidence": 0.948, + "source": "D(2,4.0658,3.3636,4.1525,3.3636,4.1525,3.4882,4.0658,3.4886)" + }, + { + "content": "29", + "span": { + "offset": 7441, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,3.3757,5.6155,3.3757,5.6155,3.4778,5.4744,3.4778)" + }, + { + "content": "6743", + "span": { + "offset": 7453, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,6.4041,3.3677,6.6531,3.3677,6.6531,3.4697,6.4041,3.4697)" + }, + { + "content": "30", + "span": { + "offset": 7478, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,3.5505,1.4039,3.5505,1.4039,3.6522,1.2669,3.6513)" + }, + { + "content": "Recovery", + "span": { + "offset": 7481, + "length": 8 + }, + "confidence": 0.994, + "source": "D(2,1.5886,3.5412,2.0618,3.5385,2.0618,3.6661,1.5886,3.6669)" + }, + { + "content": "rebate", + "span": { + "offset": 7490, + "length": 6 + }, + "confidence": 0.995, + "source": "D(2,2.0931,3.5384,2.4079,3.5375,2.4079,3.6655,2.0931,3.6661)" + }, + { + "content": "credit", + "span": { + "offset": 7497, + "length": 6 + }, + "confidence": 0.955, + "source": "D(2,2.4371,3.5375,2.7186,3.5375,2.7186,3.6649,2.4371,3.6655)" + }, + { + "content": ".", + "span": { + "offset": 7503, + "length": 1 + }, + "confidence": 0.985, + "source": "D(2,2.7207,3.5375,2.7436,3.5375,2.7436,3.6648,2.7207,3.6649)" + }, + { + "content": "See", + "span": { + "offset": 7505, + "length": 3 + }, + "confidence": 0.961, + "source": "D(2,2.7811,3.5375,2.9709,3.5378,2.9709,3.6644,2.7811,3.6648)" + }, + { + "content": "instructions", + "span": { + "offset": 7509, + "length": 12 + }, + "confidence": 0.986, + "source": "D(2,3.0063,3.538,3.5901,3.5415,3.5901,3.6628,3.0063,3.6643)" + }, + { + "content": "30", + "span": { + "offset": 7531, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4827,3.5503,5.6155,3.5503,5.6155,3.647,5.4827,3.647)" + }, + { + "content": "4562", + "span": { + "offset": 7543, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,6.4207,3.5347,6.6655,3.537,6.6655,3.6391,6.4207,3.6368)" + }, + { + "content": "31", + "span": { + "offset": 7568, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,3.7213,1.3956,3.7179,1.3956,3.8201,1.2669,3.8223)" + }, + { + "content": "Amount", + "span": { + "offset": 7571, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,1.5844,3.709,1.9875,3.7083,1.9875,3.8304,1.5844,3.8286)" + }, + { + "content": "from", + "span": { + "offset": 7578, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,2.0137,3.7083,2.2334,3.708,2.2334,3.8311,2.0137,3.8305)" + }, + { + "content": "Schedule", + "span": { + "offset": 7583, + "length": 8 + }, + "confidence": 0.973, + "source": "D(2,2.2676,3.7081,2.7433,3.7082,2.7433,3.8311,2.2676,3.8311)" + }, + { + "content": "3", + "span": { + "offset": 7592, + "length": 1 + }, + "confidence": 0.963, + "source": "D(2,2.7735,3.7083,2.832,3.7084,2.832,3.8307,2.7735,3.8309)" + }, + { + "content": ",", + "span": { + "offset": 7593, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,2.834,3.7084,2.8582,3.7084,2.8582,3.8306,2.834,3.8307)" + }, + { + "content": "line", + "span": { + "offset": 7595, + "length": 4 + }, + "confidence": 0.916, + "source": "D(2,2.8924,3.7085,3.0617,3.7088,3.0617,3.8299,2.8924,3.8305)" + }, + { + "content": "13", + "span": { + "offset": 7600, + "length": 2 + }, + "confidence": 0.95, + "source": "D(2,3.096,3.7089,3.229,3.7092,3.229,3.8293,3.096,3.8298)" + }, + { + "content": "31", + "span": { + "offset": 7612, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,3.7161,5.603,3.7149,5.603,3.8143,5.4744,3.8155)" + }, + { + "content": "2428", + "span": { + "offset": 7624, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,6.4041,3.693,6.6655,3.6913,6.6655,3.7959,6.4041,3.7968)" + }, + { + "content": "32", + "span": { + "offset": 7661, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2679,3.8745,1.408,3.8766,1.408,3.9773,1.2679,3.9773)" + }, + { + "content": "Add", + "span": { + "offset": 7664, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,1.5792,3.8614,1.7932,3.8616,1.7942,3.99,1.5803,3.9895)" + }, + { + "content": "lines", + "span": { + "offset": 7668, + "length": 5 + }, + "confidence": 0.944, + "source": "D(2,1.8289,3.8617,2.0534,3.8619,2.0543,3.9905,1.8299,3.9901)" + }, + { + "content": "27", + "span": { + "offset": 7674, + "length": 2 + }, + "confidence": 0.918, + "source": "D(2,2.0807,3.862,2.2045,3.8621,2.2054,3.9908,2.0816,3.9906)" + }, + { + "content": "through", + "span": { + "offset": 7677, + "length": 7 + }, + "confidence": 0.844, + "source": "D(2,2.2296,3.8621,2.6199,3.8626,2.6207,3.9917,2.2305,3.9909)" + }, + { + "content": "31", + "span": { + "offset": 7685, + "length": 2 + }, + "confidence": 0.657, + "source": "D(2,2.6535,3.8626,2.7626,3.8627,2.7633,3.992,2.6543,3.9918)" + }, + { + "content": ".", + "span": { + "offset": 7687, + "length": 1 + }, + "confidence": 0.941, + "source": "D(2,2.7815,3.8627,2.8066,3.8628,2.8074,3.9921,2.7822,3.992)" + }, + { + "content": "These", + "span": { + "offset": 7689, + "length": 5 + }, + "confidence": 0.703, + "source": "D(2,2.836,3.8628,3.1423,3.8632,3.143,3.9924,2.8367,3.9921)" + }, + { + "content": "are", + "span": { + "offset": 7695, + "length": 3 + }, + "confidence": 0.985, + "source": "D(2,3.1717,3.8632,3.3291,3.8635,3.3297,3.9923,3.1724,3.9924)" + }, + { + "content": "your", + "span": { + "offset": 7699, + "length": 4 + }, + "confidence": 0.979, + "source": "D(2,3.3564,3.8635,3.585,3.8639,3.5856,3.9921,3.357,3.9923)" + }, + { + "content": "total", + "span": { + "offset": 7704, + "length": 5 + }, + "confidence": 0.98, + "source": "D(2,3.6081,3.8639,3.8452,3.8643,3.8457,3.9919,3.6087,3.9921)" + }, + { + "content": "other", + "span": { + "offset": 7710, + "length": 5 + }, + "confidence": 0.988, + "source": "D(2,3.8746,3.8643,4.1641,3.8648,4.1646,3.9917,3.8751,3.9919)" + }, + { + "content": "payments", + "span": { + "offset": 7716, + "length": 8 + }, + "confidence": 0.968, + "source": "D(2,4.1914,3.8648,4.7118,3.8657,4.712,3.9906,4.1918,3.9916)" + }, + { + "content": "and", + "span": { + "offset": 7725, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,4.739,3.8658,4.93,3.8661,4.9302,3.9898,4.7393,3.9905)" + }, + { + "content": "refundable", + "span": { + "offset": 7729, + "length": 10 + }, + "confidence": 0.97, + "source": "D(2,4.9698,3.8662,5.5384,3.8673,5.5385,3.9876,4.9701,3.9897)" + }, + { + "content": "credits", + "span": { + "offset": 7740, + "length": 7 + }, + "confidence": 0.947, + "source": "D(2,5.5678,3.8674,5.9434,3.8681,5.9434,3.9862,5.5679,3.9875)" + }, + { + "content": "32", + "span": { + "offset": 7757, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,3.8747,6.9146,3.8777,6.9146,3.9773,6.7776,3.9773)" + }, + { + "content": "33", + "span": { + "offset": 7792, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2669,4.0391,1.408,4.043,1.408,4.1451,1.2669,4.1412)" + }, + { + "content": "Add", + "span": { + "offset": 7795, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,1.5803,4.0283,1.7921,4.0283,1.7921,4.1562,1.5803,4.156)" + }, + { + "content": "lines", + "span": { + "offset": 7799, + "length": 5 + }, + "confidence": 0.953, + "source": "D(2,1.8306,4.0283,2.0532,4.0283,2.0532,4.1566,1.8306,4.1563)" + }, + { + "content": "25d", + "span": { + "offset": 7805, + "length": 3 + }, + "confidence": 0.974, + "source": "D(2,2.0832,4.0283,2.2694,4.0283,2.2694,4.1568,2.0832,4.1566)" + }, + { + "content": ",", + "span": { + "offset": 7808, + "length": 1 + }, + "confidence": 0.995, + "source": "D(2,2.2779,4.0283,2.3015,4.0283,2.3015,4.1569,2.2779,4.1568)" + }, + { + "content": "26", + "span": { + "offset": 7810, + "length": 2 + }, + "confidence": 0.966, + "source": "D(2,2.3357,4.0283,2.4598,4.0283,2.4598,4.157,2.3357,4.1569)" + }, + { + "content": ",", + "span": { + "offset": 7812, + "length": 1 + }, + "confidence": 0.992, + "source": "D(2,2.462,4.0283,2.4876,4.0283,2.4876,4.1571,2.462,4.157)" + }, + { + "content": "and", + "span": { + "offset": 7814, + "length": 3 + }, + "confidence": 0.971, + "source": "D(2,2.524,4.0283,2.7059,4.0283,2.7059,4.1572,2.524,4.1571)" + }, + { + "content": "32", + "span": { + "offset": 7818, + "length": 2 + }, + "confidence": 0.853, + "source": "D(2,2.7423,4.0283,2.8621,4.0283,2.8621,4.1573,2.7423,4.1572)" + }, + { + "content": ".", + "span": { + "offset": 7820, + "length": 1 + }, + "confidence": 0.973, + "source": "D(2,2.8686,4.0283,2.8921,4.0283,2.8921,4.1573,2.8686,4.1573)" + }, + { + "content": "These", + "span": { + "offset": 7822, + "length": 5 + }, + "confidence": 0.82, + "source": "D(2,2.9242,4.0283,3.2324,4.0283,3.2324,4.1574,2.9242,4.1573)" + }, + { + "content": "are", + "span": { + "offset": 7828, + "length": 3 + }, + "confidence": 0.987, + "source": "D(2,3.2602,4.0283,3.4143,4.0283,3.4143,4.1574,3.2602,4.1574)" + }, + { + "content": "your", + "span": { + "offset": 7832, + "length": 4 + }, + "confidence": 0.97, + "source": "D(2,3.44,4.0283,3.6711,4.0283,3.6711,4.1574,3.44,4.1574)" + }, + { + "content": "total", + "span": { + "offset": 7837, + "length": 5 + }, + "confidence": 0.958, + "source": "D(2,3.6946,4.0283,3.93,4.0283,3.93,4.1572,3.6946,4.1574)" + }, + { + "content": "payments", + "span": { + "offset": 7843, + "length": 8 + }, + "confidence": 0.976, + "source": "D(2,3.9643,4.0283,4.4907,4.0283,4.4907,4.1569,3.9643,4.1572)" + }, + { + "content": "33", + "span": { + "offset": 7861, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,4.041,6.9146,4.0444,6.9146,4.1429,6.7776,4.1437)" + }, + { + "content": "3657", + "span": { + "offset": 7873, + "length": 4 + }, + "confidence": 0.989, + "source": "D(2,7.7156,4.0341,7.9563,4.0333,7.9563,4.1407,7.7156,4.1415)" + }, + { + "content": "Refund", + "span": { + "offset": 7910, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,0.4918,4.2485,0.9857,4.2485,0.9852,4.3774,0.4926,4.3774)" + }, + { + "content": "Direct", + "span": { + "offset": 7917, + "length": 6 + }, + "confidence": 0.998, + "source": "D(2,0.4913,4.5339,0.747,4.5285,0.747,4.6388,0.4913,4.64)" + }, + { + "content": "deposit", + "span": { + "offset": 7924, + "length": 7 + }, + "confidence": 0.998, + "source": "D(2,0.7673,4.5281,1.0841,4.5224,1.0841,4.6354,0.7673,4.6386)" + }, + { + "content": "?", + "span": { + "offset": 7931, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.086,4.5224,1.1434,4.5214,1.1434,4.6346,1.086,4.6353)" + }, + { + "content": "See", + "span": { + "offset": 7933, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.49,4.6515,0.6549,4.6522,0.6555,4.7563,0.4908,4.7541)" + }, + { + "content": "instructions", + "span": { + "offset": 7937, + "length": 12 + }, + "confidence": 0.997, + "source": "D(2,0.6841,4.6524,1.1703,4.656,1.1703,4.7587,0.6847,4.7567)" + }, + { + "content": ".", + "span": { + "offset": 7949, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.1737,4.656,1.2047,4.6563,1.2047,4.7587,1.1738,4.7587)" + }, + { + "content": "34", + "span": { + "offset": 7972, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2648,4.203,1.408,4.2181,1.408,4.3206,1.2648,4.3017)" + }, + { + "content": "If", + "span": { + "offset": 7975, + "length": 2 + }, + "confidence": 0.945, + "source": "D(2,1.5792,4.1988,1.6614,4.199,1.6634,4.3204,1.5813,4.32)" + }, + { + "content": "line", + "span": { + "offset": 7978, + "length": 4 + }, + "confidence": 0.878, + "source": "D(2,1.686,4.199,1.8524,4.1994,1.8543,4.3213,1.688,4.3205)" + }, + { + "content": "33", + "span": { + "offset": 7983, + "length": 2 + }, + "confidence": 0.877, + "source": "D(2,1.8832,4.1994,2.0064,4.1997,2.0083,4.322,1.8851,4.3214)" + }, + { + "content": "is", + "span": { + "offset": 7986, + "length": 2 + }, + "confidence": 0.94, + "source": "D(2,2.0413,4.1997,2.1173,4.1999,2.1191,4.3225,2.0432,4.3222)" + }, + { + "content": "more", + "span": { + "offset": 7989, + "length": 4 + }, + "confidence": 0.981, + "source": "D(2,2.1502,4.2,2.4028,4.2005,2.4045,4.3239,2.152,4.3227)" + }, + { + "content": "than", + "span": { + "offset": 7994, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,2.4315,4.2005,2.6513,4.201,2.6529,4.3251,2.4332,4.324)" + }, + { + "content": "line", + "span": { + "offset": 7999, + "length": 4 + }, + "confidence": 0.949, + "source": "D(2,2.6882,4.2011,2.8566,4.2014,2.8581,4.326,2.6898,4.3252)" + }, + { + "content": "24", + "span": { + "offset": 8004, + "length": 2 + }, + "confidence": 0.919, + "source": "D(2,2.8875,4.2015,3.0127,4.2017,3.0142,4.3268,2.8889,4.3262)" + }, + { + "content": ",", + "span": { + "offset": 8006, + "length": 1 + }, + "confidence": 0.992, + "source": "D(2,3.0168,4.2017,3.0415,4.2018,3.0429,4.3269,3.0183,4.3268)" + }, + { + "content": "subtract", + "span": { + "offset": 8008, + "length": 8 + }, + "confidence": 0.969, + "source": "D(2,3.0764,4.2018,3.4871,4.2029,3.4884,4.3281,3.0778,4.3271)" + }, + { + "content": "line", + "span": { + "offset": 8017, + "length": 4 + }, + "confidence": 0.961, + "source": "D(2,3.518,4.203,3.6864,4.2034,3.6875,4.3286,3.5192,4.3282)" + }, + { + "content": "24", + "span": { + "offset": 8022, + "length": 2 + }, + "confidence": 0.916, + "source": "D(2,3.7151,4.2035,3.8424,4.2038,3.8435,4.3289,3.7162,4.3286)" + }, + { + "content": "from", + "span": { + "offset": 8025, + "length": 4 + }, + "confidence": 0.908, + "source": "D(2,3.8691,4.2039,4.0951,4.2045,4.096,4.3295,3.8702,4.329)" + }, + { + "content": "line", + "span": { + "offset": 8030, + "length": 4 + }, + "confidence": 0.877, + "source": "D(2,4.13,4.2046,4.3004,4.205,4.3013,4.33,4.1309,4.3296)" + }, + { + "content": "33", + "span": { + "offset": 8035, + "length": 2 + }, + "confidence": 0.529, + "source": "D(2,4.3312,4.2051,4.4545,4.2054,4.4552,4.3304,4.3321,4.3301)" + }, + { + "content": ".", + "span": { + "offset": 8037, + "length": 1 + }, + "confidence": 0.897, + "source": "D(2,4.4586,4.2054,4.4812,4.2055,4.4819,4.3304,4.4593,4.3304)" + }, + { + "content": "This", + "span": { + "offset": 8039, + "length": 4 + }, + "confidence": 0.526, + "source": "D(2,4.514,4.2056,4.7276,4.2062,4.7283,4.3308,4.5148,4.3305)" + }, + { + "content": "is", + "span": { + "offset": 8044, + "length": 2 + }, + "confidence": 0.968, + "source": "D(2,4.7564,4.2063,4.8344,4.2065,4.835,4.3307,4.757,4.3308)" + }, + { + "content": "the", + "span": { + "offset": 8047, + "length": 3 + }, + "confidence": 0.93, + "source": "D(2,4.8631,4.2066,5.0233,4.2071,5.0239,4.3307,4.8637,4.3307)" + }, + { + "content": "amount", + "span": { + "offset": 8051, + "length": 6 + }, + "confidence": 0.943, + "source": "D(2,5.0521,4.2072,5.4361,4.2085,5.4365,4.3307,5.0526,4.3307)" + }, + { + "content": "you", + "span": { + "offset": 8058, + "length": 3 + }, + "confidence": 0.973, + "source": "D(2,5.4587,4.2085,5.6436,4.2091,5.6438,4.3307,5.459,4.3307)" + }, + { + "content": "overpaid", + "span": { + "offset": 8062, + "length": 8 + }, + "confidence": 0.797, + "source": "D(2,5.6785,4.2092,6.1467,4.2107,6.1467,4.3307,5.6787,4.3307)" + }, + { + "content": ".", + "span": { + "offset": 8071, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.3426,4.2892,6.3549,4.2892,6.3549,4.3016,6.3426,4.3016)" + }, + { + "content": ".", + "span": { + "offset": 8073, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.5092,4.2892,6.5216,4.2892,6.5216,4.3016,6.5092,4.3016)" + }, + { + "content": "34", + "span": { + "offset": 8084, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,4.2182,6.9146,4.2178,6.9146,4.3172,6.7776,4.3175)" + }, + { + "content": "6338", + "span": { + "offset": 8096, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,7.7156,4.2002,7.9646,4.2002,7.9646,4.3055,7.7156,4.3041)" + }, + { + "content": "35a", + "span": { + "offset": 8133, + "length": 3 + }, + "confidence": 0.942, + "source": "D(2,1.27,4.3774,1.4641,4.3774,1.4641,4.4792,1.27,4.4783)" + }, + { + "content": "5a", + "span": { + "offset": 8137, + "length": 2 + }, + "confidence": 0.948, + "source": "D(2,1.3302,4.3724,1.4544,4.3724,1.4544,4.4868,1.3302,4.4865)" + }, + { + "content": "Amount", + "span": { + "offset": 8140, + "length": 6 + }, + "confidence": 0.976, + "source": "D(2,1.5843,4.3724,1.9879,4.3724,1.9879,4.4883,1.5843,4.4872)" + }, + { + "content": "of", + "span": { + "offset": 8147, + "length": 2 + }, + "confidence": 0.993, + "source": "D(2,2.015,4.3724,2.1159,4.3725,2.1159,4.4887,2.015,4.4884)" + }, + { + "content": "line", + "span": { + "offset": 8150, + "length": 4 + }, + "confidence": 0.903, + "source": "D(2,2.1411,4.3725,2.3118,4.3725,2.3118,4.4892,2.1411,4.4887)" + }, + { + "content": "34", + "span": { + "offset": 8155, + "length": 2 + }, + "confidence": 0.796, + "source": "D(2,2.3409,4.3725,2.467,4.3725,2.467,4.4896,2.3409,4.4893)" + }, + { + "content": "you", + "span": { + "offset": 8158, + "length": 3 + }, + "confidence": 0.87, + "source": "D(2,2.4942,4.3725,2.6785,4.3725,2.6785,4.4902,2.4942,4.4897)" + }, + { + "content": "want", + "span": { + "offset": 8162, + "length": 4 + }, + "confidence": 0.986, + "source": "D(2,2.7095,4.3725,2.9578,4.3727,2.9578,4.4907,2.7095,4.4903)" + }, + { + "content": "refunded", + "span": { + "offset": 8167, + "length": 8 + }, + "confidence": 0.975, + "source": "D(2,2.9908,4.3727,3.4525,4.373,3.4525,4.4912,2.9908,4.4907)" + }, + { + "content": "to", + "span": { + "offset": 8176, + "length": 2 + }, + "confidence": 0.972, + "source": "D(2,3.4836,4.373,3.5922,4.3731,3.5922,4.4913,3.4836,4.4912)" + }, + { + "content": "you", + "span": { + "offset": 8179, + "length": 3 + }, + "confidence": 0.783, + "source": "D(2,3.6213,4.3731,3.8114,4.3733,3.8114,4.4915,3.6213,4.4913)" + }, + { + "content": ".", + "span": { + "offset": 8182, + "length": 1 + }, + "confidence": 0.928, + "source": "D(2,3.8211,4.3733,3.8444,4.3733,3.8444,4.4915,3.8211,4.4915)" + }, + { + "content": "If", + "span": { + "offset": 8184, + "length": 2 + }, + "confidence": 0.775, + "source": "D(2,3.8832,4.3733,3.9453,4.3734,3.9453,4.4916,3.8832,4.4916)" + }, + { + "content": "Form", + "span": { + "offset": 8187, + "length": 4 + }, + "confidence": 0.763, + "source": "D(2,3.9724,4.3734,4.2285,4.3736,4.2285,4.4919,3.9725,4.4917)" + }, + { + "content": "8888", + "span": { + "offset": 8192, + "length": 4 + }, + "confidence": 0.833, + "source": "D(2,4.2596,4.3736,4.5098,4.3739,4.5098,4.4917,4.2596,4.4919)" + }, + { + "content": "is", + "span": { + "offset": 8197, + "length": 2 + }, + "confidence": 0.953, + "source": "D(2,4.5447,4.374,4.6185,4.3741,4.6185,4.4916,4.5447,4.4917)" + }, + { + "content": "attached", + "span": { + "offset": 8200, + "length": 8 + }, + "confidence": 0.915, + "source": "D(2,4.6495,4.3741,5.0821,4.3746,5.0821,4.4912,4.6495,4.4916)" + }, + { + "content": ",", + "span": { + "offset": 8208, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,5.0841,4.3746,5.1112,4.3747,5.1112,4.4912,5.0841,4.4912)" + }, + { + "content": "check", + "span": { + "offset": 8210, + "length": 5 + }, + "confidence": 0.933, + "source": "D(2,5.1442,4.3747,5.4527,4.3751,5.4527,4.4909,5.1442,4.4911)" + }, + { + "content": "here", + "span": { + "offset": 8216, + "length": 4 + }, + "confidence": 0.944, + "source": "D(2,5.4779,4.3751,5.7068,4.3754,5.7068,4.4906,5.4779,4.4908)" + }, + { + "content": "☐", + "span": { + "offset": 8221, + "length": 1 + }, + "confidence": 0.963, + "source": "D(2,6.458,4.364,6.5742,4.3694,6.5742,4.4875,6.458,4.4822)" + }, + { + "content": ".", + "span": { + "offset": 8223, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.8426,4.4559,5.855,4.4559,5.855,4.4682,5.8426,4.4682)" + }, + { + "content": ".", + "span": { + "offset": 8225, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.0093,4.4559,6.0216,4.4559,6.0216,4.4682,6.0093,4.4682)" + }, + { + "content": ".", + "span": { + "offset": 8227, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.176,4.4559,6.1883,4.4559,6.1883,4.4682,6.176,4.4682)" + }, + { + "content": "35a", + "span": { + "offset": 8238, + "length": 3 + }, + "confidence": 0.954, + "source": "D(2,6.7485,4.3781,6.9478,4.3796,6.9478,4.4768,6.7485,4.4768)" + }, + { + "content": "6335", + "span": { + "offset": 8251, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,7.7156,4.3613,7.9646,4.3613,7.9646,4.4688,7.7156,4.4688)" + }, + { + "content": "b", + "span": { + "offset": 8288, + "length": 1 + }, + "confidence": 0.872, + "source": "D(2,1.2939,4.5375,1.4624,4.5376,1.4624,4.6576,1.2939,4.6548)" + }, + { + "content": "Routing", + "span": { + "offset": 8290, + "length": 7 + }, + "confidence": 0.991, + "source": "D(2,1.5964,4.5377,1.9577,4.5385,1.9577,4.6626,1.5964,4.6598)" + }, + { + "content": "number", + "span": { + "offset": 8298, + "length": 6 + }, + "confidence": 0.996, + "source": "D(2,1.9902,4.5386,2.3657,4.5401,2.3657,4.6612,1.9902,4.6628)" + }, + { + "content": "052088863", + "span": { + "offset": 8305, + "length": 9 + }, + "confidence": 0.999, + "source": "D(2,2.4031,4.5033,4.2002,4.5015,4.2002,4.6534,2.4031,4.6507)" + }, + { + "content": "▶", + "span": { + "offset": 8315, + "length": 1 + }, + "confidence": 0.916, + "source": "D(2,4.5903,4.5416,4.6779,4.5411,4.6778,4.6594,4.5903,4.6597)" + }, + { + "content": "c", + "span": { + "offset": 8317, + "length": 1 + }, + "confidence": 0.954, + "source": "D(2,4.7071,4.541,4.7713,4.541,4.7712,4.6595,4.707,4.6593)" + }, + { + "content": "Type", + "span": { + "offset": 8319, + "length": 4 + }, + "confidence": 0.965, + "source": "D(2,4.7986,4.5415,5.0514,4.5499,5.0514,4.668,4.7984,4.6601)" + }, + { + "content": ":", + "span": { + "offset": 8323, + "length": 1 + }, + "confidence": 0.994, + "source": "D(2,5.0514,4.5499,5.0884,4.5516,5.0884,4.6696,5.0514,4.668)" + }, + { + "content": "☐", + "span": { + "offset": 8325, + "length": 1 + }, + "confidence": 0.964, + "source": "D(2,5.2336,4.5359,5.354,4.5359,5.354,4.6594,5.2336,4.6567)" + }, + { + "content": "Checking", + "span": { + "offset": 8327, + "length": 8 + }, + "confidence": 0.998, + "source": "D(2,5.3914,4.5417,5.8728,4.5435,5.8728,4.6594,5.3914,4.656)" + }, + { + "content": "☑", + "span": { + "offset": 8336, + "length": 1 + }, + "confidence": 0.953, + "source": "D(2,6.0264,4.5386,6.1633,4.5386,6.1633,4.6621,6.0264,4.6621)" + }, + { + "content": "Savings", + "span": { + "offset": 8338, + "length": 7 + }, + "confidence": 0.997, + "source": "D(2,6.1924,4.5401,6.595,4.5444,6.595,4.6591,6.1924,4.6582)" + }, + { + "content": "▶", + "span": { + "offset": 8422, + "length": 1 + }, + "confidence": 0.906, + "source": "D(2,1.2897,4.7059,1.368,4.7057,1.368,4.8154,1.2897,4.815)" + }, + { + "content": "d", + "span": { + "offset": 8423, + "length": 1 + }, + "confidence": 0.972, + "source": "D(2,1.383,4.7057,1.4557,4.7056,1.4557,4.8159,1.383,4.8155)" + }, + { + "content": "Account", + "span": { + "offset": 8425, + "length": 7 + }, + "confidence": 0.995, + "source": "D(2,1.5825,4.7053,1.9796,4.706,1.9796,4.8188,1.5824,4.8165)" + }, + { + "content": "number", + "span": { + "offset": 8433, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,2.0038,4.7061,2.3636,4.7087,2.3636,4.8214,2.0038,4.819)" + }, + { + "content": "5206340044401004", + "span": { + "offset": 8440, + "length": 16 + }, + "confidence": 0.983, + "source": "D(2,2.3969,4.6552,5.603,4.6661,5.603,4.8278,2.3969,4.8236)" + }, + { + "content": "36", + "span": { + "offset": 8477, + "length": 2 + }, + "confidence": 0.981, + "source": "D(2,1.2617,4.8622,1.3943,4.862,1.3943,4.9813,1.2617,4.9807)" + }, + { + "content": "Amount", + "span": { + "offset": 8480, + "length": 6 + }, + "confidence": 0.977, + "source": "D(2,1.584,4.8618,1.9857,4.8613,1.9857,4.9842,1.584,4.9823)" + }, + { + "content": "of", + "span": { + "offset": 8487, + "length": 2 + }, + "confidence": 0.995, + "source": "D(2,2.0123,4.8612,2.1183,4.8611,2.1183,4.9848,2.0123,4.9843)" + }, + { + "content": "line", + "span": { + "offset": 8490, + "length": 4 + }, + "confidence": 0.955, + "source": "D(2,2.1346,4.8611,2.3039,4.8609,2.3039,4.9857,2.1346,4.9849)" + }, + { + "content": "34", + "span": { + "offset": 8495, + "length": 2 + }, + "confidence": 0.805, + "source": "D(2,2.3365,4.8608,2.4548,4.8607,2.4548,4.9864,2.3365,4.9859)" + }, + { + "content": "you", + "span": { + "offset": 8498, + "length": 3 + }, + "confidence": 0.85, + "source": "D(2,2.4854,4.8607,2.6669,4.8607,2.6669,4.9866,2.4854,4.9864)" + }, + { + "content": "want", + "span": { + "offset": 8502, + "length": 4 + }, + "confidence": 0.982, + "source": "D(2,2.7016,4.8608,2.9423,4.8608,2.9423,4.9868,2.7016,4.9866)" + }, + { + "content": "applied", + "span": { + "offset": 8507, + "length": 7 + }, + "confidence": 0.96, + "source": "D(2,2.9708,4.8608,3.3461,4.8609,3.3461,4.9871,2.9708,4.9868)" + }, + { + "content": "to", + "span": { + "offset": 8515, + "length": 2 + }, + "confidence": 0.987, + "source": "D(2,3.3808,4.8609,3.4868,4.861,3.4868,4.9872,3.3808,4.9871)" + }, + { + "content": "your", + "span": { + "offset": 8518, + "length": 4 + }, + "confidence": 0.827, + "source": "D(2,3.5133,4.861,3.754,4.8612,3.754,4.9869,3.5133,4.9872)" + }, + { + "content": "2021", + "span": { + "offset": 8523, + "length": 4 + }, + "confidence": 0.476, + "source": "D(2,3.7764,4.8612,4.015,4.8617,4.015,4.9861,3.7764,4.9869)" + }, + { + "content": "estimated", + "span": { + "offset": 8528, + "length": 9 + }, + "confidence": 0.639, + "source": "D(2,4.0558,4.8617,4.5739,4.8626,4.5739,4.9843,4.0558,4.986)" + }, + { + "content": "tax", + "span": { + "offset": 8538, + "length": 3 + }, + "confidence": 0.955, + "source": "D(2,4.6085,4.8627,4.8186,4.8631,4.8186,4.9835,4.6085,4.9842)" + }, + { + "content": "36", + "span": { + "offset": 8551, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,5.4744,4.8668,5.6196,4.8768,5.6196,4.9842,5.4744,4.9742)" + }, + { + "content": "45830", + "span": { + "offset": 8563, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,6.3459,4.8677,6.6655,4.8686,6.6655,4.9719,6.3459,4.9721)" + }, + { + "content": "Amount", + "span": { + "offset": 8601, + "length": 6 + }, + "confidence": 0.999, + "source": "D(2,0.491,5.0408,1.0293,5.0408,1.0272,5.164,0.4913,5.1631)" + }, + { + "content": "You", + "span": { + "offset": 8608, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,0.4918,5.1804,0.7456,5.1804,0.7461,5.3064,0.4926,5.3051)" + }, + { + "content": "Owe", + "span": { + "offset": 8612, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,0.7816,5.1804,1.1009,5.1804,1.1009,5.3065,0.782,5.3065)" + }, + { + "content": "For", + "span": { + "offset": 8616, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,0.4929,5.3408,0.6436,5.3419,0.6433,5.4467,0.4934,5.4453)" + }, + { + "content": "details", + "span": { + "offset": 8620, + "length": 7 + }, + "confidence": 0.996, + "source": "D(2,0.6624,5.342,0.9519,5.3372,0.9503,5.4405,0.6621,5.4469)" + }, + { + "content": "on", + "span": { + "offset": 8628, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,0.9759,5.3363,1.0957,5.3319,1.0936,5.4335,0.9742,5.4393)" + }, + { + "content": "how", + "span": { + "offset": 8631, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.49,5.4488,0.6778,5.4477,0.6783,5.5472,0.4908,5.5479)" + }, + { + "content": "to", + "span": { + "offset": 8635, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,0.699,5.4475,0.7904,5.4478,0.7909,5.5471,0.6995,5.5471)" + }, + { + "content": "pay", + "span": { + "offset": 8638, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,0.8182,5.448,0.9798,5.4492,0.98,5.5476,0.8186,5.5472)" + }, + { + "content": ",", + "span": { + "offset": 8641, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,0.9782,5.4492,1.001,5.4496,1.0012,5.5477,0.9784,5.5476)" + }, + { + "content": "see", + "span": { + "offset": 8643, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,1.0288,5.4501,1.1953,5.4531,1.1953,5.5493,1.029,5.548)" + }, + { + "content": "instructions", + "span": { + "offset": 8647, + "length": 12 + }, + "confidence": 0.999, + "source": "D(2,0.4921,5.5421,0.9983,5.5394,0.9983,5.636,0.4926,5.6388)" + }, + { + "content": ".", + "span": { + "offset": 8659, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.0015,5.5393,1.0303,5.5387,1.0303,5.6354,1.0015,5.636)" + }, + { + "content": "37", + "span": { + "offset": 8682, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.2679,5.0596,1.4008,5.0596,1.4008,5.1616,1.2679,5.1616)" + }, + { + "content": "Subtract", + "span": { + "offset": 8685, + "length": 8 + }, + "confidence": 0.995, + "source": "D(2,1.5865,5.0579,2.0211,5.0585,2.0211,5.1816,1.5865,5.1798)" + }, + { + "content": "line", + "span": { + "offset": 8694, + "length": 4 + }, + "confidence": 0.971, + "source": "D(2,2.0519,5.0585,2.2179,5.0588,2.2179,5.1824,2.0519,5.1817)" + }, + { + "content": "33", + "span": { + "offset": 8699, + "length": 2 + }, + "confidence": 0.936, + "source": "D(2,2.2549,5.0588,2.3758,5.059,2.3758,5.1831,2.2549,5.1826)" + }, + { + "content": "from", + "span": { + "offset": 8702, + "length": 4 + }, + "confidence": 0.944, + "source": "D(2,2.4086,5.0591,2.6321,5.0594,2.6321,5.1841,2.4086,5.1832)" + }, + { + "content": "line", + "span": { + "offset": 8707, + "length": 4 + }, + "confidence": 0.973, + "source": "D(2,2.6669,5.0594,2.831,5.0596,2.831,5.1842,2.6669,5.1841)" + }, + { + "content": "24", + "span": { + "offset": 8712, + "length": 2 + }, + "confidence": 0.861, + "source": "D(2,2.8617,5.0596,2.9868,5.0597,2.9868,5.1843,2.8617,5.1842)" + }, + { + "content": ".", + "span": { + "offset": 8714, + "length": 1 + }, + "confidence": 0.966, + "source": "D(2,2.9909,5.0597,3.0134,5.0598,3.0134,5.1843,2.9909,5.1843)" + }, + { + "content": "This", + "span": { + "offset": 8716, + "length": 4 + }, + "confidence": 0.884, + "source": "D(2,3.0524,5.0598,3.2615,5.06,3.2615,5.1843,3.0524,5.1843)" + }, + { + "content": "is", + "span": { + "offset": 8721, + "length": 2 + }, + "confidence": 0.989, + "source": "D(2,3.2943,5.06,3.3702,5.0601,3.3702,5.1844,3.2943,5.1844)" + }, + { + "content": "the", + "span": { + "offset": 8724, + "length": 3 + }, + "confidence": 0.964, + "source": "D(2,3.3948,5.0601,3.5547,5.0603,3.5547,5.1844,3.3948,5.1844)" + }, + { + "content": "amount", + "span": { + "offset": 8728, + "length": 6 + }, + "confidence": 0.939, + "source": "D(2,3.5834,5.0603,3.9955,5.0606,3.9955,5.1834,3.5834,5.1845)" + }, + { + "content": "you", + "span": { + "offset": 8735, + "length": 3 + }, + "confidence": 0.959, + "source": "D(2,4.018,5.0606,4.2128,5.0607,4.2128,5.1827,4.018,5.1833)" + }, + { + "content": "owe", + "span": { + "offset": 8739, + "length": 3 + }, + "confidence": 0.878, + "source": "D(2,4.2456,5.0607,4.467,5.0608,4.467,5.1818,4.2456,5.1826)" + }, + { + "content": "now", + "span": { + "offset": 8743, + "length": 3 + }, + "confidence": 0.917, + "source": "D(2,4.4957,5.0608,4.7356,5.0609,4.7356,5.1809,4.4957,5.1817)" + }, + { + "content": ".", + "span": { + "offset": 8747, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.0092,5.1424,5.0216,5.1424,5.0216,5.1547,5.0092,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8749, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.1759,5.1424,5.1882,5.1424,5.1882,5.1547,5.1759,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8751, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.3426,5.1424,5.3549,5.1424,5.3549,5.1547,5.3426,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8753, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.5092,5.1424,5.5216,5.1424,5.5216,5.1547,5.5092,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8755, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.6759,5.1424,5.6882,5.1424,5.6882,5.1547,5.6759,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8757, + "length": 1 + }, + "confidence": 1, + "source": "D(2,5.8426,5.1424,5.8549,5.1424,5.8549,5.1547,5.8426,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8759, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.0092,5.1424,6.0216,5.1424,6.0216,5.1547,6.0092,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8761, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.1759,5.1424,6.1882,5.1424,6.1882,5.1547,6.1759,5.1547)" + }, + { + "content": ".", + "span": { + "offset": 8763, + "length": 1 + }, + "confidence": 1, + "source": "D(2,6.3426,5.1424,6.3549,5.1424,6.3549,5.1547,6.3426,5.1547)" + }, + { + "content": "37", + "span": { + "offset": 8774, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7776,5.0515,6.9062,5.0515,6.9062,5.1536,6.7776,5.1536)" + }, + { + "content": "6430", + "span": { + "offset": 8786, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,7.7156,5.03,7.9646,5.03,7.9646,5.1375,7.7156,5.1375)" + }, + { + "content": "Note", + "span": { + "offset": 8823, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,1.5875,5.2291,1.847,5.2296,1.848,5.3535,1.5886,5.3522)" + }, + { + "content": ":", + "span": { + "offset": 8827, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,1.8512,5.2297,1.8782,5.2297,1.8792,5.3537,1.8522,5.3536)" + }, + { + "content": "Schedule", + "span": { + "offset": 8829, + "length": 8 + }, + "confidence": 0.989, + "source": "D(2,1.9218,5.2298,2.3889,5.2308,2.3898,5.3563,1.9227,5.3539)" + }, + { + "content": "H", + "span": { + "offset": 8838, + "length": 1 + }, + "confidence": 0.986, + "source": "D(2,2.4429,5.231,2.5093,5.2311,2.5101,5.3569,2.4437,5.3566)" + }, + { + "content": "and", + "span": { + "offset": 8840, + "length": 3 + }, + "confidence": 0.982, + "source": "D(2,2.5612,5.2312,2.7439,5.2316,2.7447,5.3581,2.562,5.3572)" + }, + { + "content": "Schedule", + "span": { + "offset": 8844, + "length": 8 + }, + "confidence": 0.993, + "source": "D(2,2.7916,5.2317,3.2608,5.2328,3.2615,5.3607,2.7924,5.3584)" + }, + { + "content": "SE", + "span": { + "offset": 8853, + "length": 2 + }, + "confidence": 0.996, + "source": "D(2,3.3044,5.2329,3.4477,5.2334,3.4483,5.3612,3.3051,5.3608)" + }, + { + "content": "filers", + "span": { + "offset": 8856, + "length": 6 + }, + "confidence": 0.989, + "source": "D(2,3.4933,5.2335,3.7238,5.2342,3.7244,5.3619,3.494,5.3613)" + }, + { + "content": ",", + "span": { + "offset": 8862, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.7238,5.2342,3.7487,5.2343,3.7493,5.362,3.7244,5.3619)" + }, + { + "content": "line", + "span": { + "offset": 8864, + "length": 4 + }, + "confidence": 0.937, + "source": "D(2,3.8006,5.2345,3.9688,5.235,3.9693,5.3626,3.8012,5.3621)" + }, + { + "content": "37", + "span": { + "offset": 8869, + "length": 2 + }, + "confidence": 0.833, + "source": "D(2,4.0144,5.2352,4.1411,5.2356,4.1416,5.363,4.015,5.3627)" + }, + { + "content": "may", + "span": { + "offset": 8872, + "length": 3 + }, + "confidence": 0.839, + "source": "D(2,4.1888,5.2357,4.4006,5.2364,4.401,5.3637,4.1893,5.3631)" + }, + { + "content": "not", + "span": { + "offset": 8876, + "length": 3 + }, + "confidence": 0.954, + "source": "D(2,4.4483,5.2365,4.6082,5.237,4.6086,5.3642,4.4488,5.3638)" + }, + { + "content": "represent", + "span": { + "offset": 8880, + "length": 9 + }, + "confidence": 0.934, + "source": "D(2,4.6476,5.2372,5.1272,5.2389,5.1275,5.365,4.648,5.3643)" + }, + { + "content": "all", + "span": { + "offset": 8890, + "length": 3 + }, + "confidence": 0.944, + "source": "D(2,5.1687,5.2391,5.2788,5.2395,5.279,5.3651,5.169,5.365)" + }, + { + "content": "of", + "span": { + "offset": 8894, + "length": 2 + }, + "confidence": 0.937, + "source": "D(2,5.3203,5.2397,5.4241,5.2401,5.4243,5.3651,5.3205,5.3651)" + }, + { + "content": "the", + "span": { + "offset": 8897, + "length": 3 + }, + "confidence": 0.84, + "source": "D(2,5.4573,5.2403,5.6192,5.2409,5.6194,5.3651,5.4575,5.3651)" + }, + { + "content": "taxes", + "span": { + "offset": 8901, + "length": 5 + }, + "confidence": 0.826, + "source": "D(2,5.6607,5.2411,5.9327,5.2423,5.9329,5.3651,5.6609,5.3651)" + }, + { + "content": "you", + "span": { + "offset": 8907, + "length": 3 + }, + "confidence": 0.876, + "source": "D(2,5.9742,5.2424,6.159,5.2432,6.1591,5.3651,5.9744,5.3651)" + }, + { + "content": "owe", + "span": { + "offset": 8911, + "length": 3 + }, + "confidence": 0.708, + "source": "D(2,6.2047,5.2434,6.4164,5.2443,6.4165,5.3651,6.2048,5.3651)" + }, + { + "content": "for", + "span": { + "offset": 8915, + "length": 3 + }, + "confidence": 0.837, + "source": "D(2,6.4496,5.2444,6.6033,5.245,6.6033,5.3651,6.4497,5.3651)" + }, + { + "content": "2020", + "span": { + "offset": 8995, + "length": 4 + }, + "confidence": 0.523, + "source": "D(2,1.5865,5.3737,1.8382,5.3732,1.8392,5.4971,1.5875,5.4969)" + }, + { + "content": ".", + "span": { + "offset": 8999, + "length": 1 + }, + "confidence": 0.886, + "source": "D(2,1.8465,5.3732,1.8671,5.3732,1.8681,5.4971,1.8474,5.4971)" + }, + { + "content": "See", + "span": { + "offset": 9001, + "length": 3 + }, + "confidence": 0.4, + "source": "D(2,1.9022,5.3731,2.0941,5.3728,2.095,5.4973,1.9031,5.4971)" + }, + { + "content": "Schedule", + "span": { + "offset": 9005, + "length": 8 + }, + "confidence": 0.877, + "source": "D(2,2.1209,5.3727,2.5935,5.3719,2.5942,5.4976,2.1218,5.4973)" + }, + { + "content": "3", + "span": { + "offset": 9014, + "length": 1 + }, + "confidence": 0.94, + "source": "D(2,2.6265,5.3718,2.6822,5.3718,2.6829,5.4976,2.6272,5.4977)" + }, + { + "content": ",", + "span": { + "offset": 9015, + "length": 1 + }, + "confidence": 0.991, + "source": "D(2,2.6884,5.3718,2.709,5.3718,2.7097,5.4976,2.689,5.4976)" + }, + { + "content": "line", + "span": { + "offset": 9017, + "length": 4 + }, + "confidence": 0.876, + "source": "D(2,2.7482,5.3719,2.9154,5.3719,2.916,5.4975,2.7489,5.4976)" + }, + { + "content": "12e", + "span": { + "offset": 9022, + "length": 3 + }, + "confidence": 0.892, + "source": "D(2,2.9546,5.3719,3.132,5.372,3.1325,5.4974,2.9551,5.4975)" + }, + { + "content": ",", + "span": { + "offset": 9025, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,3.132,5.372,3.1547,5.372,3.1552,5.4974,3.1325,5.4974)" + }, + { + "content": "and", + "span": { + "offset": 9027, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,3.1898,5.372,3.3714,5.3721,3.3718,5.4972,3.1903,5.4973)" + }, + { + "content": "its", + "span": { + "offset": 9031, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,3.4147,5.3721,3.5261,5.3722,3.5265,5.4971,3.4151,5.4972)" + }, + { + "content": "instructions", + "span": { + "offset": 9035, + "length": 12 + }, + "confidence": 0.988, + "source": "D(2,3.5571,5.3722,4.1287,5.3734,4.1289,5.4962,3.5575,5.4971)" + }, + { + "content": "for", + "span": { + "offset": 9048, + "length": 3 + }, + "confidence": 0.986, + "source": "D(2,4.1576,5.3735,4.2979,5.3739,4.298,5.4959,4.1577,5.4961)" + }, + { + "content": "details", + "span": { + "offset": 9052, + "length": 7 + }, + "confidence": 0.932, + "source": "D(2,4.3226,5.3739,4.6549,5.3748,4.6549,5.4952,4.3228,5.4958)" + }, + { + "content": ".", + "span": { + "offset": 9059, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,4.6569,5.3748,4.6899,5.3749,4.6899,5.4951,4.6569,5.4952)" + }, + { + "content": "38", + "span": { + "offset": 9081, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.27,5.5393,1.4039,5.539,1.4039,5.6464,1.27,5.6467)" + }, + { + "content": "Estimated", + "span": { + "offset": 9084, + "length": 9 + }, + "confidence": 0.996, + "source": "D(2,1.5886,5.5306,2.0872,5.531,2.0872,5.6599,1.5886,5.6595)" + }, + { + "content": "tax", + "span": { + "offset": 9094, + "length": 3 + }, + "confidence": 0.988, + "source": "D(2,2.1193,5.531,2.2755,5.5311,2.2755,5.66,2.1193,5.6599)" + }, + { + "content": "penalty", + "span": { + "offset": 9098, + "length": 7 + }, + "confidence": 0.965, + "source": "D(2,2.3098,5.5312,2.6736,5.5316,2.6736,5.6605,2.3098,5.6601)" + }, + { + "content": "(", + "span": { + "offset": 9106, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,2.6992,5.5316,2.7313,5.5316,2.7313,5.6605,2.6992,5.6605)" + }, + { + "content": "see", + "span": { + "offset": 9107, + "length": 3 + }, + "confidence": 0.986, + "source": "D(2,2.7313,5.5316,2.9004,5.5318,2.9004,5.6607,2.7313,5.6605)" + }, + { + "content": "instructions", + "span": { + "offset": 9111, + "length": 12 + }, + "confidence": 0.983, + "source": "D(2,2.9368,5.5319,3.5039,5.5327,3.5039,5.6616,2.9368,5.6608)" + }, + { + "content": ")", + "span": { + "offset": 9123, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,3.5018,5.5327,3.5403,5.5327,3.5403,5.6616,3.5018,5.6616)" + }, + { + "content": "38", + "span": { + "offset": 9134, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,5.4744,5.5441,5.6155,5.5438,5.6155,5.6464,5.4744,5.645)" + }, + { + "content": "1250", + "span": { + "offset": 9146, + "length": 4 + }, + "confidence": 0.992, + "source": "D(2,6.4207,5.5322,6.6655,5.5322,6.6655,5.6397,6.4207,5.6397)" + }, + { + "content": "Third", + "span": { + "offset": 9175, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,0.4934,5.7049,0.8175,5.7185,0.8165,5.8582,0.4929,5.8445)" + }, + { + "content": "Party", + "span": { + "offset": 9181, + "length": 5 + }, + "confidence": 0.998, + "source": "D(2,0.8622,5.7191,1.2078,5.7134,1.2057,5.853,0.8611,5.8587)" + }, + { + "content": "Designee", + "span": { + "offset": 9187, + "length": 8 + }, + "confidence": 0.998, + "source": "D(2,0.4947,5.8545,1.1009,5.8545,1.0988,5.9941,0.4934,5.9941)" + }, + { + "content": "Do", + "span": { + "offset": 9197, + "length": 2 + }, + "confidence": 0.983, + "source": "D(2,1.3893,5.7089,1.5349,5.709,1.5349,5.8271,1.3893,5.8269)" + }, + { + "content": "you", + "span": { + "offset": 9200, + "length": 3 + }, + "confidence": 0.972, + "source": "D(2,1.59,5.7091,1.773,5.7092,1.773,5.8274,1.59,5.8271)" + }, + { + "content": "want", + "span": { + "offset": 9204, + "length": 4 + }, + "confidence": 0.985, + "source": "D(2,1.83,5.7092,2.0799,5.7094,2.0799,5.8278,1.83,5.8275)" + }, + { + "content": "to", + "span": { + "offset": 9209, + "length": 2 + }, + "confidence": 0.99, + "source": "D(2,2.129,5.7094,2.2313,5.7095,2.2313,5.828,2.129,5.8279)" + }, + { + "content": "allow", + "span": { + "offset": 9212, + "length": 5 + }, + "confidence": 0.987, + "source": "D(2,2.2904,5.7096,2.5441,5.7097,2.5441,5.8285,2.2904,5.8281)" + }, + { + "content": "another", + "span": { + "offset": 9218, + "length": 7 + }, + "confidence": 0.989, + "source": "D(2,2.6051,5.7098,2.9946,5.7097,2.9946,5.8286,2.6051,5.8285)" + }, + { + "content": "person", + "span": { + "offset": 9226, + "length": 6 + }, + "confidence": 0.97, + "source": "D(2,3.0478,5.7097,3.3881,5.7093,3.3881,5.8281,3.0477,5.8285)" + }, + { + "content": "to", + "span": { + "offset": 9233, + "length": 2 + }, + "confidence": 0.956, + "source": "D(2,3.4432,5.7092,3.5455,5.7091,3.5455,5.8279,3.4432,5.8281)" + }, + { + "content": "discuss", + "span": { + "offset": 9236, + "length": 7 + }, + "confidence": 0.879, + "source": "D(2,3.5986,5.7091,3.9802,5.7086,3.9802,5.8274,3.5986,5.8279)" + }, + { + "content": "this", + "span": { + "offset": 9244, + "length": 4 + }, + "confidence": 0.945, + "source": "D(2,4.0334,5.7086,4.2144,5.7084,4.2143,5.8271,4.0334,5.8274)" + }, + { + "content": "return", + "span": { + "offset": 9249, + "length": 6 + }, + "confidence": 0.919, + "source": "D(2,4.2773,5.7082,4.5645,5.7074,4.5645,5.8258,4.2773,5.8269)" + }, + { + "content": "with", + "span": { + "offset": 9256, + "length": 4 + }, + "confidence": 0.931, + "source": "D(2,4.6216,5.7072,4.834,5.7066,4.834,5.8249,4.6216,5.8256)" + }, + { + "content": "the", + "span": { + "offset": 9261, + "length": 3 + }, + "confidence": 0.877, + "source": "D(2,4.8891,5.7064,5.0524,5.7059,5.0524,5.8241,4.8891,5.8247)" + }, + { + "content": "IRS", + "span": { + "offset": 9265, + "length": 3 + }, + "confidence": 0.886, + "source": "D(2,5.1114,5.7058,5.2826,5.7053,5.2826,5.8232,5.1114,5.8238)" + }, + { + "content": "?", + "span": { + "offset": 9268, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,5.2885,5.7053,5.3455,5.7051,5.3455,5.823,5.2885,5.8232)" + }, + { + "content": "See", + "span": { + "offset": 9270, + "length": 3 + }, + "confidence": 0.932, + "source": "D(2,5.3967,5.7049,5.6072,5.7043,5.6072,5.822,5.3967,5.8228)" + }, + { + "content": "instructions", + "span": { + "offset": 9274, + "length": 12 + }, + "confidence": 0.997, + "source": "D(2,1.3873,5.8491,1.9849,5.8491,1.9828,5.9565,1.3873,5.9565)" + }, + { + "content": "☐", + "span": { + "offset": 9288, + "length": 1 + }, + "confidence": 0.928, + "source": "D(2,5.6902,5.8384,5.8105,5.8384,5.8105,5.9565,5.6902,5.9565)" + }, + { + "content": "Yes", + "span": { + "offset": 9290, + "length": 3 + }, + "confidence": 0.944, + "source": "D(2,5.8396,5.8438,6.0382,5.8438,6.0382,5.9619,5.8396,5.9619)" + }, + { + "content": ".", + "span": { + "offset": 9293, + "length": 1 + }, + "confidence": 0.974, + "source": "D(2,6.0422,5.8438,6.068,5.8438,6.068,5.9619,6.0422,5.9619)" + }, + { + "content": "Complete", + "span": { + "offset": 9295, + "length": 8 + }, + "confidence": 0.953, + "source": "D(2,6.1018,5.8438,6.5924,5.8438,6.5924,5.9619,6.1018,5.9619)" + }, + { + "content": "below", + "span": { + "offset": 9304, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,6.6202,5.8438,6.9142,5.8438,6.9142,5.9619,6.6202,5.9619)" + }, + { + "content": ".", + "span": { + "offset": 9309, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,6.9162,5.8438,6.9519,5.8438,6.9519,5.9619,6.9162,5.9619)" + }, + { + "content": "☑", + "span": { + "offset": 9311, + "length": 1 + }, + "confidence": 0.953, + "source": "D(2,7.093,5.8384,7.2092,5.8384,7.2092,5.9565,7.093,5.9565)" + }, + { + "content": "No", + "span": { + "offset": 9313, + "length": 2 + }, + "confidence": 0.987, + "source": "D(2,7.2466,5.8499,7.396,5.8536,7.396,5.9512,7.2466,5.9512)" + }, + { + "content": "Designee's", + "span": { + "offset": 9317, + "length": 10 + }, + "confidence": 0.997, + "source": "D(2,1.3914,6.0149,1.8843,6.0177,1.8843,6.1251,1.3914,6.1224)" + }, + { + "content": "name", + "span": { + "offset": 9328, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,1.3873,6.1579,1.6456,6.1552,1.6456,6.2411,1.3873,6.2439)" + }, + { + "content": "Phone", + "span": { + "offset": 9334, + "length": 5 + }, + "confidence": 0.999, + "source": "D(2,4.1877,6.0164,4.4824,6.0213,4.4824,6.1179,4.1877,6.1131)" + }, + { + "content": "no", + "span": { + "offset": 9340, + "length": 2 + }, + "confidence": 0.997, + "source": "D(2,4.1877,6.1553,4.3051,6.1553,4.3051,6.2405,4.1877,6.2349)" + }, + { + "content": ".", + "span": { + "offset": 9342, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,4.3065,6.1553,4.3372,6.1553,4.3372,6.2425,4.3065,6.2406)" + }, + { + "content": "Personal", + "span": { + "offset": 9345, + "length": 8 + }, + "confidence": 0.997, + "source": "D(2,5.989,6.0103,6.37,6.0106,6.37,6.1165,5.989,6.1137)" + }, + { + "content": "identification", + "span": { + "offset": 9354, + "length": 14 + }, + "confidence": 0.997, + "source": "D(2,6.4039,6.0108,6.9644,6.017,6.9644,6.11,6.4039,6.1164)" + }, + { + "content": "number", + "span": { + "offset": 9369, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,5.9849,6.1363,6.3325,6.1335,6.3325,6.2413,5.9849,6.2348)" + }, + { + "content": "(", + "span": { + "offset": 9376, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.3549,6.1334,6.3878,6.1334,6.3878,6.241,6.355,6.2414)" + }, + { + "content": "PIN", + "span": { + "offset": 9377, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,6.3826,6.1334,6.5313,6.1342,6.5313,6.2371,6.3826,6.2411)" + }, + { + "content": ")", + "span": { + "offset": 9380, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.5296,6.1342,6.5659,6.1344,6.5659,6.2362,6.5296,6.2372)" + }, + { + "content": "Sign", + "span": { + "offset": 9387, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,0.4916,6.3136,0.8545,6.305,0.8513,6.4776,0.4895,6.4912)" + }, + { + "content": "Here", + "span": { + "offset": 9392, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,0.4923,6.4982,0.8814,6.4985,0.8814,6.6465,0.4923,6.6447)" + }, + { + "content": "Under", + "span": { + "offset": 9398, + "length": 5 + }, + "confidence": 0.997, + "source": "D(2,1.3893,6.3058,1.6591,6.3058,1.6591,6.4239,1.3893,6.424)" + }, + { + "content": "penalties", + "span": { + "offset": 9404, + "length": 9 + }, + "confidence": 0.995, + "source": "D(2,1.6867,6.3058,2.0648,6.3057,2.0648,6.4239,1.6867,6.4239)" + }, + { + "content": "of", + "span": { + "offset": 9414, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,2.0963,6.3057,2.1849,6.3057,2.1849,6.4239,2.0963,6.4239)" + }, + { + "content": "perjury", + "span": { + "offset": 9417, + "length": 7 + }, + "confidence": 0.955, + "source": "D(2,2.2105,6.3057,2.5059,6.3057,2.5059,6.4239,2.2105,6.4239)" + }, + { + "content": ",", + "span": { + "offset": 9424, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,2.5059,6.3057,2.5276,6.3057,2.5276,6.4239,2.5059,6.4239)" + }, + { + "content": "I", + "span": { + "offset": 9426, + "length": 1 + }, + "confidence": 0.937, + "source": "D(2,2.563,6.3057,2.5847,6.3057,2.5847,6.4239,2.563,6.4239)" + }, + { + "content": "declare", + "span": { + "offset": 9428, + "length": 7 + }, + "confidence": 0.865, + "source": "D(2,2.6162,6.3057,2.9293,6.3057,2.9293,6.4238,2.6162,6.4239)" + }, + { + "content": "that", + "span": { + "offset": 9436, + "length": 4 + }, + "confidence": 0.948, + "source": "D(2,2.9549,6.3057,3.1262,6.3056,3.1262,6.4238,2.9549,6.4238)" + }, + { + "content": "I", + "span": { + "offset": 9441, + "length": 1 + }, + "confidence": 0.913, + "source": "D(2,3.1597,6.3056,3.1794,6.3056,3.1794,6.4238,3.1597,6.4238)" + }, + { + "content": "have", + "span": { + "offset": 9443, + "length": 4 + }, + "confidence": 0.911, + "source": "D(2,3.209,6.3056,3.4118,6.3056,3.4118,6.4238,3.209,6.4238)" + }, + { + "content": "examined", + "span": { + "offset": 9448, + "length": 8 + }, + "confidence": 0.98, + "source": "D(2,3.4394,6.3056,3.8509,6.3055,3.8509,6.4237,3.4394,6.4238)" + }, + { + "content": "this", + "span": { + "offset": 9457, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,3.8805,6.3055,4.038,6.3054,4.038,6.4236,3.8805,6.4237)" + }, + { + "content": "return", + "span": { + "offset": 9462, + "length": 6 + }, + "confidence": 0.995, + "source": "D(2,4.0695,6.3054,4.3177,6.3053,4.3177,6.4235,4.0695,6.4236)" + }, + { + "content": "and", + "span": { + "offset": 9469, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,4.3531,6.3053,4.5067,6.3052,4.5067,6.4234,4.3531,6.4235)" + }, + { + "content": "accompanying", + "span": { + "offset": 9473, + "length": 12 + }, + "confidence": 0.977, + "source": "D(2,4.5343,6.3052,5.1625,6.305,5.1625,6.4231,4.5343,6.4234)" + }, + { + "content": "schedules", + "span": { + "offset": 9486, + "length": 9 + }, + "confidence": 0.989, + "source": "D(2,5.194,6.305,5.6272,6.3048,5.6272,6.4229,5.194,6.4231)" + }, + { + "content": "and", + "span": { + "offset": 9496, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,5.6528,6.3048,5.8163,6.3047,5.8163,6.4229,5.6528,6.4229)" + }, + { + "content": "statements", + "span": { + "offset": 9500, + "length": 10 + }, + "confidence": 0.99, + "source": "D(2,5.8517,6.3047,6.3322,6.3043,6.3322,6.4225,5.8517,6.4228)" + }, + { + "content": ",", + "span": { + "offset": 9510, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,6.3362,6.3043,6.3559,6.3043,6.3559,6.4225,6.3362,6.4225)" + }, + { + "content": "and", + "span": { + "offset": 9512, + "length": 3 + }, + "confidence": 0.993, + "source": "D(2,6.3874,6.3043,6.5488,6.3042,6.5488,6.4223,6.3874,6.4225)" + }, + { + "content": "to", + "span": { + "offset": 9516, + "length": 2 + }, + "confidence": 0.988, + "source": "D(2,6.5882,6.3041,6.665,6.3041,6.665,6.4223,6.5882,6.4223)" + }, + { + "content": "the", + "span": { + "offset": 9519, + "length": 3 + }, + "confidence": 0.972, + "source": "D(2,6.6867,6.3041,6.8147,6.304,6.8147,6.4221,6.6867,6.4222)" + }, + { + "content": "best", + "span": { + "offset": 9523, + "length": 4 + }, + "confidence": 0.753, + "source": "D(2,6.8482,6.304,7.049,6.3038,7.049,6.422,6.8482,6.4221)" + }, + { + "content": "of", + "span": { + "offset": 9528, + "length": 2 + }, + "confidence": 0.824, + "source": "D(2,7.0668,6.3038,7.1633,6.3037,7.1633,6.4219,7.0668,6.422)" + }, + { + "content": "my", + "span": { + "offset": 9531, + "length": 2 + }, + "confidence": 0.523, + "source": "D(2,7.181,6.3037,7.311,6.3036,7.311,6.4218,7.181,6.4219)" + }, + { + "content": "knowledge", + "span": { + "offset": 9534, + "length": 9 + }, + "confidence": 0.295, + "source": "D(2,7.3287,6.3036,7.8052,6.3033,7.8052,6.4214,7.3287,6.4218)" + }, + { + "content": "and", + "span": { + "offset": 9544, + "length": 3 + }, + "confidence": 0.522, + "source": "D(2,7.821,6.3033,8.0061,6.3031,8.0061,6.4213,7.821,6.4214)" + }, + { + "content": "belief", + "span": { + "offset": 9548, + "length": 6 + }, + "confidence": 0.994, + "source": "D(2,1.3883,6.4238,1.6226,6.4238,1.6236,6.542,1.3893,6.542)" + }, + { + "content": ",", + "span": { + "offset": 9554, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,1.6245,6.4238,1.6442,6.4238,1.6452,6.542,1.6255,6.542)" + }, + { + "content": "they", + "span": { + "offset": 9556, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,1.6718,6.4238,1.8608,6.4238,1.8617,6.542,1.6728,6.542)" + }, + { + "content": "are", + "span": { + "offset": 9561, + "length": 3 + }, + "confidence": 0.996, + "source": "D(2,1.8844,6.4238,2.0143,6.4238,2.0152,6.542,1.8853,6.542)" + }, + { + "content": "true", + "span": { + "offset": 9565, + "length": 4 + }, + "confidence": 0.994, + "source": "D(2,2.0399,6.4238,2.2092,6.4238,2.2101,6.542,2.0408,6.542)" + }, + { + "content": ",", + "span": { + "offset": 9569, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,2.2112,6.4238,2.2328,6.4238,2.2337,6.542,2.2121,6.542)" + }, + { + "content": "correct", + "span": { + "offset": 9571, + "length": 7 + }, + "confidence": 0.994, + "source": "D(2,2.2623,6.4238,2.5655,6.4238,2.5664,6.542,2.2632,6.542)" + }, + { + "content": ",", + "span": { + "offset": 9578, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,2.5694,6.4238,2.5891,6.4238,2.59,6.542,2.5703,6.542)" + }, + { + "content": "and", + "span": { + "offset": 9580, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,2.6128,6.4238,2.7702,6.4238,2.7711,6.542,2.6136,6.542)" + }, + { + "content": "complete", + "span": { + "offset": 9584, + "length": 8 + }, + "confidence": 0.24, + "source": "D(2,2.8037,6.4238,3.2014,6.4238,3.2021,6.542,2.8045,6.542)" + }, + { + "content": ".", + "span": { + "offset": 9592, + "length": 1 + }, + "confidence": 0.917, + "source": "D(2,3.2053,6.4238,3.225,6.4238,3.2257,6.542,3.206,6.542)" + }, + { + "content": "Declaration", + "span": { + "offset": 9594, + "length": 11 + }, + "confidence": 0.529, + "source": "D(2,3.2584,6.4238,3.7329,6.4238,3.7335,6.542,3.2592,6.542)" + }, + { + "content": "of", + "span": { + "offset": 9606, + "length": 2 + }, + "confidence": 0.997, + "source": "D(2,3.7604,6.4238,3.851,6.4238,3.8516,6.542,3.7611,6.542)" + }, + { + "content": "preparer", + "span": { + "offset": 9609, + "length": 8 + }, + "confidence": 0.989, + "source": "D(2,3.8726,6.4238,4.2329,6.4238,4.2335,6.542,3.8733,6.542)" + }, + { + "content": "(", + "span": { + "offset": 9618, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,4.2585,6.4238,4.288,6.4238,4.2886,6.542,4.2591,6.542)" + }, + { + "content": "other", + "span": { + "offset": 9619, + "length": 5 + }, + "confidence": 0.992, + "source": "D(2,4.288,6.4238,4.5144,6.4238,4.5149,6.542,4.2886,6.542)" + }, + { + "content": "than", + "span": { + "offset": 9625, + "length": 4 + }, + "confidence": 0.992, + "source": "D(2,4.5301,6.4238,4.7152,6.4238,4.7157,6.542,4.5307,6.542)" + }, + { + "content": "taxpayer", + "span": { + "offset": 9630, + "length": 8 + }, + "confidence": 0.979, + "source": "D(2,4.7467,6.4238,5.1187,6.4238,5.1192,6.542,4.7472,6.542)" + }, + { + "content": ")", + "span": { + "offset": 9638, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,5.1148,6.4238,5.1443,6.4238,5.1448,6.542,5.1153,6.542)" + }, + { + "content": "is", + "span": { + "offset": 9640, + "length": 2 + }, + "confidence": 0.997, + "source": "D(2,5.1739,6.4238,5.2428,6.4238,5.2432,6.542,5.1743,6.542)" + }, + { + "content": "based", + "span": { + "offset": 9643, + "length": 5 + }, + "confidence": 0.988, + "source": "D(2,5.2664,6.4238,5.5223,6.4238,5.5227,6.542,5.2668,6.542)" + }, + { + "content": "on", + "span": { + "offset": 9649, + "length": 2 + }, + "confidence": 0.997, + "source": "D(2,5.5558,6.4238,5.6601,6.4238,5.6605,6.542,5.5561,6.542)" + }, + { + "content": "all", + "span": { + "offset": 9652, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,5.6877,6.4238,5.7782,6.4238,5.7786,6.542,5.688,6.542)" + }, + { + "content": "information", + "span": { + "offset": 9656, + "length": 11 + }, + "confidence": 0.951, + "source": "D(2,5.8058,6.4238,6.2881,6.4238,6.2883,6.542,5.8061,6.542)" + }, + { + "content": "of", + "span": { + "offset": 9668, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,6.3078,6.4238,6.4042,6.4238,6.4045,6.542,6.308,6.542)" + }, + { + "content": "which", + "span": { + "offset": 9671, + "length": 5 + }, + "confidence": 0.977, + "source": "D(2,6.4259,6.4238,6.668,6.4238,6.6682,6.542,6.4261,6.542)" + }, + { + "content": "preparer", + "span": { + "offset": 9677, + "length": 8 + }, + "confidence": 0.871, + "source": "D(2,6.6936,6.4238,7.0775,6.4238,7.0776,6.542,6.6938,6.542)" + }, + { + "content": "has", + "span": { + "offset": 9686, + "length": 3 + }, + "confidence": 0.8, + "source": "D(2,7.0991,6.4238,7.2546,6.4238,7.2547,6.542,7.0993,6.542)" + }, + { + "content": "any", + "span": { + "offset": 9690, + "length": 3 + }, + "confidence": 0.657, + "source": "D(2,7.2645,6.4238,7.4259,6.4238,7.426,6.542,7.2646,6.542)" + }, + { + "content": "knowledge", + "span": { + "offset": 9694, + "length": 9 + }, + "confidence": 0.476, + "source": "D(2,7.4476,6.4238,7.9003,6.4238,7.9003,6.542,7.4476,6.542)" + }, + { + "content": ".", + "span": { + "offset": 9703, + "length": 1 + }, + "confidence": 0.994, + "source": "D(2,7.9121,6.4238,7.9397,6.4238,7.9397,6.542,7.9121,6.542)" + }, + { + "content": "Your", + "span": { + "offset": 9706, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,1.3904,6.6074,1.6043,6.6054,1.6043,6.722,1.3904,6.7192)" + }, + { + "content": "signature", + "span": { + "offset": 9711, + "length": 9 + }, + "confidence": 0.998, + "source": "D(2,1.6235,6.6054,2.0378,6.6063,2.0378,6.724,1.6236,6.7222)" + }, + { + "content": "anthony", + "span": { + "offset": 9721, + "length": 7 + }, + "confidence": 0.828, + "source": "D(2,2.4072,6.7622,2.9013,6.7622,2.9013,6.9853,2.4072,6.9821)" + }, + { + "content": "kelly", + "span": { + "offset": 9729, + "length": 5 + }, + "confidence": 0.973, + "source": "D(2,2.9162,6.7622,3.2456,6.7622,3.2456,6.9888,2.9162,6.9854)" + }, + { + "content": "Date", + "span": { + "offset": 9736, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,3.8453,6.6053,4.0591,6.607,4.0591,6.7037,3.8453,6.7019)" + }, + { + "content": "12/10/1986", + "span": { + "offset": 9741, + "length": 10 + }, + "confidence": 0.982, + "source": "D(2,3.8267,6.7783,4.4326,6.7783,4.4326,6.8965,3.8267,6.8965)" + }, + { + "content": "Your", + "span": { + "offset": 9753, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,4.5447,6.6081,4.761,6.6045,4.761,6.7222,4.5447,6.7239)" + }, + { + "content": "occupation", + "span": { + "offset": 9758, + "length": 10 + }, + "confidence": 0.998, + "source": "D(2,4.7789,6.6042,5.2751,6.6071,5.2751,6.7247,4.7789,6.7221)" + }, + { + "content": "Judge", + "span": { + "offset": 9769, + "length": 5 + }, + "confidence": 0.994, + "source": "D(2,4.8394,6.8055,5.1797,6.8097,5.1797,6.9386,4.8394,6.9344)" + }, + { + "content": "If", + "span": { + "offset": 9776, + "length": 2 + }, + "confidence": 0.955, + "source": "D(2,6.4414,6.5951,6.5118,6.5949,6.5118,6.7053,6.4414,6.7048)" + }, + { + "content": "the", + "span": { + "offset": 9779, + "length": 3 + }, + "confidence": 0.936, + "source": "D(2,6.5266,6.5949,6.6655,6.5946,6.6655,6.7063,6.5266,6.7054)" + }, + { + "content": "IRS", + "span": { + "offset": 9783, + "length": 3 + }, + "confidence": 0.987, + "source": "D(2,6.697,6.5945,6.8415,6.5941,6.8414,6.7075,6.697,6.7065)" + }, + { + "content": "sent", + "span": { + "offset": 9787, + "length": 4 + }, + "confidence": 0.985, + "source": "D(2,6.8692,6.5941,7.0563,6.5954,7.0563,6.7092,6.8692,6.7077)" + }, + { + "content": "you", + "span": { + "offset": 9792, + "length": 3 + }, + "confidence": 0.992, + "source": "D(2,7.0767,6.5955,7.2359,6.5966,7.2359,6.7106,7.0766,6.7094)" + }, + { + "content": "an", + "span": { + "offset": 9796, + "length": 2 + }, + "confidence": 0.987, + "source": "D(2,7.2656,6.5968,7.3711,6.5983,7.3711,6.7118,7.2655,6.7109)" + }, + { + "content": "Identity", + "span": { + "offset": 9799, + "length": 8 + }, + "confidence": 0.952, + "source": "D(2,7.4008,6.5988,7.7156,6.6039,7.7156,6.715,7.4007,6.7121)" + }, + { + "content": "Protection", + "span": { + "offset": 9808, + "length": 10 + }, + "confidence": 0.996, + "source": "D(2,6.4414,6.7139,6.8905,6.7139,6.8905,6.8213,6.4414,6.8213)" + }, + { + "content": "PIN", + "span": { + "offset": 9819, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,6.9229,6.7139,7.069,6.7139,7.069,6.8213,6.9229,6.8213)" + }, + { + "content": ",", + "span": { + "offset": 9822, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.0762,6.7139,7.0961,6.7139,7.0961,6.8213,7.0762,6.8213)" + }, + { + "content": "enter", + "span": { + "offset": 9824, + "length": 5 + }, + "confidence": 0.987, + "source": "D(2,7.1267,6.7139,7.3558,6.7139,7.3558,6.8213,7.1267,6.8213)" + }, + { + "content": "it", + "span": { + "offset": 9830, + "length": 2 + }, + "confidence": 0.979, + "source": "D(2,7.3792,6.7139,7.4351,6.7139,7.4351,6.8213,7.3792,6.8213)" + }, + { + "content": "here", + "span": { + "offset": 9833, + "length": 4 + }, + "confidence": 0.976, + "source": "D(2,7.4567,6.7139,7.6533,6.7139,7.6533,6.8213,7.4567,6.8213)" + }, + { + "content": "(", + "span": { + "offset": 9838, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.4373,6.8434,6.4793,6.845,6.4792,6.9601,6.4373,6.9592)" + }, + { + "content": "see", + "span": { + "offset": 9839, + "length": 3 + }, + "confidence": 0.997, + "source": "D(2,6.4716,6.8447,6.6244,6.848,6.6241,6.9613,6.4716,6.96)" + }, + { + "content": "inst", + "span": { + "offset": 9843, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,6.653,6.8475,6.8076,6.8407,6.8075,6.9535,6.6528,6.9606)" + }, + { + "content": ".", + "span": { + "offset": 9847, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,6.8057,6.8408,6.8266,6.8394,6.8266,6.9522,6.8055,6.9536)" + }, + { + "content": ")", + "span": { + "offset": 9848, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8247,6.8395,6.8647,6.8368,6.8647,6.9497,6.8246,6.9524)" + }, + { + "content": "654344", + "span": { + "offset": 9850, + "length": 6 + }, + "confidence": 0.997, + "source": "D(2,7.0017,6.8376,7.9937,6.8328,7.9937,6.9958,7.0017,6.9989)" + }, + { + "content": "Joint", + "span": { + "offset": 9858, + "length": 5 + }, + "confidence": 0.998, + "source": "D(2,0.4918,6.8873,0.6922,6.8819,0.6929,6.9829,0.4929,6.982)" + }, + { + "content": "return", + "span": { + "offset": 9864, + "length": 6 + }, + "confidence": 0.999, + "source": "D(2,0.7149,6.8817,0.9509,6.8834,0.951,6.9829,0.7155,6.9829)" + }, + { + "content": "?", + "span": { + "offset": 9870, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,0.9573,6.8835,1.0091,6.8845,1.0091,6.9828,0.9574,6.9829)" + }, + { + "content": "See", + "span": { + "offset": 9872, + "length": 3 + }, + "confidence": 0.999, + "source": "D(2,0.4908,7.005,0.6505,6.9997,0.6497,7.1071,0.4903,7.1124)" + }, + { + "content": "instructions", + "span": { + "offset": 9876, + "length": 12 + }, + "confidence": 0.998, + "source": "D(2,0.6754,6.9989,1.1459,6.9938,1.1439,7.1012,0.6745,7.1063)" + }, + { + "content": ".", + "span": { + "offset": 9888, + "length": 1 + }, + "confidence": 0.997, + "source": "D(2,1.1476,6.9938,1.1725,6.9938,1.1704,7.1012,1.1456,7.1012)" + }, + { + "content": "Keep", + "span": { + "offset": 9890, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,0.4903,7.1221,0.7071,7.1221,0.7073,7.2295,0.4905,7.2295)" + }, + { + "content": "a", + "span": { + "offset": 9895, + "length": 1 + }, + "confidence": 0.996, + "source": "D(2,0.7304,7.1221,0.7787,7.1221,0.7789,7.2295,0.7305,7.2295)" + }, + { + "content": "copy", + "span": { + "offset": 9897, + "length": 4 + }, + "confidence": 0.991, + "source": "D(2,0.8038,7.1221,1.0081,7.1221,1.0082,7.2295,0.804,7.2295)" + }, + { + "content": "for", + "span": { + "offset": 9902, + "length": 3 + }, + "confidence": 0.993, + "source": "D(2,1.0242,7.1221,1.1497,7.1221,1.1497,7.2295,1.0243,7.2295)" + }, + { + "content": "your", + "span": { + "offset": 9906, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,0.4838,7.2448,0.6741,7.2462,0.6747,7.3482,0.4848,7.3469)" + }, + { + "content": "records", + "span": { + "offset": 9911, + "length": 7 + }, + "confidence": 0.998, + "source": "D(2,0.6947,7.246,0.9998,7.2408,0.9999,7.3429,0.6953,7.3481)" + }, + { + "content": ".", + "span": { + "offset": 9918, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.0033,7.2407,1.0324,7.24,1.0324,7.342,1.0033,7.3428)" + }, + { + "content": "Spouse's", + "span": { + "offset": 9921, + "length": 8 + }, + "confidence": 0.978, + "source": "D(2,1.3862,7.0254,1.7973,7.0254,1.7973,7.1436,1.3862,7.1436)" + }, + { + "content": "signature", + "span": { + "offset": 9930, + "length": 9 + }, + "confidence": 0.877, + "source": "D(2,1.8249,7.0254,2.23,7.0254,2.23,7.1436,1.8249,7.1436)" + }, + { + "content": ".", + "span": { + "offset": 9939, + "length": 1 + }, + "confidence": 0.949, + "source": "D(2,2.234,7.0254,2.2537,7.0254,2.2537,7.1436,2.234,7.1436)" + }, + { + "content": "If", + "span": { + "offset": 9941, + "length": 2 + }, + "confidence": 0.877, + "source": "D(2,2.2893,7.0254,2.3427,7.0254,2.3427,7.1436,2.2893,7.1436)" + }, + { + "content": "a", + "span": { + "offset": 9944, + "length": 1 + }, + "confidence": 0.965, + "source": "D(2,2.3644,7.0254,2.4138,7.0254,2.4138,7.1436,2.3644,7.1436)" + }, + { + "content": "joint", + "span": { + "offset": 9946, + "length": 5 + }, + "confidence": 0.876, + "source": "D(2,2.4355,7.0254,2.6312,7.0254,2.6312,7.1436,2.4355,7.1436)" + }, + { + "content": "return", + "span": { + "offset": 9952, + "length": 6 + }, + "confidence": 0.975, + "source": "D(2,2.6569,7.0254,2.9078,7.0254,2.9078,7.1436,2.6569,7.1436)" + }, + { + "content": ",", + "span": { + "offset": 9958, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,2.9118,7.0254,2.9335,7.0254,2.9335,7.1436,2.9118,7.1436)" + }, + { + "content": "both", + "span": { + "offset": 9960, + "length": 4 + }, + "confidence": 0.994, + "source": "D(2,2.9691,7.0254,3.1726,7.0254,3.1726,7.1436,2.9691,7.1436)" + }, + { + "content": "must", + "span": { + "offset": 9965, + "length": 4 + }, + "confidence": 0.989, + "source": "D(2,3.2023,7.0254,3.4216,7.0254,3.4216,7.1436,3.2023,7.1436)" + }, + { + "content": "sign", + "span": { + "offset": 9970, + "length": 4 + }, + "confidence": 0.984, + "source": "D(2,3.4473,7.0254,3.6252,7.0254,3.6252,7.1436,3.4473,7.1436)" + }, + { + "content": ".", + "span": { + "offset": 9974, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,3.6291,7.0254,3.6627,7.0254,3.6627,7.1436,3.6291,7.1436)" + }, + { + "content": "laren", + "span": { + "offset": 9976, + "length": 5 + }, + "confidence": 0.98, + "source": "D(2,2.2412,7.1917,2.5574,7.1928,2.5574,7.3755,2.2412,7.3814)" + }, + { + "content": "waston", + "span": { + "offset": 9982, + "length": 6 + }, + "confidence": 0.941, + "source": "D(2,2.5843,7.1931,3.0049,7.199,3.0049,7.375,2.5843,7.3753)" + }, + { + "content": "Date", + "span": { + "offset": 9990, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,3.8453,7.0254,4.0591,7.0254,4.0591,7.1221,3.8453,7.1221)" + }, + { + "content": "02/19/1978", + "span": { + "offset": 9995, + "length": 10 + }, + "confidence": 0.97, + "source": "D(2,3.8246,7.1919,4.4451,7.1919,4.4451,7.3101,3.8246,7.3101)" + }, + { + "content": "Spouse's", + "span": { + "offset": 10007, + "length": 8 + }, + "confidence": 0.993, + "source": "D(2,4.5447,7.0286,4.9532,7.0278,4.9532,7.1382,4.5447,7.1382)" + }, + { + "content": "occupation", + "span": { + "offset": 10016, + "length": 10 + }, + "confidence": 0.997, + "source": "D(2,4.9788,7.0278,5.4785,7.0259,5.4785,7.1382,4.9788,7.1382)" + }, + { + "content": "nurse", + "span": { + "offset": 10027, + "length": 5 + }, + "confidence": 0.994, + "source": "D(2,4.8684,7.2402,5.1838,7.2402,5.1838,7.3367,4.8684,7.3351)" + }, + { + "content": "If", + "span": { + "offset": 10034, + "length": 2 + }, + "confidence": 0.957, + "source": "D(2,6.4414,7.0133,6.5125,7.014,6.5125,7.1214,6.4414,7.1207)" + }, + { + "content": "the", + "span": { + "offset": 10037, + "length": 3 + }, + "confidence": 0.951, + "source": "D(2,6.5284,7.0142,6.6634,7.0156,6.6635,7.123,6.5284,7.1216)" + }, + { + "content": "IRS", + "span": { + "offset": 10041, + "length": 3 + }, + "confidence": 0.99, + "source": "D(2,6.6954,7.0159,6.8411,7.0175,6.8411,7.1249,6.6954,7.1234)" + }, + { + "content": "sent", + "span": { + "offset": 10045, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,6.8713,7.0178,7.056,7.0188,7.056,7.1262,6.8713,7.1252)" + }, + { + "content": "your", + "span": { + "offset": 10050, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,7.0809,7.0189,7.2763,7.0199,7.2763,7.1273,7.0809,7.1263)" + }, + { + "content": "spouse", + "span": { + "offset": 10055, + "length": 6 + }, + "confidence": 0.991, + "source": "D(2,7.2958,7.02,7.6138,7.02,7.6138,7.1274,7.2958,7.1274)" + }, + { + "content": "an", + "span": { + "offset": 10062, + "length": 2 + }, + "confidence": 0.996, + "source": "D(2,7.6369,7.02,7.7488,7.0199,7.7488,7.1274,7.6369,7.1274)" + }, + { + "content": "Identity", + "span": { + "offset": 10065, + "length": 8 + }, + "confidence": 0.979, + "source": "D(2,6.4414,7.1374,6.7677,7.1311,6.7677,7.2386,6.4414,7.2448)" + }, + { + "content": "Protection", + "span": { + "offset": 10074, + "length": 10 + }, + "confidence": 0.996, + "source": "D(2,6.7943,7.1306,7.2323,7.1269,7.2323,7.2343,6.7943,7.2381)" + }, + { + "content": "PIN", + "span": { + "offset": 10085, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,7.266,7.1268,7.4132,7.1265,7.4132,7.2339,7.266,7.2342)" + }, + { + "content": ",", + "span": { + "offset": 10088, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,7.4185,7.1265,7.438,7.1265,7.4381,7.2339,7.4186,7.2339)" + }, + { + "content": "enter", + "span": { + "offset": 10090, + "length": 5 + }, + "confidence": 0.98, + "source": "D(2,7.4682,7.1264,7.6969,7.1296,7.697,7.237,7.4682,7.2338)" + }, + { + "content": "it", + "span": { + "offset": 10096, + "length": 2 + }, + "confidence": 0.961, + "source": "D(2,7.72,7.13,7.7767,7.1308,7.7768,7.2382,7.72,7.2374)" + }, + { + "content": "here", + "span": { + "offset": 10099, + "length": 4 + }, + "confidence": 0.97, + "source": "D(2,7.798,7.1312,8.002,7.1342,8.002,7.2416,7.798,7.2386)" + }, + { + "content": "(", + "span": { + "offset": 10104, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.4414,7.2725,6.4784,7.2725,6.4784,7.3799,6.4414,7.3799)" + }, + { + "content": "see", + "span": { + "offset": 10105, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,6.4749,7.2725,6.6266,7.2725,6.6266,7.3799,6.4749,7.3799)" + }, + { + "content": "inst", + "span": { + "offset": 10109, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,6.6548,7.2725,6.8083,7.2725,6.8083,7.3799,6.6548,7.3799)" + }, + { + "content": ".", + "span": { + "offset": 10113, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8048,7.2725,6.8259,7.2725,6.8259,7.3799,6.8048,7.3799)" + }, + { + "content": ")", + "span": { + "offset": 10114, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8259,7.2725,6.8647,7.2725,6.8647,7.3799,6.8259,7.3799)" + }, + { + "content": "574890", + "span": { + "offset": 10116, + "length": 6 + }, + "confidence": 0.999, + "source": "D(2,6.9976,7.2498,8.002,7.2445,8.002,7.4182,6.9976,7.4225)" + }, + { + "content": "Phone", + "span": { + "offset": 10124, + "length": 5 + }, + "confidence": 0.996, + "source": "D(2,1.3873,7.4489,1.6697,7.4494,1.6684,7.5568,1.3873,7.5563)" + }, + { + "content": "no", + "span": { + "offset": 10130, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,1.6965,7.4491,1.8091,7.4463,1.8072,7.5537,1.6951,7.5565)" + }, + { + "content": ".", + "span": { + "offset": 10132, + "length": 1 + }, + "confidence": 0.998, + "source": "D(2,1.8145,7.4461,1.8448,7.4454,1.8428,7.5528,1.8125,7.5536)" + }, + { + "content": "00141386308", + "span": { + "offset": 10134, + "length": 11 + }, + "confidence": 0.942, + "source": "D(2,2.4736,7.442,3.1667,7.4415,3.1667,7.5587,2.4736,7.5544)" + }, + { + "content": "Email", + "span": { + "offset": 10147, + "length": 5 + }, + "confidence": 0.989, + "source": "D(2,3.8453,7.445,4.0753,7.4438,4.0753,7.562,3.8453,7.5632)" + }, + { + "content": "address", + "span": { + "offset": 10153, + "length": 7 + }, + "confidence": 0.98, + "source": "D(2,4.1029,7.4437,4.439,7.4419,4.439,7.5601,4.1029,7.5618)" + }, + { + "content": "mirachael123@gmail.com.us", + "span": { + "offset": 10161, + "length": 25 + }, + "confidence": 0.935, + "source": "D(2,4.5177,7.4415,6.0471,7.4391,6.0471,7.5573,4.5177,7.5597)" + }, + { + "content": "Paid", + "span": { + "offset": 10191, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,0.4947,7.6735,0.828,7.6721,0.828,7.8074,0.4949,7.8123)" + }, + { + "content": "Preparer", + "span": { + "offset": 10196, + "length": 8 + }, + "confidence": 0.997, + "source": "D(2,0.4947,7.8525,1.1445,7.8525,1.1403,7.9965,0.4936,8.0024)" + }, + { + "content": "Use", + "span": { + "offset": 10205, + "length": 3 + }, + "confidence": 0.998, + "source": "D(2,0.4967,8.0147,0.7766,8.0189,0.7742,8.172,0.4949,8.1732)" + }, + { + "content": "Only", + "span": { + "offset": 10209, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,0.8154,8.0191,1.16,8.0182,1.1569,8.1765,0.813,8.1721)" + }, + { + "content": "Preparer's", + "span": { + "offset": 10215, + "length": 10 + }, + "confidence": 0.987, + "source": "D(2,1.3893,7.6044,1.8436,7.611,1.843,7.7231,1.3893,7.7164)" + }, + { + "content": "name", + "span": { + "offset": 10226, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,1.8712,7.6112,2.125,7.6103,2.124,7.7175,1.8706,7.7231)" + }, + { + "content": "Mark", + "span": { + "offset": 10231, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,1.2887,7.7615,1.5561,7.7585,1.5561,7.8767,1.2887,7.8797)" + }, + { + "content": "Collins", + "span": { + "offset": 10236, + "length": 7 + }, + "confidence": 0.996, + "source": "D(2,1.5822,7.7586,1.9642,7.7631,1.9642,7.8813,1.5822,7.8768)" + }, + { + "content": "Preparer's", + "span": { + "offset": 10245, + "length": 10 + }, + "confidence": 0.99, + "source": "D(2,3.0464,7.6088,3.4964,7.6137,3.4964,7.7313,3.0464,7.7249)" + }, + { + "content": "signature", + "span": { + "offset": 10256, + "length": 9 + }, + "confidence": 0.996, + "source": "D(2,3.5214,7.6138,3.9387,7.6115,3.9387,7.73,3.5214,7.7314)" + }, + { + "content": "mark", + "span": { + "offset": 10266, + "length": 4 + }, + "confidence": 0.959, + "source": "D(2,4.1836,7.7183,4.5575,7.7183,4.5575,7.9027,4.1836,7.9012)" + }, + { + "content": "collins", + "span": { + "offset": 10271, + "length": 7 + }, + "confidence": 0.78, + "source": "D(2,4.5696,7.7183,4.9556,7.7183,4.9556,7.9039,4.5696,7.9027)" + }, + { + "content": "Date", + "span": { + "offset": 10280, + "length": 4 + }, + "confidence": 0.999, + "source": "D(2,5.4453,7.6153,5.6611,7.6185,5.6611,7.7152,5.4453,7.712)" + }, + { + "content": "10/20/1990", + "span": { + "offset": 10285, + "length": 10 + }, + "confidence": 0.988, + "source": "D(2,5.4661,7.729,6.0762,7.729,6.0762,7.8472,5.4661,7.8472)" + }, + { + "content": "PTIN", + "span": { + "offset": 10297, + "length": 4 + }, + "confidence": 0.982, + "source": "D(2,6.2754,7.6055,6.4954,7.6055,6.4954,7.7021,6.2754,7.7021)" + }, + { + "content": "09870", + "span": { + "offset": 10302, + "length": 5 + }, + "confidence": 0.994, + "source": "D(2,6.4373,7.766,6.7527,7.7645,6.7527,7.8838,6.4373,7.8798)" + }, + { + "content": "Check", + "span": { + "offset": 10309, + "length": 5 + }, + "confidence": 0.998, + "source": "D(2,7.0432,7.6161,7.3373,7.613,7.3373,7.7151,7.0432,7.7115)" + }, + { + "content": "if", + "span": { + "offset": 10315, + "length": 2 + }, + "confidence": 0.998, + "source": "D(2,7.357,7.6123,7.4162,7.6102,7.4161,7.7122,7.357,7.7144)" + }, + { + "content": ":", + "span": { + "offset": 10317, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.4096,7.6105,7.4375,7.6095,7.4375,7.7114,7.4096,7.7125)" + }, + { + "content": "☐", + "span": { + "offset": 10320, + "length": 1 + }, + "confidence": 0.928, + "source": "D(2,7.093,7.7612,7.2175,7.7559,7.2175,7.8794,7.093,7.8794)" + }, + { + "content": "Self", + "span": { + "offset": 10322, + "length": 4 + }, + "confidence": 0.997, + "source": "D(2,7.2424,7.7701,7.4179,7.7688,7.4179,7.8796,7.2424,7.8776)" + }, + { + "content": "-", + "span": { + "offset": 10326, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.4142,7.7688,7.4471,7.7686,7.4471,7.88,7.4142,7.8796)" + }, + { + "content": "employed", + "span": { + "offset": 10327, + "length": 8 + }, + "confidence": 0.999, + "source": "D(2,7.4435,7.7686,7.8857,7.7734,7.8857,7.8846,7.4435,7.8799)" + }, + { + "content": "Firm's", + "span": { + "offset": 10337, + "length": 6 + }, + "confidence": 0.996, + "source": "D(2,1.3893,7.9659,1.659,7.9661,1.6589,8.0681,1.3893,8.068)" + }, + { + "content": "name", + "span": { + "offset": 10344, + "length": 4 + }, + "confidence": 0.998, + "source": "D(2,1.6866,7.9663,1.9424,7.9705,1.9424,8.0726,1.6866,8.0684)" + }, + { + "content": "STATE", + "span": { + "offset": 10349, + "length": 5 + }, + "confidence": 0.996, + "source": "D(2,2.1208,7.949,2.4873,7.9499,2.4873,8.0739,2.1208,8.0726)" + }, + { + "content": "company", + "span": { + "offset": 10355, + "length": 7 + }, + "confidence": 0.998, + "source": "D(2,2.5204,7.9499,3.0153,7.9487,3.0153,8.0791,2.5204,8.0741)" + }, + { + "content": "Phone", + "span": { + "offset": 10364, + "length": 5 + }, + "confidence": 0.995, + "source": "D(2,6.4414,7.9635,6.7294,7.9703,6.7294,8.0723,6.4414,8.0656)" + }, + { + "content": "no", + "span": { + "offset": 10370, + "length": 2 + }, + "confidence": 0.999, + "source": "D(2,6.7565,7.97,6.8648,7.966,6.8649,8.0681,6.7565,8.0721)" + }, + { + "content": ".", + "span": { + "offset": 10372, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,6.8682,7.9659,6.9021,7.9647,6.9021,8.0667,6.8682,8.068)" + }, + { + "content": "8760765000876", + "span": { + "offset": 10374, + "length": 13 + }, + "confidence": 0.934, + "source": "D(2,7.0474,7.9429,7.8691,7.9392,7.8691,8.0574,7.0474,8.061)" + }, + { + "content": "Firm's", + "span": { + "offset": 10389, + "length": 6 + }, + "confidence": 0.992, + "source": "D(2,1.3873,8.1284,1.6609,8.121,1.6609,8.2278,1.3873,8.2277)" + }, + { + "content": "address", + "span": { + "offset": 10396, + "length": 7 + }, + "confidence": 0.997, + "source": "D(2,1.6869,8.1211,2.0524,8.1319,2.0524,8.2379,1.6868,8.2282)" + }, + { + "content": "2025", + "span": { + "offset": 10404, + "length": 4 + }, + "confidence": 0.882, + "source": "D(2,2.2267,8.1164,2.4863,8.1151,2.4863,8.2333,2.2267,8.2327)" + }, + { + "content": "E", + "span": { + "offset": 10409, + "length": 1 + }, + "confidence": 0.983, + "source": "D(2,2.5222,8.1149,2.5861,8.1146,2.5861,8.2336,2.5222,8.2334)" + }, + { + "content": "76TH", + "span": { + "offset": 10411, + "length": 4 + }, + "confidence": 0.716, + "source": "D(2,2.62,8.1145,2.8876,8.1131,2.8876,8.2343,2.62,8.2337)" + }, + { + "content": "LOS", + "span": { + "offset": 10416, + "length": 3 + }, + "confidence": 0.991, + "source": "D(2,2.9315,8.1129,3.1512,8.112,3.1512,8.2348,2.9315,8.2344)" + }, + { + "content": "ANGELES", + "span": { + "offset": 10420, + "length": 7 + }, + "confidence": 0.978, + "source": "D(2,3.1811,8.1119,3.7182,8.1106,3.7182,8.2339,3.1811,8.2347)" + }, + { + "content": "CA", + "span": { + "offset": 10428, + "length": 2 + }, + "confidence": 0.976, + "source": "D(2,3.7542,8.1106,3.9139,8.1102,3.9139,8.2336,3.7542,8.2339)" + }, + { + "content": "90001-2712", + "span": { + "offset": 10431, + "length": 10 + }, + "confidence": 0.657, + "source": "D(2,3.9419,8.1101,4.5369,8.1102,4.5369,8.2304,3.9419,8.2336)" + }, + { + "content": "USA", + "span": { + "offset": 10442, + "length": 3 + }, + "confidence": 0.939, + "source": "D(2,4.5708,8.1102,4.8145,8.1102,4.8145,8.2289,4.5709,8.2302)" + }, + { + "content": "Firm's", + "span": { + "offset": 10447, + "length": 6 + }, + "confidence": 0.977, + "source": "D(2,6.4373,8.1251,6.7166,8.1214,6.7166,8.2284,6.4373,8.2272)" + }, + { + "content": "EIN", + "span": { + "offset": 10454, + "length": 3 + }, + "confidence": 0.92, + "source": "D(2,6.7442,8.1212,6.9062,8.121,6.9062,8.2286,6.7442,8.2285)" + }, + { + "content": "080686", + "span": { + "offset": 10458, + "length": 6 + }, + "confidence": 0.996, + "source": "D(2,7.3254,8.1211,7.7114,8.1211,7.7114,8.2285,7.3254,8.2285)" + }, + { + "content": "Go", + "span": { + "offset": 10483, + "length": 2 + }, + "confidence": 0.993, + "source": "D(2,0.4882,8.2987,0.6245,8.2986,0.6252,8.4168,0.489,8.4169)" + }, + { + "content": "to", + "span": { + "offset": 10486, + "length": 2 + }, + "confidence": 0.994, + "source": "D(2,0.6442,8.2986,0.7331,8.2986,0.7338,8.4167,0.645,8.4168)" + }, + { + "content": "www.irs.gov/Form1040", + "span": { + "offset": 10489, + "length": 20 + }, + "confidence": 0.309, + "source": "D(2,0.7568,8.2985,1.7761,8.2979,1.7765,8.4161,0.7575,8.4167)" + }, + { + "content": "for", + "span": { + "offset": 10510, + "length": 3 + }, + "confidence": 0.964, + "source": "D(2,1.7958,8.2979,1.9223,8.2978,1.9227,8.4159,1.7963,8.416)" + }, + { + "content": "instructions", + "span": { + "offset": 10514, + "length": 12 + }, + "confidence": 0.964, + "source": "D(2,1.946,8.2978,2.4477,8.2974,2.448,8.4155,1.9464,8.4159)" + }, + { + "content": "and", + "span": { + "offset": 10527, + "length": 3 + }, + "confidence": 0.995, + "source": "D(2,2.4714,8.2974,2.6353,8.2972,2.6356,8.4154,2.4717,8.4155)" + }, + { + "content": "the", + "span": { + "offset": 10531, + "length": 3 + }, + "confidence": 0.994, + "source": "D(2,2.663,8.2972,2.8052,8.2971,2.8054,8.4152,2.6632,8.4154)" + }, + { + "content": "latest", + "span": { + "offset": 10535, + "length": 6 + }, + "confidence": 0.976, + "source": "D(2,2.8309,8.297,3.0679,8.2968,3.0681,8.415,2.8311,8.4152)" + }, + { + "content": "information", + "span": { + "offset": 10542, + "length": 11 + }, + "confidence": 0.953, + "source": "D(2,3.0956,8.2968,3.5815,8.2963,3.5815,8.4145,3.0957,8.4149)" + }, + { + "content": ".", + "span": { + "offset": 10553, + "length": 1 + }, + "confidence": 0.988, + "source": "D(2,3.5855,8.2963,3.6171,8.2963,3.6171,8.4144,3.5855,8.4145)" + }, + { + "content": "Form", + "span": { + "offset": 10577, + "length": 4 + }, + "confidence": 0.996, + "source": "D(2,7.2175,8.2983,7.4186,8.2983,7.4186,8.4165,7.2175,8.4165)" + }, + { + "content": "1040", + "span": { + "offset": 10582, + "length": 4 + }, + "confidence": 0.989, + "source": "D(2,7.462,8.2983,7.7281,8.2983,7.7281,8.4165,7.462,8.4165)" + }, + { + "content": "(", + "span": { + "offset": 10587, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.7557,8.2983,7.7912,8.2983,7.7912,8.4165,7.7557,8.4165)" + }, + { + "content": "2020", + "span": { + "offset": 10588, + "length": 4 + }, + "confidence": 0.995, + "source": "D(2,7.7794,8.2983,7.9765,8.2983,7.9765,8.4165,7.7794,8.4165)" + }, + { + "content": ")", + "span": { + "offset": 10592, + "length": 1 + }, + "confidence": 0.999, + "source": "D(2,7.9647,8.2983,8.0061,8.2983,8.0061,8.4165,7.9647,8.4165)" + } + ], + "lines": [ + { + "content": "Page 2", + "source": "D(2,7.6601,0.3436,8.002,0.3396,8.002,0.4727,7.6616,0.4767)", + "span": { + "offset": 5459, + "length": 6 + } + }, + { + "content": "Form 1040 (2020)", + "source": "D(2,0.4885,0.3439,1.2669,0.348,1.2663,0.4636,0.4878,0.4595)", + "span": { + "offset": 5488, + "length": 16 + } + }, + { + "content": "16", + "source": "D(2,1.27,0.545,1.4039,0.545,1.4039,0.6482,1.27,0.6482)", + "span": { + "offset": 5564, + "length": 2 + } + }, + { + "content": "Tax (see instructions). Check if any from Form(s): 1", + "source": "D(2,1.5803,0.5343,4.0591,0.5355,4.0591,0.6678,1.5802,0.6666)", + "span": { + "offset": 5567, + "length": 52 + } + }, + { + "content": "☑", + "source": "D(2,4.1213,0.5371,4.2417,0.5358,4.2417,0.661,4.1213,0.6617)", + "span": { + "offset": 5620, + "length": 1 + } + }, + { + "content": "8814", + "source": "D(2,4.2911,0.5449,4.553,0.544,4.5533,0.6481,4.2915,0.649)", + "span": { + "offset": 5622, + "length": 4 + } + }, + { + "content": "2", + "source": "D(2,4.6899,0.5506,4.7563,0.5506,4.7563,0.6448,4.6899,0.6448)", + "span": { + "offset": 5627, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(2,4.8269,0.5371,4.9473,0.5354,4.9473,0.6573,4.8269,0.6613)", + "span": { + "offset": 5629, + "length": 1 + } + }, + { + "content": "4972", + "source": "D(2,4.9887,0.5443,5.2544,0.5441,5.2545,0.6482,4.9888,0.6483)", + "span": { + "offset": 5631, + "length": 4 + } + }, + { + "content": "3", + "source": "D(2,5.4038,0.5521,5.4619,0.5521,5.4619,0.6455,5.4038,0.6455)", + "span": { + "offset": 5636, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(2,5.5242,0.5368,5.6487,0.5344,5.6487,0.658,5.5242,0.662)", + "span": { + "offset": 5638, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.3414,0.6281,6.3522,0.6281,6.3522,0.6389,6.3414,0.6389)", + "span": { + "offset": 5640, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.5081,0.6281,6.5189,0.6281,6.5189,0.6389,6.5081,0.6389)", + "span": { + "offset": 5642, + "length": 1 + } + }, + { + "content": "16", + "source": "D(2,6.79,0.5471,6.9062,0.5471,6.9062,0.6456,6.79,0.6456)", + "span": { + "offset": 5653, + "length": 2 + } + }, + { + "content": "2350", + "source": "D(2,7.7151,0.5317,7.9771,0.5305,7.9775,0.6376,7.7156,0.6387)", + "span": { + "offset": 5665, + "length": 4 + } + }, + { + "content": "17", + "source": "D(2,1.2721,0.713,1.4039,0.713,1.4039,0.8144,1.2721,0.8144)", + "span": { + "offset": 5702, + "length": 2 + } + }, + { + "content": "Amount from Schedule 2, line 3", + "source": "D(2,1.5823,0.7011,3.167,0.7049,3.1667,0.8267,1.582,0.8229)", + "span": { + "offset": 5705, + "length": 30 + } + }, + { + "content": "17", + "source": "D(2,6.79,0.7111,6.9062,0.7111,6.9062,0.8109,6.79,0.8109)", + "span": { + "offset": 5745, + "length": 2 + } + }, + { + "content": "5437", + "source": "D(2,7.7156,0.6988,7.9647,0.699,7.9646,0.8028,7.7155,0.8026)", + "span": { + "offset": 5757, + "length": 4 + } + }, + { + "content": "18", + "source": "D(2,1.2739,0.88,1.4039,0.8796,1.4042,0.9788,1.2742,0.9792)", + "span": { + "offset": 5794, + "length": 2 + } + }, + { + "content": "Add lines 16 and 17", + "source": "D(2,1.5823,0.8708,2.5919,0.8703,2.592,0.9865,1.5823,0.987)", + "span": { + "offset": 5797, + "length": 19 + } + }, + { + "content": "18", + "source": "D(2,6.79,0.8789,6.9062,0.8789,6.9062,0.9782,6.79,0.9782)", + "span": { + "offset": 5826, + "length": 2 + } + }, + { + "content": "1000", + "source": "D(2,7.7239,0.8641,7.9646,0.8641,7.9646,0.9655,7.7239,0.9655)", + "span": { + "offset": 5838, + "length": 4 + } + }, + { + "content": "19", + "source": "D(2,1.2728,1.0463,1.4018,1.0441,1.4034,1.1436,1.2742,1.1457)", + "span": { + "offset": 5875, + "length": 2 + } + }, + { + "content": "Child tax credit or credit for other dependents", + "source": "D(2,1.5823,1.0336,3.8747,1.0386,3.8744,1.1604,1.5821,1.1554)", + "span": { + "offset": 5878, + "length": 47 + } + }, + { + "content": "19", + "source": "D(2,6.79,1.0422,6.9062,1.0422,6.9062,1.143,6.79,1.143)", + "span": { + "offset": 5935, + "length": 2 + } + }, + { + "content": "753", + "source": "D(2,7.7861,1.0319,7.9646,1.0319,7.9646,1.1336,7.7861,1.1336)", + "span": { + "offset": 5947, + "length": 3 + } + }, + { + "content": "20", + "source": "D(2,1.2669,1.2072,1.4039,1.2073,1.4039,1.311,1.2669,1.311)", + "span": { + "offset": 5983, + "length": 2 + } + }, + { + "content": "Amount from Schedule 3, line 7", + "source": "D(2,1.5792,1.1988,3.1626,1.1989,3.1626,1.3201,1.5792,1.32)", + "span": { + "offset": 5986, + "length": 30 + } + }, + { + "content": "20", + "source": "D(2,6.7776,1.2079,6.9152,1.2088,6.9146,1.3088,6.777,1.308)", + "span": { + "offset": 6026, + "length": 2 + } + }, + { + "content": "5430", + "source": "D(2,7.7149,1.1969,7.9771,1.1953,7.9777,1.3004,7.7156,1.302)", + "span": { + "offset": 6038, + "length": 4 + } + }, + { + "content": "21", + "source": "D(2,1.2638,1.3763,1.3956,1.3763,1.3956,1.4798,1.2638,1.4798)", + "span": { + "offset": 6075, + "length": 2 + } + }, + { + "content": "Add lines 19 and 20", + "source": "D(2,1.5823,1.3658,2.5922,1.3684,2.5919,1.4874,1.582,1.4847)", + "span": { + "offset": 6078, + "length": 19 + } + }, + { + "content": "21", + "source": "D(2,6.7776,1.3769,6.8979,1.3769,6.8979,1.4778,6.7776,1.4778)", + "span": { + "offset": 6107, + "length": 2 + } + }, + { + "content": "15790", + "source": "D(2,7.6699,1.3655,7.9646,1.3643,7.965,1.4672,7.6699,1.4684)", + "span": { + "offset": 6119, + "length": 5 + } + }, + { + "content": "22", + "source": "D(2,1.2669,1.5409,1.4091,1.5424,1.408,1.6439,1.2658,1.6423)", + "span": { + "offset": 6157, + "length": 2 + } + }, + { + "content": "Subtract line 21 from line 18. If zero or less, enter -0-", + "source": "D(2,1.5792,1.5359,4.2085,1.5364,4.2085,1.6573,1.5792,1.6568)", + "span": { + "offset": 6160, + "length": 57 + } + }, + { + "content": "22", + "source": "D(2,6.7776,1.5399,6.9173,1.546,6.9146,1.6459,6.7734,1.6399)", + "span": { + "offset": 6227, + "length": 2 + } + }, + { + "content": "5436", + "source": "D(2,7.7156,1.5287,7.9649,1.5295,7.9646,1.6317,7.7152,1.6309)", + "span": { + "offset": 6239, + "length": 4 + } + }, + { + "content": "23", + "source": "D(2,1.2679,1.71,1.408,1.71,1.408,1.8101,1.2679,1.8101)", + "span": { + "offset": 6276, + "length": 2 + } + }, + { + "content": "Other taxes, including self-employment tax, from Schedule 2, line 10", + "source": "D(2,1.5865,1.7007,5.0054,1.7007,5.0054,1.8269,1.5865,1.8269)", + "span": { + "offset": 6279, + "length": 68 + } + }, + { + "content": "23", + "source": "D(2,6.7776,1.7103,6.9062,1.7108,6.9062,1.8093,6.7773,1.8089)", + "span": { + "offset": 6357, + "length": 2 + } + }, + { + "content": "7650", + "source": "D(2,7.7154,1.6938,7.9646,1.6935,7.9647,1.7977,7.7156,1.798)", + "span": { + "offset": 6369, + "length": 4 + } + }, + { + "content": "24", + "source": "D(2,1.2702,1.8728,1.4111,1.8804,1.4059,1.9848,1.2673,1.9773)", + "span": { + "offset": 6406, + "length": 2 + } + }, + { + "content": "Add lines 22 and 23. This is your total tax", + "source": "D(2,1.5792,1.8689,3.6855,1.8701,3.6855,1.9971,1.5792,1.996)", + "span": { + "offset": 6409, + "length": 43 + } + }, + { + "content": "24", + "source": "D(2,6.7776,1.8799,6.9163,1.8824,6.9145,1.9792,6.7758,1.9766)", + "span": { + "offset": 6462, + "length": 2 + } + }, + { + "content": "12780", + "source": "D(2,7.6616,1.8664,7.9648,1.8669,7.9646,1.9716,7.6615,1.9711)", + "span": { + "offset": 6474, + "length": 5 + } + }, + { + "content": "25", + "source": "D(2,1.2666,2.0433,1.408,2.0429,1.4083,2.1459,1.2669,2.1463)", + "span": { + "offset": 6512, + "length": 2 + } + }, + { + "content": "Federal income tax withheld from:", + "source": "D(2,1.5865,2.0404,3.2871,2.0406,3.2871,2.1584,1.5865,2.1581)", + "span": { + "offset": 6515, + "length": 33 + } + }, + { + "content": "6220", + "source": "D(2,7.7156,2.6931,7.9651,2.6943,7.9646,2.8037,7.7151,2.8025)", + "span": { + "offset": 6592, + "length": 4 + } + }, + { + "content": "a", + "source": "D(2,1.3873,2.2326,1.4641,2.2326,1.4641,2.3188,1.3873,2.3188)", + "span": { + "offset": 6617, + "length": 1 + } + }, + { + "content": "Form(s) W-2", + "source": "D(2,1.5875,2.2073,2.2142,2.2073,2.2142,2.3315,1.5875,2.3315)", + "span": { + "offset": 6619, + "length": 11 + } + }, + { + "content": "25a", + "source": "D(2,5.4411,2.218,5.6445,2.2178,5.6445,2.3178,5.4412,2.318)", + "span": { + "offset": 6640, + "length": 3 + } + }, + { + "content": "4220", + "source": "D(2,6.4207,2.1979,6.6698,2.1983,6.6697,2.303,6.4205,2.3028)", + "span": { + "offset": 6653, + "length": 4 + } + }, + { + "content": "b", + "source": "D(2,1.3893,2.3844,1.4641,2.3844,1.4641,2.4798,1.3893,2.4798)", + "span": { + "offset": 6678, + "length": 1 + } + }, + { + "content": "Form(s) 1099", + "source": "D(2,1.5875,2.3727,2.2495,2.3727,2.2495,2.4977,1.5875,2.4977)", + "span": { + "offset": 6680, + "length": 12 + } + }, + { + "content": "25b", + "source": "D(2,5.4406,2.3766,5.6445,2.3755,5.6445,2.4782,5.4412,2.4793)", + "span": { + "offset": 6702, + "length": 3 + } + }, + { + "content": "1000", + "source": "D(2,6.4248,2.3657,6.6697,2.3657,6.6697,2.472,6.4248,2.472)", + "span": { + "offset": 6715, + "length": 4 + } + }, + { + "content": "c", + "source": "D(2,1.4042,2.5759,1.4609,2.5759,1.4609,2.6363,1.4042,2.6363)", + "span": { + "offset": 6740, + "length": 1 + } + }, + { + "content": "Other forms (see instructions)", + "source": "D(2,1.5865,2.5355,3.0631,2.5366,3.063,2.6641,1.5864,2.6629)", + "span": { + "offset": 6742, + "length": 30 + } + }, + { + "content": "25c", + "source": "D(2,5.4453,2.5461,5.6445,2.5436,5.6445,2.6436,5.4453,2.6461)", + "span": { + "offset": 6782, + "length": 3 + } + }, + { + "content": "2000", + "source": "D(2,6.4193,2.5298,6.6695,2.5215,6.6731,2.6328,6.4207,2.641)", + "span": { + "offset": 6795, + "length": 4 + } + }, + { + "content": "d", + "source": "D(2,1.3935,2.7151,1.4692,2.7151,1.4692,2.8118,1.3935,2.8118)", + "span": { + "offset": 6832, + "length": 1 + } + }, + { + "content": "Add lines 25a through 25c", + "source": "D(2,1.5792,2.7003,2.9117,2.7025,2.9115,2.8311,1.579,2.8289)", + "span": { + "offset": 6834, + "length": 25 + } + }, + { + "content": "25d", + "source": "D(2,6.7361,2.7071,6.9545,2.7123,6.9519,2.8157,6.7347,2.8101)", + "span": { + "offset": 6869, + "length": 3 + } + }, + { + "content": ". If you have a", + "source": "D(2,0.455,2.9315,1.0423,2.9352,1.0417,3.0337,0.4543,3.0318)", + "span": { + "offset": 6905, + "length": 15 + } + }, + { + "content": "qualifying child,", + "source": "D(2,0.5157,3.0347,1.1497,3.0347,1.1497,3.1313,0.5157,3.1313)", + "span": { + "offset": 6921, + "length": 17 + } + }, + { + "content": "attach Sch. EIC.", + "source": "D(2,0.5136,3.1289,1.1631,3.1289,1.1631,3.2246,0.5136,3.2246)", + "span": { + "offset": 6939, + "length": 16 + } + }, + { + "content": ". If you have", + "source": "D(2,0.4586,3.2515,0.9696,3.2571,0.9686,3.3497,0.4576,3.344)", + "span": { + "offset": 6956, + "length": 13 + } + }, + { + "content": "nontaxable", + "source": "D(2,0.5156,3.3521,0.9722,3.3478,0.9731,3.4406,0.5165,3.4434)", + "span": { + "offset": 6970, + "length": 10 + } + }, + { + "content": "combat pay,", + "source": "D(2,0.5149,3.4514,1.0231,3.4532,1.0227,3.5512,0.5146,3.5495)", + "span": { + "offset": 6981, + "length": 11 + } + }, + { + "content": "see instructions.", + "source": "D(2,0.5126,3.552,1.1813,3.5555,1.1808,3.6488,0.5121,3.6454)", + "span": { + "offset": 6993, + "length": 17 + } + }, + { + "content": "26", + "source": "D(2,1.2659,2.8762,1.4039,2.8762,1.4039,2.9836,1.2659,2.9836)", + "span": { + "offset": 7032, + "length": 2 + } + }, + { + "content": "2020 estimated tax payments and amount applied from 2019 return", + "source": "D(2,1.5865,2.8704,4.9639,2.8699,4.9639,3.0001,1.5865,3.0005)", + "span": { + "offset": 7035, + "length": 63 + } + }, + { + "content": "26", + "source": "D(2,6.7776,2.8765,6.9173,2.881,6.9146,2.9796,6.7744,2.975)", + "span": { + "offset": 7108, + "length": 2 + } + }, + { + "content": "5438", + "source": "D(2,7.7156,2.8555,7.9687,2.8691,7.9645,2.9784,7.7142,2.9653)", + "span": { + "offset": 7120, + "length": 4 + } + }, + { + "content": "27", + "source": "D(2,1.2659,3.0444,1.4045,3.0453,1.4039,3.148,1.2652,3.1471)", + "span": { + "offset": 7145, + "length": 2 + } + }, + { + "content": "Earned income credit (EIC)", + "source": "D(2,1.5896,3.0307,2.9368,3.035,2.9364,3.1641,1.5892,3.1598)", + "span": { + "offset": 7148, + "length": 26 + } + }, + { + "content": "27", + "source": "D(2,5.4659,3.0442,5.6155,3.044,5.6156,3.1447,5.4661,3.1449)", + "span": { + "offset": 7184, + "length": 2 + } + }, + { + "content": "4359", + "source": "D(2,6.4082,3.0302,6.6655,3.0294,6.6659,3.1337,6.4082,3.1346)", + "span": { + "offset": 7196, + "length": 4 + } + }, + { + "content": "6534", + "source": "D(2,7.7156,3.8645,7.9646,3.8645,7.9646,3.9666,7.7156,3.9666)", + "span": { + "offset": 7232, + "length": 4 + } + }, + { + "content": "28", + "source": "D(2,1.2669,3.2082,1.4039,3.2082,1.4039,3.3088,1.2669,3.3088)", + "span": { + "offset": 7257, + "length": 2 + } + }, + { + "content": "Additional child tax credit. Attach Schedule 8812", + "source": "D(2,1.5843,3.2014,4.0217,3.1998,4.0219,3.3185,1.5844,3.3212)", + "span": { + "offset": 7260, + "length": 49 + } + }, + { + "content": "28", + "source": "D(2,5.4744,3.2099,5.6155,3.2099,5.6155,3.3086,5.4744,3.3086)", + "span": { + "offset": 7319, + "length": 2 + } + }, + { + "content": "5326", + "source": "D(2,6.4041,3.1912,6.6683,3.2029,6.6655,3.3104,6.4027,3.2987)", + "span": { + "offset": 7331, + "length": 4 + } + }, + { + "content": "29", + "source": "D(2,1.2669,3.3757,1.407,3.3757,1.407,3.4778,1.2669,3.4778)", + "span": { + "offset": 7378, + "length": 2 + } + }, + { + "content": "American opportunity credit from Form 8863, line 8", + "source": "D(2,1.582,3.3673,4.1525,3.3613,4.1528,3.4909,1.5823,3.4969)", + "span": { + "offset": 7381, + "length": 50 + } + }, + { + "content": "29", + "source": "D(2,5.4744,3.3757,5.6155,3.3757,5.6155,3.4778,5.4744,3.4778)", + "span": { + "offset": 7441, + "length": 2 + } + }, + { + "content": "6743", + "source": "D(2,6.4041,3.3677,6.6531,3.3677,6.6531,3.4697,6.4041,3.4697)", + "span": { + "offset": 7453, + "length": 4 + } + }, + { + "content": "30", + "source": "D(2,1.2669,3.55,1.4039,3.55,1.4039,3.6522,1.2669,3.6522)", + "span": { + "offset": 7478, + "length": 2 + } + }, + { + "content": "Recovery rebate credit. See instructions", + "source": "D(2,1.5884,3.5385,3.5901,3.5354,3.5903,3.6637,1.5886,3.6669)", + "span": { + "offset": 7481, + "length": 40 + } + }, + { + "content": "30", + "source": "D(2,5.4827,3.5503,5.6155,3.5503,5.6155,3.647,5.4827,3.647)", + "span": { + "offset": 7531, + "length": 2 + } + }, + { + "content": "4562", + "source": "D(2,6.4207,3.5347,6.6665,3.5371,6.6655,3.6422,6.4197,3.6399)", + "span": { + "offset": 7543, + "length": 4 + } + }, + { + "content": "31", + "source": "D(2,1.2652,3.7201,1.3956,3.7179,1.3973,3.8208,1.2669,3.823)", + "span": { + "offset": 7568, + "length": 2 + } + }, + { + "content": "Amount from Schedule 3, line 13", + "source": "D(2,1.5844,3.708,3.229,3.7081,3.229,3.8313,1.5844,3.8312)", + "span": { + "offset": 7571, + "length": 31 + } + }, + { + "content": "31", + "source": "D(2,5.4734,3.7162,5.603,3.7149,5.604,3.8185,5.4744,3.8197)", + "span": { + "offset": 7612, + "length": 2 + } + }, + { + "content": "2428", + "source": "D(2,6.4034,3.693,6.6655,3.6913,6.6662,3.7983,6.4041,3.8)", + "span": { + "offset": 7624, + "length": 4 + } + }, + { + "content": "32", + "source": "D(2,1.2679,3.8745,1.408,3.8745,1.408,3.9773,1.2679,3.9773)", + "span": { + "offset": 7661, + "length": 2 + } + }, + { + "content": "Add lines 27 through 31. These are your total other payments and refundable credits", + "source": "D(2,1.5792,3.8614,5.9434,3.8663,5.9433,3.9958,1.5791,3.9909)", + "span": { + "offset": 7664, + "length": 83 + } + }, + { + "content": "32", + "source": "D(2,6.7776,3.8747,6.9146,3.8747,6.9146,3.9773,6.7776,3.9773)", + "span": { + "offset": 7757, + "length": 2 + } + }, + { + "content": "33", + "source": "D(2,1.2669,4.0381,1.4109,4.0421,1.408,4.1451,1.2641,4.1411)", + "span": { + "offset": 7792, + "length": 2 + } + }, + { + "content": "Add lines 25d, 26, and 32. These are your total payments", + "source": "D(2,1.5803,4.0283,4.4907,4.0283,4.4907,4.1575,1.5803,4.1575)", + "span": { + "offset": 7795, + "length": 56 + } + }, + { + "content": "33", + "source": "D(2,6.7776,4.041,6.9146,4.041,6.9146,4.1439,6.7776,4.1439)", + "span": { + "offset": 7861, + "length": 2 + } + }, + { + "content": "3657", + "source": "D(2,7.7152,4.0336,7.9563,4.0328,7.9567,4.1407,7.7156,4.1415)", + "span": { + "offset": 7873, + "length": 4 + } + }, + { + "content": "Refund", + "source": "D(2,0.4918,4.2485,0.9857,4.2485,0.9857,4.3774,0.4918,4.3774)", + "span": { + "offset": 7910, + "length": 6 + } + }, + { + "content": "Direct deposit?", + "source": "D(2,0.4899,4.5295,1.1434,4.5214,1.1448,4.6346,0.4913,4.6427)", + "span": { + "offset": 7917, + "length": 15 + } + }, + { + "content": "See instructions.", + "source": "D(2,0.49,4.651,1.2053,4.6556,1.2046,4.7603,0.4893,4.7558)", + "span": { + "offset": 7933, + "length": 17 + } + }, + { + "content": "34", + "source": "D(2,1.2648,4.203,1.4111,4.2192,1.408,4.3206,1.2617,4.3043)", + "span": { + "offset": 7972, + "length": 2 + } + }, + { + "content": "If line 33 is more than line 24, subtract line 24 from line 33. This is the amount you overpaid", + "source": "D(2,1.5792,4.1983,6.147,4.209,6.1467,4.3343,1.5789,4.3236)", + "span": { + "offset": 7975, + "length": 95 + } + }, + { + "content": ".", + "source": "D(2,6.3426,4.2892,6.3549,4.2892,6.3549,4.3016,6.3426,4.3016)", + "span": { + "offset": 8071, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.5092,4.2892,6.5216,4.2892,6.5216,4.3016,6.5092,4.3016)", + "span": { + "offset": 8073, + "length": 1 + } + }, + { + "content": "34", + "source": "D(2,6.7773,4.2139,6.9145,4.2135,6.9148,4.3172,6.7776,4.3175)", + "span": { + "offset": 8084, + "length": 2 + } + }, + { + "content": "6338", + "source": "D(2,7.7156,4.2002,7.9646,4.2002,7.9646,4.3063,7.7156,4.3063)", + "span": { + "offset": 8096, + "length": 4 + } + }, + { + "content": "35a", + "source": "D(2,1.27,4.3774,1.4641,4.3774,1.4641,4.4797,1.27,4.4797)", + "span": { + "offset": 8133, + "length": 3 + } + }, + { + "content": "5a Amount of line 34 you want refunded to you. If Form 8888 is attached, check here", + "source": "D(2,1.3302,4.3715,5.7069,4.3746,5.7068,4.4929,1.3301,4.4899)", + "span": { + "offset": 8137, + "length": 83 + } + }, + { + "content": "☐", + "source": "D(2,6.458,4.364,6.5742,4.3694,6.5742,4.4875,6.458,4.4822)", + "span": { + "offset": 8221, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.8426,4.4559,5.855,4.4559,5.855,4.4682,5.8426,4.4682)", + "span": { + "offset": 8223, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.0093,4.4559,6.0216,4.4559,6.0216,4.4682,6.0093,4.4682)", + "span": { + "offset": 8225, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.176,4.4559,6.1883,4.4559,6.1883,4.4682,6.176,4.4682)", + "span": { + "offset": 8227, + "length": 1 + } + }, + { + "content": "35a", + "source": "D(2,6.7485,4.3781,6.9478,4.3781,6.9478,4.4768,6.7485,4.4768)", + "span": { + "offset": 8238, + "length": 3 + } + }, + { + "content": "6335", + "source": "D(2,7.7156,4.3613,7.9646,4.3613,7.9646,4.4688,7.7156,4.4688)", + "span": { + "offset": 8251, + "length": 4 + } + }, + { + "content": "b Routing number", + "source": "D(2,1.2939,4.5369,2.366,4.5396,2.3657,4.6638,1.2936,4.6611)", + "span": { + "offset": 8288, + "length": 16 + } + }, + { + "content": "052088863", + "source": "D(2,2.403,4.5026,4.2002,4.5015,4.2002,4.6535,2.4031,4.6545)", + "span": { + "offset": 8305, + "length": 9 + } + }, + { + "content": "▶ c Type:", + "source": "D(2,4.5904,4.5395,5.0908,4.5474,5.0884,4.6696,4.588,4.6596)", + "span": { + "offset": 8315, + "length": 9 + } + }, + { + "content": "☐", + "source": "D(2,5.2336,4.5359,5.354,4.5359,5.354,4.6594,5.2336,4.6567)", + "span": { + "offset": 8325, + "length": 1 + } + }, + { + "content": "Checking", + "source": "D(2,5.3914,4.5403,5.8732,4.5421,5.8728,4.66,5.3909,4.6583)", + "span": { + "offset": 8327, + "length": 8 + } + }, + { + "content": "☑", + "source": "D(2,6.0264,4.5386,6.1633,4.5386,6.1633,4.6621,6.0264,4.6621)", + "span": { + "offset": 8336, + "length": 1 + } + }, + { + "content": "Savings", + "source": "D(2,6.1924,4.5401,6.5959,4.5434,6.5949,4.6613,6.1924,4.6582)", + "span": { + "offset": 8338, + "length": 7 + } + }, + { + "content": "▶d Account number", + "source": "D(2,1.2898,4.7019,2.3643,4.7082,2.3636,4.8214,1.2894,4.815)", + "span": { + "offset": 8422, + "length": 17 + } + }, + { + "content": "5206340044401004", + "source": "D(2,2.3969,4.6552,5.6036,4.6661,5.603,4.8384,2.3963,4.8284)", + "span": { + "offset": 8440, + "length": 16 + } + }, + { + "content": "36 Amount of line 34 you want applied to your 2021 estimated tax", + "source": "D(2,1.2617,4.8606,4.8186,4.8613,4.8186,4.9876,1.2617,4.9867)", + "span": { + "offset": 8477, + "length": 64 + } + }, + { + "content": "36", + "source": "D(2,5.4744,4.8668,5.6224,4.8773,5.6194,4.9878,5.473,4.9773)", + "span": { + "offset": 8551, + "length": 2 + } + }, + { + "content": "45830", + "source": "D(2,6.3459,4.8677,6.6658,4.8686,6.6655,4.9744,6.3457,4.9735)", + "span": { + "offset": 8563, + "length": 5 + } + }, + { + "content": "Amount", + "source": "D(2,0.491,5.0408,1.0293,5.0408,1.0293,5.1645,0.491,5.1645)", + "span": { + "offset": 8601, + "length": 6 + } + }, + { + "content": "You Owe", + "source": "D(2,0.4918,5.1804,1.1009,5.1804,1.1009,5.3067,0.4918,5.3067)", + "span": { + "offset": 8608, + "length": 7 + } + }, + { + "content": "For details on", + "source": "D(2,0.4925,5.3408,1.0957,5.3319,1.0957,5.4412,0.4934,5.4474)", + "span": { + "offset": 8616, + "length": 14 + } + }, + { + "content": "how to pay, see", + "source": "D(2,0.49,5.4469,1.1953,5.4483,1.1953,5.5493,0.4898,5.5479)", + "span": { + "offset": 8631, + "length": 15 + } + }, + { + "content": "instructions.", + "source": "D(2,0.492,5.5421,1.0303,5.5387,1.031,5.638,0.4926,5.6412)", + "span": { + "offset": 8647, + "length": 13 + } + }, + { + "content": "37", + "source": "D(2,1.2679,5.0596,1.4008,5.0596,1.4008,5.1616,1.2679,5.1616)", + "span": { + "offset": 8682, + "length": 2 + } + }, + { + "content": "Subtract line 33 from line 24. This is the amount you owe now", + "source": "D(2,1.5865,5.0579,4.7357,5.0609,4.7356,5.1862,1.5864,5.1831)", + "span": { + "offset": 8685, + "length": 61 + } + }, + { + "content": ".", + "source": "D(2,5.0092,5.1424,5.0216,5.1424,5.0216,5.1547,5.0092,5.1547)", + "span": { + "offset": 8747, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.1759,5.1424,5.1882,5.1424,5.1882,5.1547,5.1759,5.1547)", + "span": { + "offset": 8749, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.3426,5.1424,5.3549,5.1424,5.3549,5.1547,5.3426,5.1547)", + "span": { + "offset": 8751, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.5092,5.1424,5.5216,5.1424,5.5216,5.1547,5.5092,5.1547)", + "span": { + "offset": 8753, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.6759,5.1424,5.6882,5.1424,5.6882,5.1547,5.6759,5.1547)", + "span": { + "offset": 8755, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,5.8426,5.1424,5.8549,5.1424,5.8549,5.1547,5.8426,5.1547)", + "span": { + "offset": 8757, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.0092,5.1424,6.0216,5.1424,6.0216,5.1547,6.0092,5.1547)", + "span": { + "offset": 8759, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.1759,5.1424,6.1882,5.1424,6.1882,5.1547,6.1759,5.1547)", + "span": { + "offset": 8761, + "length": 1 + } + }, + { + "content": ".", + "source": "D(2,6.3426,5.1424,6.3549,5.1424,6.3549,5.1547,6.3426,5.1547)", + "span": { + "offset": 8763, + "length": 1 + } + }, + { + "content": "37", + "source": "D(2,6.7776,5.0515,6.9062,5.0515,6.9062,5.1536,6.7776,5.1536)", + "span": { + "offset": 8774, + "length": 2 + } + }, + { + "content": "6430", + "source": "D(2,7.7156,5.03,7.9646,5.03,7.9646,5.1375,7.7156,5.1375)", + "span": { + "offset": 8786, + "length": 4 + } + }, + { + "content": "Note: Schedule H and Schedule SE filers, line 37 may not represent all of the taxes you owe for", + "source": "D(2,1.5875,5.2285,6.6036,5.2414,6.6033,5.3693,1.5872,5.3564)", + "span": { + "offset": 8823, + "length": 95 + } + }, + { + "content": "2020. See Schedule 3, line 12e, and its instructions for details.", + "source": "D(2,1.5865,5.3718,4.6899,5.3718,4.6899,5.4977,1.5865,5.4977)", + "span": { + "offset": 8995, + "length": 65 + } + }, + { + "content": "38", + "source": "D(2,1.2698,5.536,1.4039,5.5357,1.4041,5.6464,1.27,5.6467)", + "span": { + "offset": 9081, + "length": 2 + } + }, + { + "content": "Estimated tax penalty (see instructions)", + "source": "D(2,1.5886,5.5304,3.5404,5.5325,3.5403,5.6616,1.5884,5.6595)", + "span": { + "offset": 9084, + "length": 40 + } + }, + { + "content": "38", + "source": "D(2,5.4744,5.5438,5.6155,5.5438,5.6155,5.6464,5.4744,5.6464)", + "span": { + "offset": 9134, + "length": 2 + } + }, + { + "content": "1250", + "source": "D(2,6.4207,5.5322,6.6655,5.5322,6.6655,5.6397,6.4207,5.6397)", + "span": { + "offset": 9146, + "length": 4 + } + }, + { + "content": "Third Party", + "source": "D(2,0.4934,5.7049,1.2078,5.7134,1.206,5.8626,0.4925,5.8543)", + "span": { + "offset": 9175, + "length": 11 + } + }, + { + "content": "Designee", + "source": "D(2,0.4934,5.8545,1.1009,5.8545,1.1009,5.9941,0.4934,5.9941)", + "span": { + "offset": 9187, + "length": 8 + } + }, + { + "content": "Do you want to allow another person to discuss this return with the IRS? See", + "source": "D(2,1.3892,5.7089,5.6072,5.7043,5.6073,5.8257,1.3893,5.8294)", + "span": { + "offset": 9197, + "length": 76 + } + }, + { + "content": "instructions", + "source": "D(2,1.3873,5.8491,1.9849,5.8491,1.9849,5.9565,1.3873,5.9565)", + "span": { + "offset": 9274, + "length": 12 + } + }, + { + "content": "☐", + "source": "D(2,5.6902,5.8384,5.8105,5.8384,5.8105,5.9565,5.6902,5.9565)", + "span": { + "offset": 9288, + "length": 1 + } + }, + { + "content": "Yes. Complete below.", + "source": "D(2,5.8396,5.8438,6.9519,5.8438,6.9519,5.9619,5.8396,5.9619)", + "span": { + "offset": 9290, + "length": 20 + } + }, + { + "content": "☑", + "source": "D(2,7.093,5.8384,7.2092,5.8384,7.2092,5.9565,7.093,5.9565)", + "span": { + "offset": 9311, + "length": 1 + } + }, + { + "content": "No", + "source": "D(2,7.2466,5.8483,7.396,5.8483,7.396,5.9512,7.2466,5.9512)", + "span": { + "offset": 9313, + "length": 2 + } + }, + { + "content": "Designee's", + "source": "D(2,1.3914,6.0121,1.8849,6.0141,1.8843,6.1251,1.3908,6.1224)", + "span": { + "offset": 9317, + "length": 10 + } + }, + { + "content": "name", + "source": "D(2,1.3863,6.153,1.6456,6.1505,1.6465,6.2411,1.3873,6.2439)", + "span": { + "offset": 9328, + "length": 4 + } + }, + { + "content": "Phone", + "source": "D(2,4.1878,6.0134,4.4824,6.0182,4.4824,6.1179,4.1862,6.1131)", + "span": { + "offset": 9334, + "length": 5 + } + }, + { + "content": "no.", + "source": "D(2,4.1877,6.1553,4.3372,6.1553,4.3372,6.2425,4.1877,6.2425)", + "span": { + "offset": 9340, + "length": 3 + } + }, + { + "content": "Personal identification", + "source": "D(2,5.989,6.0102,6.9644,6.0102,6.9644,6.1167,5.989,6.1167)", + "span": { + "offset": 9345, + "length": 23 + } + }, + { + "content": "number (PIN)", + "source": "D(2,5.9849,6.1333,6.5659,6.1333,6.5659,6.2414,5.9849,6.2414)", + "span": { + "offset": 9369, + "length": 12 + } + }, + { + "content": "Sign", + "source": "D(2,0.487,6.3139,0.8543,6.3002,0.8577,6.4775,0.4895,6.4912)", + "span": { + "offset": 9387, + "length": 4 + } + }, + { + "content": "Here", + "source": "D(2,0.4923,6.4982,0.8816,6.4985,0.8814,6.6465,0.4922,6.6462)", + "span": { + "offset": 9392, + "length": 4 + } + }, + { + "content": "Under penalties of perjury, I declare that I have examined this return and accompanying schedules and statements, and to the best of my knowledge and", + "source": "D(2,1.3893,6.3058,8.0061,6.3031,8.0062,6.422,1.3893,6.4247)", + "span": { + "offset": 9398, + "length": 149 + } + }, + { + "content": "belief, they are true, correct, and complete. Declaration of preparer (other than taxpayer) is based on all information of which preparer has any knowledge.", + "source": "D(2,1.3883,6.4238,7.9397,6.4238,7.9397,6.542,1.3883,6.542)", + "span": { + "offset": 9548, + "length": 156 + } + }, + { + "content": "Your signature", + "source": "D(2,1.3904,6.6044,2.038,6.6054,2.0378,6.724,1.3902,6.723)", + "span": { + "offset": 9706, + "length": 14 + } + }, + { + "content": "anthony kelly", + "source": "D(2,2.4072,6.7622,3.2456,6.7622,3.2456,6.9888,2.4072,6.9888)", + "span": { + "offset": 9721, + "length": 13 + } + }, + { + "content": "Date", + "source": "D(2,3.8453,6.6046,4.0599,6.6064,4.0591,6.7037,3.8446,6.7019)", + "span": { + "offset": 9736, + "length": 4 + } + }, + { + "content": "12/10/1986", + "source": "D(2,3.8267,6.7783,4.4326,6.7783,4.4326,6.8965,3.8267,6.8965)", + "span": { + "offset": 9741, + "length": 10 + } + }, + { + "content": "Your occupation", + "source": "D(2,4.5447,6.6031,5.2753,6.6039,5.2751,6.7247,4.5446,6.7239)", + "span": { + "offset": 9753, + "length": 15 + } + }, + { + "content": "Judge", + "source": "D(2,4.8394,6.8055,5.1797,6.8097,5.1797,6.9408,4.8377,6.9366)", + "span": { + "offset": 9769, + "length": 5 + } + }, + { + "content": "If the IRS sent you an Identity", + "source": "D(2,6.4414,6.5934,7.7165,6.6004,7.7156,6.715,6.4414,6.7048)", + "span": { + "offset": 9776, + "length": 31 + } + }, + { + "content": "Protection PIN, enter it here", + "source": "D(2,6.4414,6.7139,7.6533,6.7139,7.6533,6.8213,6.4414,6.8213)", + "span": { + "offset": 9808, + "length": 29 + } + }, + { + "content": "(see inst.)", + "source": "D(2,6.4359,6.8434,6.8647,6.8368,6.8666,6.9578,6.4373,6.9643)", + "span": { + "offset": 9838, + "length": 11 + } + }, + { + "content": "654344", + "source": "D(2,7.0012,6.8334,7.9936,6.8303,7.9942,6.9958,7.0017,6.9989)", + "span": { + "offset": 9850, + "length": 6 + } + }, + { + "content": "Joint return?", + "source": "D(2,0.4918,6.8811,1.0091,6.8811,1.0091,6.9831,0.4918,6.9831)", + "span": { + "offset": 9858, + "length": 13 + } + }, + { + "content": "See instructions.", + "source": "D(2,0.4884,7.0012,1.1724,6.9919,1.1732,7.1011,0.4903,7.1124)", + "span": { + "offset": 9872, + "length": 17 + } + }, + { + "content": "Keep a copy for", + "source": "D(2,0.4903,7.1221,1.1497,7.1221,1.1497,7.2295,0.4903,7.2295)", + "span": { + "offset": 9890, + "length": 15 + } + }, + { + "content": "your records.", + "source": "D(2,0.4838,7.2448,1.0324,7.24,1.0333,7.3451,0.4847,7.3499)", + "span": { + "offset": 9906, + "length": 13 + } + }, + { + "content": "Spouse's signature. If a joint return, both must sign.", + "source": "D(2,1.3862,7.0254,3.6627,7.0254,3.6627,7.1436,1.3862,7.1436)", + "span": { + "offset": 9921, + "length": 54 + } + }, + { + "content": "laren waston", + "source": "D(2,2.2412,7.1917,3.0049,7.1917,3.0049,7.3814,2.2412,7.3814)", + "span": { + "offset": 9976, + "length": 12 + } + }, + { + "content": "Date", + "source": "D(2,3.8453,7.0254,4.0591,7.0254,4.0591,7.1221,3.8453,7.1221)", + "span": { + "offset": 9990, + "length": 4 + } + }, + { + "content": "02/19/1978", + "source": "D(2,3.8246,7.1919,4.4451,7.1919,4.4451,7.3101,3.8246,7.3101)", + "span": { + "offset": 9995, + "length": 10 + } + }, + { + "content": "Spouse's occupation", + "source": "D(2,4.5447,7.0259,5.4785,7.0259,5.4785,7.1382,4.5447,7.1382)", + "span": { + "offset": 10007, + "length": 19 + } + }, + { + "content": "nurse", + "source": "D(2,4.8684,7.2402,5.1838,7.2402,5.1838,7.3371,4.8684,7.3371)", + "span": { + "offset": 10027, + "length": 5 + } + }, + { + "content": "If the IRS sent your spouse an", + "source": "D(2,6.4414,7.0133,7.7493,7.0199,7.7488,7.1297,6.4414,7.1231)", + "span": { + "offset": 10034, + "length": 30 + } + }, + { + "content": "Identity Protection PIN, enter it here", + "source": "D(2,6.4414,7.1285,8.0019,7.1253,8.002,7.2416,6.4414,7.2448)", + "span": { + "offset": 10065, + "length": 38 + } + }, + { + "content": "(see inst.)", + "source": "D(2,6.4414,7.2725,6.8647,7.2725,6.8647,7.3799,6.4414,7.3799)", + "span": { + "offset": 10104, + "length": 11 + } + }, + { + "content": "574890", + "source": "D(2,6.9968,7.2488,8.002,7.2445,8.002,7.4182,6.9976,7.4225)", + "span": { + "offset": 10116, + "length": 6 + } + }, + { + "content": "Phone no.", + "source": "D(2,1.3865,7.4489,1.8448,7.4454,1.8457,7.5555,1.3873,7.559)", + "span": { + "offset": 10124, + "length": 9 + } + }, + { + "content": "00141386308", + "source": "D(2,2.4736,7.4415,3.1667,7.4415,3.1667,7.5587,2.4736,7.5587)", + "span": { + "offset": 10134, + "length": 11 + } + }, + { + "content": "Email address mirachael123@gmail.com.us", + "source": "D(2,3.845,7.4432,6.0471,7.4372,6.0474,7.5573,3.8453,7.5632)", + "span": { + "offset": 10147, + "length": 39 + } + }, + { + "content": "Paid", + "source": "D(2,0.4928,7.667,0.8279,7.662,0.83,7.8074,0.4949,7.8123)", + "span": { + "offset": 10191, + "length": 4 + } + }, + { + "content": "Preparer", + "source": "D(2,0.4936,7.8525,1.1445,7.8525,1.1445,8.0034,0.4936,8.0034)", + "span": { + "offset": 10196, + "length": 8 + } + }, + { + "content": "Use Only", + "source": "D(2,0.4958,8.0147,1.16,8.0182,1.1592,8.1766,0.4949,8.1732)", + "span": { + "offset": 10205, + "length": 8 + } + }, + { + "content": "Preparer's name", + "source": "D(2,1.3893,7.6044,2.125,7.6103,2.1241,7.7267,1.389,7.7208)", + "span": { + "offset": 10215, + "length": 15 + } + }, + { + "content": "Mark Collins", + "source": "D(2,1.2887,7.7579,1.9645,7.7595,1.9642,7.8813,1.2884,7.8797)", + "span": { + "offset": 10231, + "length": 12 + } + }, + { + "content": "Preparer's signature", + "source": "D(2,3.0464,7.6088,3.9391,7.6115,3.9387,7.733,3.046,7.7303)", + "span": { + "offset": 10245, + "length": 20 + } + }, + { + "content": "mark collins", + "source": "D(2,4.1836,7.7183,4.9556,7.7183,4.9556,7.9039,4.1836,7.9039)", + "span": { + "offset": 10266, + "length": 12 + } + }, + { + "content": "Date", + "source": "D(2,5.4453,7.6153,5.6611,7.6186,5.6611,7.7168,5.4453,7.7135)", + "span": { + "offset": 10280, + "length": 4 + } + }, + { + "content": "10/20/1990", + "source": "D(2,5.4661,7.729,6.0762,7.729,6.0762,7.8472,5.4661,7.8472)", + "span": { + "offset": 10285, + "length": 10 + } + }, + { + "content": "PTIN", + "source": "D(2,6.2754,7.6055,6.4954,7.6055,6.4954,7.7021,6.2754,7.7021)", + "span": { + "offset": 10297, + "length": 4 + } + }, + { + "content": "09870", + "source": "D(2,6.4374,7.7532,6.7543,7.7572,6.7527,7.8838,6.4359,7.8798)", + "span": { + "offset": 10302, + "length": 5 + } + }, + { + "content": "Check if:", + "source": "D(2,7.0416,7.6161,7.4375,7.6095,7.4375,7.714,7.0434,7.7172)", + "span": { + "offset": 10309, + "length": 9 + } + }, + { + "content": "☐", + "source": "D(2,7.093,7.7612,7.2175,7.7559,7.2175,7.8794,7.093,7.8794)", + "span": { + "offset": 10320, + "length": 1 + } + }, + { + "content": "Self-employed", + "source": "D(2,7.2425,7.767,7.8857,7.7717,7.8857,7.8846,7.2414,7.8781)", + "span": { + "offset": 10322, + "length": 13 + } + }, + { + "content": "Firm's name", + "source": "D(2,1.3894,7.9638,1.9424,7.9684,1.9424,8.0726,1.389,8.068)", + "span": { + "offset": 10337, + "length": 11 + } + }, + { + "content": "STATE company", + "source": "D(2,2.1208,7.9487,3.0153,7.9487,3.0153,8.0791,2.1208,8.0791)", + "span": { + "offset": 10349, + "length": 13 + } + }, + { + "content": "Phone no.", + "source": "D(2,6.4414,7.9635,6.9024,7.9647,6.9021,8.0728,6.4414,8.0716)", + "span": { + "offset": 10364, + "length": 9 + } + }, + { + "content": "8760765000876", + "source": "D(2,7.0468,7.932,7.8691,7.9283,7.8691,8.0574,7.0474,8.061)", + "span": { + "offset": 10374, + "length": 13 + } + }, + { + "content": "Firm's address", + "source": "D(2,1.3875,8.1158,2.0531,8.1253,2.0524,8.2379,1.3857,8.2276)", + "span": { + "offset": 10389, + "length": 14 + } + }, + { + "content": "2025 E 76TH LOS ANGELES CA 90001-2712 USA", + "source": "D(2,2.2265,8.1126,4.8145,8.1088,4.8145,8.2323,2.2267,8.2361)", + "span": { + "offset": 10404, + "length": 41 + } + }, + { + "content": "Firm's EIN", + "source": "D(2,6.4373,8.121,6.9062,8.121,6.9062,8.2286,6.4373,8.2286)", + "span": { + "offset": 10447, + "length": 10 + } + }, + { + "content": "080686", + "source": "D(2,7.3254,8.1211,7.7114,8.1211,7.7114,8.2285,7.3254,8.2285)", + "span": { + "offset": 10458, + "length": 6 + } + }, + { + "content": "Go to www.irs.gov/Form1040 for instructions and the latest information.", + "source": "D(2,0.4882,8.2987,3.6171,8.2963,3.6172,8.4146,0.4883,8.4171)", + "span": { + "offset": 10483, + "length": 71 + } + }, + { + "content": "Form 1040 (2020)", + "source": "D(2,7.2175,8.2983,8.0061,8.2983,8.0061,8.4165,7.2175,8.4165)", + "span": { + "offset": 10577, + "length": 16 + } + } + ] + } + ], + "paragraphs": [ + { + "role": "pageHeader", + "content": "Form 1040", + "source": "D(1,0.4981,0.5019,1.2576,0.5018,1.2576,0.7791,0.4981,0.7792)", + "span": { + "offset": 0, + "length": 31 + } + }, + { + "role": "pageHeader", + "content": "Department of the Treasury-Internal Revenue Service (99) U.S. Individual Income Tax Return", + "source": "D(1,1.3427,0.5121,3.9098,0.516,3.9093,0.8005,1.3422,0.7966)", + "span": { + "offset": 32, + "length": 112 + } + }, + { + "role": "pageHeader", + "content": "2020", + "source": "D(1,4.1296,0.5311,4.8685,0.5315,4.8684,0.7729,4.1295,0.7726)", + "span": { + "offset": 145, + "length": 26 + } + }, + { + "role": "pageHeader", + "content": "OMB No. 1545-0074", + "source": "D(1,4.939,0.6876,5.8521,0.6878,5.8521,0.7883,4.9389,0.7881)", + "span": { + "offset": 172, + "length": 39 + } + }, + { + "role": "pageHeader", + "content": "IRS Use Only-Do not write or staple in this space.", + "source": "D(1,5.9849,0.6983,7.8901,0.7027,7.8899,0.807,5.9846,0.8026)", + "span": { + "offset": 212, + "length": 72 + } + }, + { + "content": "Filing Status Check only one box.", + "source": "D(1,0.4914,0.9131,1.2516,0.9148,1.2508,1.3037,0.4906,1.302)", + "span": { + "offset": 286, + "length": 33 + } + }, + { + "content": "☐ Single ☑ Married filing jointly ☐ Married filing separately (MFS) ☐ Head of household (HOH) ☐ Qualifying widow(er) (QW)", + "source": "D(1,1.3209,0.9339,7.9771,0.9337,7.9771,1.0693,1.3209,1.0695)", + "span": { + "offset": 321, + "length": 121 + } + }, + { + "content": "If you checked the MFS box, enter the name of your spouse. If you checked the HOH or QW box, enter the child's name if the qualifying person is a child but not your dependent", + "source": "D(1,1.3146,1.1128,7.9854,1.1128,7.9854,1.3837,1.3146,1.3837)", + "span": { + "offset": 444, + "length": 174 + } + }, + { + "content": "Your first name and middle initial Anthony", + "source": "D(1,0.5183,1.4434,1.9849,1.4434,1.9849,1.7247,0.5183,1.7247)", + "span": { + "offset": 620, + "length": 42 + } + }, + { + "content": "Last name Kelly", + "source": "D(1,3.3376,1.4492,3.8105,1.4512,3.8093,1.725,3.3364,1.7229)", + "span": { + "offset": 664, + "length": 15 + } + }, + { + "content": "Your social security number 980 9 7 0 2 0 0", + "source": "D(1,6.545,1.443,7.9648,1.4439,7.9646,1.7272,6.5449,1.7264)", + "span": { + "offset": 681, + "length": 43 + } + }, + { + "content": "If joint return, spouse's first name and middle initial Lauren", + "source": "D(1,0.5196,1.7792,2.7746,1.7715,2.7755,2.0348,0.5205,2.0424)", + "span": { + "offset": 726, + "length": 62 + } + }, + { + "content": "Last name Watson", + "source": "D(1,3.3277,1.7796,3.8108,1.7833,3.8088,2.0436,3.3257,2.0399)", + "span": { + "offset": 790, + "length": 16 + } + }, + { + "content": "Spouse's social security number 0 5 6 0 4 1 0 8 5", + "source": "D(1,6.5327,1.7743,8.0061,1.7743,8.0061,2.0584,6.5327,2.0584)", + "span": { + "offset": 808, + "length": 49 + } + }, + { + "content": "Home address (number and street). If you have a P.O. box, see instructions. 10221 COMPTON LOS ANGELES CA 90002-2805 USA", + "source": "D(1,0.5272,2.107,3.8516,2.1052,3.8517,2.3727,0.5274,2.3746)", + "span": { + "offset": 859, + "length": 119 + } + }, + { + "content": "Apt. no. 10221", + "source": "D(1,5.8396,2.1123,6.2991,2.1177,6.2961,2.3746,5.8366,2.3692)", + "span": { + "offset": 980, + "length": 14 + } + }, + { + "content": "City, town, or post office. If you have a foreign address, also complete spaces below. 615 E 80TH LOS ANGELES CA 90001-3255 USA", + "source": "D(1,0.5193,2.4481,4.2541,2.4481,4.2541,2.7134,0.5193,2.7134)", + "span": { + "offset": 996, + "length": 127 + } + }, + { + "content": "State LA", + "source": "D(1,4.703,2.5259,4.7863,2.3612,5.2748,2.6086,5.1915,2.7733)", + "span": { + "offset": 1125, + "length": 8 + } + }, + { + "content": "ZIP code 61500", + "source": "D(1,5.6362,2.4473,6.2032,2.4529,6.2007,2.7106,5.6337,2.705)", + "span": { + "offset": 1135, + "length": 14 + } + }, + { + "content": "Foreign country name N/A", + "source": "D(1,0.5178,2.7798,1.5118,2.7798,1.5118,3.0402,0.5178,3.0402)", + "span": { + "offset": 1151, + "length": 24 + } + }, + { + "content": "Foreign province/state/county N/A", + "source": "D(1,3.6357,2.7766,4.9639,2.7765,4.9639,3.0402,3.6357,3.0403)", + "span": { + "offset": 1177, + "length": 33 + } + }, + { + "content": "Foreign postal code N/A", + "source": "D(1,5.6444,2.7812,6.458,2.78,6.4584,3.0374,5.6447,3.0386)", + "span": { + "offset": 1212, + "length": 23 + } + }, + { + "content": "Presidential Election Campaign Check here if you, or your spouse if filing jointly, want $3 to go to this fund. Checking a box below will not change your tax or refund.", + "source": "D(1,6.5333,2.1132,8.007,2.1245,8.0012,2.891,6.5274,2.8797)", + "span": { + "offset": 1237, + "length": 168 + } + }, + { + "content": "☐ You ☐ Spouse", + "source": "D(1,6.9851,2.9165,7.9939,2.9165,7.9939,3.0454,6.9851,3.0454)", + "span": { + "offset": 1407, + "length": 14 + } + }, + { + "content": "At any time during 2020, did you receive, sell, send, exchange, or otherwise acquire any financial interest in any virtual currency?", + "source": "D(1,0.4936,3.1441,6.8773,3.148,6.8772,3.2784,0.4936,3.2745)", + "span": { + "offset": 1423, + "length": 132 + } + }, + { + "content": "☐ Yes ☑ No", + "source": "D(1,6.9976,3.1394,7.7997,3.1464,7.7986,3.2763,6.9964,3.2693)", + "span": { + "offset": 1557, + "length": 10 + } + }, + { + "content": "Standard Deduction", + "source": "D(1,0.4921,3.373,1.1849,3.373,1.1849,3.6389,0.4921,3.6389)", + "span": { + "offset": 1569, + "length": 18 + } + }, + { + "content": "Someone can claim:", + "source": "D(1,1.2887,3.3596,2.3787,3.365,2.3781,3.4833,1.2881,3.4779)", + "span": { + "offset": 1589, + "length": 18 + } + }, + { + "content": "☐ You as a dependent ☐ Your spouse as a dependent ☐ Spouse itemizes on a separate return or you were a dual-status alien", + "source": "D(1,1.3209,3.3569,5.5366,3.3569,5.5366,3.6519,1.3209,3.6519)", + "span": { + "offset": 1609, + "length": 120 + } + }, + { + "content": "Age/Blindness", + "source": "D(1,0.4895,3.7766,1.2454,3.7784,1.2451,3.9041,0.4892,3.9024)", + "span": { + "offset": 1731, + "length": 13 + } + }, + { + "content": "You:", + "source": "D(1,1.2949,3.7792,1.5448,3.7811,1.5439,3.8893,1.2941,3.8873)", + "span": { + "offset": 1746, + "length": 4 + } + }, + { + "content": "☑ Were born before January 2, 1956 ☐ Are blind", + "source": "D(1,1.6135,3.7535,4.2467,3.7712,4.2457,3.9164,1.6125,3.8987)", + "span": { + "offset": 1752, + "length": 46 + } + }, + { + "content": "Spouse:", + "source": "D(1,4.4866,3.7786,4.9348,3.7786,4.9348,3.8967,4.4866,3.8967)", + "span": { + "offset": 1800, + "length": 7 + } + }, + { + "content": "☐ Was born before January 2, 1956 ☑ Is blind", + "source": "D(1,5.0178,3.7625,7.5538,3.7637,7.5537,3.9007,5.0178,3.8994)", + "span": { + "offset": 1809, + "length": 44 + } + }, + { + "content": "Dependents If more than four dependents, see instructions and check here ☐", + "source": "D(1,0.4425,3.9141,1.2881,3.9123,1.2883,4.9141,0.4396,4.9134)", + "span": { + "offset": 1885, + "length": 74 + } + }, + { + "content": "(see instructions):", + "source": "D(1,1.2881,3.9123,3.7072,3.9134,3.7072,4.0888,1.2887,4.0907)", + "span": { + "offset": 1981, + "length": 19 + } + }, + { + "content": "(2) Social security number", + "source": "D(1,3.7072,3.9134,4.9013,3.9141,4.9018,4.2538,3.707,4.2537)", + "span": { + "offset": 2034, + "length": 26 + } + }, + { + "content": "(3) Relationship to you", + "source": "D(1,4.9013,3.9141,5.8007,3.9147,5.8015,4.2531,4.9018,4.2538)", + "span": { + "offset": 2082, + "length": 23 + } + }, + { + "content": "(4) ✓ if qualifies for (see instructions):", + "source": "D(1,5.8007,3.9147,7.9913,3.9164,7.991,4.0888,5.8011,4.0888)", + "span": { + "offset": 2127, + "length": 42 + } + }, + { + "content": "(1) First name", + "source": "D(1,1.2887,4.0907,2.2868,4.0899,2.2863,4.2544,1.2882,4.2541)", + "span": { + "offset": 2190, + "length": 14 + } + }, + { + "content": "Last name", + "source": "D(1,2.2868,4.0899,3.7072,4.0888,3.707,4.2537,2.2863,4.2544)", + "span": { + "offset": 2214, + "length": 9 + } + }, + { + "content": "Child tax credit", + "source": "D(1,5.8011,4.0888,6.9006,4.0885,6.9012,4.253,5.8015,4.2531)", + "span": { + "offset": 2233, + "length": 16 + } + }, + { + "content": "Credit for other dependents", + "source": "D(1,6.9006,4.0885,7.991,4.0888,7.991,4.2527,6.9012,4.253)", + "span": { + "offset": 2259, + "length": 27 + } + }, + { + "content": "Evelyn", + "source": "D(1,1.2882,4.2541,2.2863,4.2544,2.2857,4.4192,1.2882,4.4191)", + "span": { + "offset": 2307, + "length": 6 + } + }, + { + "content": "Collins", + "source": "D(1,2.2863,4.2544,3.707,4.2537,3.7075,4.4187,2.2857,4.4192)", + "span": { + "offset": 2323, + "length": 7 + } + }, + { + "content": "005", + "source": "D(1,3.707,4.2537,4.0705,4.2542,4.0711,4.4188,3.7075,4.4187)", + "span": { + "offset": 2340, + "length": 3 + } + }, + { + "content": "78", + "source": "D(1,4.0705,4.2542,4.3274,4.2538,4.3275,4.4186,4.0711,4.4188)", + "span": { + "offset": 2353, + "length": 2 + } + }, + { + "content": "5758", + "source": "D(1,4.3274,4.2538,4.9018,4.2538,4.9016,4.4186,4.3275,4.4186)", + "span": { + "offset": 2365, + "length": 4 + } + }, + { + "content": "friend", + "source": "D(1,4.9018,4.2538,5.8015,4.2531,5.8013,4.4187,4.9016,4.4186)", + "span": { + "offset": 2379, + "length": 6 + } + }, + { + "content": "☐", + "source": "D(1,5.8015,4.2531,6.9012,4.253,6.9012,4.4188,5.8013,4.4187)", + "span": { + "offset": 2395, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.9012,4.253,7.991,4.2527,7.9909,4.4191,6.9012,4.4188)", + "span": { + "offset": 2406, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,5.8013,4.4187,6.9012,4.4188,6.9008,4.5805,5.801,4.5804)", + "span": { + "offset": 2488, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.9012,4.4188,7.9909,4.4191,7.9907,4.5808,6.9008,4.5805)", + "span": { + "offset": 2499, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,5.801,4.5804,6.9008,4.5805,6.9007,4.7528,5.8008,4.7532)", + "span": { + "offset": 2581, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.9008,4.5805,7.9907,4.5808,7.9907,4.7528,6.9007,4.7528)", + "span": { + "offset": 2592, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,5.8008,4.7532,6.9007,4.7528,6.9016,4.9139,5.8016,4.9141)", + "span": { + "offset": 2674, + "length": 1 + } + }, + { + "content": "☐", + "source": "D(1,6.9007,4.7528,7.9907,4.7528,7.991,4.9142,6.9016,4.9139)", + "span": { + "offset": 2685, + "length": 1 + } + }, + { + "content": "Attach Sch. B if required.", + "source": "D(1,0.4053,4.9155,1.2047,4.9151,1.2035,5.7491,0.4041,5.75)", + "span": { + "offset": 2738, + "length": 26 + } + }, + { + "content": "1 Wages, salaries, tips, etc. Attach Form(s) W-2", + "source": "D(1,1.2047,4.9151,6.6874,4.9146,6.6872,5.0812,1.2048,5.0816)", + "span": { + "offset": 2786, + "length": 48 + } + }, + { + "content": "1", + "source": "D(1,6.6874,4.9146,6.9932,4.9143,6.9931,5.0813,6.6872,5.0812)", + "span": { + "offset": 2844, + "length": 1 + } + }, + { + "content": "2501", + "source": "D(1,6.9932,4.9143,8.0071,4.9148,8.0071,5.0812,6.9931,5.0813)", + "span": { + "offset": 2855, + "length": 4 + } + }, + { + "content": "2a Tax-exempt interest . .", + "source": "D(1,1.2048,5.0816,3.2007,5.0807,3.2,5.2553,1.2043,5.2556)", + "span": { + "offset": 2880, + "length": 26 + } + }, + { + "content": "2a", + "source": "D(1,3.2007,5.0807,3.4854,5.0807,3.4847,5.2545,3.2,5.2553)", + "span": { + "offset": 2916, + "length": 2 + } + }, + { + "content": "2010", + "source": "D(1,3.4854,5.0807,4.5183,5.081,4.5178,5.2547,3.4847,5.2545)", + "span": { + "offset": 2928, + "length": 4 + } + }, + { + "content": "b Taxable interest", + "source": "D(1,4.5183,5.081,6.6872,5.0812,6.6868,5.2554,4.5178,5.2547)", + "span": { + "offset": 2954, + "length": 18 + } + }, + { + "content": "2b", + "source": "D(1,6.6872,5.0812,6.9931,5.0813,6.9924,5.2552,6.6868,5.2554)", + "span": { + "offset": 2982, + "length": 2 + } + }, + { + "content": "5202", + "source": "D(1,6.9931,5.0813,8.0071,5.0812,8.0072,5.2556,6.9924,5.2552)", + "span": { + "offset": 2994, + "length": 4 + } + }, + { + "content": "3a Qualified dividends . . .", + "source": "D(1,1.2043,5.2556,3.2,5.2553,3.1999,5.42,1.2037,5.4205)", + "span": { + "offset": 3019, + "length": 28 + } + }, + { + "content": "3a", + "source": "D(1,3.2,5.2553,3.4847,5.2545,3.4843,5.4197,3.1999,5.42)", + "span": { + "offset": 3057, + "length": 2 + } + }, + { + "content": "1007", + "source": "D(1,3.4847,5.2545,4.5178,5.2547,4.5173,5.4195,3.4843,5.4197)", + "span": { + "offset": 3069, + "length": 4 + } + }, + { + "content": "b Ordinary dividends", + "source": "D(1,4.5178,5.2547,6.6868,5.2554,6.6861,5.4195,4.5173,5.4195)", + "span": { + "offset": 3095, + "length": 20 + } + }, + { + "content": "3b", + "source": "D(1,6.6868,5.2554,6.9924,5.2552,6.9922,5.4196,6.6861,5.4195)", + "span": { + "offset": 3125, + "length": 2 + } + }, + { + "content": "3405", + "source": "D(1,6.9924,5.2552,8.0072,5.2556,8.0071,5.4196,6.9922,5.4196)", + "span": { + "offset": 3137, + "length": 4 + } + }, + { + "content": "4a IRA distributions", + "source": "D(1,1.2037,5.4205,3.1999,5.42,3.1998,5.5825,1.2035,5.583)", + "span": { + "offset": 3162, + "length": 20 + } + }, + { + "content": "4a", + "source": "D(1,3.1999,5.42,3.4843,5.4197,3.4843,5.5821,3.1998,5.5825)", + "span": { + "offset": 3192, + "length": 2 + } + }, + { + "content": "3524", + "source": "D(1,3.4843,5.4197,4.5173,5.4195,4.5172,5.5821,3.4843,5.5821)", + "span": { + "offset": 3204, + "length": 4 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.5173,5.4195,6.6861,5.4195,6.6862,5.582,4.5172,5.5821)", + "span": { + "offset": 3230, + "length": 16 + } + }, + { + "content": "4b", + "source": "D(1,6.6861,5.4195,6.9922,5.4196,6.9923,5.5821,6.6862,5.582)", + "span": { + "offset": 3256, + "length": 2 + } + }, + { + "content": "4508", + "source": "D(1,6.9922,5.4196,8.0071,5.4196,8.0072,5.5822,6.9923,5.5821)", + "span": { + "offset": 3268, + "length": 4 + } + }, + { + "content": "5a Pensions and annuities . .", + "source": "D(1,1.2035,5.583,3.1998,5.5825,3.2002,5.7482,1.2035,5.7491)", + "span": { + "offset": 3293, + "length": 29 + } + }, + { + "content": "5a", + "source": "D(1,3.1998,5.5825,3.4843,5.5821,3.4843,5.748,3.2002,5.7482)", + "span": { + "offset": 3332, + "length": 2 + } + }, + { + "content": "2535", + "source": "D(1,3.4843,5.5821,4.5172,5.5821,4.5179,5.748,3.4843,5.748)", + "span": { + "offset": 3344, + "length": 4 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.5172,5.5821,6.6862,5.582,6.6856,5.7485,4.5179,5.748)", + "span": { + "offset": 3370, + "length": 16 + } + }, + { + "content": "5b", + "source": "D(1,6.6862,5.582,6.9923,5.5821,6.9923,5.7486,6.6856,5.7485)", + "span": { + "offset": 3396, + "length": 2 + } + }, + { + "content": "1008", + "source": "D(1,6.9923,5.5821,8.0072,5.5822,8.0072,5.7491,6.9923,5.7486)", + "span": { + "offset": 3408, + "length": 4 + } + }, + { + "content": "Standard Deduction for- . Single or Married filing separately, $12,400 . Married filing jointly or Qualifying widow(er), $24,800 . Head of household, $18,650 . If you checked any box under Standard Deduction, see instructions.", + "source": "D(1,0.4041,5.75,1.2035,5.7491,1.2052,7.9113,0.4016,7.9114)", + "span": { + "offset": 3446, + "length": 226 + } + }, + { + "content": "6a Social security benefits .", + "source": "D(1,1.2035,5.7491,3.2002,5.7482,3.2004,5.9103,1.2037,5.9116)", + "span": { + "offset": 3682, + "length": 29 + } + }, + { + "content": "6a", + "source": "D(1,3.2002,5.7482,3.4843,5.748,3.4846,5.9105,3.2004,5.9103)", + "span": { + "offset": 3721, + "length": 2 + } + }, + { + "content": "5328", + "source": "D(1,3.4843,5.748,4.5179,5.748,4.5178,5.9101,3.4846,5.9105)", + "span": { + "offset": 3733, + "length": 4 + } + }, + { + "content": "b Taxable amount", + "source": "D(1,4.5179,5.748,6.6856,5.7485,6.6861,5.9106,4.5178,5.9101)", + "span": { + "offset": 3759, + "length": 16 + } + }, + { + "content": "6b", + "source": "D(1,6.6856,5.7485,6.9923,5.7486,6.9933,5.9108,6.6861,5.9106)", + "span": { + "offset": 3785, + "length": 2 + } + }, + { + "content": "2004", + "source": "D(1,6.9923,5.7486,8.0072,5.7491,8.0072,5.9114,6.9933,5.9108)", + "span": { + "offset": 3797, + "length": 4 + } + }, + { + "content": "7 Capital gain or (loss). Attach Schedule D if required. If not required, check here ☐", + "source": "D(1,1.2037,5.9116,6.6861,5.9106,6.686,6.0853,1.2035,6.0859)", + "span": { + "offset": 3834, + "length": 86 + } + }, + { + "content": "7", + "source": "D(1,6.6861,5.9106,6.9933,5.9108,6.9935,6.0853,6.686,6.0853)", + "span": { + "offset": 3930, + "length": 1 + } + }, + { + "content": "3006", + "source": "D(1,6.9933,5.9108,8.0072,5.9114,8.0072,6.0858,6.9935,6.0853)", + "span": { + "offset": 3941, + "length": 4 + } + }, + { + "content": "8 Other income from Schedule 1, line 9", + "source": "D(1,1.2035,6.0859,6.686,6.0853,6.6861,6.2474,1.2037,6.2482)", + "span": { + "offset": 3978, + "length": 38 + } + }, + { + "content": "8", + "source": "D(1,6.686,6.0853,6.9935,6.0853,6.9936,6.2477,6.6861,6.2474)", + "span": { + "offset": 4026, + "length": 1 + } + }, + { + "content": "4006", + "source": "D(1,6.9935,6.0853,8.0072,6.0858,8.0075,6.2481,6.9936,6.2477)", + "span": { + "offset": 4037, + "length": 4 + } + }, + { + "content": "9 Add lines 1, 2b, 3b, 4b, 5b, 6b, 7, and 8. This is your total income", + "source": "D(1,1.2037,6.2482,6.6861,6.2474,6.6846,6.4104,1.203,6.411)", + "span": { + "offset": 4074, + "length": 70 + } + }, + { + "content": "9", + "source": "D(1,6.6861,6.2474,6.9936,6.2477,6.9924,6.4099,6.6846,6.4104)", + "span": { + "offset": 4154, + "length": 1 + } + }, + { + "content": "46708", + "source": "D(1,6.9936,6.2477,8.0075,6.2481,8.0073,6.4105,6.9924,6.4099)", + "span": { + "offset": 4165, + "length": 5 + } + }, + { + "content": "10 Adjustments to income:", + "source": "D(1,1.203,6.411,6.6846,6.4104,6.6858,6.5746,1.2031,6.5788)", + "span": { + "offset": 4203, + "length": 25 + } + }, + { + "content": "6455", + "source": "D(1,6.9924,6.4099,8.0073,6.4105,8.0081,7.0781,6.994,7.0779)", + "span": { + "offset": 4272, + "length": 4 + } + }, + { + "content": "a From Schedule 1, line 22", + "source": "D(1,1.2031,6.5788,5.3993,6.5756,5.4002,6.7497,1.203,6.7509)", + "span": { + "offset": 4309, + "length": 26 + } + }, + { + "content": "10a", + "source": "D(1,5.3993,6.5756,5.6925,6.5755,5.6933,6.7498,5.4002,6.7497)", + "span": { + "offset": 4345, + "length": 3 + } + }, + { + "content": "6538", + "source": "D(1,5.6925,6.5755,6.6858,6.5746,6.6858,6.7498,5.6933,6.7498)", + "span": { + "offset": 4358, + "length": 4 + } + }, + { + "content": "b Charitable contributions if you take the standard deduction. See instructions", + "source": "D(1,1.203,6.7509,5.4002,6.7497,5.398,6.9176,1.203,6.9192)", + "span": { + "offset": 4395, + "length": 79 + } + }, + { + "content": "10b", + "source": "D(1,5.4002,6.7497,5.6933,6.7498,5.6918,6.9178,5.398,6.9176)", + "span": { + "offset": 4484, + "length": 3 + } + }, + { + "content": "6536", + "source": "D(1,5.6933,6.7498,6.6858,6.7498,6.6859,6.9181,5.6918,6.9178)", + "span": { + "offset": 4497, + "length": 4 + } + }, + { + "content": "c Add lines 10a and 10b. These are your total adjustments to income", + "source": "D(1,1.203,6.9192,6.6859,6.9181,6.6865,7.0779,1.2031,7.08)", + "span": { + "offset": 4534, + "length": 67 + } + }, + { + "content": "10c", + "source": "D(1,6.6859,6.9181,6.9929,6.9183,6.994,7.0779,6.6865,7.0779)", + "span": { + "offset": 4611, + "length": 3 + } + }, + { + "content": "11 Subtract line 10c from line 9. This is your adjusted gross income", + "source": "D(1,1.2031,7.08,6.6865,7.0779,6.6863,7.2508,1.2031,7.252)", + "span": { + "offset": 4647, + "length": 68 + } + }, + { + "content": "11", + "source": "D(1,6.6865,7.0779,6.994,7.0779,6.9938,7.2508,6.6863,7.2508)", + "span": { + "offset": 4725, + "length": 2 + } + }, + { + "content": "7658", + "source": "D(1,6.994,7.0779,8.0081,7.0781,8.0083,7.2509,6.9938,7.2508)", + "span": { + "offset": 4737, + "length": 4 + } + }, + { + "content": "12 Standard deduction or itemized deductions (from Schedule A)", + "source": "D(1,1.2031,7.252,6.6863,7.2508,6.686,7.4131,1.2031,7.4148)", + "span": { + "offset": 4774, + "length": 62 + } + }, + { + "content": "12", + "source": "D(1,6.6863,7.2508,6.9938,7.2508,6.9935,7.4131,6.686,7.4131)", + "span": { + "offset": 4846, + "length": 2 + } + }, + { + "content": "3427", + "source": "D(1,6.9938,7.2508,8.0083,7.2509,8.0082,7.4127,6.9935,7.4131)", + "span": { + "offset": 4858, + "length": 4 + } + }, + { + "content": "13 Qualified business income deduction. Attach Form 8995 or Form 8995-A", + "source": "D(1,1.2031,7.4148,6.686,7.4131,6.6864,7.5788,1.2033,7.5794)", + "span": { + "offset": 4895, + "length": 71 + } + }, + { + "content": "13", + "source": "D(1,6.686,7.4131,6.9935,7.4131,6.9938,7.579,6.6864,7.5788)", + "span": { + "offset": 4976, + "length": 2 + } + }, + { + "content": "8009", + "source": "D(1,6.9935,7.4131,8.0082,7.4127,8.0085,7.5792,6.9938,7.579)", + "span": { + "offset": 4988, + "length": 4 + } + }, + { + "content": "14 Add lines 12 and 13", + "source": "D(1,1.2033,7.5794,6.6864,7.5788,6.6864,7.7475,1.2033,7.7497)", + "span": { + "offset": 5025, + "length": 22 + } + }, + { + "content": "14", + "source": "D(1,6.6864,7.5788,6.9938,7.579,6.9937,7.7473,6.6864,7.7475)", + "span": { + "offset": 5057, + "length": 2 + } + }, + { + "content": "6008", + "source": "D(1,6.9938,7.579,8.0085,7.5792,8.0081,7.7471,6.9937,7.7473)", + "span": { + "offset": 5069, + "length": 4 + } + }, + { + "content": "15 Taxable income. Subtract line 14 from line 11. If zero or less, enter -0-", + "source": "D(1,1.2033,7.7497,6.6864,7.7475,6.6887,7.9105,1.2052,7.9113)", + "span": { + "offset": 5106, + "length": 76 + } + }, + { + "content": "15", + "source": "D(1,6.6864,7.7475,6.9937,7.7473,6.9959,7.9107,6.6887,7.9105)", + "span": { + "offset": 5192, + "length": 2 + } + }, + { + "content": "1055", + "source": "D(1,6.9937,7.7473,8.0081,7.7471,8.0077,7.9104,6.9959,7.9107)", + "span": { + "offset": 5204, + "length": 4 + } + }, + { + "role": "pageFooter", + "content": "For Disclosure, Privacy Act, and Paperwork Reduction Act Notice, see separate instructions.", + "source": "D(1,0.4879,7.964,4.7896,7.9659,4.7895,8.0846,0.4879,8.0827)", + "span": { + "offset": 5231, + "length": 113 + } + }, + { + "role": "pageFooter", + "content": "Cat. No. 11320B", + "source": "D(1,5.6777,7.9761,6.3086,7.9761,6.3086,8.0674,5.6777,8.0674)", + "span": { + "offset": 5345, + "length": 37 + } + }, + { + "role": "pageFooter", + "content": "Form 1040 (2020)", + "source": "D(1,7.2092,7.9576,8.0023,7.9601,8.0019,8.0802,7.2089,8.0777)", + "span": { + "offset": 5383, + "length": 38 + } + }, + { + "role": "pageNumber", + "content": "Page 2", + "source": "D(2,7.6601,0.3436,8.002,0.3396,8.0035,0.4727,7.6616,0.4767)", + "span": { + "offset": 5442, + "length": 28 + } + }, + { + "role": "pageHeader", + "content": "Form 1040 (2020)", + "source": "D(2,0.4885,0.3439,1.2669,0.348,1.2663,0.4636,0.4878,0.4595)", + "span": { + "offset": 5471, + "length": 38 + } + }, + { + "content": "16 Tax (see instructions). Check if any from Form(s): 1 ☑ 8814 2 ☐ 4972 3 ☐ . .", + "source": "D(2,1.2427,0.5024,6.696,0.502,6.6943,0.6658,1.2419,0.6673)", + "span": { + "offset": 5564, + "length": 79 + } + }, + { + "content": "16", + "source": "D(2,6.696,0.502,6.9954,0.5013,6.9943,0.6648,6.6943,0.6658)", + "span": { + "offset": 5653, + "length": 2 + } + }, + { + "content": "2350", + "source": "D(2,6.9954,0.5013,8.0027,0.5021,8.0021,0.6654,6.9943,0.6648)", + "span": { + "offset": 5665, + "length": 4 + } + }, + { + "content": "17 Amount from Schedule 2, line 3", + "source": "D(2,1.2419,0.6673,6.6943,0.6658,6.6942,0.8369,1.241,0.8393)", + "span": { + "offset": 5702, + "length": 33 + } + }, + { + "content": "17", + "source": "D(2,6.6943,0.6658,6.9943,0.6648,6.9941,0.8361,6.6942,0.8369)", + "span": { + "offset": 5745, + "length": 2 + } + }, + { + "content": "5437", + "source": "D(2,6.9943,0.6648,8.0021,0.6654,8.0026,0.8366,6.9941,0.8361)", + "span": { + "offset": 5757, + "length": 4 + } + }, + { + "content": "18 Add lines 16 and 17", + "source": "D(2,1.241,0.8393,6.6942,0.8369,6.6938,1.001,1.2405,1.0034)", + "span": { + "offset": 5794, + "length": 22 + } + }, + { + "content": "18", + "source": "D(2,6.6942,0.8369,6.9941,0.8361,6.994,1.0002,6.6938,1.001)", + "span": { + "offset": 5826, + "length": 2 + } + }, + { + "content": "1000", + "source": "D(2,6.9941,0.8361,8.0026,0.8366,8.0022,1.0002,6.994,1.0002)", + "span": { + "offset": 5838, + "length": 4 + } + }, + { + "content": "19 Child tax credit or credit for other dependents", + "source": "D(2,1.2405,1.0034,6.6938,1.001,6.6939,1.165,1.241,1.1675)", + "span": { + "offset": 5875, + "length": 50 + } + }, + { + "content": "19", + "source": "D(2,6.6938,1.001,6.994,1.0002,6.9939,1.1644,6.6939,1.165)", + "span": { + "offset": 5935, + "length": 2 + } + }, + { + "content": "753", + "source": "D(2,6.994,1.0002,8.0022,1.0002,8.0024,1.1641,6.9939,1.1644)", + "span": { + "offset": 5947, + "length": 3 + } + }, + { + "content": "20 Amount from Schedule 3, line 7", + "source": "D(2,1.241,1.1675,6.6939,1.165,6.6935,1.3351,1.2409,1.3369)", + "span": { + "offset": 5983, + "length": 33 + } + }, + { + "content": "20", + "source": "D(2,6.6939,1.165,6.9939,1.1644,6.9937,1.3346,6.6935,1.3351)", + "span": { + "offset": 6026, + "length": 2 + } + }, + { + "content": "5430", + "source": "D(2,6.9939,1.1644,8.0024,1.1641,8.0024,1.3345,6.9937,1.3346)", + "span": { + "offset": 6038, + "length": 4 + } + }, + { + "content": "21 Add lines 19 and 20", + "source": "D(2,1.2409,1.3369,6.6935,1.3351,6.6945,1.4972,1.2411,1.4984)", + "span": { + "offset": 6075, + "length": 22 + } + }, + { + "content": "21", + "source": "D(2,6.6935,1.3351,6.9937,1.3346,6.9943,1.497,6.6945,1.4972)", + "span": { + "offset": 6107, + "length": 2 + } + }, + { + "content": "15790", + "source": "D(2,6.9937,1.3346,8.0024,1.3345,8.0025,1.4972,6.9943,1.497)", + "span": { + "offset": 6119, + "length": 5 + } + }, + { + "content": "22 Subtract line 21 from line 18. If zero or less, enter -0-", + "source": "D(2,1.2411,1.4984,6.6945,1.4972,6.6946,1.6673,1.241,1.668)", + "span": { + "offset": 6157, + "length": 60 + } + }, + { + "content": "22", + "source": "D(2,6.6945,1.4972,6.9943,1.497,6.9945,1.6671,6.6946,1.6673)", + "span": { + "offset": 6227, + "length": 2 + } + }, + { + "content": "5436", + "source": "D(2,6.9943,1.497,8.0025,1.4972,8.0022,1.6674,6.9945,1.6671)", + "span": { + "offset": 6239, + "length": 4 + } + }, + { + "content": "23 Other taxes, including self-employment tax, from Schedule 2, line 10", + "source": "D(2,1.241,1.668,6.6946,1.6673,6.6949,1.833,1.2407,1.834)", + "span": { + "offset": 6276, + "length": 71 + } + }, + { + "content": "23", + "source": "D(2,6.6946,1.6673,6.9945,1.6671,6.9949,1.8328,6.6949,1.833)", + "span": { + "offset": 6357, + "length": 2 + } + }, + { + "content": "7650", + "source": "D(2,6.9945,1.6671,8.0022,1.6674,8.002,1.8335,6.9949,1.8328)", + "span": { + "offset": 6369, + "length": 4 + } + }, + { + "content": "24 Add lines 22 and 23. This is your total tax", + "source": "D(2,1.2407,1.834,6.6949,1.833,6.6931,1.9948,1.2402,1.9967)", + "span": { + "offset": 6406, + "length": 46 + } + }, + { + "content": "24", + "source": "D(2,6.6949,1.833,6.9949,1.8328,6.9942,1.9939,6.6931,1.9948)", + "span": { + "offset": 6462, + "length": 2 + } + }, + { + "content": "12780", + "source": "D(2,6.9949,1.8328,8.002,1.8335,8.0024,1.9948,6.9942,1.9939)", + "span": { + "offset": 6474, + "length": 5 + } + }, + { + "content": "25 Federal income tax withheld from:", + "source": "D(2,1.2402,1.9967,6.6931,1.9948,6.694,2.1542,1.24,2.1607)", + "span": { + "offset": 6512, + "length": 36 + } + }, + { + "content": "6220", + "source": "D(2,6.9942,1.9939,8.0024,1.9948,8.0027,2.8339,6.995,2.8345)", + "span": { + "offset": 6592, + "length": 4 + } + }, + { + "content": "a Form(s) W-2", + "source": "D(2,1.24,2.1607,5.3968,2.1559,5.3961,2.3326,1.2403,2.3338)", + "span": { + "offset": 6617, + "length": 13 + } + }, + { + "content": "25a", + "source": "D(2,5.3968,2.1559,5.6913,2.1559,5.6912,2.3326,5.3961,2.3326)", + "span": { + "offset": 6640, + "length": 3 + } + }, + { + "content": "4220", + "source": "D(2,5.6913,2.1559,6.694,2.1542,6.6947,2.3327,5.6912,2.3326)", + "span": { + "offset": 6653, + "length": 4 + } + }, + { + "content": "b Form(s) 1099", + "source": "D(2,1.2403,2.3338,5.3961,2.3326,5.3963,2.4987,1.2404,2.5)", + "span": { + "offset": 6678, + "length": 14 + } + }, + { + "content": "25b", + "source": "D(2,5.3961,2.3326,5.6912,2.3326,5.6912,2.4985,5.3963,2.4987)", + "span": { + "offset": 6702, + "length": 3 + } + }, + { + "content": "1000", + "source": "D(2,5.6912,2.3326,6.6947,2.3327,6.695,2.4986,5.6912,2.4985)", + "span": { + "offset": 6715, + "length": 4 + } + }, + { + "content": "c Other forms (see instructions)", + "source": "D(2,1.2404,2.5,5.3963,2.4987,5.396,2.6643,1.2404,2.6656)", + "span": { + "offset": 6740, + "length": 32 + } + }, + { + "content": "25c", + "source": "D(2,5.3963,2.4987,5.6912,2.4985,5.6914,2.6645,5.396,2.6643)", + "span": { + "offset": 6782, + "length": 3 + } + }, + { + "content": "2000", + "source": "D(2,5.6912,2.4985,6.695,2.4986,6.6942,2.6653,5.6914,2.6645)", + "span": { + "offset": 6795, + "length": 4 + } + }, + { + "content": "d Add lines 25a through 25c", + "source": "D(2,1.2404,2.6656,6.6942,2.6653,6.6943,2.8347,1.2401,2.8362)", + "span": { + "offset": 6832, + "length": 27 + } + }, + { + "content": "25d", + "source": "D(2,6.6942,2.6653,6.995,2.6646,6.995,2.8345,6.6943,2.8347)", + "span": { + "offset": 6869, + "length": 3 + } + }, + { + "content": ". If you have a qualifying child, attach Sch. EIC. . If you have nontaxable combat pay, see instructions.", + "source": "D(2,0.4165,2.8368,1.2401,2.8362,1.2401,4.1682,0.4156,4.1682)", + "span": { + "offset": 6905, + "length": 105 + } + }, + { + "content": "26 2020 estimated tax payments and amount applied from 2019 return", + "source": "D(2,1.2401,2.8362,6.6943,2.8347,6.694,2.9957,1.2401,2.9969)", + "span": { + "offset": 7032, + "length": 66 + } + }, + { + "content": "26", + "source": "D(2,6.6943,2.8347,6.995,2.8345,6.9943,2.9952,6.694,2.9957)", + "span": { + "offset": 7108, + "length": 2 + } + }, + { + "content": "5438", + "source": "D(2,6.995,2.8345,8.0027,2.8339,8.0026,2.9951,6.9943,2.9952)", + "span": { + "offset": 7120, + "length": 4 + } + }, + { + "content": "27 Earned income credit (EIC)", + "source": "D(2,1.2401,2.9969,5.3961,2.9951,5.3955,3.1603,1.2406,3.1619)", + "span": { + "offset": 7145, + "length": 29 + } + }, + { + "content": "27", + "source": "D(2,5.3961,2.9951,5.6911,2.9955,5.6906,3.1603,5.3955,3.1603)", + "span": { + "offset": 7184, + "length": 2 + } + }, + { + "content": "4359", + "source": "D(2,5.6911,2.9955,6.694,2.9957,6.695,3.1602,5.6906,3.1603)", + "span": { + "offset": 7196, + "length": 4 + } + }, + { + "content": "6534", + "source": "D(2,6.9943,2.9952,8.0026,2.9951,8.0026,4.0011,6.9948,4.0011)", + "span": { + "offset": 7232, + "length": 4 + } + }, + { + "content": "28 Additional child tax credit. Attach Schedule 8812", + "source": "D(2,1.2406,3.1619,5.3955,3.1603,5.3955,3.3302,1.2405,3.3318)", + "span": { + "offset": 7257, + "length": 52 + } + }, + { + "content": "28", + "source": "D(2,5.3955,3.1603,5.6906,3.1603,5.6906,3.3302,5.3955,3.3302)", + "span": { + "offset": 7319, + "length": 2 + } + }, + { + "content": "5326", + "source": "D(2,5.6906,3.1603,6.695,3.1602,6.6954,3.3302,5.6906,3.3302)", + "span": { + "offset": 7331, + "length": 4 + } + }, + { + "content": "29 American opportunity credit from Form 8863, line 8", + "source": "D(2,1.2405,3.3318,5.3955,3.3302,5.3952,3.4984,1.2399,3.4996)", + "span": { + "offset": 7378, + "length": 53 + } + }, + { + "content": "29", + "source": "D(2,5.3955,3.3302,5.6906,3.3302,5.6904,3.4982,5.3952,3.4984)", + "span": { + "offset": 7441, + "length": 2 + } + }, + { + "content": "6743", + "source": "D(2,5.6906,3.3302,6.6954,3.3302,6.6953,3.4984,5.6904,3.4982)", + "span": { + "offset": 7453, + "length": 4 + } + }, + { + "content": "30 Recovery rebate credit. See instructions", + "source": "D(2,1.2399,3.4996,5.3952,3.4984,5.3966,3.665,1.2402,3.6659)", + "span": { + "offset": 7478, + "length": 43 + } + }, + { + "content": "30", + "source": "D(2,5.3952,3.4984,5.6904,3.4982,5.6915,3.6648,5.3966,3.665)", + "span": { + "offset": 7531, + "length": 2 + } + }, + { + "content": "4562", + "source": "D(2,5.6904,3.4982,6.6953,3.4984,6.6952,3.6652,5.6915,3.6648)", + "span": { + "offset": 7543, + "length": 4 + } + }, + { + "content": "31 Amount from Schedule 3, line 13", + "source": "D(2,1.2402,3.6659,5.3966,3.665,5.3972,3.8314,1.2401,3.8342)", + "span": { + "offset": 7568, + "length": 34 + } + }, + { + "content": "31", + "source": "D(2,5.3966,3.665,5.6915,3.6648,5.6924,3.8316,5.3972,3.8314)", + "span": { + "offset": 7612, + "length": 2 + } + }, + { + "content": "2428", + "source": "D(2,5.6915,3.6648,6.6952,3.6652,6.6945,3.8317,5.6924,3.8316)", + "span": { + "offset": 7624, + "length": 4 + } + }, + { + "content": "32 Add lines 27 through 31. These are your total other payments and refundable credits", + "source": "D(2,1.2401,3.8342,6.6945,3.8317,6.6948,4.0015,1.24,4.0038)", + "span": { + "offset": 7661, + "length": 86 + } + }, + { + "content": "32", + "source": "D(2,6.6945,3.8317,6.9949,3.8309,6.9948,4.0011,6.6948,4.0015)", + "span": { + "offset": 7757, + "length": 2 + } + }, + { + "content": "33 Add lines 25d, 26, and 32. These are your total payments", + "source": "D(2,1.24,4.0038,6.6948,4.0015,6.6946,4.1652,1.2401,4.1682)", + "span": { + "offset": 7792, + "length": 59 + } + }, + { + "content": "33", + "source": "D(2,6.6948,4.0015,6.9948,4.0011,6.9948,4.1648,6.6946,4.1652)", + "span": { + "offset": 7861, + "length": 2 + } + }, + { + "content": "3657", + "source": "D(2,6.9948,4.0011,8.0026,4.0011,8.0029,4.1646,6.9948,4.1648)", + "span": { + "offset": 7873, + "length": 4 + } + }, + { + "content": "Refund Direct deposit? See instructions.", + "source": "D(2,0.4156,4.1682,1.2401,4.1682,1.2402,4.9942,0.4158,4.9943)", + "span": { + "offset": 7910, + "length": 40 + } + }, + { + "content": "34 If line 33 is more than line 24, subtract line 24 from line 33. This is the amount you overpaid . .", + "source": "D(2,1.2401,4.1682,6.6946,4.1652,6.6949,4.3308,1.2401,4.3328)", + "span": { + "offset": 7972, + "length": 102 + } + }, + { + "content": "34", + "source": "D(2,6.6946,4.1652,6.9948,4.1648,6.9949,4.3304,6.6949,4.3308)", + "span": { + "offset": 8084, + "length": 2 + } + }, + { + "content": "6338", + "source": "D(2,6.9948,4.1648,8.0029,4.1646,8.0029,4.3306,6.9949,4.3304)", + "span": { + "offset": 8096, + "length": 4 + } + }, + { + "content": "5a Amount of line 34 you want refunded to you. If Form 8888 is attached, check here\n35a\n☐ . . .", + "source": "D(2,1.2401,4.3328,6.6949,4.3308,6.6951,4.4973,1.2401,4.4998)", + "span": { + "offset": 8133, + "length": 95 + } + }, + { + "content": "35a", + "source": "D(2,6.6949,4.3308,6.9949,4.3304,6.9953,4.497,6.6951,4.4973)", + "span": { + "offset": 8238, + "length": 3 + } + }, + { + "content": "6335", + "source": "D(2,6.9949,4.3304,8.0029,4.3306,8.0025,4.4972,6.9953,4.497)", + "span": { + "offset": 8251, + "length": 4 + } + }, + { + "content": "b Routing number 052088863 ▶ c Type: ☐ Checking ☑ Savings", + "source": "D(2,1.2401,4.4998,6.6951,4.4973,6.6947,4.6607,1.2401,4.6629)", + "span": { + "offset": 8288, + "length": 57 + } + }, + { + "content": "▶d Account number 5206340044401004", + "source": "D(2,1.2401,4.6629,6.6947,4.6607,6.6947,4.8251,1.2403,4.8264)", + "span": { + "offset": 8422, + "length": 34 + } + }, + { + "content": "36 Amount of line 34 you want applied to your 2021 estimated tax", + "source": "D(2,1.2403,4.8264,5.397,4.8253,5.3971,4.994,1.2402,4.9942)", + "span": { + "offset": 8477, + "length": 64 + } + }, + { + "content": "36", + "source": "D(2,5.397,4.8253,5.6912,4.8257,5.6925,4.994,5.3971,4.994)", + "span": { + "offset": 8551, + "length": 2 + } + }, + { + "content": "45830", + "source": "D(2,5.6912,4.8257,6.6947,4.8251,6.695,4.9941,5.6925,4.994)", + "span": { + "offset": 8563, + "length": 5 + } + }, + { + "content": "Amount You Owe For details on how to pay, see instructions.", + "source": "D(2,0.4158,4.9943,1.2402,4.9942,1.2412,5.6684,0.4142,5.6683)", + "span": { + "offset": 8601, + "length": 59 + } + }, + { + "content": "37 Subtract line 33 from line 24. This is the amount you owe now . . . . . . . . .", + "source": "D(2,1.2402,4.9942,6.695,4.9941,6.695,5.178,1.2394,5.18)", + "span": { + "offset": 8682, + "length": 82 + } + }, + { + "content": "37", + "source": "D(2,6.695,4.9941,6.995,4.9941,6.9953,5.1778,6.695,5.178)", + "span": { + "offset": 8774, + "length": 2 + } + }, + { + "content": "6430", + "source": "D(2,6.995,4.9941,8.0027,4.9942,8.0029,5.1778,6.9953,5.1778)", + "span": { + "offset": 8786, + "length": 4 + } + }, + { + "content": "Note: Schedule H and Schedule SE filers, line 37 may not represent all of the taxes you owe for", + "source": "D(2,1.2394,5.18,6.695,5.178,6.6944,5.3458,1.2395,5.3474)", + "span": { + "offset": 8823, + "length": 95 + } + }, + { + "content": "2020. See Schedule 3, line 12e, and its instructions for details.", + "source": "D(2,1.2395,5.3474,6.6944,5.3458,6.6949,5.5026,1.2398,5.5037)", + "span": { + "offset": 8995, + "length": 65 + } + }, + { + "content": "38 Estimated tax penalty (see instructions)", + "source": "D(2,1.2398,5.5037,5.3957,5.5028,5.3963,5.6678,1.2412,5.6684)", + "span": { + "offset": 9081, + "length": 43 + } + }, + { + "content": "38", + "source": "D(2,5.3957,5.5028,5.6908,5.5027,5.6914,5.668,5.3963,5.6678)", + "span": { + "offset": 9134, + "length": 2 + } + }, + { + "content": "1250", + "source": "D(2,5.6908,5.5027,6.6949,5.5026,6.6963,5.6685,5.6914,5.668)", + "span": { + "offset": 9146, + "length": 4 + } + }, + { + "role": "sectionHeading", + "content": "Third Party Designee", + "source": "D(2,0.4934,5.7049,1.2078,5.7134,1.2043,6.0026,0.4899,5.9941)", + "span": { + "offset": 9173, + "length": 22 + } + }, + { + "content": "Do you want to allow another person to discuss this return with the IRS? See instructions", + "source": "D(2,1.387,5.7089,5.6072,5.7043,5.6074,5.9526,1.3873,5.9572)", + "span": { + "offset": 9197, + "length": 89 + } + }, + { + "content": "☐ Yes. Complete below. ☑ No", + "source": "D(2,5.6902,5.8384,7.396,5.8384,7.396,5.9619,5.6902,5.9619)", + "span": { + "offset": 9288, + "length": 27 + } + }, + { + "content": "Designee's name", + "source": "D(2,1.3869,6.0121,1.8849,6.0141,1.8839,6.2459,1.3859,6.2439)", + "span": { + "offset": 9317, + "length": 15 + } + }, + { + "content": "Phone no.", + "source": "D(2,4.1862,6.0134,4.4824,6.0134,4.4824,6.2425,4.1862,6.2425)", + "span": { + "offset": 9334, + "length": 9 + } + }, + { + "content": "Personal identification number (PIN)", + "source": "D(2,5.9849,6.0102,6.9644,6.0102,6.9644,6.2414,5.9849,6.2414)", + "span": { + "offset": 9345, + "length": 36 + } + }, + { + "role": "sectionHeading", + "content": "Sign Here", + "source": "D(2,0.4869,6.3054,0.8787,6.2999,0.8836,6.6465,0.4918,6.652)", + "span": { + "offset": 9384, + "length": 12 + } + }, + { + "content": "Under penalties of perjury, I declare that I have examined this return and accompanying schedules and statements, and to the best of my knowledge and belief, they are true, correct, and complete. Declaration of preparer (other than taxpayer) is based on all information of which preparer has any knowledge.", + "source": "D(2,1.3882,6.3058,8.0061,6.3031,8.0062,6.542,1.3883,6.5446)", + "span": { + "offset": 9398, + "length": 306 + } + }, + { + "content": "Your signature anthony kelly", + "source": "D(2,1.401,6.5226,3.2745,6.766,3.2317,7.0958,1.3582,6.8525)", + "span": { + "offset": 9706, + "length": 28 + } + }, + { + "content": "Date 12/10/1986", + "source": "D(2,3.8267,6.6046,4.4326,6.6046,4.4326,6.8965,3.8267,6.8965)", + "span": { + "offset": 9736, + "length": 15 + } + }, + { + "content": "Your occupation Judge", + "source": "D(2,4.5447,6.6031,5.2753,6.6039,5.2749,6.9409,4.5443,6.9401)", + "span": { + "offset": 9753, + "length": 21 + } + }, + { + "content": "If the IRS sent you an Identity Protection PIN, enter it here (see inst.) 654344", + "source": "D(2,6.4373,6.5933,7.9963,6.6019,7.9941,7.0044,6.435,6.9958)", + "span": { + "offset": 9776, + "length": 80 + } + }, + { + "content": "Joint return? See instructions. Keep a copy for your records.", + "source": "D(2,0.4838,6.8811,1.1732,6.8811,1.1732,7.3499,0.4838,7.3499)", + "span": { + "offset": 9858, + "length": 61 + } + }, + { + "content": "Spouse's signature. If a joint return, both must sign. laren waston", + "source": "D(2,1.3862,7.0254,3.6627,7.0254,3.6627,7.3814,1.3862,7.3814)", + "span": { + "offset": 9921, + "length": 67 + } + }, + { + "content": "Date 02/19/1978", + "source": "D(2,3.8246,7.0254,4.4451,7.0254,4.4451,7.3101,3.8246,7.3101)", + "span": { + "offset": 9990, + "length": 15 + } + }, + { + "content": "Spouse's occupation nurse", + "source": "D(2,4.5447,7.0259,5.4785,7.0259,5.4785,7.3371,4.5447,7.3371)", + "span": { + "offset": 10007, + "length": 25 + } + }, + { + "content": "If the IRS sent your spouse an Identity Protection PIN, enter it here (see inst.) 574890", + "source": "D(2,6.4414,7.0133,8.004,7.0212,8.0019,7.4276,6.4393,7.4197)", + "span": { + "offset": 10034, + "length": 88 + } + }, + { + "content": "Phone no. 00141386308", + "source": "D(2,1.3865,7.4417,3.1667,7.4414,3.1668,7.5587,1.3865,7.559)", + "span": { + "offset": 10124, + "length": 21 + } + }, + { + "content": "Email address mirachael123@gmail.com.us", + "source": "D(2,3.845,7.4432,6.0471,7.4372,6.0474,7.5573,3.8453,7.5632)", + "span": { + "offset": 10147, + "length": 39 + } + }, + { + "role": "sectionHeading", + "content": "Paid Preparer Use Only", + "source": "D(2,0.4928,7.6603,1.1619,7.6638,1.1592,8.1766,0.4902,8.1732)", + "span": { + "offset": 10189, + "length": 24 + } + }, + { + "content": "Preparer's name Mark Collins", + "source": "D(2,1.2891,7.6042,2.125,7.6062,2.1243,7.8817,1.2884,7.8797)", + "span": { + "offset": 10215, + "length": 28 + } + }, + { + "content": "Preparer's signature mark collins", + "source": "D(2,3.0558,7.5186,4.9748,7.7203,4.9472,7.9841,3.0282,7.7825)", + "span": { + "offset": 10245, + "length": 33 + } + }, + { + "content": "Date 10/20/1990", + "source": "D(2,5.4453,7.6153,6.0762,7.6153,6.0762,7.8472,5.4453,7.8472)", + "span": { + "offset": 10280, + "length": 15 + } + }, + { + "content": "PTIN 09870", + "source": "D(2,6.2754,7.6027,6.7562,7.6088,6.7527,7.8838,6.272,7.8777)", + "span": { + "offset": 10297, + "length": 10 + } + }, + { + "content": "Check if:", + "source": "D(2,7.0416,7.6161,7.4375,7.6095,7.4393,7.7139,7.0434,7.7206)", + "span": { + "offset": 10309, + "length": 9 + } + }, + { + "content": "☐ Self-employed", + "source": "D(2,7.0931,7.755,7.8865,7.7602,7.8857,7.8846,7.0922,7.8794)", + "span": { + "offset": 10320, + "length": 15 + } + }, + { + "content": "Firm's name STATE company", + "source": "D(2,1.389,7.9487,3.0153,7.9487,3.0153,8.0791,1.389,8.0791)", + "span": { + "offset": 10337, + "length": 25 + } + }, + { + "content": "Phone no. 8760765000876", + "source": "D(2,6.4393,7.9416,7.8689,7.9189,7.8711,8.0573,6.4415,8.0801)", + "span": { + "offset": 10364, + "length": 23 + } + }, + { + "content": "Firm's address 2025 E 76TH LOS ANGELES CA 90001-2712 USA", + "source": "D(2,1.3855,8.1143,4.8144,8.1074,4.8147,8.2323,1.3858,8.2392)", + "span": { + "offset": 10389, + "length": 56 + } + }, + { + "content": "Firm's EIN 080686", + "source": "D(2,6.4373,8.121,7.7114,8.121,7.7114,8.2286,6.4373,8.2286)", + "span": { + "offset": 10447, + "length": 17 + } + }, + { + "role": "pageFooter", + "content": "Go to www.irs.gov/Form1040 for instructions and the latest information.", + "source": "D(2,0.4882,8.2987,3.6171,8.2963,3.6172,8.4146,0.4883,8.4171)", + "span": { + "offset": 10466, + "length": 93 + } + }, + { + "role": "pageFooter", + "content": "Form 1040 (2020)", + "source": "D(2,7.2175,8.2983,8.0061,8.2983,8.0061,8.4165,7.2175,8.4165)", + "span": { + "offset": 10560, + "length": 38 + } + } + ], + "sections": [ + { + "span": { + "offset": 286, + "length": 10178 + }, + "elements": [ + "/sections/1", + "/sections/2", + "/sections/4" + ] + }, + { + "span": { + "offset": 286, + "length": 8884 + }, + "elements": [ + "/paragraphs/5", + "/paragraphs/6", + "/paragraphs/7", + "/paragraphs/8", + "/paragraphs/9", + "/paragraphs/10", + "/paragraphs/11", + "/paragraphs/12", + "/paragraphs/13", + "/paragraphs/14", + "/paragraphs/15", + "/paragraphs/16", + "/paragraphs/17", + "/paragraphs/18", + "/paragraphs/19", + "/paragraphs/20", + "/paragraphs/21", + "/paragraphs/22", + "/paragraphs/23", + "/paragraphs/24", + "/paragraphs/25", + "/paragraphs/26", + "/paragraphs/27", + "/paragraphs/28", + "/paragraphs/29", + "/paragraphs/30", + "/paragraphs/31", + "/paragraphs/32", + "/paragraphs/33", + "/tables/0", + "/tables/1", + "/tables/2" + ] + }, + { + "span": { + "offset": 9173, + "length": 1013 + }, + "elements": [ + "/paragraphs/217", + "/paragraphs/218", + "/paragraphs/219", + "/paragraphs/220", + "/paragraphs/221", + "/paragraphs/222", + "/sections/3" + ] + }, + { + "span": { + "offset": 9384, + "length": 802 + }, + "elements": [ + "/paragraphs/223", + "/paragraphs/224", + "/paragraphs/225", + "/paragraphs/226", + "/paragraphs/227", + "/paragraphs/228", + "/paragraphs/229", + "/paragraphs/230", + "/paragraphs/231", + "/paragraphs/232", + "/paragraphs/233", + "/paragraphs/234", + "/paragraphs/235" + ] + }, + { + "span": { + "offset": 10189, + "length": 275 + }, + "elements": [ + "/paragraphs/236", + "/paragraphs/237", + "/paragraphs/238", + "/paragraphs/239", + "/paragraphs/240", + "/paragraphs/241", + "/paragraphs/242", + "/paragraphs/243", + "/paragraphs/244", + "/paragraphs/245", + "/paragraphs/246" + ] + } + ], + "tables": [ + { + "rowCount": 6, + "columnCount": 9, + "cells": [ + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 0, + "rowSpan": 6, + "columnSpan": 1, + "content": "Dependents If more than four dependents, see instructions and check here ☐", + "source": "D(1,0.4425,3.9141,1.2881,3.9123,1.2883,4.9141,0.4396,4.9134)", + "span": { + "offset": 1885, + "length": 74 + }, + "elements": [ + "/paragraphs/34" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 2, + "content": "(see instructions):", + "source": "D(1,1.2881,3.9123,3.7072,3.9134,3.7072,4.0888,1.2887,4.0907)", + "span": { + "offset": 1981, + "length": 19 + }, + "elements": [ + "/paragraphs/35" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 3, + "rowSpan": 2, + "columnSpan": 3, + "content": "(2) Social security number", + "source": "D(1,3.7072,3.9134,4.9013,3.9141,4.9018,4.2538,3.707,4.2537)", + "span": { + "offset": 2034, + "length": 26 + }, + "elements": [ + "/paragraphs/36" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 6, + "rowSpan": 2, + "columnSpan": 1, + "content": "(3) Relationship to you", + "source": "D(1,4.9013,3.9141,5.8007,3.9147,5.8015,4.2531,4.9018,4.2538)", + "span": { + "offset": 2082, + "length": 23 + }, + "elements": [ + "/paragraphs/37" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 0, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 2, + "content": "(4) ✓ if qualifies for (see instructions):", + "source": "D(1,5.8007,3.9147,7.9913,3.9164,7.991,4.0888,5.8011,4.0888)", + "span": { + "offset": 2127, + "length": 42 + }, + "elements": [ + "/paragraphs/38" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 1, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "(1) First name", + "source": "D(1,1.2887,4.0907,2.2868,4.0899,2.2863,4.2544,1.2882,4.2541)", + "span": { + "offset": 2190, + "length": 14 + }, + "elements": [ + "/paragraphs/39" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 1, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "Last name", + "source": "D(1,2.2868,4.0899,3.7072,4.0888,3.707,4.2537,2.2863,4.2544)", + "span": { + "offset": 2214, + "length": 9 + }, + "elements": [ + "/paragraphs/40" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 1, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "Child tax credit", + "source": "D(1,5.8011,4.0888,6.9006,4.0885,6.9012,4.253,5.8015,4.2531)", + "span": { + "offset": 2233, + "length": 16 + }, + "elements": [ + "/paragraphs/41" + ] + }, + { + "kind": "columnHeader", + "rowIndex": 1, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "Credit for other dependents", + "source": "D(1,6.9006,4.0885,7.991,4.0888,7.991,4.2527,6.9012,4.253)", + "span": { + "offset": 2259, + "length": 27 + }, + "elements": [ + "/paragraphs/42" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "Evelyn", + "source": "D(1,1.2882,4.2541,2.2863,4.2544,2.2857,4.4192,1.2882,4.4191)", + "span": { + "offset": 2307, + "length": 6 + }, + "elements": [ + "/paragraphs/43" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "Collins", + "source": "D(1,2.2863,4.2544,3.707,4.2537,3.7075,4.4187,2.2857,4.4192)", + "span": { + "offset": 2323, + "length": 7 + }, + "elements": [ + "/paragraphs/44" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "005", + "source": "D(1,3.707,4.2537,4.0705,4.2542,4.0711,4.4188,3.7075,4.4187)", + "span": { + "offset": 2340, + "length": 3 + }, + "elements": [ + "/paragraphs/45" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "78", + "source": "D(1,4.0705,4.2542,4.3274,4.2538,4.3275,4.4186,4.0711,4.4188)", + "span": { + "offset": 2353, + "length": 2 + }, + "elements": [ + "/paragraphs/46" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "5758", + "source": "D(1,4.3274,4.2538,4.9018,4.2538,4.9016,4.4186,4.3275,4.4186)", + "span": { + "offset": 2365, + "length": 4 + }, + "elements": [ + "/paragraphs/47" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "friend", + "source": "D(1,4.9018,4.2538,5.8015,4.2531,5.8013,4.4187,4.9016,4.4186)", + "span": { + "offset": 2379, + "length": 6 + }, + "elements": [ + "/paragraphs/48" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,5.8015,4.2531,6.9012,4.253,6.9012,4.4188,5.8013,4.4187)", + "span": { + "offset": 2395, + "length": 1 + }, + "elements": [ + "/paragraphs/49" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,6.9012,4.253,7.991,4.2527,7.9909,4.4191,6.9012,4.4188)", + "span": { + "offset": 2406, + "length": 1 + }, + "elements": [ + "/paragraphs/50" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,1.2882,4.4191,2.2857,4.4192,2.2853,4.5806,1.288,4.581)", + "span": { + "offset": 2428, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,2.2857,4.4192,3.7075,4.4187,3.7073,4.5803,2.2853,4.5806)", + "span": { + "offset": 2438, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,3.7075,4.4187,4.0711,4.4188,4.071,4.5804,3.7073,4.5803)", + "span": { + "offset": 2448, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.0711,4.4188,4.3275,4.4186,4.3274,4.5801,4.071,4.5804)", + "span": { + "offset": 2458, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.3275,4.4186,4.9016,4.4186,4.9013,4.5804,4.3274,4.5801)", + "span": { + "offset": 2468, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.9016,4.4186,5.8013,4.4187,5.801,4.5804,4.9013,4.5804)", + "span": { + "offset": 2478, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,5.8013,4.4187,6.9012,4.4188,6.9008,4.5805,5.801,4.5804)", + "span": { + "offset": 2488, + "length": 1 + }, + "elements": [ + "/paragraphs/51" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,6.9012,4.4188,7.9909,4.4191,7.9907,4.5808,6.9008,4.5805)", + "span": { + "offset": 2499, + "length": 1 + }, + "elements": [ + "/paragraphs/52" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,1.288,4.581,2.2853,4.5806,2.2849,4.7548,1.2878,4.7554)", + "span": { + "offset": 2521, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,2.2853,4.5806,3.7073,4.5803,3.7072,4.7538,2.2849,4.7548)", + "span": { + "offset": 2531, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,3.7073,4.5803,4.071,4.5804,4.071,4.7538,3.7072,4.7538)", + "span": { + "offset": 2541, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.071,4.5804,4.3274,4.5801,4.3273,4.7535,4.071,4.7538)", + "span": { + "offset": 2551, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.3274,4.5801,4.9013,4.5804,4.901,4.7535,4.3273,4.7535)", + "span": { + "offset": 2561, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.9013,4.5804,5.801,4.5804,5.8008,4.7532,4.901,4.7535)", + "span": { + "offset": 2571, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,5.801,4.5804,6.9008,4.5805,6.9007,4.7528,5.8008,4.7532)", + "span": { + "offset": 2581, + "length": 1 + }, + "elements": [ + "/paragraphs/53" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,6.9008,4.5805,7.9907,4.5808,7.9907,4.7528,6.9007,4.7528)", + "span": { + "offset": 2592, + "length": 1 + }, + "elements": [ + "/paragraphs/54" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,1.2878,4.7554,2.2849,4.7548,2.2876,4.9135,1.2883,4.9141)", + "span": { + "offset": 2614, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,2.2849,4.7548,3.7072,4.7538,3.7072,4.9136,2.2876,4.9135)", + "span": { + "offset": 2624, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,3.7072,4.7538,4.071,4.7538,4.0713,4.9135,3.7072,4.9136)", + "span": { + "offset": 2634, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.071,4.7538,4.3273,4.7535,4.3278,4.9139,4.0713,4.9135)", + "span": { + "offset": 2644, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.3273,4.7535,4.901,4.7535,4.902,4.914,4.3278,4.9139)", + "span": { + "offset": 2654, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(1,4.901,4.7535,5.8008,4.7532,5.8016,4.9141,4.902,4.914)", + "span": { + "offset": 2664, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,5.8008,4.7532,6.9007,4.7528,6.9016,4.9139,5.8016,4.9141)", + "span": { + "offset": 2674, + "length": 1 + }, + "elements": [ + "/paragraphs/55" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "☐", + "source": "D(1,6.9007,4.7528,7.9907,4.7528,7.991,4.9142,6.9016,4.9139)", + "span": { + "offset": 2685, + "length": 1 + }, + "elements": [ + "/paragraphs/56" + ] + } + ], + "source": "D(1,0.4571,3.9451,8.002,3.9155,8.0061,4.8877,0.4584,4.8984)", + "span": { + "offset": 1856, + "length": 850 + } + }, + { + "rowCount": 18, + "columnCount": 9, + "cells": [ + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 0, + "rowSpan": 5, + "columnSpan": 1, + "content": "Attach Sch. B if required.", + "source": "D(1,0.4053,4.9155,1.2047,4.9151,1.2035,5.7491,0.4041,5.75)", + "span": { + "offset": 2738, + "length": 26 + }, + "elements": [ + "/paragraphs/57" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "1 Wages, salaries, tips, etc. Attach Form(s) W-2", + "source": "D(1,1.2047,4.9151,6.6874,4.9146,6.6872,5.0812,1.2048,5.0816)", + "span": { + "offset": 2786, + "length": 48 + }, + "elements": [ + "/paragraphs/58" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "1", + "source": "D(1,6.6874,4.9146,6.9932,4.9143,6.9931,5.0813,6.6872,5.0812)", + "span": { + "offset": 2844, + "length": 1 + }, + "elements": [ + "/paragraphs/59" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "2501", + "source": "D(1,6.9932,4.9143,8.0071,4.9148,8.0071,5.0812,6.9931,5.0813)", + "span": { + "offset": 2855, + "length": 4 + }, + "elements": [ + "/paragraphs/60" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "2a Tax-exempt interest . .", + "source": "D(1,1.2048,5.0816,3.2007,5.0807,3.2,5.2553,1.2043,5.2556)", + "span": { + "offset": 2880, + "length": 26 + }, + "elements": [ + "/paragraphs/61" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "2a", + "source": "D(1,3.2007,5.0807,3.4854,5.0807,3.4847,5.2545,3.2,5.2553)", + "span": { + "offset": 2916, + "length": 2 + }, + "elements": [ + "/paragraphs/62" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "2010", + "source": "D(1,3.4854,5.0807,4.5183,5.081,4.5178,5.2547,3.4847,5.2545)", + "span": { + "offset": 2928, + "length": 4 + }, + "elements": [ + "/paragraphs/63" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Taxable interest", + "source": "D(1,4.5183,5.081,6.6872,5.0812,6.6868,5.2554,4.5178,5.2547)", + "span": { + "offset": 2954, + "length": 18 + }, + "elements": [ + "/paragraphs/64" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "2b", + "source": "D(1,6.6872,5.0812,6.9931,5.0813,6.9924,5.2552,6.6868,5.2554)", + "span": { + "offset": 2982, + "length": 2 + }, + "elements": [ + "/paragraphs/65" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "5202", + "source": "D(1,6.9931,5.0813,8.0071,5.0812,8.0072,5.2556,6.9924,5.2552)", + "span": { + "offset": 2994, + "length": 4 + }, + "elements": [ + "/paragraphs/66" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "3a Qualified dividends . . .", + "source": "D(1,1.2043,5.2556,3.2,5.2553,3.1999,5.42,1.2037,5.4205)", + "span": { + "offset": 3019, + "length": 28 + }, + "elements": [ + "/paragraphs/67" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "3a", + "source": "D(1,3.2,5.2553,3.4847,5.2545,3.4843,5.4197,3.1999,5.42)", + "span": { + "offset": 3057, + "length": 2 + }, + "elements": [ + "/paragraphs/68" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "1007", + "source": "D(1,3.4847,5.2545,4.5178,5.2547,4.5173,5.4195,3.4843,5.4197)", + "span": { + "offset": 3069, + "length": 4 + }, + "elements": [ + "/paragraphs/69" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Ordinary dividends", + "source": "D(1,4.5178,5.2547,6.6868,5.2554,6.6861,5.4195,4.5173,5.4195)", + "span": { + "offset": 3095, + "length": 20 + }, + "elements": [ + "/paragraphs/70" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "3b", + "source": "D(1,6.6868,5.2554,6.9924,5.2552,6.9922,5.4196,6.6861,5.4195)", + "span": { + "offset": 3125, + "length": 2 + }, + "elements": [ + "/paragraphs/71" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "3405", + "source": "D(1,6.9924,5.2552,8.0072,5.2556,8.0071,5.4196,6.9922,5.4196)", + "span": { + "offset": 3137, + "length": 4 + }, + "elements": [ + "/paragraphs/72" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "4a IRA distributions", + "source": "D(1,1.2037,5.4205,3.1999,5.42,3.1998,5.5825,1.2035,5.583)", + "span": { + "offset": 3162, + "length": 20 + }, + "elements": [ + "/paragraphs/73" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "4a", + "source": "D(1,3.1999,5.42,3.4843,5.4197,3.4843,5.5821,3.1998,5.5825)", + "span": { + "offset": 3192, + "length": 2 + }, + "elements": [ + "/paragraphs/74" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "3524", + "source": "D(1,3.4843,5.4197,4.5173,5.4195,4.5172,5.5821,3.4843,5.5821)", + "span": { + "offset": 3204, + "length": 4 + }, + "elements": [ + "/paragraphs/75" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Taxable amount", + "source": "D(1,4.5173,5.4195,6.6861,5.4195,6.6862,5.582,4.5172,5.5821)", + "span": { + "offset": 3230, + "length": 16 + }, + "elements": [ + "/paragraphs/76" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "4b", + "source": "D(1,6.6861,5.4195,6.9922,5.4196,6.9923,5.5821,6.6862,5.582)", + "span": { + "offset": 3256, + "length": 2 + }, + "elements": [ + "/paragraphs/77" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "4508", + "source": "D(1,6.9922,5.4196,8.0071,5.4196,8.0072,5.5822,6.9923,5.5821)", + "span": { + "offset": 3268, + "length": 4 + }, + "elements": [ + "/paragraphs/78" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "5a Pensions and annuities . .", + "source": "D(1,1.2035,5.583,3.1998,5.5825,3.2002,5.7482,1.2035,5.7491)", + "span": { + "offset": 3293, + "length": 29 + }, + "elements": [ + "/paragraphs/79" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "5a", + "source": "D(1,3.1998,5.5825,3.4843,5.5821,3.4843,5.748,3.2002,5.7482)", + "span": { + "offset": 3332, + "length": 2 + }, + "elements": [ + "/paragraphs/80" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "2535", + "source": "D(1,3.4843,5.5821,4.5172,5.5821,4.5179,5.748,3.4843,5.748)", + "span": { + "offset": 3344, + "length": 4 + }, + "elements": [ + "/paragraphs/81" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Taxable amount", + "source": "D(1,4.5172,5.5821,6.6862,5.582,6.6856,5.7485,4.5179,5.748)", + "span": { + "offset": 3370, + "length": 16 + }, + "elements": [ + "/paragraphs/82" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "5b", + "source": "D(1,6.6862,5.582,6.9923,5.5821,6.9923,5.7486,6.6856,5.7485)", + "span": { + "offset": 3396, + "length": 2 + }, + "elements": [ + "/paragraphs/83" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "1008", + "source": "D(1,6.9923,5.5821,8.0072,5.5822,8.0072,5.7491,6.9923,5.7486)", + "span": { + "offset": 3408, + "length": 4 + }, + "elements": [ + "/paragraphs/84" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 0, + "rowSpan": 13, + "columnSpan": 1, + "content": "Standard Deduction for- . Single or Married filing separately, $12,400 . Married filing jointly or Qualifying widow(er), $24,800 . Head of household, $18,650 . If you checked any box under Standard Deduction, see instructions.", + "source": "D(1,0.4041,5.75,1.2035,5.7491,1.2052,7.9113,0.4016,7.9114)", + "span": { + "offset": 3446, + "length": 226 + }, + "elements": [ + "/paragraphs/85" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "6a Social security benefits .", + "source": "D(1,1.2035,5.7491,3.2002,5.7482,3.2004,5.9103,1.2037,5.9116)", + "span": { + "offset": 3682, + "length": 29 + }, + "elements": [ + "/paragraphs/86" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "6a", + "source": "D(1,3.2002,5.7482,3.4843,5.748,3.4846,5.9105,3.2004,5.9103)", + "span": { + "offset": 3721, + "length": 2 + }, + "elements": [ + "/paragraphs/87" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "5328", + "source": "D(1,3.4843,5.748,4.5179,5.748,4.5178,5.9101,3.4846,5.9105)", + "span": { + "offset": 3733, + "length": 4 + }, + "elements": [ + "/paragraphs/88" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Taxable amount", + "source": "D(1,4.5179,5.748,6.6856,5.7485,6.6861,5.9106,4.5178,5.9101)", + "span": { + "offset": 3759, + "length": 16 + }, + "elements": [ + "/paragraphs/89" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "6b", + "source": "D(1,6.6856,5.7485,6.9923,5.7486,6.9933,5.9108,6.6861,5.9106)", + "span": { + "offset": 3785, + "length": 2 + }, + "elements": [ + "/paragraphs/90" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "2004", + "source": "D(1,6.9923,5.7486,8.0072,5.7491,8.0072,5.9114,6.9933,5.9108)", + "span": { + "offset": 3797, + "length": 4 + }, + "elements": [ + "/paragraphs/91" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "7 Capital gain or (loss). Attach Schedule D if required. If not required, check here ☐", + "source": "D(1,1.2037,5.9116,6.6861,5.9106,6.686,6.0853,1.2035,6.0859)", + "span": { + "offset": 3834, + "length": 86 + }, + "elements": [ + "/paragraphs/92" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "7", + "source": "D(1,6.6861,5.9106,6.9933,5.9108,6.9935,6.0853,6.686,6.0853)", + "span": { + "offset": 3930, + "length": 1 + }, + "elements": [ + "/paragraphs/93" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "3006", + "source": "D(1,6.9933,5.9108,8.0072,5.9114,8.0072,6.0858,6.9935,6.0853)", + "span": { + "offset": 3941, + "length": 4 + }, + "elements": [ + "/paragraphs/94" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "8 Other income from Schedule 1, line 9", + "source": "D(1,1.2035,6.0859,6.686,6.0853,6.6861,6.2474,1.2037,6.2482)", + "span": { + "offset": 3978, + "length": 38 + }, + "elements": [ + "/paragraphs/95" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "8", + "source": "D(1,6.686,6.0853,6.9935,6.0853,6.9936,6.2477,6.6861,6.2474)", + "span": { + "offset": 4026, + "length": 1 + }, + "elements": [ + "/paragraphs/96" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "4006", + "source": "D(1,6.9935,6.0853,8.0072,6.0858,8.0075,6.2481,6.9936,6.2477)", + "span": { + "offset": 4037, + "length": 4 + }, + "elements": [ + "/paragraphs/97" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "9 Add lines 1, 2b, 3b, 4b, 5b, 6b, 7, and 8. This is your total income", + "source": "D(1,1.2037,6.2482,6.6861,6.2474,6.6846,6.4104,1.203,6.411)", + "span": { + "offset": 4074, + "length": 70 + }, + "elements": [ + "/paragraphs/98" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "9", + "source": "D(1,6.6861,6.2474,6.9936,6.2477,6.9924,6.4099,6.6846,6.4104)", + "span": { + "offset": 4154, + "length": 1 + }, + "elements": [ + "/paragraphs/99" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "46708", + "source": "D(1,6.9936,6.2477,8.0075,6.2481,8.0073,6.4105,6.9924,6.4099)", + "span": { + "offset": 4165, + "length": 5 + }, + "elements": [ + "/paragraphs/100" + ] + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "10 Adjustments to income:", + "source": "D(1,1.203,6.411,6.6846,6.4104,6.6858,6.5746,1.2031,6.5788)", + "span": { + "offset": 4203, + "length": 25 + }, + "elements": [ + "/paragraphs/101" + ] + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 7, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(1,6.6846,6.4104,6.9924,6.4099,6.9929,6.9183,6.6859,6.9181)", + "span": { + "offset": 4250, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 8, + "rowSpan": 4, + "columnSpan": 1, + "content": "6455", + "source": "D(1,6.9924,6.4099,8.0073,6.4105,8.0081,7.0781,6.994,7.0779)", + "span": { + "offset": 4272, + "length": 4 + }, + "elements": [ + "/paragraphs/102" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 4, + "content": "a From Schedule 1, line 22", + "source": "D(1,1.2031,6.5788,5.3993,6.5756,5.4002,6.7497,1.203,6.7509)", + "span": { + "offset": 4309, + "length": 26 + }, + "elements": [ + "/paragraphs/103" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "10a", + "source": "D(1,5.3993,6.5756,5.6925,6.5755,5.6933,6.7498,5.4002,6.7497)", + "span": { + "offset": 4345, + "length": 3 + }, + "elements": [ + "/paragraphs/104" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "6538", + "source": "D(1,5.6925,6.5755,6.6858,6.5746,6.6858,6.7498,5.6933,6.7498)", + "span": { + "offset": 4358, + "length": 4 + }, + "elements": [ + "/paragraphs/105" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 4, + "content": "b Charitable contributions if you take the standard deduction. See instructions", + "source": "D(1,1.203,6.7509,5.4002,6.7497,5.398,6.9176,1.203,6.9192)", + "span": { + "offset": 4395, + "length": 79 + }, + "elements": [ + "/paragraphs/106" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "10b", + "source": "D(1,5.4002,6.7497,5.6933,6.7498,5.6918,6.9178,5.398,6.9176)", + "span": { + "offset": 4484, + "length": 3 + }, + "elements": [ + "/paragraphs/107" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 6, + "rowSpan": 1, + "columnSpan": 1, + "content": "6536", + "source": "D(1,5.6933,6.7498,6.6858,6.7498,6.6859,6.9181,5.6918,6.9178)", + "span": { + "offset": 4497, + "length": 4 + }, + "elements": [ + "/paragraphs/108" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "c Add lines 10a and 10b. These are your total adjustments to income", + "source": "D(1,1.203,6.9192,6.6859,6.9181,6.6865,7.0779,1.2031,7.08)", + "span": { + "offset": 4534, + "length": 67 + }, + "elements": [ + "/paragraphs/109" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "10c", + "source": "D(1,6.6859,6.9181,6.9929,6.9183,6.994,7.0779,6.6865,7.0779)", + "span": { + "offset": 4611, + "length": 3 + }, + "elements": [ + "/paragraphs/110" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "11 Subtract line 10c from line 9. This is your adjusted gross income", + "source": "D(1,1.2031,7.08,6.6865,7.0779,6.6863,7.2508,1.2031,7.252)", + "span": { + "offset": 4647, + "length": 68 + }, + "elements": [ + "/paragraphs/111" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "11", + "source": "D(1,6.6865,7.0779,6.994,7.0779,6.9938,7.2508,6.6863,7.2508)", + "span": { + "offset": 4725, + "length": 2 + }, + "elements": [ + "/paragraphs/112" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "7658", + "source": "D(1,6.994,7.0779,8.0081,7.0781,8.0083,7.2509,6.9938,7.2508)", + "span": { + "offset": 4737, + "length": 4 + }, + "elements": [ + "/paragraphs/113" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "12 Standard deduction or itemized deductions (from Schedule A)", + "source": "D(1,1.2031,7.252,6.6863,7.2508,6.686,7.4131,1.2031,7.4148)", + "span": { + "offset": 4774, + "length": 62 + }, + "elements": [ + "/paragraphs/114" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "12", + "source": "D(1,6.6863,7.2508,6.9938,7.2508,6.9935,7.4131,6.686,7.4131)", + "span": { + "offset": 4846, + "length": 2 + }, + "elements": [ + "/paragraphs/115" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "3427", + "source": "D(1,6.9938,7.2508,8.0083,7.2509,8.0082,7.4127,6.9935,7.4131)", + "span": { + "offset": 4858, + "length": 4 + }, + "elements": [ + "/paragraphs/116" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "13 Qualified business income deduction. Attach Form 8995 or Form 8995-A", + "source": "D(1,1.2031,7.4148,6.686,7.4131,6.6864,7.5788,1.2033,7.5794)", + "span": { + "offset": 4895, + "length": 71 + }, + "elements": [ + "/paragraphs/117" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "13", + "source": "D(1,6.686,7.4131,6.9935,7.4131,6.9938,7.579,6.6864,7.5788)", + "span": { + "offset": 4976, + "length": 2 + }, + "elements": [ + "/paragraphs/118" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "8009", + "source": "D(1,6.9935,7.4131,8.0082,7.4127,8.0085,7.5792,6.9938,7.579)", + "span": { + "offset": 4988, + "length": 4 + }, + "elements": [ + "/paragraphs/119" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "14 Add lines 12 and 13", + "source": "D(1,1.2033,7.5794,6.6864,7.5788,6.6864,7.7475,1.2033,7.7497)", + "span": { + "offset": 5025, + "length": 22 + }, + "elements": [ + "/paragraphs/120" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "14", + "source": "D(1,6.6864,7.5788,6.9938,7.579,6.9937,7.7473,6.6864,7.7475)", + "span": { + "offset": 5057, + "length": 2 + }, + "elements": [ + "/paragraphs/121" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "6008", + "source": "D(1,6.9938,7.579,8.0085,7.5792,8.0081,7.7471,6.9937,7.7473)", + "span": { + "offset": 5069, + "length": 4 + }, + "elements": [ + "/paragraphs/122" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 6, + "content": "15 Taxable income. Subtract line 14 from line 11. If zero or less, enter -0-", + "source": "D(1,1.2033,7.7497,6.6864,7.7475,6.6887,7.9105,1.2052,7.9113)", + "span": { + "offset": 5106, + "length": 76 + }, + "elements": [ + "/paragraphs/123" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 7, + "rowSpan": 1, + "columnSpan": 1, + "content": "15", + "source": "D(1,6.6864,7.7475,6.9937,7.7473,6.9959,7.9107,6.6887,7.9105)", + "span": { + "offset": 5192, + "length": 2 + }, + "elements": [ + "/paragraphs/124" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 8, + "rowSpan": 1, + "columnSpan": 1, + "content": "1055", + "source": "D(1,6.9937,7.7473,8.0081,7.7471,8.0077,7.9104,6.9959,7.9107)", + "span": { + "offset": 5204, + "length": 4 + }, + "elements": [ + "/paragraphs/125" + ] + } + ], + "source": "D(1,0.3956,4.9414,8.0061,4.9226,8.0061,7.9009,0.3966,7.9009)", + "span": { + "offset": 2709, + "length": 2519 + } + }, + { + "rowCount": 31, + "columnCount": 6, + "cells": [ + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 0, + "rowSpan": 14, + "columnSpan": 1, + "content": "", + "source": "D(2,0.418,0.5041,1.2427,0.5024,1.2401,2.8362,0.4165,2.8368)", + "span": { + "offset": 5542, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "16 Tax (see instructions). Check if any from Form(s): 1 ☑ 8814 2 ☐ 4972 3 ☐ . .", + "source": "D(2,1.2427,0.5024,6.696,0.502,6.6943,0.6658,1.2419,0.6673)", + "span": { + "offset": 5564, + "length": 79 + }, + "elements": [ + "/paragraphs/131" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "16", + "source": "D(2,6.696,0.502,6.9954,0.5013,6.9943,0.6648,6.6943,0.6658)", + "span": { + "offset": 5653, + "length": 2 + }, + "elements": [ + "/paragraphs/132" + ] + }, + { + "kind": "content", + "rowIndex": 0, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "2350", + "source": "D(2,6.9954,0.5013,8.0027,0.5021,8.0021,0.6654,6.9943,0.6648)", + "span": { + "offset": 5665, + "length": 4 + }, + "elements": [ + "/paragraphs/133" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "17 Amount from Schedule 2, line 3", + "source": "D(2,1.2419,0.6673,6.6943,0.6658,6.6942,0.8369,1.241,0.8393)", + "span": { + "offset": 5702, + "length": 33 + }, + "elements": [ + "/paragraphs/134" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "17", + "source": "D(2,6.6943,0.6658,6.9943,0.6648,6.9941,0.8361,6.6942,0.8369)", + "span": { + "offset": 5745, + "length": 2 + }, + "elements": [ + "/paragraphs/135" + ] + }, + { + "kind": "content", + "rowIndex": 1, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "5437", + "source": "D(2,6.9943,0.6648,8.0021,0.6654,8.0026,0.8366,6.9941,0.8361)", + "span": { + "offset": 5757, + "length": 4 + }, + "elements": [ + "/paragraphs/136" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "18 Add lines 16 and 17", + "source": "D(2,1.241,0.8393,6.6942,0.8369,6.6938,1.001,1.2405,1.0034)", + "span": { + "offset": 5794, + "length": 22 + }, + "elements": [ + "/paragraphs/137" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "18", + "source": "D(2,6.6942,0.8369,6.9941,0.8361,6.994,1.0002,6.6938,1.001)", + "span": { + "offset": 5826, + "length": 2 + }, + "elements": [ + "/paragraphs/138" + ] + }, + { + "kind": "content", + "rowIndex": 2, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "1000", + "source": "D(2,6.9941,0.8361,8.0026,0.8366,8.0022,1.0002,6.994,1.0002)", + "span": { + "offset": 5838, + "length": 4 + }, + "elements": [ + "/paragraphs/139" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "19 Child tax credit or credit for other dependents", + "source": "D(2,1.2405,1.0034,6.6938,1.001,6.6939,1.165,1.241,1.1675)", + "span": { + "offset": 5875, + "length": 50 + }, + "elements": [ + "/paragraphs/140" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "19", + "source": "D(2,6.6938,1.001,6.994,1.0002,6.9939,1.1644,6.6939,1.165)", + "span": { + "offset": 5935, + "length": 2 + }, + "elements": [ + "/paragraphs/141" + ] + }, + { + "kind": "content", + "rowIndex": 3, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "753", + "source": "D(2,6.994,1.0002,8.0022,1.0002,8.0024,1.1641,6.9939,1.1644)", + "span": { + "offset": 5947, + "length": 3 + }, + "elements": [ + "/paragraphs/142" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "20 Amount from Schedule 3, line 7", + "source": "D(2,1.241,1.1675,6.6939,1.165,6.6935,1.3351,1.2409,1.3369)", + "span": { + "offset": 5983, + "length": 33 + }, + "elements": [ + "/paragraphs/143" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "20", + "source": "D(2,6.6939,1.165,6.9939,1.1644,6.9937,1.3346,6.6935,1.3351)", + "span": { + "offset": 6026, + "length": 2 + }, + "elements": [ + "/paragraphs/144" + ] + }, + { + "kind": "content", + "rowIndex": 4, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "5430", + "source": "D(2,6.9939,1.1644,8.0024,1.1641,8.0024,1.3345,6.9937,1.3346)", + "span": { + "offset": 6038, + "length": 4 + }, + "elements": [ + "/paragraphs/145" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "21 Add lines 19 and 20", + "source": "D(2,1.2409,1.3369,6.6935,1.3351,6.6945,1.4972,1.2411,1.4984)", + "span": { + "offset": 6075, + "length": 22 + }, + "elements": [ + "/paragraphs/146" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "21", + "source": "D(2,6.6935,1.3351,6.9937,1.3346,6.9943,1.497,6.6945,1.4972)", + "span": { + "offset": 6107, + "length": 2 + }, + "elements": [ + "/paragraphs/147" + ] + }, + { + "kind": "content", + "rowIndex": 5, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "15790", + "source": "D(2,6.9937,1.3346,8.0024,1.3345,8.0025,1.4972,6.9943,1.497)", + "span": { + "offset": 6119, + "length": 5 + }, + "elements": [ + "/paragraphs/148" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "22 Subtract line 21 from line 18. If zero or less, enter -0-", + "source": "D(2,1.2411,1.4984,6.6945,1.4972,6.6946,1.6673,1.241,1.668)", + "span": { + "offset": 6157, + "length": 60 + }, + "elements": [ + "/paragraphs/149" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "22", + "source": "D(2,6.6945,1.4972,6.9943,1.497,6.9945,1.6671,6.6946,1.6673)", + "span": { + "offset": 6227, + "length": 2 + }, + "elements": [ + "/paragraphs/150" + ] + }, + { + "kind": "content", + "rowIndex": 6, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "5436", + "source": "D(2,6.9943,1.497,8.0025,1.4972,8.0022,1.6674,6.9945,1.6671)", + "span": { + "offset": 6239, + "length": 4 + }, + "elements": [ + "/paragraphs/151" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "23 Other taxes, including self-employment tax, from Schedule 2, line 10", + "source": "D(2,1.241,1.668,6.6946,1.6673,6.6949,1.833,1.2407,1.834)", + "span": { + "offset": 6276, + "length": 71 + }, + "elements": [ + "/paragraphs/152" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "23", + "source": "D(2,6.6946,1.6673,6.9945,1.6671,6.9949,1.8328,6.6949,1.833)", + "span": { + "offset": 6357, + "length": 2 + }, + "elements": [ + "/paragraphs/153" + ] + }, + { + "kind": "content", + "rowIndex": 7, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "7650", + "source": "D(2,6.9945,1.6671,8.0022,1.6674,8.002,1.8335,6.9949,1.8328)", + "span": { + "offset": 6369, + "length": 4 + }, + "elements": [ + "/paragraphs/154" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "24 Add lines 22 and 23. This is your total tax", + "source": "D(2,1.2407,1.834,6.6949,1.833,6.6931,1.9948,1.2402,1.9967)", + "span": { + "offset": 6406, + "length": 46 + }, + "elements": [ + "/paragraphs/155" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "24", + "source": "D(2,6.6949,1.833,6.9949,1.8328,6.9942,1.9939,6.6931,1.9948)", + "span": { + "offset": 6462, + "length": 2 + }, + "elements": [ + "/paragraphs/156" + ] + }, + { + "kind": "content", + "rowIndex": 8, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "12780", + "source": "D(2,6.9949,1.8328,8.002,1.8335,8.0024,1.9948,6.9942,1.9939)", + "span": { + "offset": 6474, + "length": 5 + }, + "elements": [ + "/paragraphs/157" + ] + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "25 Federal income tax withheld from:", + "source": "D(2,1.2402,1.9967,6.6931,1.9948,6.694,2.1542,1.24,2.1607)", + "span": { + "offset": 6512, + "length": 36 + }, + "elements": [ + "/paragraphs/158" + ] + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 4, + "rowSpan": 4, + "columnSpan": 1, + "content": "", + "source": "D(2,6.6931,1.9948,6.9942,1.9939,6.995,2.6646,6.6942,2.6653)", + "span": { + "offset": 6570, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 9, + "columnIndex": 5, + "rowSpan": 5, + "columnSpan": 1, + "content": "6220", + "source": "D(2,6.9942,1.9939,8.0024,1.9948,8.0027,2.8339,6.995,2.8345)", + "span": { + "offset": 6592, + "length": 4 + }, + "elements": [ + "/paragraphs/159" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "a Form(s) W-2", + "source": "D(2,1.24,2.1607,5.3968,2.1559,5.3961,2.3326,1.2403,2.3338)", + "span": { + "offset": 6617, + "length": 13 + }, + "elements": [ + "/paragraphs/160" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "25a", + "source": "D(2,5.3968,2.1559,5.6913,2.1559,5.6912,2.3326,5.3961,2.3326)", + "span": { + "offset": 6640, + "length": 3 + }, + "elements": [ + "/paragraphs/161" + ] + }, + { + "kind": "content", + "rowIndex": 10, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "4220", + "source": "D(2,5.6913,2.1559,6.694,2.1542,6.6947,2.3327,5.6912,2.3326)", + "span": { + "offset": 6653, + "length": 4 + }, + "elements": [ + "/paragraphs/162" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "b Form(s) 1099", + "source": "D(2,1.2403,2.3338,5.3961,2.3326,5.3963,2.4987,1.2404,2.5)", + "span": { + "offset": 6678, + "length": 14 + }, + "elements": [ + "/paragraphs/163" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "25b", + "source": "D(2,5.3961,2.3326,5.6912,2.3326,5.6912,2.4985,5.3963,2.4987)", + "span": { + "offset": 6702, + "length": 3 + }, + "elements": [ + "/paragraphs/164" + ] + }, + { + "kind": "content", + "rowIndex": 11, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "1000", + "source": "D(2,5.6912,2.3326,6.6947,2.3327,6.695,2.4986,5.6912,2.4985)", + "span": { + "offset": 6715, + "length": 4 + }, + "elements": [ + "/paragraphs/165" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "c Other forms (see instructions)", + "source": "D(2,1.2404,2.5,5.3963,2.4987,5.396,2.6643,1.2404,2.6656)", + "span": { + "offset": 6740, + "length": 32 + }, + "elements": [ + "/paragraphs/166" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "25c", + "source": "D(2,5.3963,2.4987,5.6912,2.4985,5.6914,2.6645,5.396,2.6643)", + "span": { + "offset": 6782, + "length": 3 + }, + "elements": [ + "/paragraphs/167" + ] + }, + { + "kind": "content", + "rowIndex": 12, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "2000", + "source": "D(2,5.6912,2.4985,6.695,2.4986,6.6942,2.6653,5.6914,2.6645)", + "span": { + "offset": 6795, + "length": 4 + }, + "elements": [ + "/paragraphs/168" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "d Add lines 25a through 25c", + "source": "D(2,1.2404,2.6656,6.6942,2.6653,6.6943,2.8347,1.2401,2.8362)", + "span": { + "offset": 6832, + "length": 27 + }, + "elements": [ + "/paragraphs/169" + ] + }, + { + "kind": "content", + "rowIndex": 13, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "25d", + "source": "D(2,6.6942,2.6653,6.995,2.6646,6.995,2.8345,6.6943,2.8347)", + "span": { + "offset": 6869, + "length": 3 + }, + "elements": [ + "/paragraphs/170" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 0, + "rowSpan": 8, + "columnSpan": 1, + "content": ". If you have a qualifying child, attach Sch. EIC. . If you have nontaxable combat pay, see instructions.", + "source": "D(2,0.4165,2.8368,1.2401,2.8362,1.2401,4.1682,0.4156,4.1682)", + "span": { + "offset": 6905, + "length": 105 + }, + "elements": [ + "/paragraphs/171" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "26 2020 estimated tax payments and amount applied from 2019 return", + "source": "D(2,1.2401,2.8362,6.6943,2.8347,6.694,2.9957,1.2401,2.9969)", + "span": { + "offset": 7032, + "length": 66 + }, + "elements": [ + "/paragraphs/172" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "26", + "source": "D(2,6.6943,2.8347,6.995,2.8345,6.9943,2.9952,6.694,2.9957)", + "span": { + "offset": 7108, + "length": 2 + }, + "elements": [ + "/paragraphs/173" + ] + }, + { + "kind": "content", + "rowIndex": 14, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "5438", + "source": "D(2,6.995,2.8345,8.0027,2.8339,8.0026,2.9951,6.9943,2.9952)", + "span": { + "offset": 7120, + "length": 4 + }, + "elements": [ + "/paragraphs/174" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "27 Earned income credit (EIC)", + "source": "D(2,1.2401,2.9969,5.3961,2.9951,5.3955,3.1603,1.2406,3.1619)", + "span": { + "offset": 7145, + "length": 29 + }, + "elements": [ + "/paragraphs/175" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "27", + "source": "D(2,5.3961,2.9951,5.6911,2.9955,5.6906,3.1603,5.3955,3.1603)", + "span": { + "offset": 7184, + "length": 2 + }, + "elements": [ + "/paragraphs/176" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "4359", + "source": "D(2,5.6911,2.9955,6.694,2.9957,6.695,3.1602,5.6906,3.1603)", + "span": { + "offset": 7196, + "length": 4 + }, + "elements": [ + "/paragraphs/177" + ] + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "", + "source": "D(2,6.694,2.9957,6.9943,2.9952,6.9951,3.1599,6.695,3.1602)", + "span": { + "offset": 7210, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 15, + "columnIndex": 5, + "rowSpan": 6, + "columnSpan": 1, + "content": "6534", + "source": "D(2,6.9943,2.9952,8.0026,2.9951,8.0026,4.0011,6.9948,4.0011)", + "span": { + "offset": 7232, + "length": 4 + }, + "elements": [ + "/paragraphs/178" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "28 Additional child tax credit. Attach Schedule 8812", + "source": "D(2,1.2406,3.1619,5.3955,3.1603,5.3955,3.3302,1.2405,3.3318)", + "span": { + "offset": 7257, + "length": 52 + }, + "elements": [ + "/paragraphs/179" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "28", + "source": "D(2,5.3955,3.1603,5.6906,3.1603,5.6906,3.3302,5.3955,3.3302)", + "span": { + "offset": 7319, + "length": 2 + }, + "elements": [ + "/paragraphs/180" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "5326", + "source": "D(2,5.6906,3.1603,6.695,3.1602,6.6954,3.3302,5.6906,3.3302)", + "span": { + "offset": 7331, + "length": 4 + }, + "elements": [ + "/paragraphs/181" + ] + }, + { + "kind": "content", + "rowIndex": 16, + "columnIndex": 4, + "rowSpan": 4, + "columnSpan": 1, + "content": "", + "source": "D(2,6.695,3.1602,6.9951,3.1599,6.9949,3.8309,6.6945,3.8317)", + "span": { + "offset": 7357, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "29 American opportunity credit from Form 8863, line 8", + "source": "D(2,1.2405,3.3318,5.3955,3.3302,5.3952,3.4984,1.2399,3.4996)", + "span": { + "offset": 7378, + "length": 53 + }, + "elements": [ + "/paragraphs/182" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "29", + "source": "D(2,5.3955,3.3302,5.6906,3.3302,5.6904,3.4982,5.3952,3.4984)", + "span": { + "offset": 7441, + "length": 2 + }, + "elements": [ + "/paragraphs/183" + ] + }, + { + "kind": "content", + "rowIndex": 17, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "6743", + "source": "D(2,5.6906,3.3302,6.6954,3.3302,6.6953,3.4984,5.6904,3.4982)", + "span": { + "offset": 7453, + "length": 4 + }, + "elements": [ + "/paragraphs/184" + ] + }, + { + "kind": "content", + "rowIndex": 18, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "30 Recovery rebate credit. See instructions", + "source": "D(2,1.2399,3.4996,5.3952,3.4984,5.3966,3.665,1.2402,3.6659)", + "span": { + "offset": 7478, + "length": 43 + }, + "elements": [ + "/paragraphs/185" + ] + }, + { + "kind": "content", + "rowIndex": 18, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "30", + "source": "D(2,5.3952,3.4984,5.6904,3.4982,5.6915,3.6648,5.3966,3.665)", + "span": { + "offset": 7531, + "length": 2 + }, + "elements": [ + "/paragraphs/186" + ] + }, + { + "kind": "content", + "rowIndex": 18, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "4562", + "source": "D(2,5.6904,3.4982,6.6953,3.4984,6.6952,3.6652,5.6915,3.6648)", + "span": { + "offset": 7543, + "length": 4 + }, + "elements": [ + "/paragraphs/187" + ] + }, + { + "kind": "content", + "rowIndex": 19, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "31 Amount from Schedule 3, line 13", + "source": "D(2,1.2402,3.6659,5.3966,3.665,5.3972,3.8314,1.2401,3.8342)", + "span": { + "offset": 7568, + "length": 34 + }, + "elements": [ + "/paragraphs/188" + ] + }, + { + "kind": "content", + "rowIndex": 19, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "31", + "source": "D(2,5.3966,3.665,5.6915,3.6648,5.6924,3.8316,5.3972,3.8314)", + "span": { + "offset": 7612, + "length": 2 + }, + "elements": [ + "/paragraphs/189" + ] + }, + { + "kind": "content", + "rowIndex": 19, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "2428", + "source": "D(2,5.6915,3.6648,6.6952,3.6652,6.6945,3.8317,5.6924,3.8316)", + "span": { + "offset": 7624, + "length": 4 + }, + "elements": [ + "/paragraphs/190" + ] + }, + { + "kind": "content", + "rowIndex": 20, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "32 Add lines 27 through 31. These are your total other payments and refundable credits", + "source": "D(2,1.2401,3.8342,6.6945,3.8317,6.6948,4.0015,1.24,4.0038)", + "span": { + "offset": 7661, + "length": 86 + }, + "elements": [ + "/paragraphs/191" + ] + }, + { + "kind": "content", + "rowIndex": 20, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "32", + "source": "D(2,6.6945,3.8317,6.9949,3.8309,6.9948,4.0011,6.6948,4.0015)", + "span": { + "offset": 7757, + "length": 2 + }, + "elements": [ + "/paragraphs/192" + ] + }, + { + "kind": "content", + "rowIndex": 21, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "33 Add lines 25d, 26, and 32. These are your total payments", + "source": "D(2,1.24,4.0038,6.6948,4.0015,6.6946,4.1652,1.2401,4.1682)", + "span": { + "offset": 7792, + "length": 59 + }, + "elements": [ + "/paragraphs/193" + ] + }, + { + "kind": "content", + "rowIndex": 21, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "33", + "source": "D(2,6.6948,4.0015,6.9948,4.0011,6.9948,4.1648,6.6946,4.1652)", + "span": { + "offset": 7861, + "length": 2 + }, + "elements": [ + "/paragraphs/194" + ] + }, + { + "kind": "content", + "rowIndex": 21, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "3657", + "source": "D(2,6.9948,4.0011,8.0026,4.0011,8.0029,4.1646,6.9948,4.1648)", + "span": { + "offset": 7873, + "length": 4 + }, + "elements": [ + "/paragraphs/195" + ] + }, + { + "kind": "content", + "rowIndex": 22, + "columnIndex": 0, + "rowSpan": 5, + "columnSpan": 1, + "content": "Refund Direct deposit? See instructions.", + "source": "D(2,0.4156,4.1682,1.2401,4.1682,1.2402,4.9942,0.4158,4.9943)", + "span": { + "offset": 7910, + "length": 40 + }, + "elements": [ + "/paragraphs/196" + ] + }, + { + "kind": "content", + "rowIndex": 22, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "34 If line 33 is more than line 24, subtract line 24 from line 33. This is the amount you overpaid . .", + "source": "D(2,1.2401,4.1682,6.6946,4.1652,6.6949,4.3308,1.2401,4.3328)", + "span": { + "offset": 7972, + "length": 102 + }, + "elements": [ + "/paragraphs/197" + ] + }, + { + "kind": "content", + "rowIndex": 22, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "34", + "source": "D(2,6.6946,4.1652,6.9948,4.1648,6.9949,4.3304,6.6949,4.3308)", + "span": { + "offset": 8084, + "length": 2 + }, + "elements": [ + "/paragraphs/198" + ] + }, + { + "kind": "content", + "rowIndex": 22, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "6338", + "source": "D(2,6.9948,4.1648,8.0029,4.1646,8.0029,4.3306,6.9949,4.3304)", + "span": { + "offset": 8096, + "length": 4 + }, + "elements": [ + "/paragraphs/199" + ] + }, + { + "kind": "content", + "rowIndex": 23, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "5a Amount of line 34 you want refunded to you. If Form 8888 is attached, check here\n35a\n☐ . . .", + "source": "D(2,1.2401,4.3328,6.6949,4.3308,6.6951,4.4973,1.2401,4.4998)", + "span": { + "offset": 8133, + "length": 95 + }, + "elements": [ + "/paragraphs/200" + ] + }, + { + "kind": "content", + "rowIndex": 23, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "35a", + "source": "D(2,6.6949,4.3308,6.9949,4.3304,6.9953,4.497,6.6951,4.4973)", + "span": { + "offset": 8238, + "length": 3 + }, + "elements": [ + "/paragraphs/201" + ] + }, + { + "kind": "content", + "rowIndex": 23, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "6335", + "source": "D(2,6.9949,4.3304,8.0029,4.3306,8.0025,4.4972,6.9953,4.497)", + "span": { + "offset": 8251, + "length": 4 + }, + "elements": [ + "/paragraphs/202" + ] + }, + { + "kind": "content", + "rowIndex": 24, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "b Routing number 052088863 ▶ c Type: ☐ Checking ☑ Savings", + "source": "D(2,1.2401,4.4998,6.6951,4.4973,6.6947,4.6607,1.2401,4.6629)", + "span": { + "offset": 8288, + "length": 57 + }, + "elements": [ + "/paragraphs/203" + ] + }, + { + "kind": "content", + "rowIndex": 24, + "columnIndex": 4, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(2,6.6951,4.4973,6.9953,4.497,6.995,4.9941,6.695,4.9941)", + "span": { + "offset": 8367, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 24, + "columnIndex": 5, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(2,6.9953,4.497,8.0025,4.4972,8.0027,4.9942,6.995,4.9941)", + "span": { + "offset": 8389, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 25, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "▶d Account number 5206340044401004", + "source": "D(2,1.2401,4.6629,6.6947,4.6607,6.6947,4.8251,1.2403,4.8264)", + "span": { + "offset": 8422, + "length": 34 + }, + "elements": [ + "/paragraphs/204" + ] + }, + { + "kind": "content", + "rowIndex": 26, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "36 Amount of line 34 you want applied to your 2021 estimated tax", + "source": "D(2,1.2403,4.8264,5.397,4.8253,5.3971,4.994,1.2402,4.9942)", + "span": { + "offset": 8477, + "length": 64 + }, + "elements": [ + "/paragraphs/205" + ] + }, + { + "kind": "content", + "rowIndex": 26, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "36", + "source": "D(2,5.397,4.8253,5.6912,4.8257,5.6925,4.994,5.3971,4.994)", + "span": { + "offset": 8551, + "length": 2 + }, + "elements": [ + "/paragraphs/206" + ] + }, + { + "kind": "content", + "rowIndex": 26, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "45830", + "source": "D(2,5.6912,4.8257,6.6947,4.8251,6.695,4.9941,5.6925,4.994)", + "span": { + "offset": 8563, + "length": 5 + }, + "elements": [ + "/paragraphs/207" + ] + }, + { + "kind": "content", + "rowIndex": 27, + "columnIndex": 0, + "rowSpan": 4, + "columnSpan": 1, + "content": "Amount You Owe For details on how to pay, see instructions.", + "source": "D(2,0.4158,4.9943,1.2402,4.9942,1.2412,5.6684,0.4142,5.6683)", + "span": { + "offset": 8601, + "length": 59 + }, + "elements": [ + "/paragraphs/208" + ] + }, + { + "kind": "content", + "rowIndex": 27, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "37 Subtract line 33 from line 24. This is the amount you owe now . . . . . . . . .", + "source": "D(2,1.2402,4.9942,6.695,4.9941,6.695,5.178,1.2394,5.18)", + "span": { + "offset": 8682, + "length": 82 + }, + "elements": [ + "/paragraphs/209" + ] + }, + { + "kind": "content", + "rowIndex": 27, + "columnIndex": 4, + "rowSpan": 1, + "columnSpan": 1, + "content": "37", + "source": "D(2,6.695,4.9941,6.995,4.9941,6.9953,5.1778,6.695,5.178)", + "span": { + "offset": 8774, + "length": 2 + }, + "elements": [ + "/paragraphs/210" + ] + }, + { + "kind": "content", + "rowIndex": 27, + "columnIndex": 5, + "rowSpan": 1, + "columnSpan": 1, + "content": "6430", + "source": "D(2,6.995,4.9941,8.0027,4.9942,8.0029,5.1778,6.9953,5.1778)", + "span": { + "offset": 8786, + "length": 4 + }, + "elements": [ + "/paragraphs/211" + ] + }, + { + "kind": "content", + "rowIndex": 28, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "Note: Schedule H and Schedule SE filers, line 37 may not represent all of the taxes you owe for", + "source": "D(2,1.2394,5.18,6.695,5.178,6.6944,5.3458,1.2395,5.3474)", + "span": { + "offset": 8823, + "length": 95 + }, + "elements": [ + "/paragraphs/212" + ] + }, + { + "kind": "content", + "rowIndex": 28, + "columnIndex": 4, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(2,6.695,5.178,6.9953,5.1778,6.996,5.6684,6.6963,5.6685)", + "span": { + "offset": 8940, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 28, + "columnIndex": 5, + "rowSpan": 3, + "columnSpan": 1, + "content": "", + "source": "D(2,6.9953,5.1778,8.0029,5.1778,8.003,5.6685,6.996,5.6684)", + "span": { + "offset": 8962, + "length": 0 + } + }, + { + "kind": "content", + "rowIndex": 29, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 3, + "content": "2020. See Schedule 3, line 12e, and its instructions for details.", + "source": "D(2,1.2395,5.3474,6.6944,5.3458,6.6949,5.5026,1.2398,5.5037)", + "span": { + "offset": 8995, + "length": 65 + }, + "elements": [ + "/paragraphs/213" + ] + }, + { + "kind": "content", + "rowIndex": 30, + "columnIndex": 1, + "rowSpan": 1, + "columnSpan": 1, + "content": "38 Estimated tax penalty (see instructions)", + "source": "D(2,1.2398,5.5037,5.3957,5.5028,5.3963,5.6678,1.2412,5.6684)", + "span": { + "offset": 9081, + "length": 43 + }, + "elements": [ + "/paragraphs/214" + ] + }, + { + "kind": "content", + "rowIndex": 30, + "columnIndex": 2, + "rowSpan": 1, + "columnSpan": 1, + "content": "38", + "source": "D(2,5.3957,5.5028,5.6908,5.5027,5.6914,5.668,5.3963,5.6678)", + "span": { + "offset": 9134, + "length": 2 + }, + "elements": [ + "/paragraphs/215" + ] + }, + { + "kind": "content", + "rowIndex": 30, + "columnIndex": 3, + "rowSpan": 1, + "columnSpan": 1, + "content": "1250", + "source": "D(2,5.6908,5.5027,6.6949,5.5026,6.6963,5.6685,5.6914,5.668)", + "span": { + "offset": 9146, + "length": 4 + }, + "elements": [ + "/paragraphs/216" + ] + } + ], + "source": "D(2,0.4062,0.4972,7.9937,0.4831,8.0061,5.6504,0.407,5.6665)", + "span": { + "offset": 5512, + "length": 3658 + } + } + ], + "analyzerId": "prebuilt-documentSearch", + "mimeType": "application/pdf" + } + ] + }, + "usage": { + "documentPagesStandard": 2, + "contextualizationTokens": 2000, + "tokens": { + "gpt-4.1-mini-input": 12028, + "gpt-4.1-mini-output": 828 + } + } +} \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/README.md new file mode 100644 index 000000000000..5d1ba0112748 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/README.md @@ -0,0 +1,53 @@ +# Training Samples for Custom Model Building + +This directory contains training files for the `build_custom_model_with_training.py` sample. + +## File Requirements + +For each training document, you need **three files**: + +1. **PDF file**: The actual document (e.g., `IRS_1040_1_09.pdf`) +2. **Labels file**: Field annotations (e.g., `IRS_1040_1_09.pdf.labels.json`) +3. **Result file**: OCR output from prebuilt-documentSearch (e.g., `IRS_1040_1_09.pdf.result.json`) + +## Labels File Format + +The `.labels.json` files must: +- Use schema version `2025-11-01` (not the preview version) +- Contain only fields defined in your custom schema +- Match the field types defined in the schema + +Example structure: +```json +{ + "$schema": "https://schema.ai.azure.com/mmi/2025-11-01/labels.json", + "fileId": "", + "fieldLabels": { + "FieldYourFirstNameAndMiddleInitial": { + "type": "string", + "valueString": "Robert", + ... + } + } +} +``` + +## Current Training Set + +This directory contains 2 labeled IRS 1040 forms with 5 fields: +- `FieldYourFirstNameAndMiddleInitial` +- `FieldYourFirstNameAndMiddleInitialLastName` +- `CheckboxYouAsADependent` +- `TableDependents` (with nested properties) +- `FieldWagesSalariesTipsEtcAttachFormSW2` + +## Usage + +1. Upload all files to Azure Blob Storage +2. Set the `CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL` environment variable +3. Set the `CONTENT_UNDERSTANDING_STORAGE_PREFIX` to point to your training files +4. Run `python build_custom_model_with_training.py` + +See `../../env.sample` for configuration details. + + From bb1e2df46f382774885e7e390955db8f1da5a5d3 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 21:20:53 +0000 Subject: [PATCH 009/105] SAMPLE: Add analyze_binary_features.py to demonstrate advanced PDF analysis - Introduced `analyze_binary_features.py` to showcase extraction of charts, hyperlinks, and annotations from PDF documents using the prebuilt-documentSearch analyzer. - Added `sample_document_features.pdf` for testing the new sample functionality. --- .../azure-ai-contentunderstanding/.gitignore | 25 ++ .../samples/analyze_binary_features.py | 380 ++++++++++++++++++ .../sample_files/sample_document_features.pdf | Bin 0 -> 152348 bytes .../samples/sample_helper.py | 2 +- 4 files changed, 406 insertions(+), 1 deletion(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_features.py create mode 100755 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_document_features.pdf diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore b/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore new file mode 100644 index 000000000000..3725075a038c --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore @@ -0,0 +1,25 @@ +# Sample output files +samples/sample_output/ + +# Virtual environment +.venv/ + +# Python cache +__pycache__/ +*.pyc +*.pyo +*.pyd +.Python + +# IDE +.vscode/ +.idea/ + +# Testing +.pytest_cache/ +.coverage +htmlcov/ + +# Environment variables +.env + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_features.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_features.py new file mode 100644 index 000000000000..87314a39ec6a --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_features.py @@ -0,0 +1,380 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: demonstrate additional features on prebuilt-documentSearch to show results for charts, hyperlinks, and PDF annotations from PDF. + +This sample demonstrates the additional features available in the prebuilt-documentSearch analyzer: +- Charts: Extraction and analysis of charts from PDF documents +- Hyperlinks: Detection and extraction of hyperlinks in PDF documents +- PDF Annotations: Detection and extraction of annotations (highlights, comments, etc.) from PDF documents + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python analyze_binary_features.py +""" + +from __future__ import annotations + +import asyncio +import json +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeResult, + MediaContent, + DocumentContent, + MediaContentKind, + DocumentChartFigure, + DocumentFigureKind, + DocumentAnnotation, + DocumentAnnotationKind, + DocumentHyperlink, + DocumentFormula, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential +from sample_helper import save_json_to_file + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Demonstrate additional features on prebuilt-documentSearch +# --------------------------------------------------------------------------- +# This sample demonstrates additional features on prebuilt-documentSearch to show +# results for charts, hyperlinks, and PDF annotations from PDF documents. +# +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Read a PDF file from disk +# 3. Analyze the document using begin_analyze_binary with prebuilt-documentSearch +# 4. Extract and display chart information from figures +# 5. Extract and display annotation information +# 6. Extract and display hyperlink information +# 7. Extract and display formula information +# +# The prebuilt-documentSearch analyzer has the following additional features enabled: +# - enableFigureDescription: True - Enables figure descriptions +# - enableFigureAnalysis: True - Enables figure analysis including charts +# - chartFormat: 'chartjs' - Charts are represented as Chart.js config in the figure content +# - annotationFormat: 'markdown' - Enables annotation detection and represents annotations in markdown format +# - returnDetails: True - Returns detailed information including figures and annotations +# +# Note: The analyzer also has other features enabled (enableOcr, enableLayout, enableFormula, etc.) +# but this sample focuses on demonstrating charts, hyperlinks, and PDF annotations. +# +# Charts are accessed via: +# - document_content.figures - List of all figures (including charts) +# - Filter figures where figure.kind == DocumentFigureKind.CHART to get charts +# - Each DocumentChartFigure has a 'content' property containing Chart.js configuration +# - Charts are also embedded in the markdown content based on chartFormat setting +# +# Annotations are accessed via: +# - document_content.annotations - List of all annotations in the document +# - Each DocumentAnnotation has properties like kind, spans, comments, author, etc. +# - Annotations are also represented in the markdown content based on annotationFormat setting +# +# Hyperlinks are accessed via: +# - document_content.hyperlinks - List of all hyperlinks in the document +# - Each DocumentHyperlink has properties like content (link text), url, span, source +# - Hyperlinks are also represented in the markdown content as [text](url) format + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # Read the sample_document_features.pdf file + pdf_path = "sample_files/sample_document_features.pdf" + with open(pdf_path, "rb") as f: + pdf_bytes: bytes = f.read() + + print(f"Analyzing {pdf_path} with prebuilt-documentSearch...") + print("This sample demonstrates additional features: charts, hyperlinks, and PDF annotations.") + print() + + # Analyze the document using prebuilt-documentSearch + # The analyzer config includes: + # - enableFigureAnalysis: True (enables chart detection and analysis) + # - chartFormat: 'chartjs' (charts represented as Chart.js config) + # - annotationFormat: 'markdown' (enables annotation detection and represents annotations in markdown format) + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=pdf_bytes, + ) + result: AnalyzeResult = await poller.result() + + # Get the document content from the analysis result + content: MediaContent = result.contents[0] + + # Verify this is document content + if content.kind != MediaContentKind.DOCUMENT: + print("Error: Expected document content") + return + + # Type assertion: we know this is DocumentContent for PDF files + document_content: DocumentContent = content # type: ignore + + print("=" * 80) + print("DOCUMENT ANALYSIS RESULTS") + print("=" * 80) + print(f"Start page: {document_content.start_page_number}") + print(f"End page: {document_content.end_page_number}") + print(f"Total pages: {document_content.end_page_number - document_content.start_page_number + 1}") + print() + + # ===================================================================== + # PART 1: EXTRACT AND DISPLAY CHARTS + # ===================================================================== + # Charts are stored in document_content.figures + # We need to filter for figures where kind == DocumentFigureKind.CHART + # Each chart figure (DocumentChartFigure) contains: + # - id: Unique identifier for the chart + # - content: Chart.js configuration object (when chartFormat is 'chartjs') + # - description: AI-generated description of the chart + # - caption: Chart caption if present + # - span: Location of the chart in the markdown content + # - source: Position of the chart in the document + print("=" * 80) + print("CHARTS EXTRACTION") + print("=" * 80) + + if document_content.figures: + # Filter for chart figures + # Charts are a subtype of DocumentFigure with kind == DocumentFigureKind.CHART + # We can check the kind property or use isinstance with DocumentChartFigure + chart_figures = [ + figure for figure in document_content.figures + if isinstance(figure, DocumentChartFigure) or + (hasattr(figure, 'kind') and figure.kind == DocumentFigureKind.CHART) + ] + + print(f"Found {len(chart_figures)} chart(s) in the document") + print() + + for i, figure in enumerate(chart_figures, 1): + # Cast to DocumentChartFigure for type safety + chart: DocumentChartFigure = figure # type: ignore + + print(f"Chart {i}:") + print(f" ID: {chart.id}") + print(f" Source: {chart.source}") + + if chart.description: + print(f" Description: {chart.description}") + + if chart.caption: + print(f" Caption: {chart.caption.content}") + + if chart.span: + print(f" Location in markdown: offset={chart.span.offset}, length={chart.span.length}") + + # The chart content contains Chart.js configuration + # This is a JSON object that can be used with Chart.js library to render the chart + if chart.content: + print(f" Chart.js Config:") + print(f" {json.dumps(chart.content, indent=4, default=str)}") + + print() + else: + print("No figures found in the document") + print() + + # ===================================================================== + # PART 2: EXTRACT AND DISPLAY ANNOTATIONS + # ===================================================================== + # Annotations are stored in document_content.annotations + # Each annotation (DocumentAnnotation) contains: + # - id: Unique identifier for the annotation + # - kind: Type of annotation (highlight, strikethrough, underline, italic, bold, circle, note) + # - spans: List of content spans where the annotation appears + # - comments: List of comments associated with the annotation + # - author: Author of the annotation + # - created_at: When the annotation was created + # - tags: Tags associated with the annotation + print("=" * 80) + print("ANNOTATIONS EXTRACTION") + print("=" * 80) + + if document_content.annotations: + print(f"Found {len(document_content.annotations)} annotation(s) in the document") + print() + + for i, annotation in enumerate(document_content.annotations, 1): + print(f"Annotation {i}:") + print(f" ID: {annotation.id}") + print(f" Kind: {annotation.kind}") + + if annotation.spans: + print(f" Spans ({len(annotation.spans)}):") + for span in annotation.spans: + print(f" - offset={span.offset}, length={span.length}") + + if annotation.comments: + print(f" Comments ({len(annotation.comments)}):") + for comment in annotation.comments: + print(f" - {comment.message}") + + if annotation.author: + print(f" Author: {annotation.author}") + + if annotation.created_at: + print(f" Created at: {annotation.created_at}") + + if annotation.tags: + print(f" Tags: {annotation.tags}") + + if annotation.source: + print(f" Source: {annotation.source}") + + print() + else: + print("No annotations found in the document") + print() + + # ===================================================================== + # PART 3: EXTRACT AND DISPLAY HYPERLINKS + # ===================================================================== + # Hyperlinks are stored in document_content.hyperlinks + # Each hyperlink (DocumentHyperlink) contains: + # - content: The text/content that is hyperlinked + # - url: The URL of the hyperlink + # - span: Location of the hyperlink in the markdown content + # - source: Position of the hyperlink in the document + print("=" * 80) + print("HYPERLINKS EXTRACTION") + print("=" * 80) + + if document_content.hyperlinks: + print(f"Found {len(document_content.hyperlinks)} hyperlink(s) in the document") + print() + + for i, hyperlink in enumerate(document_content.hyperlinks, 1): + print(f"Hyperlink {i}:") + print(f" Content: {hyperlink.content}") + print(f" URL: {hyperlink.url}") + + if hyperlink.span: + print(f" Location in markdown: offset={hyperlink.span.offset}, length={hyperlink.span.length}") + + if hyperlink.source: + print(f" Source: {hyperlink.source}") + + print() + else: + print("No hyperlinks found in the document") + print() + + # ===================================================================== + # PART 4: EXTRACT AND DISPLAY FORMULAS + # ===================================================================== + # Formulas are stored in document_content.pages[].formulas (per page) + # Each formula (DocumentFormula) contains: + # - kind: Type of formula (inline or display) + # - value: The LaTeX representation of the formula (may contain extra spaces) + # - span: Location of the formula in the markdown content + # - source: Position of the formula in the document + # - confidence: Confidence of predicting the formula + # + # Note: The LaTeX value extracted from PDFs may have extra spaces between + # commands and arguments (e.g., "\frac { 1 } { n }" instead of "\frac{1}{n}"). + # While this will still render correctly in most LaTeX processors, you may + # want to clean it up for production use by removing extra spaces. + print("=" * 80) + print("FORMULAS EXTRACTION") + print("=" * 80) + + # Collect all formulas from all pages + all_formulas = [] + if document_content.pages: + for page in document_content.pages: + if page.formulas: + all_formulas.extend(page.formulas) + + if all_formulas: + print(f"Found {len(all_formulas)} formula(s) in the document") + print() + print("Note: LaTeX values may contain extra spaces (e.g., '\\frac { 1 } { n }').") + print(" This is expected from PDF extraction and will still render correctly.") + print() + + for i, formula in enumerate(all_formulas, 1): + print(f"Formula {i}:") + print(f" Kind: {formula.kind}") + print(f" LaTeX: {formula.value}") + + if formula.confidence: + print(f" Confidence: {formula.confidence}") + + if formula.span: + print(f" Location in markdown: offset={formula.span.offset}, length={formula.span.length}") + + if formula.source: + print(f" Source: {formula.source}") + + print() + else: + print("No formulas found in the document") + print() + + # ===================================================================== + # PART 5: MARKDOWN CONTENT + # ===================================================================== + # The markdown content is also available in the result and contains embedded + # representations of charts, annotations, hyperlinks, and formulas: + # - Charts appear in markdown using image syntax: ![chart data](path "description") + # - Annotations appear as markdown formatting (e.g., ==highlighted text== for highlights) + # - Hyperlinks appear as [text](url) format + # - Formulas appear as LaTeX syntax: $formula$ for inline, $$formula$$ for display + # + # To see how to extract and display markdown content, see the analyze_binary.py sample. + # The markdown can be accessed via: content.markdown or document_content.markdown + print("=" * 80) + print("MARKDOWN CONTENT") + print("=" * 80) + print("Note: Markdown content is available in the result and contains embedded") + print("representations of charts, annotations, and hyperlinks.") + print("See analyze_binary.py for how to extract and display markdown content.") + print("=" * 80) + print() + + # ===================================================================== + # PART 6: DUMP ANALYZE RESULT AS JSON + # ===================================================================== + # Save the full AnalyzeResult as JSON for inspection + # This includes all the data structures: contents, figures, annotations, etc. + print() + print("=" * 80) + print("SAVING ANALYZE RESULT AS JSON") + print("=" * 80) + # Convert the result to a dictionary and save as JSON + # This saves the object model, not the raw JSON response + result_dict = result.as_dict() + save_json_to_file(result_dict, filename_prefix="analyze_binary_features") + print("=" * 80) + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_document_features.pdf b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/sample_document_features.pdf new file mode 100755 index 0000000000000000000000000000000000000000..9f47030c0377bbafc658abd2fd2ecac8b0dc736a GIT binary patch literal 152348 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%0AlGTjAu6LLhTY zD6ibupiBt2PY6z%g(%o19qvus2?@fP5yP5<*{GK=<$AdhS%f4lD=LjOP8^8>2-@PP z*DJE0Ib^-$YVJXo`r)0zotoL>$;ejEqvyR4cc5gzc?`MWDmtl!#6&g2=#}XW=Dows z_i7Ln2O9KkJJ`zlfj6IMUhD!4Z-lX4WfJ09SO1KB3bni!s iSkI3XF`Y7$Cx0^De@qd30d#;38G(XAR9*}j;eP=+ubN~4 literal 0 HcmV?d00001 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py index 1cc2a3dd6e5c..19ff5a7ec6a1 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py @@ -24,7 +24,7 @@ def save_json_to_file(data: dict[str, Any], filename_prefix: str = "result") -> :rtype: str """ # Create output directory if it doesn't exist - output_dir = Path(__file__).parent / "output" + output_dir = Path(__file__).parent / "sample_output" output_dir.mkdir(exist_ok=True) # Generate filename with timestamp From b2746a4d7209723023076bee11587102bcd18afd Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 22:34:24 +0000 Subject: [PATCH 010/105] SAMPLE: Migrate samples --- .../samples/README.md | 2 +- .../samples/analyze_binary_raw_json.py | 105 +++++++++ .../samples/analyze_category.py | 206 +++++++++++++++++ .../analyze_category_enable_segments.py | 207 ++++++++++++++++++ .../samples/create_analyzer.py | 143 ++++++++++++ .../samples/delete_analyzer.py | 102 +++++++++ .../samples/get_analyzer.py | 144 ++++++++++++ .../samples/list_analyzers.py | 114 ++++++++++ .../samples/update_analyzer.py | 161 ++++++++++++++ 9 files changed, 1183 insertions(+), 1 deletion(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_raw_json.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/list_analyzers.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index 8078981e348b..ad4b8126af76 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -169,7 +169,7 @@ Creates a custom analyzer with content categories for document classification an ### Custom Analyzer Management -#### `create_or_replace.py` +#### `create_analyzer.py` Creates or replaces a custom analyzer with field schemas and analysis configuration. #### `get_analyzer.py` diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_raw_json.py new file mode 100644 index 000000000000..b8f84b860b9d --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_raw_json.py @@ -0,0 +1,105 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: use the prebuilt-documentSearch to extract content from a PDF and save raw JSON response. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python analyze_binary_raw_json.py +""" + +from __future__ import annotations + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import AnalyzeResult +from sample_helper import save_json_to_file +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Extract content from PDF using begin_analyze_binary API and save raw JSON +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Read a PDF file from disk +# 3. Analyze the document using begin_analyze_binary with prebuilt-documentSearch +# 4. Save the raw JSON response to a file using a customized callback in poller parameter +# +# prebuilt-documentSearch is an AI-enhanced analyzer that extends prebuilt-document with: +# - Document summarization: Returns a "Summary" field with AI-generated document summaries +# - Figure analysis: Extracts descriptions and analyzes figures in documents (enableFigureDescription, enableFigureAnalysis) +# - Enhanced output: Provides more detailed analysis results (returnDetails: true) +# - AI completion model: Uses gpt-4.1-mini for intelligent content extraction +# +# IMPORTANT NOTES: +# - The SDK returns analysis results with an object model, which is easier to navigate and retrieve +# the desired results compared to parsing raw JSON +# - This sample is ONLY for demonstration purposes to show how to access raw JSON responses +# - For production use, prefer the object model approach shown in: +# - analyze_binary.py +# - analyze_url.py + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + with open("sample_files/sample_invoice.pdf", "rb") as f: + pdf_bytes: bytes = f.read() + + print("Analyzing sample_files/sample_invoice.pdf with prebuilt-documentSearch...") + + # Use poller callback to save raw JSON response + # The 'cls' parameter allows us to intercept the response before it gets deserialized as an object model + # We return a tuple: (deserialized_object, raw_http_response) + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=pdf_bytes, + content_type="application/pdf", + cls=lambda pipeline_response, deserialized_obj, response_headers: ( + deserialized_obj, + pipeline_response.http_response, + ), + ) + + # Wait for completion and get both model and raw HTTP response + _, raw_http_response = await poller.result() + + # Save the raw JSON response + save_json_to_file(raw_http_response.json(), filename_prefix="analyze_binary_raw_json") # type: ignore[attr-defined] + # Note: For easier data access, see object model samples: + # analyze_binary.py + # analyze_url.py + + print("Analysis completed and raw JSON response saved!") + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py new file mode 100644 index 000000000000..ff5a847e4227 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py @@ -0,0 +1,206 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: Create a classifier to categorize financial documents without automatic page segmentation. + +This sample demonstrates how to: +1. Create a custom analyzer with content categories for document classification +2. Disable automatic page segmentation by category (enable_segment=False) +3. Classify documents into categories (Invoice, Bank Statement, Loan Application) +4. View classification results without automatic segmentation +5. Clean up resources + +The key difference from analyze_category_enable_segments.py is that enable_segment=False, +which means the analyzer will classify the entire document as a single unit without +automatically segmenting pages by category. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python analyze_category.py +""" + +from __future__ import annotations + +import asyncio +import json +import os +from datetime import datetime +from typing import cast + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeResult, + ContentAnalyzer, + ContentAnalyzerConfig, + ContentCategoryDefinition, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}\n") + + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + print("Environment Variables:") + print("=" * 50) + print(f"AZURE_CONTENT_UNDERSTANDING_ENDPOINT: {endpoint}") + print(f"AZURE_CONTENT_UNDERSTANDING_KEY: {'***' if key else '(not set, using DefaultAzureCredential)'}") + print("=" * 50) + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # Create a unique analyzer ID + analyzer_id = f"financial_doc_classifier_{int(asyncio.get_event_loop().time())}" + + print(f"\nCreating analyzer '{analyzer_id}'...") + print("Categories: Invoice, Bank Statement, Loan Application") + print("Note: enable_segment=False - document will be classified as a single unit\n") + + # Create an analyzer with content categories for document classification + # enable_segment=False disables automatic segmentation - entire document is classified as one unit + content_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + config=ContentAnalyzerConfig( + return_details=True, + content_categories={ + "Loan application": ContentCategoryDefinition( + description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." + ), + "Invoice": ContentCategoryDefinition( + description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." + ), + "Bank Statement": ContentCategoryDefinition( + description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." + ), + }, + enable_segment=False, # Disable automatic page segmentation by category + ), + description=f"Custom analyzer for financial document categorization without segmentation", + models={"completion": "gpt-4o"}, + tags={"demo_type": "category_classification_without_segmentation"}, + ) + + # Create the analyzer + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=content_analyzer, + ) + + print("Waiting for analyzer creation to complete...") + result = await poller.result() + print(f"✅ Analyzer '{analyzer_id}' created successfully!\n") + + if result.warnings: + print("⚠️ Warnings encountered while building the analyzer:") + for warning in result.warnings: + print(f" - {warning}") + print() + + # Test files to classify + # Note: With enable_segment=False, each document will be classified as a single unit. + # Even mixed_financial_docs.pdf (which contains multiple document types) will be + # classified as one category covering all pages, not segmented by page content. + test_files = [ + "sample_invoice.pdf", + "sample_bank_statement.pdf", + "mixed_financial_docs.pdf", # Will be classified as a unit, not segmented + ] + + samples_dir = os.path.dirname(__file__) + output_dir = os.path.join(samples_dir, "sample_output") + os.makedirs(output_dir, exist_ok=True) + + # Classify each document + for test_file in test_files: + test_file_path = os.path.join(samples_dir, "sample_files", test_file) + + if not os.path.exists(test_file_path): + print(f"⚠️ Skipping {test_file} - file not found") + continue + + print(f"{'=' * 60}") + print(f"📄 Analyzing: {test_file}") + print(f"{'=' * 60}") + + # Read and analyze the document + with open(test_file_path, "rb") as f: + pdf_bytes = f.read() + + analyze_poller = await client.begin_analyze_binary( + analyzer_id=analyzer_id, + binary_input=pdf_bytes, + content_type="application/pdf", + ) + + analyze_result: AnalyzeResult = await analyze_poller.result() + print("✅ Classification completed!\n") + + # Display classification results + print("📊 Classification Results:") + print("-" * 60) + + for content in analyze_result.contents: + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = cast(DocumentContent, content) + + # When enable_segment=False, the document is classified as a single unit + # Display the page range for the entire document + print(f"\nPages: {document_content.start_page_number}-{document_content.end_page_number}") + + # Note: segments may still exist but won't be automatically created by category + if document_content.segments: + print(f"\nFound {len(document_content.segments)} segment(s):") + for i, segment in enumerate(document_content.segments, 1): + print(f" Segment {i}:") + print(f" Category: {segment.category}") + print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + print(f" Segment ID: {segment.segment_id}") + + print() + + # Save results to JSON file + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + result_filename = f"analyze_category_{test_file.replace('.pdf', '')}_{timestamp}.json" + result_file = os.path.join(output_dir, result_filename) + + with open(result_file, "w") as f: + json.dump(analyze_result.as_dict(), f, indent=2, default=str) + + print(f"💾 Results saved to: {result_file}\n") + + # Cleanup + print(f"{'=' * 60}") + print(f"🗑️ Deleting analyzer '{analyzer_id}' (demo cleanup)...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"✅ Analyzer '{analyzer_id}' deleted successfully!") + print(f"{'=' * 60}") + + # Close DefaultAzureCredential if used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py new file mode 100644 index 000000000000..76b9224bcf12 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py @@ -0,0 +1,207 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: Create a classifier to categorize financial documents with automatic page segmentation. + +This sample demonstrates how to: +1. Create a custom analyzer with content categories for document classification +2. Enable automatic page segmentation by category (enable_segment=True) +3. Classify documents into categories (Invoice, Bank Statement, Loan Application) +4. View classification results with automatic segmentation - pages are automatically grouped by category +5. Clean up resources + +The key feature of this sample is the enable_segment=True option, which allows the analyzer to +automatically segment multi-page documents by their category. For example, if a document contains +both an invoice and a bank statement, each will be identified as separate segments with their +respective categories and page ranges. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python analyze_category_enable_segments.py +""" + +from __future__ import annotations + +import asyncio +import json +import os +from datetime import datetime +from typing import cast + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeResult, + ContentAnalyzer, + ContentAnalyzerConfig, + ContentCategoryDefinition, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}\n") + + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + print("Environment Variables:") + print("=" * 50) + print(f"AZURE_CONTENT_UNDERSTANDING_ENDPOINT: {endpoint}") + print(f"AZURE_CONTENT_UNDERSTANDING_KEY: {'***' if key else '(not set, using DefaultAzureCredential)'}") + print("=" * 50) + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # Create a unique analyzer ID + analyzer_id = f"financial_doc_classifier_{int(asyncio.get_event_loop().time())}" + + print(f"\nCreating analyzer '{analyzer_id}'...") + print("Categories: Invoice, Bank Statement, Loan Application") + print("Note: enable_segment=True allows automatic page segmentation by category\n") + + # Create an analyzer with content categories for document classification + # enable_segment=True enables automatic segmentation of pages by their category + content_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + config=ContentAnalyzerConfig( + return_details=True, + content_categories={ + "Loan application": ContentCategoryDefinition( + description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." + ), + "Invoice": ContentCategoryDefinition( + description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." + ), + "Bank Statement": ContentCategoryDefinition( + description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." + ), + }, + enable_segment=True, # Enable automatic page segmentation by category + ), + description=f"Custom analyzer for financial document categorization with automatic segmentation", + models={"completion": "gpt-4o"}, + tags={"demo_type": "category_classification_with_segmentation"}, + ) + + # Create the analyzer + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=content_analyzer, + ) + + print("Waiting for analyzer creation to complete...") + result = await poller.result() + print(f"✅ Analyzer '{analyzer_id}' created successfully!\n") + + if result.warnings: + print("⚠️ Warnings encountered while building the analyzer:") + for warning in result.warnings: + print(f" - {warning}") + print() + + # Test files to classify + # Note: With enable_segment=True, documents will be automatically segmented by category. + # mixed_financial_docs.pdf contains multiple document types (invoice, bank statement, etc.) + # and will be automatically split into separate segments based on content category. + test_files = [ + "sample_invoice.pdf", # Single category + "sample_bank_statement.pdf", # Single category + "mixed_financial_docs.pdf", # Will be auto-segmented into multiple categories + ] + + samples_dir = os.path.dirname(__file__) + output_dir = os.path.join(samples_dir, "sample_output") + os.makedirs(output_dir, exist_ok=True) + + # Classify each document + for test_file in test_files: + test_file_path = os.path.join(samples_dir, "sample_files", test_file) + + if not os.path.exists(test_file_path): + print(f"⚠️ Skipping {test_file} - file not found") + continue + + print(f"{'=' * 60}") + print(f"📄 Analyzing: {test_file}") + print(f"{'=' * 60}") + + # Read and analyze the document + with open(test_file_path, "rb") as f: + pdf_bytes = f.read() + + analyze_poller = await client.begin_analyze_binary( + analyzer_id=analyzer_id, + binary_input=pdf_bytes, + content_type="application/pdf", + ) + + analyze_result: AnalyzeResult = await analyze_poller.result() + print("✅ Classification completed!\n") + + # Display classification results + print("📊 Classification Results (with automatic segmentation):") + print("-" * 60) + + for content in analyze_result.contents: + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = cast(DocumentContent, content) + + # Display segments with their categories + # When enable_segment=True, pages are automatically grouped by category + if document_content.segments: + print(f"\nFound {len(document_content.segments)} segment(s):") + for i, segment in enumerate(document_content.segments, 1): + print(f"\n Segment {i}:") + print(f" Category: {segment.category}") + print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + print(f" Segment ID: {segment.segment_id}") + else: + # Fallback if no segments (shouldn't happen with enable_segment=True) + print(f"\n⚠️ No segments found for this document") + print(f" Pages: {document_content.start_page_number}-{document_content.end_page_number}") + + print() + + # Save results to JSON file + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + result_filename = f"analyze_category_segments_{test_file.replace('.pdf', '')}_{timestamp}.json" + result_file = os.path.join(output_dir, result_filename) + + with open(result_file, "w") as f: + json.dump(analyze_result.as_dict(), f, indent=2, default=str) + + print(f"💾 Results saved to: {result_file}\n") + + # Cleanup + print(f"{'=' * 60}") + print(f"🗑️ Deleting analyzer '{analyzer_id}' (demo cleanup)...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"✅ Analyzer '{analyzer_id}' deleted successfully!") + print(f"{'=' * 60}") + + # Close DefaultAzureCredential if used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py new file mode 100644 index 000000000000..1b23ab195753 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py @@ -0,0 +1,143 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: create a custom analyzer using begin_create_analyzer API. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python create_analyzer.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Create custom analyzer using begin_create_analyzer API +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Create a custom analyzer with field schema using object model +# 3. Wait for analyzer creation to complete +# 4. Save the analyzer definition to a JSON file + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + analyzer_id = f"sdk_sample_custom_analyzer_{int(asyncio.get_event_loop().time())}" + + # Create a custom analyzer using object model + custom_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom analyzer for extracting company information", + config=ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + field_schema=ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + # EXTRACT: Extract information directly from document content + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + # GENERATE: AI generates content based on document understanding + "document_summary": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="A concise summary of the document's main content", + ), + "key_insights": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="Key business insights or actionable items from the document", + ), + # CLASSIFY: Categorize the document or content + "document_category": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.CLASSIFY, + description="Category of the document", + enum=["invoice", "contract", "receipt", "report", "other"], + ), + "urgency_level": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.CLASSIFY, + description="Urgency level of the document", + enum=["high", "medium", "low"], + ), + }, + ), + models={"completion": "gpt-4o"}, # Required when using field_schema + ) + + print(f"Creating custom analyzer '{analyzer_id}'...") + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=custom_analyzer, + ) + result = await poller.result() + print(f"Analyzer '{analyzer_id}' created successfully!") + + # Clean up the created analyzer (demo cleanup) + print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully!") + + # Next steps: + # - To retrieve the analyzer: see get_analyzer.py + # - To use the analyzer for analysis: see analyze_binary.py + # - To delete the analyzer: see delete_analyzer.py + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py new file mode 100644 index 000000000000..a3b269f30140 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py @@ -0,0 +1,102 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: delete a custom analyzer using the delete API. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python delete_analyzer.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Delete custom analyzer using delete API +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Create a custom analyzer (for deletion demo) +# 3. Delete the analyzer using the delete API +# 4. Verify the analyzer is no longer available + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + analyzer_id = f"sdk_sample_analyzer_to_delete_{int(asyncio.get_event_loop().time())}" + + # First, create an analyzer to delete (for demo purposes) + print(f"Creating analyzer '{analyzer_id}' for deletion demo...") + custom_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Temporary analyzer for deletion demo", + config=ContentAnalyzerConfig(return_details=True), + field_schema=ContentFieldSchema( + name="demo_schema", + description="Schema for deletion demo", + fields={ + "demo_field": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Demo field for deletion", + ), + }, + ), + models={"completion": "gpt-4o"}, # Required when using field_schema + ) + + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=custom_analyzer, + ) + await poller.result() + print(f"Analyzer '{analyzer_id}' created successfully!") + + # Now delete the analyzer + print(f"Deleting analyzer '{analyzer_id}'...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully!") + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py new file mode 100644 index 000000000000..7773d9ba2145 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py @@ -0,0 +1,144 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: retrieve an analyzer using the get API. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python get_analyzer.py +""" + +from __future__ import annotations +import asyncio +import json +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Retrieve analyzer using get API +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Retrieve a prebuilt analyzer and dump it as JSON +# 3. Create a custom analyzer +# 4. Retrieve the custom analyzer using the get API +# 5. Display analyzer details and dump as JSON +# 6. Clean up by deleting the analyzer (demo purposes) + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # First, retrieve and dump the prebuilt-document analyzer + print("Retrieving prebuilt-document analyzer...") + prebuilt_analyzer: ContentAnalyzer = await client.get_analyzer(analyzer_id="prebuilt-documentSearch") + print("Prebuilt-document analyzer retrieved successfully!") + + # Dump prebuilt analyzer as JSON + print("\n" + "=" * 80) + print("Dump ContentAnalyzer object for prebuilt-document") + print("=" * 80) + prebuilt_json = json.dumps(prebuilt_analyzer.as_dict(), indent=2, default=str) + print(prebuilt_json) + print("=" * 80 + "\n") + + # Now create a custom analyzer for piano student registration form processing + analyzer_id = f"piano_student_registration_{int(asyncio.get_event_loop().time())}" + print(f"Creating custom analyzer '{analyzer_id}' for piano student registration form processing...") + custom_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom analyzer for processing piano student registration forms", + config=ContentAnalyzerConfig(return_details=True), + field_schema=ContentFieldSchema( + name="piano_student_registration_schema", + description="Schema for extracting and analyzing piano student registration form data", + fields={ + "student_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="The full name of the student registering for piano lessons", + ), + "years_of_playing": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="Number of years the student has been playing piano, inferred from experience level or dates mentioned", + ), + "learning_goals_summary": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="A concise summary of the student's learning goals and musical aspirations", + ), + }, + ), + models={"completion": "gpt-4o"}, # Required when using field_schema + ) + + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=custom_analyzer, + ) + await poller.result() + print(f"Custom analyzer '{analyzer_id}' created successfully!") + + # Now retrieve the custom analyzer + print(f"\nRetrieving custom analyzer '{analyzer_id}'...") + retrieved_analyzer: ContentAnalyzer = await client.get_analyzer(analyzer_id=analyzer_id) + print(f"Custom analyzer '{analyzer_id}' retrieved successfully!") + print(f" Description: {retrieved_analyzer.description}") + print(f" Status: {retrieved_analyzer.status}") + print(f" Created at: {retrieved_analyzer.created_at}") + + # Dump custom analyzer as JSON + print("\n" + "=" * 80) + print(f"Dump ContentAnalyzer object for {analyzer_id}") + print("=" * 80) + custom_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) + print(custom_json) + print("=" * 80 + "\n") + + # Clean up: delete the analyzer (demo purposes only) + # Note: You can leave the analyzer for later use if desired + print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully!") + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/list_analyzers.py new file mode 100644 index 000000000000..d3b08dc1aa58 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/list_analyzers.py @@ -0,0 +1,114 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- + +import asyncio +import os + +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient + +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +from dotenv import load_dotenv + +load_dotenv() + +""" +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python list_analyzers.py +""" + + +async def main(): + """ + List all available analyzers using list API. + + High-level steps: + 1. Connect to Azure AI Content Understanding + 2. List all available analyzers + 3. Display detailed information about each analyzer + 4. Show summary statistics + """ + endpoint = os.getenv("AZURE_CONTENT_UNDERSTANDING_ENDPOINT") or "" + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + print(f"Listing all available analyzers...") + + # List all analyzers + response = client.list_analyzers() + analyzers = [analyzer async for analyzer in response] + + print(f"Found {len(analyzers)} analyzers") + print() + + # Display detailed information about each analyzer + for i, analyzer in enumerate(analyzers, 1): + print(f"Analyzer {i}:") + print(f" ID: {analyzer.analyzer_id}") + print(f" Description: {analyzer.description}") + print(f" Status: {analyzer.status}") + print(f" Created at: {analyzer.created_at}") + + # Check if it's a prebuilt analyzer + if analyzer.analyzer_id.startswith("prebuilt-"): + print(f" Type: Prebuilt analyzer") + else: + print(f" Type: Custom analyzer") + + # Show tags if available + if hasattr(analyzer, "tags") and analyzer.tags: + print(f" Tags: {analyzer.tags}") + + # Get full analyzer details including config using get API + try: + full_analyzer = await client.get_analyzer(analyzer_id=analyzer.analyzer_id) + if full_analyzer.config: + print(f" Config: {full_analyzer.config}") + if full_analyzer.base_analyzer_id: + print(f" Base analyzer ID: {full_analyzer.base_analyzer_id}") + if full_analyzer.field_schema: + print(f" Field schema: {full_analyzer.field_schema.name if hasattr(full_analyzer.field_schema, 'name') else 'Available'}") + if hasattr(full_analyzer.field_schema, 'fields') and full_analyzer.field_schema.fields: + print(f" Number of fields: {len(full_analyzer.field_schema.fields)}") + if full_analyzer.models: + print(f" Models: {full_analyzer.models}") + except Exception as e: + print(f" Error getting analyzer details: {e}") + + print() + + # Check for specific prebuilt analyzers + prebuilt_ids = [analyzer.analyzer_id for analyzer in analyzers if analyzer.analyzer_id.startswith("prebuilt-")] + if "prebuilt-document" in prebuilt_ids: + print(f" prebuilt-document is available") + if "prebuilt-videoSearch" in prebuilt_ids: + print(f" prebuilt-videoSearch is available") + + # x-ms-original-file: 2025-11-01/ContentAnalyzers_List.json + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py new file mode 100644 index 000000000000..80bc1f12d32f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py @@ -0,0 +1,161 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- + +import asyncio +import os + +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, + ProcessingLocation, +) + +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +from dotenv import load_dotenv + +load_dotenv() + +""" +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python update_analyzer.py +""" + + +async def main(): + """ + Update analyzer using update API. + + High-level steps: + 1. Create an initial analyzer + 2. Get the analyzer to verify initial state + 3. Update the analyzer with new description and tags + 4. Get the analyzer again to verify changes persisted + 5. Clean up the created analyzer + """ + endpoint = os.getenv("AZURE_CONTENT_UNDERSTANDING_ENDPOINT") or "" + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + analyzer_id = f"sdk_sample_analyzer_for_update_{int(asyncio.get_event_loop().time())}" + + # Create initial analyzer using object model + print(f"Creating initial analyzer '{analyzer_id}'...") + + initial_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + config=ContentAnalyzerConfig( + enable_formula=True, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + description=f"Initial description", + field_schema=ContentFieldSchema( + fields={ + "total_amount": ContentFieldDefinition( + description="Total amount of this document", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.NUMBER, + ), + "company_name": ContentFieldDefinition( + description="Name of the company", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.STRING, + ), + }, + description="Schema for update demo", + name="update_demo_schema", + ), + models={"completion": "gpt-4o"}, # Required when using field_schema + processing_location=ProcessingLocation.GLOBAL, + tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, + ) + + # Start the analyzer creation operation + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=initial_analyzer, + ) + + # Wait for the analyzer to be created + print(f"Waiting for analyzer creation to complete...") + await poller.result() + print(f"Analyzer '{analyzer_id}' created successfully!") + + # Get the analyzer before update to verify initial state + print(f" Getting analyzer '{analyzer_id}' before update...") + analyzer_before_update = await client.get_analyzer(analyzer_id=analyzer_id) + + print(f"Initial analyzer state verified:") + print(f" Description: {analyzer_before_update.description}") + print(f" Tags: {analyzer_before_update.tags}") + + # Create updated analyzer with only allowed properties (description and tags) + print(f"Creating updated analyzer configuration...") + # Update the value for tag1, remove tag2 by setting it to an empty string, and add tag3 + updated_analyzer = ContentAnalyzer( + # Note: Service requires baseAnalyzerId and models even in PATCH update + # This is a service bug - TypeSpec says they should not be required in Update + base_analyzer_id=analyzer_before_update.base_analyzer_id, # <== SERVICE-FIX: Service will return error without this + models=analyzer_before_update.models, # <== SERVICE-FIX: Service will return error without this + description=f"Updated description", + tags={"tag1": "tag1_updated_value", "tag2": "", "tag3": "tag3_value"}, + ) + + # Update the analyzer + print(f"Updating analyzer '{analyzer_id}' with new description and tags...") + response = await client.update_analyzer( + analyzer_id=analyzer_id, + resource=updated_analyzer, + ) + + print(f"Analyzer updated successfully!") + + # Get the analyzer after update to verify the changes persisted + print(f" Getting analyzer '{analyzer_id}' after update...") + analyzer_after_update = await client.get_analyzer(analyzer_id=analyzer_id) + + print(f"Updated analyzer state verified:") + print(f" Description: {analyzer_after_update.description}") + print(f" Tags: {analyzer_after_update.tags}") + + # Clean up the created analyzer (demo cleanup) + print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully!") + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +# x-ms-original-file: 2025-11-01/ContentAnalyzers_Update.json +if __name__ == "__main__": + asyncio.run(main()) From 17eb5e6eee36ef9c248f22be02c7d7c3fafdbcbe Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 22:36:15 +0000 Subject: [PATCH 011/105] PATCH: ContentField*.value --- .../contentunderstanding/models/__init__.py | 44 ++++++++++++++++++- .../ai/contentunderstanding/models/_patch.py | 35 +++++---------- 2 files changed, 55 insertions(+), 24 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py index 15b346e544bc..cc6c3d11c00c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py @@ -7,10 +7,52 @@ # -------------------------------------------------------------------------- # pylint: disable=wrong-import-position -from typing import TYPE_CHECKING +from typing import TYPE_CHECKING, Optional, Any, List, Dict, Union if TYPE_CHECKING: from ._patch import * # pylint: disable=unused-wildcard-import + + # Type stubs for .value property on field classes + # These override the imported classes during type checking to add .value property signatures + class ContentField(ContentField): # type: ignore[no-redef] + @property + def value(self) -> Union[Optional[str], Optional[int], Optional[float], Optional[bool], Optional[List[Any]], Optional[Dict[str, Any]], Optional[Any]]: ... + + class StringField(StringField): # type: ignore[no-redef] + @property + def value(self) -> Optional[str]: ... + + class IntegerField(IntegerField): # type: ignore[no-redef] + @property + def value(self) -> Optional[int]: ... + + class NumberField(NumberField): # type: ignore[no-redef] + @property + def value(self) -> Optional[float]: ... + + class BooleanField(BooleanField): # type: ignore[no-redef] + @property + def value(self) -> Optional[bool]: ... + + class DateField(DateField): # type: ignore[no-redef] + @property + def value(self) -> Optional[str]: ... + + class TimeField(TimeField): # type: ignore[no-redef] + @property + def value(self) -> Optional[str]: ... + + class ArrayField(ArrayField): # type: ignore[no-redef] + @property + def value(self) -> Optional[List[ContentField]]: ... + + class ObjectField(ObjectField): # type: ignore[no-redef] + @property + def value(self) -> Optional[Dict[str, ContentField]]: ... + + class JsonField(JsonField): # type: ignore[no-redef] + @property + def value(self) -> Optional[Any]: ... from ._models import ( # type: ignore diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index 72451ccdb4eb..0688f9193388 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -25,28 +25,6 @@ PollingReturnType_co = TypeVar("PollingReturnType_co", covariant=True) -# Type stub to help mypy and pyright understand that ContentField has a .value property -if TYPE_CHECKING: - - class ContentFieldTypeStub: - """Type stub for ContentField to help type checkers understand the .value property.""" - - @property - def value( - self, - ) -> Union[ - Optional[str], - Optional[float], - Optional[int], - Optional[bool], - Optional[Any], - Optional[List[Any]], - Optional[dict[str, Any]], - ]: - """Get the value of this field regardless of its type.""" - ... # pylint: disable=unnecessary-ellipsis - - __all__ = [ "RecordMergePatchUpdate", "AnalyzeLROPoller", @@ -147,7 +125,6 @@ def patch_sdk(): from . import _models # Add RecordMergePatchUpdate as an alias - # (AnalyzeInput is now generated in _models.py, so we don\'t need to add it) _models.RecordMergePatchUpdate = RecordMergePatchUpdate # type: ignore[attr-defined] # Add .value property to all ContentField subclasses for easier access @@ -161,3 +138,15 @@ def patch_sdk(): _add_value_property_to_field(ArrayField, "value_array") _add_value_property_to_field(ObjectField, "value_object") _add_value_property_to_field(JsonField, "value_json") + + # Add dynamic .value to ContentField base class + # This checks which value_* attribute exists and returns it + def _content_field_value_getter(self) -> Any: + """Get the value of this field regardless of its specific type.""" + for attr in ['value_string', 'value_integer', 'value_number', 'value_boolean', + 'value_date', 'value_time', 'value_array', 'value_object', 'value_json']: + if hasattr(self, attr): + return getattr(self, attr) + return None + + setattr(ContentField, "value", property(_content_field_value_getter)) From 7ec95d0ca593beb537c8a3398b8a458e794301f6 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 22:52:22 +0000 Subject: [PATCH 012/105] SERVICE-FIX: patch for KeyFrameTImesMs --- .../azure/ai/contentunderstanding/models/_models.py | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py index 940a0a4d32df..c745388db82d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py @@ -402,6 +402,14 @@ def __init__(self, mapping: Mapping[str, Any]) -> None: """ def __init__(self, *args: Any, **kwargs: Any) -> None: + # Workaround for service bug: keyFrameTimesMs is returned as KeyFrameTimesMs + # Fix the incorrect casing before calling parent __init__ + if args and isinstance(args[0], Mapping): + mapping = dict(args[0]) + if "KeyFrameTimesMs" in mapping and "keyFrameTimesMs" not in mapping: + mapping["keyFrameTimesMs"] = mapping.pop("KeyFrameTimesMs") + args = (mapping,) + args[1:] + super().__init__(*args, **kwargs) self.kind = MediaContentKind.AUDIO_VISUAL # type: ignore From e5aef5ee1ad94a94d975db9c10742738d1dec87e Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 22:52:38 +0000 Subject: [PATCH 013/105] SAMPLE: Add get_result_file.py to demonstrate video analysis and keyframe extraction - Introduced `get_result_file.py` to showcase the process of analyzing a video file, extracting keyframes, and saving them as images. - Included environment setup instructions and prerequisites for running the sample. - Implemented functionality to create a marketing video analyzer and handle keyframe image downloads. --- .../samples/get_result_file.py | 266 ++++++++++++++++++ 1 file changed, 266 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py new file mode 100644 index 000000000000..61040cb71096 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py @@ -0,0 +1,266 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- + +import asyncio +import os +from datetime import datetime +import uuid +from collections.abc import AsyncIterator + +from typing import Any, Optional + +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, + ProcessingLocation, + AudioVisualContent, +) + +from sample_helper import ( + save_json_to_file, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +from dotenv import load_dotenv + +load_dotenv() + +""" +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python get_result_file.py +""" + + +def save_keyframe_image_to_file( + image_content: bytes, + keyframe_id: str, + test_name: str, + test_py_file_dir: str, + identifier: Optional[str] = None, + output_dir: str = "sample_output", +) -> str: + """Save keyframe image to output file using pytest naming convention. + + Args: + image_content: The binary image content to save + keyframe_id: The keyframe ID (e.g., "keyframes/733") + test_name: Name of the test case (e.g., function name) + test_py_file_dir: Directory where pytest files are located + identifier: Optional unique identifier to avoid conflicts (e.g., analyzer_id) + output_dir: Directory name to save the output file (default: "sample_output") + + Returns: + str: Path to the saved image file + + Raises: + OSError: If there are issues creating directory or writing file + """ + # Generate timestamp and frame ID + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + # Extract the frame time from the keyframe path (e.g., "keyframes/733" -> "733") + if "/" in keyframe_id: + frame_id = keyframe_id.split("/")[-1] + else: + # Fallback: use as-is if no slash found + frame_id = keyframe_id + + # Create output directory if it doesn't exist + output_dir_path = os.path.join(test_py_file_dir, output_dir) + os.makedirs(output_dir_path, exist_ok=True) + + # Generate output filename with optional identifier to avoid conflicts + if identifier: + output_filename = f"{test_name}_{identifier}_{timestamp}_{frame_id}.jpg" + else: + output_filename = f"{test_name}_{timestamp}_{frame_id}.jpg" + + saved_file_path = os.path.join(output_dir_path, output_filename) + + # Write the image content to file + with open(saved_file_path, "wb") as image_file: + image_file.write(image_content) + + print(f"Image file saved to: {saved_file_path}") + return saved_file_path + + +async def main(): + """ + Get result files using get_result_file API. + + High-level steps: + 1. Create a marketing video analyzer + 2. Analyze a video file to generate keyframes + 3. Extract operation ID from the analysis + 4. Get result files (keyframe images) using the operation ID + 5. Save the keyframe images to local files + 6. Clean up the created analyzer + """ + endpoint = os.getenv("AZURE_CONTENT_UNDERSTANDING_ENDPOINT") or "" + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + analyzer_id = f"sdk_sample_video_{datetime.now().strftime('%Y%m%d')}_{datetime.now().strftime('%H%M%S')}_{uuid.uuid4().hex[:8]}" + + # Create a marketing video analyzer using object model + print(f"Creating marketing video analyzer '{analyzer_id}'...") + + video_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-video", + config=ContentAnalyzerConfig( + return_details=True, + ), + models={"completion": "gpt-4o"}, # Required when using field_schema + description="Marketing video analyzer for result file demo", + tags={"demo_type": "video_analysis"}, + ) + + # Start the analyzer creation operation + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=video_analyzer, + ) + + # Wait for the analyzer to be created + print(f"Waiting for analyzer creation to complete...") + await poller.result() + print(f"Analyzer '{analyzer_id}' created successfully!") + + # Use the FlightSimulator.mp4 video file from remote location + video_file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/videos/sdk_samples/FlightSimulator.mp4" + print(f"Using video file from URL: {video_file_url}") + + # Begin video analysis operation + print(f"Starting video analysis with analyzer '{analyzer_id}'...") + analysis_poller = await client.begin_analyze(analyzer_id=analyzer_id, inputs=[AnalyzeInput(url=video_file_url)]) + + # Wait for analysis completion + print(f"Waiting for video analysis to complete...") + analysis_result = await analysis_poller.result() + print(f"Video analysis completed successfully!") + + # Save the full analysis result to JSON for detailed inspection + save_json_to_file( + analysis_result.as_dict(), + filename_prefix="get_result_file", + ) + print("Analysis result saved to JSON file for detailed inspection") + + # Extract operation ID for get_result_file using the poller's details property + analysis_operation_id = analysis_poller.operation_id + print(f"Extracted analysis operation ID: {analysis_operation_id}") + + # Use the analysis result we already have from the poller to see what files are available + print(f"Using analysis result to find available files...") + operation_result: Any = analysis_result + if operation_result is None: + print("No analysis result available") + return + print(f"Analysis result contains {len(operation_result.contents)} contents") + + # Look for keyframe times in the analysis result + keyframe_times_ms: list[int] = [] + for content in operation_result.contents: + if isinstance(content, AudioVisualContent): + video_content: AudioVisualContent = content + print(f"KeyFrameTimesMs: {video_content.key_frame_times_ms}") + keyframe_times_ms.extend(video_content.key_frame_times_ms or []) + print(f"Found keyframes in video content") + break + else: + print(f"Content is not an AudioVisualContent: {content}") + + if not keyframe_times_ms: + print("No keyframe times found in the analysis result") + return + + print(f"Found {len(keyframe_times_ms)} keyframe times in milliseconds") + + # Build keyframe filenames using the time values + keyframe_files = [f"keyframes/{time_ms}" for time_ms in keyframe_times_ms] + + # Download and save a few keyframe images as examples (first, middle, last) + if len(keyframe_files) >= 3: + frames_to_download = { + keyframe_files[0], + keyframe_files[-1], + keyframe_files[len(keyframe_files) // 2], + } + else: + frames_to_download = set(keyframe_files) + + files_to_download = list(frames_to_download) + print(f"Downloading {len(files_to_download)} keyframe images as examples: {files_to_download}") + + for keyframe_id in files_to_download: + print(f"Getting result file: {keyframe_id}") + + # Get the result file (keyframe image) + response: Any = await client.get_result_file( + operation_id=analysis_operation_id, + path=keyframe_id, + ) + + # Handle the response - it's an async iterator that needs to be collected + from collections.abc import AsyncIterator + + assert isinstance(response, AsyncIterator), f"Expected AsyncIterator, got {type(response)}" + + # It's an async iterator, collect all bytes efficiently + chunks: list[bytes] = [] + async for chunk in response: + chunks.append(chunk) + image_content = b"".join(chunks) + + print(f"Retrieved image file for {keyframe_id} ({len(image_content)} bytes)") + + # Save the image file + saved_file_path = save_keyframe_image_to_file( + image_content=image_content, + keyframe_id=keyframe_id, + test_name="get_result_file", + test_py_file_dir=os.path.dirname(os.path.abspath(__file__)), + identifier=analyzer_id, + ) + print(f"Keyframe image saved to: {saved_file_path}") + + # Clean up the created analyzer (demo cleanup) + print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully!") + + # x-ms-original-file: 2025-11-01/ContentAnalyzers_GetResultFile.json + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) From 21c634b0e7ff0fa870f69e8124e60c920a66153a Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 22:53:03 +0000 Subject: [PATCH 014/105] SAMPLE: Add analyze_url_prebuilt_invoice.py to demonstrate invoice field extraction from a URL - Introduced `analyze_url_prebuilt_invoice.py` to showcase the use of the prebuilt-invoice analyzer for extracting fields from an invoice URL. - Included environment setup instructions and prerequisites for running the sample. - Implemented functionality to analyze an invoice and save the results to a JSON file for detailed inspection. --- .../samples/analyze_url_prebuilt_invoice.py | 160 ++++++++++++++++++ 1 file changed, 160 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url_prebuilt_invoice.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url_prebuilt_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url_prebuilt_invoice.py new file mode 100644 index 000000000000..95f10a85ac86 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url_prebuilt_invoice.py @@ -0,0 +1,160 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: use the prebuilt-invoice analyzer to extract invoice fields from a URL. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python analyze_url_prebuilt_invoice.py +""" + +from __future__ import annotations +import asyncio +import os + + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + ContentField, + MediaContent, +) +from sample_helper import save_json_to_file +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Extract invoice fields from URL using begin_analyze API with prebuilt-invoice +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Analyze an invoice from a remote URL using begin_analyze with prebuilt-invoice analyzer +# 3. Save the complete analysis result to JSON file +# 4. Show examples of extracting different field types (string, number, object, array) + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + await analyze_invoice(client) + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +async def analyze_invoice(client: ContentUnderstandingClient) -> None: + """Analyze an invoice and display the extracted fields.""" + file_url = ( + "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + ) + print(f"Analyzing invoice from {file_url} with prebuilt-invoice analyzer...") + poller = await client.begin_analyze(analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(url=file_url)]) + result: AnalyzeResult = await poller.result() + + # AnalyzeResult contains the full analysis result and can be used to access various properties + print("\nInvoice Analysis Result:") + print("=" * 50) + + # A PDF file has only one content element even if it contains multiple pages + content: MediaContent = result.contents[0] + + if not content.fields: + print("No fields found in the analysis result") + return + + print("\nSample Field Extractions:") + print("-" * 40) + + # Example 1: Simple string fields + # Note: Use .get() to check if field exists: field = content.fields.get("FieldName") + # Use [] when field is known to exist (cleaner code) + customer_name = content.fields["CustomerName"].value + + # TotalAmount is an ObjectField containing Amount and CurrencyCode fields + total_amount_obj: dict[str, ContentField] | None = content.fields["TotalAmount"].value # type: ignore[attr-defined] + invoice_total = total_amount_obj["Amount"].value if total_amount_obj else None # type: ignore[union-attr] + + invoice_date = content.fields["InvoiceDate"].value + + print(f"Customer Name: {customer_name or '(None)'}") + print(f"Invoice Total: ${invoice_total or '(None)'}") + print(f"Invoice Date: {invoice_date or '(None)'}") + + # Example 2: Array field (Items) + items: list[ContentField] | None = content.fields["LineItems"].value # type: ignore[attr-defined] + print(f"\nInvoice Items (Array):") + if items: + for i, item in enumerate(items): + # item is a ContentField (ObjectField at runtime), get its value + item_obj: dict[str, Any] | None = item.value_object # type: ignore[attr-defined] + if item_obj: + print(f" Item {i + 1}:") + + # Extract fields from line item + # Note: For nested field access, we use value_* attributes directly + # to avoid type checker issues with dictionary value types + description = item_obj["Description"].value_string # type: ignore[attr-defined] + quantity = item_obj["Quantity"].value_number # type: ignore[attr-defined] + + # UnitPrice and TotalAmount are ObjectFields, extract Amount from them + # Note: Some fields might be optional in some line items + unit_price_field = item_obj.get("UnitPrice") + if unit_price_field and hasattr(unit_price_field, 'value_object'): + unit_price_obj = unit_price_field.value_object # type: ignore[attr-defined] + unit_price = unit_price_obj["Amount"].value_number if unit_price_obj else None # type: ignore[attr-defined,union-attr] + else: + unit_price = None + + total_amount_field = item_obj.get("TotalAmount") + if total_amount_field and hasattr(total_amount_field, 'value_object'): + total_amount_obj_inner = total_amount_field.value_object # type: ignore[attr-defined] + total_amount = total_amount_obj_inner["Amount"].value_number if total_amount_obj_inner else None # type: ignore[attr-defined,union-attr] + else: + total_amount = None + + print(f" Description: {description or 'N/A'}") + print(f" Quantity: {quantity or 'N/A'}") + print(f" Unit Price: ${unit_price or 'N/A'}") + print(f" Total Amount: ${total_amount or 'N/A'}") + else: + print(f" Item {i + 1}: No item object found") + else: + print(" No items found") + + print(f"\nTotal fields extracted: {len(content.fields)}") + + # Save the full result to JSON for detailed inspection + save_json_to_file( + result.as_dict(), + filename_prefix="analyze_url_prebuilt_invoice", + ) + print("Invoice fields saved to JSON file for detailed inspection") + + +if __name__ == "__main__": + asyncio.run(main()) + From 681123986e6fedcb6c3cb16731008097b64939b2 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 23:02:07 +0000 Subject: [PATCH 015/105] SAMPLE: Add create_analyzer_with_labels.py for custom model training - Introduced `create_analyzer_with_labels.py` to demonstrate building a custom model using training files from Azure Blob Storage. - Updated `env.sample` to reflect new environment variables required for the sample. - Included detailed instructions for setting up the environment and running the sample, including handling of optional parameters for training data. --- .../azure-ai-contentunderstanding/env.sample | 26 +- .../samples/create_analyzer_with_labels.py | 264 ++++++++++++++++++ 2 files changed, 281 insertions(+), 9 deletions(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample index 6f2c8d12c2de..edf725c2a574 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample @@ -57,24 +57,32 @@ AZURE_SKIP_LIVE_RECORDING=false # ============================================================================ # Custom Model Training Configuration # ============================================================================ -# These variables are used by build_custom_model_with_training.py sample +# These variables are used by create_analyzer_with_labels.py sample + +# IMPORTANT: Before running the sample, copy the training files from +# sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/ +# into your Azure Blob Storage container # SAS URL to Azure Blob Storage container containing training files -# Required for build_custom_model_with_training.py +# Required for create_analyzer_with_labels.py # Format: https://.blob.core.windows.net/? +# SAS Token Requirements: Must have 'read' and 'list' permissions +# Example: https://mystorageaccount.blob.core.windows.net/training-data?sp=rl&st=2024-01-01T00:00:00Z&se=2024-12-31T23:59:59Z&spr=https&sv=2022-11-02&sr=c&sig=... CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL= +# Optional: Prefix (folder path) to filter blobs within the container +# Use this to organize training files in subdirectories +# If empty, all files in the container will be used +# Example: "training_data/" or "irs_1040_samples/" +# Note: Prefix acts as a folder path filter - only files starting with this path will be included +CONTENT_UNDERSTANDING_STORAGE_PREFIX= + # Optional: Path to a file listing specific blobs to include in training -# If empty, all files in the container/prefix will be used +# If empty, all files in the container (or prefix) will be used # Example: "filelist.jsonl" +# Format: Each line should contain a blob name relative to the container root CONTENT_UNDERSTANDING_FILE_LIST_PATH= -# Optional: Prefix to filter blobs within the container -# If empty, all files in the container will be used -# Example: "sdk_sample_training_files_updated/" -# Note: Training files must use schema version "2025-11-01" in *.labels.json files -CONTENT_UNDERSTANDING_STORAGE_PREFIX= - # ============================================================================ # Usage Instructions # ============================================================================ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py new file mode 100644 index 000000000000..62dc7fb09e08 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py @@ -0,0 +1,264 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: build a custom model using training files and test it. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL (required) + - SAS URL to Azure Blob Storage container with training files + - SAS token must have 'read' and 'list' permissions + - Format: https://.blob.core.windows.net/? + - Training files: Copy the files from sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/ + into your blob storage container before running this sample + CONTENT_UNDERSTANDING_STORAGE_PREFIX (optional) + - Prefix (folder path) to filter blobs within the container + - Example: "training_data/" to only use files in that folder + - If not set, all files in the container will be used + CONTENT_UNDERSTANDING_FILE_LIST_PATH (optional) + - Path to a file listing specific blobs to include in training + - If not set, all files in the container (or prefix) will be used + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python create_analyzer_with_labels.py +""" + +from __future__ import annotations + +import asyncio +import json +import os +from datetime import datetime +from typing import cast + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, + LabeledDataKnowledgeSource, + KnowledgeSource, + AnalyzeResult, +) +from sample_helper import save_json_to_file +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +def create_irs_1040_schema() -> ContentFieldSchema: + """Create a simplified IRS 1040 field schema with 5 key fields for demonstration.""" + return ContentFieldSchema( + name="IRS_1040", + description="Simplified IRS 1040 form schema for demonstration", + fields={ + "FieldYourFirstNameAndMiddleInitial": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="", + ), + "FieldYourFirstNameAndMiddleInitialLastName": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="", + ), + "CheckboxYouAsADependent": ContentFieldDefinition( + type=ContentFieldType.BOOLEAN, + method=GenerationMethod.EXTRACT, + description="", + ), + "TableDependents": ContentFieldDefinition( + type=ContentFieldType.ARRAY, + method=GenerationMethod.GENERATE, + description="", + item_definition=ContentFieldDefinition( + type=ContentFieldType.OBJECT, + method=GenerationMethod.EXTRACT, + description="", + properties={ + "FirstNameLastName": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="", + ), + "SocialSecurityNumber": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="", + ), + "RelationshipToYou": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="", + ), + "CheckboxChildTaxCredit": ContentFieldDefinition( + type=ContentFieldType.BOOLEAN, + method=GenerationMethod.EXTRACT, + description="", + ), + "CheckboxCreditForOtherDependents": ContentFieldDefinition( + type=ContentFieldType.BOOLEAN, + method=GenerationMethod.EXTRACT, + description="", + ), + }, + ), + ), + "FieldWagesSalariesTipsEtcAttachFormSW2": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="", + ), + }, + ) + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}\n") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + # Get training data container URL + container_sas_url = os.getenv("CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL") + if not container_sas_url: + raise ValueError( + "CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL environment variable is required. " + "Set it in your .env file or environment." + ) + + # Print environment variable values before training + print("Environment Variables:") + print("=" * 50) + print(f"AZURE_CONTENT_UNDERSTANDING_ENDPOINT: {endpoint}") + print(f"AZURE_CONTENT_UNDERSTANDING_KEY: {'***' if key else '(not set, using DefaultAzureCredential)'}") + + # Extract storage account and container from SAS URL (for security, don't print the full SAS token) + try: + from urllib.parse import urlparse + parsed_url = urlparse(container_sas_url) + storage_info = f"{parsed_url.scheme}://{parsed_url.netloc}{parsed_url.path}?" + print(f"CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL: {storage_info}") + except Exception: + # Fallback if parsing fails + print(f"CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL: ") + + file_list_path = os.getenv("CONTENT_UNDERSTANDING_FILE_LIST_PATH", "") + storage_prefix = os.getenv("CONTENT_UNDERSTANDING_STORAGE_PREFIX", "") + print(f"CONTENT_UNDERSTANDING_FILE_LIST_PATH: {file_list_path if file_list_path else '(not set, using all files)'}") + print(f"CONTENT_UNDERSTANDING_STORAGE_PREFIX: {storage_prefix if storage_prefix else '(not set, using all files in container)'}") + print("=" * 50) + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # Define the IRS 1040 field schema + print("Defining IRS 1040 field schema...") + field_schema = create_irs_1040_schema() + + # Create analyzer ID + analyzer_id = f"irs_1040_custom_model_{int(asyncio.get_event_loop().time())}" + + # Build analyzer with training data + description = "Custom IRS 1040 form analyzer built with training files" + print(f"\nCreating analyzer '{analyzer_id}' {description}...") + + knowledge_sources: list[LabeledDataKnowledgeSource] | None = None + if container_sas_url: + file_list_path = os.getenv("CONTENT_UNDERSTANDING_FILE_LIST_PATH", "") + storage_prefix = os.getenv("CONTENT_UNDERSTANDING_STORAGE_PREFIX", "") + + # Build kwargs dynamically - only include non-empty optional parameters + lds_kwargs = {"container_url": container_sas_url} + if file_list_path: + lds_kwargs["file_list_path"] = file_list_path + if storage_prefix: + lds_kwargs["prefix"] = storage_prefix + + knowledge_sources = [LabeledDataKnowledgeSource(**lds_kwargs)] + + custom_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description=description, + config=ContentAnalyzerConfig( + return_details=True, + enable_layout=True, + enable_formula=False, + estimate_field_source_and_confidence=True, + ), + field_schema=field_schema, + knowledge_sources=cast(list[KnowledgeSource] | None, knowledge_sources) if knowledge_sources else None, + models={"completion": "gpt-4o", "embedding": "text-embedding-ada-002"}, # Required when using field_schema + ) + + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=custom_analyzer, + ) + + print("Waiting for analyzer creation to complete...") + result = await poller.result() + print(f"Analyzer '{analyzer_id}' created successfully!") + print(f"Status: {result.status}") + print(f"Created at: {result.created_at}") + + if result.warnings: + print("Warnings encountered while building the analyzer:") + for warning in result.warnings: + print(f" - {warning}") + + # Test the analyzer + test_file_path = os.path.join( + os.path.dirname(__file__), + "sample_files", + "IRS_1040_test.pdf", + ) + print(f"\nTesting analyzer with {test_file_path}...") + with open(test_file_path, "rb") as f: + pdf_bytes = f.read() + + analyze_poller = await client.begin_analyze_binary( + analyzer_id=analyzer_id, + binary_input=pdf_bytes, + content_type="application/pdf", + ) + analyze_result = await analyze_poller.result() + print("Analysis completed successfully!") + + # Save results + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + output_dir = os.path.join(os.path.dirname(__file__), "sample_output") + os.makedirs(output_dir, exist_ok=True) + + result_file = os.path.join(output_dir, f"build_custom_model_test_result_{timestamp}.json") + with open(result_file, "w") as f: + json.dump(analyze_result.as_dict(), f, indent=2, default=str) + print(f"Analysis result saved to: {result_file}") + print("Analysis result saved to JSON file for detailed inspection") + + # Cleanup + print(f"\nDeleting analyzer '{analyzer_id}' (demo cleanup)...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully!") + + # Close DefaultAzureCredential if used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) From 71225628fa99d96b99397556b25bb3748c905f36 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 23:21:37 +0000 Subject: [PATCH 016/105] SAMPLE: Add cross-subscription copy samples for analyzers - Introduced `copy_analyzer.py` to demonstrate copying an analyzer from a development environment to production using the `begin_copy_analyzer` API. - Added `grant_copy_auth.py` to showcase granting copy authorization and copying an analyzer between different Azure subscriptions. - Updated `env.sample` with new environment variables required for cross-subscription operations, including source and target resource IDs and regions. - Provided detailed instructions for setting up the environment and running the new samples. --- .../azure-ai-contentunderstanding/env.sample | 42 +++ .../samples/README.md | 2 +- .../samples/copy_analyzer.py | 174 ++++++++++++ .../samples/grant_copy_auth.py | 260 ++++++++++++++++++ .../sample_files/training_samples/README.md | 4 +- 5 files changed, 479 insertions(+), 3 deletions(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample index edf725c2a574..308daa6f3366 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample @@ -83,6 +83,48 @@ CONTENT_UNDERSTANDING_STORAGE_PREFIX= # Format: Each line should contain a blob name relative to the container root CONTENT_UNDERSTANDING_FILE_LIST_PATH= +# ============================================================================ +# Cross-Subscription Copy Configuration +# ============================================================================ +# These variables are used by grant_copy_auth.py sample for copying analyzers +# between different Azure subscriptions or regions + +# IMPORTANT: Both source and target AI Foundry Resources require +# "Cognitive Services User" role for cross-subscription copy operations. +# Ensure your credentials have this role on both resources. + +# Source Azure Resource Manager resource ID (where the analyzer currently exists) +# Required for grant_copy_auth.py +# Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name} +# Example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-rg/providers/Microsoft.CognitiveServices/accounts/my-source-resource +AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID= + +# Source Azure region +# Required for grant_copy_auth.py +# Example: "westus3" or "eastus" +AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION= + +# Target endpoint for cross-subscription copy +# Required for grant_copy_auth.py +# Format: https://{resource-name}.services.ai.azure.com/ +# Example: https://my-target-resource.services.ai.azure.com/ +AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT= + +# Target Azure Resource Manager resource ID (where you want to copy the analyzer to) +# Required for grant_copy_auth.py +# Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name} +# Example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-rg/providers/Microsoft.CognitiveServices/accounts/my-target-resource +AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID= + +# Target Azure region +# Required for grant_copy_auth.py +# Example: "swedencentral" or "eastus" +AZURE_CONTENT_UNDERSTANDING_TARGET_REGION= + +# Optional: Target API key if different from source +# If not set, DefaultAzureCredential will be used for target as well +AZURE_CONTENT_UNDERSTANDING_TARGET_KEY= + # ============================================================================ # Usage Instructions # ============================================================================ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index ad4b8126af76..38adb2533070 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -186,7 +186,7 @@ Deletes a custom analyzer. ### Advanced Features -#### `build_custom_model_with_training.py` +#### `create_analyzer_with_labels.py` Builds a custom analyzer using training data from Azure Blob Storage. Requires additional configuration (see `env.sample`). #### `copy_analyzer.py` diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py new file mode 100644 index 000000000000..9abacfeaa16b --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py @@ -0,0 +1,174 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: copy an analyzer from dev to prod using begin_copy_analyzer API. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python copy_analyzer_to_prod.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Copy analyzer from dev to prod using begin_copy_analyzer API +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Create a dev analyzer with "-dev" postfix and tag "modelType": "dev" +# 3. Copy the dev analyzer to prod with "-prod" postfix and tag "modelType": "prod" +# 4. Wait for copy operation to complete +# 5. Clean up both analyzers + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + base_analyzer_id = f"sdk_sample_custom_analyzer_{int(asyncio.get_event_loop().time())}" + dev_analyzer_id = f"{base_analyzer_id}_dev" + prod_analyzer_id = f"{base_analyzer_id}_prod" + + # Step 1: Create the dev analyzer with "-dev" postfix and tag "modelType": "dev" + print(f"Creating dev analyzer '{dev_analyzer_id}' with tag 'modelType': 'dev'...") + + # Create a custom analyzer using object model (following pattern from create_analyzer.py) + dev_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Development analyzer for extracting company information", + tags={"modelType": "dev"}, + config=ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + field_schema=ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + # EXTRACT: Extract information directly from document content + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + # GENERATE: AI generates content based on document understanding + "document_summary": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="A concise summary of the document's main content", + ), + "key_insights": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="Key business insights or actionable items from the document", + ) + }, + ), + models={"completion": "gpt-4o"}, # Required when using field_schema + ) + + poller = await client.begin_create_analyzer( + analyzer_id=dev_analyzer_id, + resource=dev_analyzer, + ) + dev_result = await poller.result() + print(f"Dev analyzer '{dev_analyzer_id}' created successfully!") + print(f"Dev analyzer tags: {dev_result.tags}") + + # Step 2: Copy the dev analyzer to prod using begin_copy_analyzer API + print(f"\nCopying analyzer from '{dev_analyzer_id}' to '{prod_analyzer_id}' with tag 'modelType': 'prod'...") + + # Use begin_copy_analyzer with source_analyzer_id keyword argument + # The body will include sourceAnalyzerId and we can add tags to the target analyzer + # Note: Tags may need to be set via update after copy, or included in the copy body if supported + try: + copy_poller = await client.begin_copy_analyzer( + analyzer_id=prod_analyzer_id, + source_analyzer_id=dev_analyzer_id, + ) + prod_result = await copy_poller.result() + print(f"Prod analyzer '{prod_analyzer_id}' copied successfully!") + print(f"Prod analyzer tags (before update): {prod_result.tags}") + except Exception as e: + print(f"Error copying analyzer: {e}") + print("Note: The copy operation may not be available on all service endpoints.") + # Clean up dev analyzer before raising + print(f"\nDeleting dev analyzer '{dev_analyzer_id}' (cleanup after error)...") + await client.delete_analyzer(analyzer_id=dev_analyzer_id) + print(f"Dev analyzer '{dev_analyzer_id}' deleted successfully!") + raise + + # Update the prod analyzer to add the "modelType": "prod" tag + # Since copy may not preserve or set tags, we update after copying + print(f"\nUpdating prod analyzer '{prod_analyzer_id}' with tag 'modelType': 'prod'...") + updated_prod_analyzer = ContentAnalyzer( + tags={"modelType": "prod"} + ) + final_prod_result = await client.update_analyzer( + analyzer_id=prod_analyzer_id, + resource=updated_prod_analyzer, + ) + print(f"Prod analyzer '{prod_analyzer_id}' updated successfully!") + print(f"Prod analyzer tags: {final_prod_result.tags}") + + # Clean up the created analyzers (demo cleanup) + print(f"\nDeleting analyzers (demo cleanup)...") + print(f"Deleting dev analyzer '{dev_analyzer_id}'...") + await client.delete_analyzer(analyzer_id=dev_analyzer_id) + print(f"Dev analyzer '{dev_analyzer_id}' deleted successfully!") + + print(f"Deleting prod analyzer '{prod_analyzer_id}'...") + await client.delete_analyzer(analyzer_id=prod_analyzer_id) + print(f"Prod analyzer '{prod_analyzer_id}' deleted successfully!") + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py new file mode 100644 index 000000000000..4fb05768fbfa --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py @@ -0,0 +1,260 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: grant copy authorization and copy an analyzer from source to target. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - Source endpoint + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID (required) - Full Azure Resource Manager resource ID of source + AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION (required) - Azure region of source resource + AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT (required) - Target endpoint for cross-subscription copy + AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID (required) - Full Azure Resource Manager resource ID of target + AZURE_CONTENT_UNDERSTANDING_TARGET_REGION (required) - Azure region of target resource + AZURE_CONTENT_UNDERSTANDING_TARGET_KEY (optional) - Target API key if different from source + Example resource ID format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name} + Note: Both source and target AI Foundry Resources require Cognitive Services User Role for cross-subscription copy + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python grant_copy_auth.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, + CopyAuthorization, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Grant copy authorization and copy analyzer from source to target +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Create a source analyzer +# 3. Grant copy authorization for copying the analyzer +# 4. Print the authorization result +# 5. Copy the source analyzer to target +# 6. Wait for copy operation to complete +# 7. Clean up both analyzers + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as source_client: + base_analyzer_id = f"sdk_sample_custom_analyzer_{int(asyncio.get_event_loop().time())}" + source_analyzer_id = f"{base_analyzer_id}_source" + target_analyzer_id = f"{base_analyzer_id}_target" + + # Step 1: Create the source analyzer + print(f"Creating source analyzer '{source_analyzer_id}'...") + + # Create a custom analyzer using object model (following pattern from create_analyzer.py) + source_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for extracting company information", + config=ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + field_schema=ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + # EXTRACT: Extract information directly from document content + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + # GENERATE: AI generates content based on document understanding + "document_summary": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="A concise summary of the document's main content", + ), + "key_insights": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="Key business insights or actionable items from the document", + ) + }, + ), + models={"completion": "gpt-4o"}, # Required when using field_schema + ) + + poller = await source_client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=source_analyzer, + ) + source_result = await poller.result() + print(f"Source analyzer '{source_analyzer_id}' created successfully!") + print(f"Source analyzer tags: {source_result.tags}") + + # Step 2: Grant copy authorization before copying + print(f"\nGranting copy authorization for analyzer '{source_analyzer_id}'...") + + # Source Azure Resource Manager resource ID (where the analyzer currently exists) + source_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID"] + source_region = os.environ["AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION"] + + # Target endpoint and region for cross-subscription copy + target_endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT"] + target_region = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_REGION"] + + # Target resource ID (where we want to copy the analyzer to) + target_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID"] + + copy_auth: CopyAuthorization = await source_client.grant_copy_authorization( + analyzer_id=source_analyzer_id, + target_azure_resource_id=target_resource_id, + target_region=target_region, + ) + + # Step 3: Print the authorization result + print(f"\nCopy authorization granted successfully!") + print(f"Authorization details:") + print(f" Source: {copy_auth.source}") + print(f" Target Azure Resource ID: {copy_auth.target_azure_resource_id}") + print(f" Target Region: {target_region}") + print(f" Expires at: {copy_auth.expires_at}") + + # Step 4: Create target client for cross-subscription copy + print(f"\nCreating target client for cross-subscription copy...") + print(f"Target endpoint: {target_endpoint}") + print(f"Target region: {target_region}") + + # Create target client with the target endpoint + # Use the same credential (should work across subscriptions if properly configured) + target_key = os.getenv("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") + target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=target_endpoint, credential=target_credential) as target_client: + # Step 5: Copy the source analyzer to target using begin_copy_analyzer API on target client + print(f"\nCopying analyzer from '{source_analyzer_id}' to '{target_analyzer_id}' on target subscription...") + print(f"Source resource ID: {source_resource_id}") + print(f"Source region: {source_region}") + print(f"Target region: {target_region}") + + # For cross-subscription copy, use parameters to specify source location + # Note: Copy authorization was granted above, but we'll use parameters instead of the CopyAuthorization object + # since the CopyAuthorization might not be correctly populated (source: None) + try: + copy_poller = await target_client.begin_copy_analyzer( + analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id, + source_azure_resource_id=source_resource_id, + source_region=source_region, + ) + target_result = await copy_poller.result() + print(f"Target analyzer '{target_analyzer_id}' copied successfully to target subscription!") + print(f"Target analyzer tags (before update): {target_result.tags}") + except Exception as e: + print(f"Error copying analyzer: {e}") + print("Note: The copy operation may not be available on all service endpoints or may require additional permissions.") + # Continue to cleanup section + raise + + # Step 6: Get the target analyzer using target client and dump values + print(f"\nRetrieving target analyzer '{target_analyzer_id}' from target client...") + retrieved_analyzer = await target_client.get_analyzer(analyzer_id=target_analyzer_id) + + # Dump all analyzer values + print(f"\n=== Target Analyzer Details ===") + print(f"Analyzer ID: {retrieved_analyzer.analyzer_id}") + print(f"Description: {retrieved_analyzer.description}") + print(f"Status: {retrieved_analyzer.status}") + print(f"Created at: {retrieved_analyzer.created_at}") + print(f"Last modified: {retrieved_analyzer.last_modified_at}") + print(f"Tags: {retrieved_analyzer.tags}") + if retrieved_analyzer.base_analyzer_id: + print(f"Base analyzer ID: {retrieved_analyzer.base_analyzer_id}") + if retrieved_analyzer.config: + print(f"Config: {retrieved_analyzer.config}") + if retrieved_analyzer.field_schema: + print(f"Field schema name: {retrieved_analyzer.field_schema.name}") + print(f"Field schema description: {retrieved_analyzer.field_schema.description}") + if retrieved_analyzer.field_schema.fields: + print(f"Number of fields: {len(retrieved_analyzer.field_schema.fields)}") + for field_name, field_def in retrieved_analyzer.field_schema.fields.items(): + print(f" - {field_name}: {field_def.type} ({field_def.method})") + if retrieved_analyzer.models: + print(f"Models: {retrieved_analyzer.models}") + print(f"=== End Target Analyzer Details ===\n") + + # Update the target analyzer tags if needed + # Since copy may not preserve or set tags, we update after copying + print(f"\nUpdating target analyzer '{target_analyzer_id}' tags...") + updated_target_analyzer = ContentAnalyzer( + tags={"copiedFrom": source_analyzer_id} + ) + final_target_result = await target_client.update_analyzer( + analyzer_id=target_analyzer_id, + resource=updated_target_analyzer, + ) + print(f"Target analyzer '{target_analyzer_id}' updated successfully!") + print(f"Target analyzer tags: {final_target_result.tags}") + + # Clean up the target analyzer on target subscription + print(f"\nDeleting target analyzer '{target_analyzer_id}' from target subscription (demo cleanup)...") + await target_client.delete_analyzer(analyzer_id=target_analyzer_id) + print(f"Target analyzer '{target_analyzer_id}' deleted successfully from target subscription!") + + # Manually close DefaultAzureCredential if it was used for target client + if isinstance(target_credential, DefaultAzureCredential): + await target_credential.close() + + # Clean up the created analyzers (demo cleanup) + print(f"\nDeleting analyzers (demo cleanup)...") + print(f"Deleting source analyzer '{source_analyzer_id}'...") + await source_client.delete_analyzer(analyzer_id=source_analyzer_id) + print(f"Source analyzer '{source_analyzer_id}' deleted successfully!") + + # Note: Target analyzer is already deleted from target subscription above + print(f"Target analyzer '{target_analyzer_id}' was already deleted from target subscription.") + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/README.md index 5d1ba0112748..e849355c1f66 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/README.md @@ -1,6 +1,6 @@ # Training Samples for Custom Model Building -This directory contains training files for the `build_custom_model_with_training.py` sample. +This directory contains training files for the `create_analyzer_with_labels.py` sample. ## File Requirements @@ -46,7 +46,7 @@ This directory contains 2 labeled IRS 1040 forms with 5 fields: 1. Upload all files to Azure Blob Storage 2. Set the `CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL` environment variable 3. Set the `CONTENT_UNDERSTANDING_STORAGE_PREFIX` to point to your training files -4. Run `python build_custom_model_with_training.py` +4. Run `python create_analyzer_with_labels.py` See `../../env.sample` for configuration details. From fdd919ce67b9e3e0356016ee4255a9fe5738cb45 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 17 Nov 2025 23:22:51 +0000 Subject: [PATCH 017/105] SERVICE-FIX/EMITTER-FIX: Fix issues from service returning 201. Fix issues that emitter generates incorrect copy path. --- .../ai/contentunderstanding/_operations/_operations.py | 6 ++++-- .../ai/contentunderstanding/aio/_operations/_operations.py | 4 +++- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py index 4c761ce494b9..d8012b4303d0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py @@ -134,7 +134,7 @@ def build_content_understanding_copy_analyzer_request( # pylint: disable=name-t accept = _headers.pop("Accept", "application/json") # Construct URL - _url = "/analyzers/{analyzerId}:copyAnalyzer" + _url = "/analyzers/{analyzerId}:copy" path_format_arguments = { "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), } @@ -1005,7 +1005,9 @@ def _copy_analyzer_initial( response = pipeline_response.http_response - if response.status_code not in [202]: + # Accept both 201 (Created) and 202 (Accepted) for copy analyzer operation + # Service may return 201 instead of 202 for this LRO + if response.status_code not in [201, 202]: try: response.read() # Load the body in memory and close the socket except (StreamConsumedError, StreamClosedError): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py index 02aa1b9a0fe1..ae6fbc122ae3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py @@ -616,7 +616,9 @@ async def _copy_analyzer_initial( response = pipeline_response.http_response - if response.status_code not in [202]: + # Accept both 201 (Created) and 202 (Accepted) for copy analyzer operation + # Service may return 201 instead of 202 for this LRO + if response.status_code not in [201, 202]: try: await response.read() # Load the body in memory and close the socket except (StreamConsumedError, StreamClosedError): From 8f4905096dc41164ad4265040c9d072681ff1fb5 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Thu, 20 Nov 2025 21:03:52 +0000 Subject: [PATCH 018/105] Update comments in _operations.py to clarify handling of service response codes for copy analyzer operations. Ensure compatibility with both current (201) and future (202) service behavior. --- .../azure/ai/contentunderstanding/_operations/_operations.py | 3 ++- .../ai/contentunderstanding/aio/_operations/_operations.py | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py index d8012b4303d0..695524e71c5e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py @@ -1006,7 +1006,8 @@ def _copy_analyzer_initial( response = pipeline_response.http_response # Accept both 201 (Created) and 202 (Accepted) for copy analyzer operation - # Service may return 201 instead of 202 for this LRO + # Service currently returns 201 but may return 202 in the future + # This ensures compatibility with both current and future service behavior if response.status_code not in [201, 202]: try: response.read() # Load the body in memory and close the socket diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py index ae6fbc122ae3..2c295861b551 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py @@ -617,7 +617,8 @@ async def _copy_analyzer_initial( response = pipeline_response.http_response # Accept both 201 (Created) and 202 (Accepted) for copy analyzer operation - # Service may return 201 instead of 202 for this LRO + # Service currently returns 201 but may return 202 in the future + # This ensures compatibility with both current and future service behavior if response.status_code not in [201, 202]: try: await response.read() # Load the body in memory and close the socket From 293692125e79d8e564bb167f6f2cdb12e632f806 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Thu, 20 Nov 2025 21:55:33 +0000 Subject: [PATCH 019/105] Migrate CU SDK Test --- .../azure-ai-contentunderstanding/.gitignore | 5 +- .../tests/README.md | 165 ++++ .../tests/conftest.py | 75 ++ .../tests/test_analyzer_operation_id.py | 172 ++++ ...erstanding_content_analyzers_operations.py | 794 +++++++++++++++ ...ding_content_analyzers_operations_async.py | 908 ++++++++++++++++++ .../tests/test_data/sample_invoice.pdf | Bin 0 -> 151363 bytes .../tests/test_helpers.py | 306 ++++++ .../tests/testpreparer.py | 48 + .../tests/testpreparer_async.py | 50 + 10 files changed, 2521 insertions(+), 2 deletions(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_data/sample_invoice.pdf create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore b/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore index 3725075a038c..d2e11e7d02e6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore @@ -1,5 +1,6 @@ -# Sample output files -samples/sample_output/ +# Sample and test output files (any directory starting with these names) +**/test_output*/ +**/sample_output*/ # Virtual environment .venv/ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md new file mode 100644 index 000000000000..43aca8938be9 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md @@ -0,0 +1,165 @@ +# Testing Guide for Azure AI Content Understanding SDK + +This guide provides instructions for running tests for the Azure AI Content Understanding SDK. + +## Prerequisites + +1. Python 3.8 or higher +2. Virtual environment activated +3. Dependencies installed (see `dev_requirements.txt`) + +## Running Tests + +### Basic Test Execution + +Run all tests: +```bash +pytest +``` + +Run specific test file: +```bash +pytest tests/test_content_understanding_content_analyzers_operations.py +``` + +Run specific test: +```bash +pytest tests/test_content_understanding_content_analyzers_operations.py::TestContentUnderstandingContentAnalyzersOperations::test_content_analyzers_get +``` + +### Parallel Test Execution + +To run tests in parallel using `pytest-xdist`: +```bash +pytest -n auto +``` + +**Important:** Parallel execution requires manual test-proxy management. See [Test-Proxy Configuration](#test-proxy-configuration) below. + +## Test-Proxy Configuration + +The test framework uses the **test-proxy** for recording and playing back HTTP requests during tests. + +### Automatic Startup (Default) + +By default, the test-proxy starts automatically when you run `pytest`. **No configuration is needed.** + +**⚠️ IMPORTANT:** Do NOT set `PROXY_MANUAL_START=false` in your `.env` file. + +**Why?** Environment variables are read as strings. Setting `PROXY_MANUAL_START=false` makes it the string `"false"`, which is truthy in Python. This causes the framework to think the proxy is manually started, preventing automatic startup. + +**Correct approach:** +- **Remove** `PROXY_MANUAL_START` from `.env` entirely (or don't set it) +- The framework will use the default `False` (boolean), enabling automatic startup + +**Incorrect approach:** +```bash +# ❌ DON'T DO THIS - This will break automatic startup! +PROXY_MANUAL_START=false +``` + +**Correct approach:** +```bash +# ✅ DO THIS - Remove the line entirely or don't set it +# (No PROXY_MANUAL_START line in .env) +``` + +### Manual Startup (For Parallel Execution) + +If you need to run tests in parallel (`pytest -n auto`), you must manually start the test-proxy: + +1. **Start the test-proxy manually:** + ```bash + ./start_test_proxy_for_parallel.sh + ``` + +2. **Set environment variable:** + ```bash + export PROXY_MANUAL_START=true + ``` + + Or add to `.env` file: + ```bash + PROXY_MANUAL_START=true + ``` + +3. **Run tests in parallel:** + ```bash + pytest -n auto + ``` + +4. **Stop the test-proxy when done:** + ```bash + ./stop_test_proxy.sh + ``` + +**Note:** The string `"true"` is truthy in Python, so setting `PROXY_MANUAL_START=true` correctly tells the framework that the proxy is manually managed. + +## Test Modes + +### Playback Mode (Default) +Tests run against recorded HTTP responses. No live service calls are made. + +### Live Mode +Tests make actual API calls to Azure services. Requires valid credentials. + +Set environment variable: +```bash +export AZURE_TEST_RUN_LIVE=true +``` + +### Record Mode +Tests make live API calls and record the responses for future playback. + +Set environment variable: +```bash +export AZURE_TEST_RUN_LIVE=true +export AZURE_TEST_RECORD_MODE=true +``` + +## Troubleshooting + +### Connection Refused Errors + +If you see errors like: +``` +ConnectionRefusedError: [Errno 111] Connection refused +MaxRetryError: HTTPConnectionPool(host='localhost', port=5000) +``` + +**Check:** +1. Is `PROXY_MANUAL_START` set incorrectly in `.env`? + - Remove it entirely for automatic startup + - Or set it to `true` if manually managing the proxy +2. Is the test-proxy running? + ```bash + curl http://localhost:5000/Admin/IsAlive + ``` +3. For automatic startup, ensure `PROXY_MANUAL_START` is not in `.env` (or is unset) + +### Test-Proxy Not Starting Automatically + +**Symptoms:** Tests fail with connection errors, proxy doesn't start. + +**Solution:** +1. Check `.env` file at repository root (`/home/yslin/repos/azure-sdk-for-python-pr/.env`) +2. Remove any `PROXY_MANUAL_START=false` line +3. The framework will use the default `False` (boolean) for automatic startup + +## Helper Scripts + +- `start_test_proxy_for_parallel.sh` - Start test-proxy manually for parallel execution +- `stop_test_proxy.sh` - Stop manually started test-proxy +- `enable_parallel_proxy.md` - Detailed guide for parallel execution setup + +## Additional Resources + +- [Azure SDK Python Testing Guide](../../../../../doc/dev/tests.md) - Comprehensive testing documentation +- [Test-Proxy Documentation](https://github.com/Azure/azure-sdk-tools/tree/main/tools/test-proxy) - Official test-proxy documentation + + + + + + + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py new file mode 100644 index 000000000000..8bea3f29c0d6 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py @@ -0,0 +1,75 @@ +# 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. +# -------------------------------------------------------------------------- +import os +import pytest +from dotenv import load_dotenv +from devtools_testutils import ( + test_proxy, + add_general_string_sanitizer, + add_body_key_sanitizer, + add_header_regex_sanitizer, +) + +load_dotenv() + + +@pytest.fixture(scope="session", autouse=True) +def start_proxy(test_proxy): + # Ensures the test proxy is started for the session + return + + +# For security, please avoid record sensitive identity information in recordings +@pytest.fixture(scope="session", autouse=True) +def add_sanitizers(test_proxy): + """Add sanitizers to hide secrets and sensitive information in recordings.""" + contentunderstanding_subscription_id = os.environ.get( + "CONTENTUNDERSTANDING_SUBSCRIPTION_ID", "00000000-0000-0000-0000-000000000000" + ) + contentunderstanding_tenant_id = os.environ.get( + "CONTENTUNDERSTANDING_TENANT_ID", "00000000-0000-0000-0000-000000000000" + ) + contentunderstanding_client_id = os.environ.get( + "CONTENTUNDERSTANDING_CLIENT_ID", "00000000-0000-0000-0000-000000000000" + ) + contentunderstanding_client_secret = os.environ.get( + "CONTENTUNDERSTANDING_CLIENT_SECRET", "00000000-0000-0000-0000-000000000000" + ) + + # Use string sanitizers (safer than regex for exact values) + if ( + contentunderstanding_subscription_id + and contentunderstanding_subscription_id != "00000000-0000-0000-0000-000000000000" + ): + add_general_string_sanitizer( + target=contentunderstanding_subscription_id, value="00000000-0000-0000-0000-000000000000" + ) + if contentunderstanding_tenant_id and contentunderstanding_tenant_id != "00000000-0000-0000-0000-000000000000": + add_general_string_sanitizer( + target=contentunderstanding_tenant_id, value="00000000-0000-0000-0000-000000000000" + ) + if contentunderstanding_client_id and contentunderstanding_client_id != "00000000-0000-0000-0000-000000000000": + add_general_string_sanitizer( + target=contentunderstanding_client_id, value="00000000-0000-0000-0000-000000000000" + ) + if ( + contentunderstanding_client_secret + and contentunderstanding_client_secret != "00000000-0000-0000-0000-000000000000" + ): + add_general_string_sanitizer(target=contentunderstanding_client_secret, value="fake-secret") + + # Sanitize API keys + contentunderstanding_key = os.environ.get("AZURE_CONTENT_UNDERSTANDING_KEY", "") + if contentunderstanding_key: + add_general_string_sanitizer(target=contentunderstanding_key, value="fake-api-key") + + # Sanitize Ocp-Apim-Subscription-Key header (where the API key is sent) + add_header_regex_sanitizer(key="Ocp-Apim-Subscription-Key", value="fake-api-key", regex=".*") + add_header_regex_sanitizer(key="Set-Cookie", value="[set-cookie;]") + add_header_regex_sanitizer(key="Cookie", value="cookie;") + add_body_key_sanitizer(json_path="$..access_token", value="access_token") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py new file mode 100644 index 000000000000..62a541a9abce --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py @@ -0,0 +1,172 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- + +""" +Tests for Content Understanding analyzer operation ID functionality. +""" + +import pytest +from unittest.mock import Mock, patch +from azure.core.polling import LROPoller, PollingMethod +from azure.ai.contentunderstanding.operations._patch import ( + AnalyzeLROPoller, + _parse_operation_id, +) +from azure.ai.contentunderstanding.models import AnalyzeInput +from azure.ai.contentunderstanding import ContentUnderstandingClient + + +class TestParseOperationId: + """Test the operation ID parsing function.""" + + def test_parse_analyze_operation_id(self): + """Test parsing operation ID from analyze operation location.""" + url = "https://endpoint/contentunderstanding/analyzerResults/12345-67890-abcdef?api-version=2025-11-01" + operation_id = _parse_operation_id(url) + assert operation_id == "12345-67890-abcdef" + + def test_parse_operation_id_with_different_endpoints(self): + """Test parsing operation ID from different endpoint formats.""" + urls = [ + "https://ai-foundry-mock.services.ai.azure.com/contentunderstanding/analyzerResults/b0fdb7d6-6fa7-4b43-af09-1b14e84cedce?api-version=2025-11-01", + "https://my-resource.cognitiveservices.azure.com/contentunderstanding/analyzerResults/abc123?api-version=2025-11-01", + "https://localhost:8080/contentunderstanding/analyzerResults/test-op-id?api-version=2025-11-01", + ] + + expected_ids = ["b0fdb7d6-6fa7-4b43-af09-1b14e84cedce", "abc123", "test-op-id"] + + for url, expected_id in zip(urls, expected_ids): + operation_id = _parse_operation_id(url) + assert operation_id == expected_id + + def test_parse_operation_id_no_match(self): + """Test parsing operation ID when no match is found.""" + url = "https://endpoint/contentunderstanding/something-else/12345?api-version=2025-11-01" + + with pytest.raises(ValueError, match="Could not extract operation ID"): + _parse_operation_id(url) + + +class TestAnalyzeLROPoller: + """Test the AnalyzeLROPoller class.""" + + def test_details_property_success(self): + """Test the details property when operation ID can be extracted.""" + # Mock the polling method and initial response + mock_polling_method = Mock() + mock_initial_response = Mock() + mock_http_response = Mock() + mock_http_response.headers = { + "Operation-Location": "https://endpoint/contentunderstanding/analyzerResults/test-op-id?api-version=2025-11-01" + } + mock_initial_response.http_response = mock_http_response + mock_polling_method.return_value = mock_polling_method + mock_polling_method._initial_response = mock_initial_response + + # Create poller instance + poller = AnalyzeLROPoller( + client=Mock(), initial_response=Mock(), deserialization_callback=Mock(), polling_method=mock_polling_method + ) + + # Test details property + details = poller.details + assert details["operation_id"] == "test-op-id" + assert details["operation_type"] == "analyze" + + def test_details_property_missing_header(self): + """Test the details property when Operation-Location header is missing.""" + # Mock the polling method and initial response + mock_polling_method = Mock() + mock_initial_response = Mock() + mock_http_response = Mock() + mock_http_response.headers = {} # Missing Operation-Location header + mock_initial_response.http_response = mock_http_response + mock_polling_method.return_value = mock_polling_method + mock_polling_method._initial_response = mock_initial_response + + # Create poller instance + poller = AnalyzeLROPoller( + client=Mock(), initial_response=Mock(), deserialization_callback=Mock(), polling_method=mock_polling_method + ) + + # Test details property + details = poller.details + assert details["operation_id"] is None + assert details["operation_type"] == "analyze" + assert "error" in details + + def test_details_property_invalid_url(self): + """Test the details property when URL format is invalid.""" + # Mock the polling method and initial response + mock_polling_method = Mock() + mock_initial_response = Mock() + mock_http_response = Mock() + mock_http_response.headers = { + "Operation-Location": "https://endpoint/invalid/path/12345?api-version=2025-11-01" + } + mock_initial_response.http_response = mock_http_response + mock_polling_method.return_value = mock_polling_method + mock_polling_method._initial_response = mock_initial_response + + # Create poller instance + poller = AnalyzeLROPoller( + client=Mock(), initial_response=Mock(), deserialization_callback=Mock(), polling_method=mock_polling_method + ) + + # Test details property + details = poller.details + assert details["operation_id"] is None + assert details["operation_type"] == "analyze" + assert "error" in details + + def test_from_continuation_token(self): + """Test the from_continuation_token class method.""" + # Mock the polling method + mock_polling_method = Mock() + mock_polling_method.from_continuation_token.return_value = ( + Mock(), # client + Mock(), # initial_response + Mock(), # deserialization_callback + ) + + # Test the class method + poller = AnalyzeLROPoller.from_continuation_token( + polling_method=mock_polling_method, continuation_token="test-token" + ) + + assert isinstance(poller, AnalyzeLROPoller) + mock_polling_method.from_continuation_token.assert_called_once_with("test-token") + + +class TestPollerIntegration: + """Test integration with the operations classes.""" + + def test_analyze_operation_returns_custom_poller(self): + """Test that begin_analyze returns AnalyzeLROPoller with details property.""" + # Create a mock client + mock_client = Mock(spec=ContentUnderstandingClient) + + # Create a mock poller with the required structure + mock_poller = Mock(spec=AnalyzeLROPoller) + mock_poller._polling_method = Mock() + mock_poller._polling_method._initial_response = Mock() + mock_poller._polling_method._initial_response.http_response = Mock() + mock_poller._polling_method._initial_response.http_response.headers = { + "Operation-Location": "https://endpoint.com/analyzerResults/test-op-id-123?api-version=2025-11-01" + } + + # Create actual AnalyzeLROPoller instance + result = AnalyzeLROPoller( + mock_client, mock_poller._polling_method._initial_response, Mock(), mock_poller._polling_method + ) + + # Verify it has the details property + assert isinstance(result, AnalyzeLROPoller) + assert hasattr(result, "details") + details = result.details + assert "operation_id" in details + assert details["operation_id"] == "test-op-id-123" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py new file mode 100644 index 000000000000..66d3c55bf09f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py @@ -0,0 +1,794 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +import pytest +import os +import re +from typing import Tuple, Union, Dict, Any, Optional, List, Set +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer +from testpreparer import ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import ContentAnalyzer +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import AnalyzeInput +from test_helpers import ( + generate_analyzer_id, + new_simple_content_analyzer_object, + new_marketing_video_analyzer_object, + assert_poller_properties, + assert_simple_content_analyzer_result, + save_analysis_result_to_file, + save_keyframe_image_to_file, +) + +from devtools_testutils import is_live, is_live_and_not_recording + + +def create_analyzer_and_assert_sync( + client: ContentUnderstandingClient, analyzer_id: str, resource: Union[ContentAnalyzer, Dict[str, Any]] +) -> Any: + """Create an analyzer and perform basic assertions (sync version). + + Args: + client: The ContentUnderstandingClient instance + analyzer_id: The analyzer ID to create + resource: The analyzer resource (ContentAnalyzer object or dict) + + Returns: + Any: The poller object + + Raises: + AssertionError: If the creation fails or assertions fail + """ + print(f"\nCreating analyzer {analyzer_id}") + + # Start the analyzer creation operation + poller = client.begin_create_or_replace( + analyzer_id=analyzer_id, + resource=resource, + ) + + # Wait for the operation to complete + print(f" Waiting for analyzer {analyzer_id} to be created") + response = poller.result() + assert response is not None + assert poller.status() == "Succeeded" + assert poller.done() + print(f" Analyzer {analyzer_id} is created successfully") + + # Additional poller assertions + assert poller is not None + assert poller.status() is not None + assert poller.status() != "" + assert poller.continuation_token() is not None + + return poller + + +def delete_analyzer_and_assert_sync( + client: ContentUnderstandingClient, analyzer_id: str, created_analyzer: bool +) -> None: + """Delete an analyzer and assert it was deleted successfully (sync version). + + Args: + client: The ContentUnderstandingClient instance + analyzer_id: The analyzer ID to delete + created_analyzer: Whether the analyzer was created (to determine if cleanup is needed) + + Raises: + AssertionError: If the analyzer still exists after deletion + """ + if created_analyzer: + print(f"Cleaning up analyzer {analyzer_id}") + try: + client.delete(analyzer_id=analyzer_id) + # Verify deletion + print(f"Analyzer {analyzer_id} is deleted successfully") + except Exception as e: + # If deletion fails, the test should fail + raise AssertionError(f"Failed to delete analyzer {analyzer_id}: {e}") from e + else: + print(f"Analyzer {analyzer_id} was not created, no cleanup needed") + + +def download_keyframes_and_assert_sync( + client: ContentUnderstandingClient, + analysis_operation_id: str, + result: Any, + test_py_file_dir: str, + identifier: Optional[str] = None, +) -> None: + """Download keyframes from video analysis result and assert their existence (sync version). + + Downloads up to 3 keyframes: first, middle, and last frame to avoid duplicates. + + Args: + client: The ContentUnderstandingClient instance + analysis_operation_id: The operation ID from the analysis + result: The analysis result containing markdown with keyframes + test_py_file_dir: The directory where pytest files are located + identifier: Optional unique identifier to avoid conflicts (e.g., analyzer_id) + + Returns: + None + + Raises: + AssertionError: If no keyframes are found in the analysis result + """ + keyframe_ids: Set[str] = set() + + # Iterate over contents to find keyframes from markdown + for content in result.contents: + # Extract keyframe IDs from "markdown" if it exists and is a string + markdown_content = getattr(content, "markdown", "") + if isinstance(markdown_content, str): + # Use the same regex pattern as the official sample: (keyFrame\.d+)\.jpg + keyframe_ids.update(re.findall(r"(keyFrame\.\d+)\.jpg", markdown_content)) + + print(f"Found keyframe IDs in markdown: {keyframe_ids}") + + # Assert that keyframe IDs were found in the video analysis + assert ( + keyframe_ids + ), "No keyframe IDs were found in the video analysis markdown content. Video analysis should generate keyframes that can be extracted using regex pattern." + + print(f"Successfully extracted {len(keyframe_ids)} keyframe IDs from video analysis") + + # Sort keyframes by frame number to get first, middle, and last + # Extract numeric part from "keyFrame.22367" format and convert to "keyframes/22367" format + def extract_frame_number(keyframe_id: str) -> int: + # Extract number after "keyFrame." + match = re.search(r"keyFrame\.(\d+)", keyframe_id) + if match: + return int(match.group(1)) + return 0 + + # Build keyframe paths in the format expected by get_result_file API: "keyframes/{time_ms}" + keyframe_paths = [f"keyframes/{extract_frame_number(kf)}" for kf in keyframe_ids] + + # Sort by frame number + sorted_keyframes: List[str] = sorted(keyframe_paths, key=lambda x: int(x.split("/")[-1])) + + # Create a set with first, middle, and last frames (automatically removes duplicates) + frames_set: Set[str] = {sorted_keyframes[0], sorted_keyframes[-1], sorted_keyframes[len(sorted_keyframes) // 2]} + + # Convert set to list for processing + frames_to_download: List[str] = list(frames_set) + + print(f"Selected frames to download: {frames_to_download}") + + # Try to retrieve the selected keyframe images using get_result_file API + files_retrieved: int = 0 + + for keyframe_id in frames_to_download: + print(f"Trying to get result file with path: {keyframe_id}") + response = client.get_result_file( + operation_id=analysis_operation_id, + path=keyframe_id, # Use keyframe_id directly as path, no .jpg extension + ) + + # Handle the response - it's an iterator that needs to be collected + if hasattr(response, "__iter__"): + # It's an iterator, collect all bytes efficiently + chunks = [] + for chunk in response: + chunks.append(chunk) + response = b"".join(chunks) + + # Assert that we successfully get a response and it's valid image data + assert response is not None, f"Response for path {keyframe_id} should not be None" + assert isinstance( + response, bytes + ), f"Response for {keyframe_id} should be bytes (image data), got {type(response)}" + assert len(response) > 0, f"Image file content for {keyframe_id} should not be empty" + + print(f"Successfully retrieved image file for path: {keyframe_id}") + print(f"Image file content length: {len(response)} bytes") + + # Save the image file using the helper function + saved_file_path = save_keyframe_image_to_file( + image_content=response, + keyframe_id=keyframe_id, + test_name="test_content_analyzers_get_result_file", + test_py_file_dir=test_py_file_dir, + identifier=identifier, + ) + + # Verify the saved file exists and has content + assert os.path.exists(saved_file_path), f"Saved image file should exist at {saved_file_path}" + assert os.path.getsize(saved_file_path) > 0, f"Saved image file should not be empty" + + files_retrieved += 1 + print(f"Successfully downloaded keyframe image: {keyframe_id}") + + # Assert that we successfully downloaded all expected files + assert files_retrieved == len( + frames_to_download + ), f"Expected to download {len(frames_to_download)} files, but only downloaded {files_retrieved}" + print(f"Successfully completed get_result_file test - downloaded {files_retrieved} keyframe images") + + +class TestContentUnderstandingContentAnalyzersOperations(ContentUnderstandingClientTestBase): + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_begin_create_with_content_analyzer(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create analyzer using ContentAnalyzer object + - Verify analyzer creation and poller properties + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "create_sync", is_async=False) + created_analyzer = False + + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, description=f"test analyzer: {analyzer_id}", tags={"tag1_name": "tag1_value"} + ) + + try: + # Create analyzer using the refactored function + poller = create_analyzer_and_assert_sync(client, analyzer_id, content_analyzer) + created_analyzer = True + + finally: + # Always clean up the created analyzer, even if the test fails + delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + + # @ContentUnderstandingPreparer() + # @recorded_by_proxy + # @pytest.mark.skip(reason="GA API addition - to be implemented") + + # @ContentUnderstandingPreparer() + # @recorded_by_proxy + # @pytest.mark.skip(reason="GA API addition - to be implemented") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_begin_create_with_json(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create analyzer using JSON dictionary + - Verify analyzer creation and poller properties + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "create_json_sync", is_async=False) + created_analyzer = False + + try: + # Create analyzer using the refactored function with JSON resource + poller = create_analyzer_and_assert_sync( + client, + analyzer_id, + { + "analyzerId": analyzer_id, + "baseAnalyzerId": "prebuilt-document", + "config": { + "disableContentFiltering": False, + "disableFaceBlurring": False, + "enableFace": False, + "enableFormula": True, + "enableLayout": True, + "enableOcr": True, + "estimateFieldSourceAndConfidence": True, + "returnDetails": True, + }, + "description": f"test analyzer: {analyzer_id}", + "processingLocation": "global", + "models": {"completion": "gpt-4o"}, + "tags": {"tag1_name": "tag1_value"}, + }, + ) + created_analyzer = True + + finally: + # Always clean up the created analyzer, even if the test fails + delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_update(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create initial analyzer + - Get analyzer before update to verify initial state + - Update analyzer with new description and tags + - Get analyzer after update to verify changes persisted + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "update_sync", is_async=False) + created_analyzer = False + + # Create initial analyzer + initial_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"Initial analyzer for update test: {analyzer_id}", + tags={"initial_tag": "initial_value"}, + ) + + try: + # Create the initial analyzer using the refactored function + poller = create_analyzer_and_assert_sync(client, analyzer_id, initial_analyzer) + created_analyzer = True + + # Get the analyzer before update to verify initial state + print(f"Getting analyzer {analyzer_id} before update") + analyzer_before_update = client.get(analyzer_id=analyzer_id) + assert analyzer_before_update is not None + assert analyzer_before_update.analyzer_id == analyzer_id + assert analyzer_before_update.description == f"Initial analyzer for update test: {analyzer_id}" + assert analyzer_before_update.tags == {"initial_tag": "initial_value"} + print( + f"Initial analyzer state verified - description: {analyzer_before_update.description}, tags: {analyzer_before_update.tags}" + ) + + # Create updated analyzer with only allowed properties (description and tags) + updated_analyzer = ContentAnalyzer( + base_analyzer_id=analyzer_before_update.base_analyzer_id, + models=analyzer_before_update.models, + analyzer_id=analyzer_id, + description=f"Updated analyzer description: {analyzer_id}", + tags={"updated_tag": "updated_value"}, + ) + + # Update the analyzer + print(f"Updating analyzer {analyzer_id}") + response = client.update(analyzer_id=analyzer_id, resource=updated_analyzer) + assert response is not None + assert response.analyzer_id == analyzer_id + + # Get the analyzer after update to verify changes persisted + print(f"Getting analyzer {analyzer_id} after update") + analyzer_after_update = client.get(analyzer_id=analyzer_id) + assert analyzer_after_update is not None + assert analyzer_after_update.analyzer_id == analyzer_id + assert analyzer_after_update.description == f"Updated analyzer description: {analyzer_id}" + assert analyzer_after_update.tags == {"updated_tag": "updated_value"} + print( + f"Updated analyzer state verified - description: {analyzer_after_update.description}, tags: {analyzer_after_update.tags}" + ) + + finally: + # Always clean up the created analyzer, even if the test fails + delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_delete(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create analyzer for deletion test + - Delete analyzer + - Clean up if deletion failed + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "delete_sync", is_async=False) + created_analyzer = False + + # Create a simple analyzer for deletion test + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"test analyzer for deletion: {analyzer_id}", + tags={"test_type": "deletion"}, + ) + + try: + # Create analyzer using the refactored function + poller = create_analyzer_and_assert_sync(client, analyzer_id, content_analyzer) + created_analyzer = True + + # Delete the analyzer + print(f"Deleting analyzer {analyzer_id}") + response = client.delete(analyzer_id=analyzer_id) + + # Verify the delete response + assert response is None + + finally: + # Clean up if the analyzer was created but deletion failed + delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_begin_analyze_url(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create simple analyzer for URL analysis + - Begin analysis operation with URL input + - Wait for analysis completion + - Save analysis result to output file + - Verify fields node exists in first result + - Verify total_amount field exists and equals 110 + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "analyze_url_sync", is_async=False) + created_analyzer = False + + # Create a simple analyzer for URL analysis + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"test analyzer for URL analysis: {analyzer_id}", + tags={"test_type": "url_analysis"}, + ) + + try: + # Create analyzer using the refactored function + poller = create_analyzer_and_assert_sync(client, analyzer_id, content_analyzer) + created_analyzer = True + + # Use the provided URL for the invoice PDF + invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + print(f"Starting URL analysis with analyzer {analyzer_id}") + + # Begin analysis operation with URL + analysis_poller = client.begin_analyze(analyzer_id=analyzer_id, inputs=[AnalyzeInput(url=invoice_url)]) + assert_poller_properties(analysis_poller, "Analysis poller") + + # Wait for the analysis to complete + print(f"Waiting for analysis to complete") + analysis_result = analysis_poller.result() + assert_simple_content_analyzer_result(analysis_result, "URL analysis result") + + # Save the analysis result to a file + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + save_analysis_result_to_file( + analysis_result, "test_content_analyzers_begin_analyze_url", test_file_dir, analyzer_id + ) + + finally: + # Always clean up the created analyzer, even if the test fails + delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_begin_analyze_binary(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create simple analyzer for binary analysis + - Read sample invoice PDF file + - Begin binary analysis operation with analyzer + - Wait for analysis completion + - Save analysis result to output file + - Verify fields node exists in first result + - Verify total_amount field exists and equals 110 + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "analyze_binary_sync", is_async=False) + created_analyzer = False + + # Create a simple analyzer for binary analysis + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"test analyzer for binary analysis: {analyzer_id}", + tags={"test_type": "binary_analysis"}, + ) + + try: + # Create analyzer using the refactored function + poller = create_analyzer_and_assert_sync(client, analyzer_id, content_analyzer) + created_analyzer = True + + # Read the sample invoice PDF file using absolute path based on this test file's location + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + pdf_path = os.path.join(test_file_dir, "test_data", "sample_invoice.pdf") + with open(pdf_path, "rb") as pdf_file: + pdf_content = pdf_file.read() + + print(f"Starting binary analysis with analyzer {analyzer_id}") + + # Begin binary analysis operation + analysis_poller = client.begin_analyze_binary(analyzer_id=analyzer_id, binary_input=pdf_content) + assert_poller_properties(analysis_poller, "Analysis poller") + + # Wait for the analysis to complete + print(f"Waiting for analysis to complete") + analysis_result = analysis_poller.result() + assert_simple_content_analyzer_result(analysis_result, "Binary analysis result") + + # Save the analysis result to a file + save_analysis_result_to_file( + analysis_result, "test_content_analyzers_begin_analyze_binary", test_file_dir, analyzer_id + ) + + finally: + # Always clean up the created analyzer, even if the test fails + delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create marketing video analyzer based on the marketing video template + - Read FlightSimulator.mp4 file + - Begin video analysis operation with analyzer + - Wait for analysis completion + - Use get_result_file to retrieve image files generated from video analysis + - Verify image file content is returned and save to test_output + - Clean up created analyzer + """ + if not is_live_and_not_recording(): + pytest.skip( + "This test requires live mode to run, as it involves large video files that are too big for test proxy to record" + ) + return + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "get_result_file_sync", is_async=False) + created_analyzer = False + + # Create a marketing video analyzer based on the template + video_analyzer = new_marketing_video_analyzer_object( + analyzer_id=analyzer_id, + description=f"marketing video analyzer for get result file test: {analyzer_id}", + tags={"test_type": "get_result_file_video"}, + ) + + try: + # Create analyzer using the refactored function + poller = create_analyzer_and_assert_sync(client, analyzer_id, video_analyzer) + created_analyzer = True + + # Use the FlightSimulator.mp4 video file from remote location + video_file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/videos/sdk_samples/FlightSimulator.mp4" + print(f"Using video file from URL: {video_file_url}") + + # Get test file directory for saving output + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + + print(f"Starting video analysis to get operation ID") + + # Begin video analysis operation using URL + analysis_poller = client.begin_analyze(analyzer_id=analyzer_id, inputs=[AnalyzeInput(url=video_file_url)]) + assert_poller_properties(analysis_poller, "Video analysis poller") + + # Wait for the analysis to complete + print(f"Waiting for video analysis to complete") + analysis_result = analysis_poller.result() + + # Get the operation ID from the poller details + details = analysis_poller.details + assert "operation_id" in details, "Details should contain operation_id" + analysis_operation_id = details["operation_id"] + assert analysis_operation_id is not None, "Operation ID should not be None" + assert len(analysis_operation_id) > 0, "Operation ID should not be empty" + print(f"Analysis operation ID: {analysis_operation_id}") + + # Use the analysis result we already have from the poller to see what files are available + result = analysis_result + assert result is not None, "Analysis result should not be None" + print(f"Analysis result contains {len(result.contents)} contents") + + # Use the refactored function to download keyframes by calling client.get_result_file + download_keyframes_and_assert_sync(client, analysis_operation_id, result, test_file_dir, analyzer_id) + + finally: + # Always clean up the created analyzer, even if the test fails + delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + + +# def test_content_analyzers_begin_analyze(self, contentunderstanding_endpoint): +# client = self.create_client(endpoint=contentunderstanding_endpoint) +# response = client.begin_analyze( +# analyzer_id="str", +# body={ +# "inputs": [ +# { +# "data": bytes("bytes", encoding="utf-8"), +# "mimeType": "str", +# "name": "str", +# "range": "str", +# "url": "str", +# } +# ], +# "modelDeployments": {"str": "str"}, +# }, +# ).result() # call '.result()' to poll until service return final result + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# def test_content_analyzers_begin_copy(self, contentunderstanding_endpoint): +# client = self.create_client(endpoint=contentunderstanding_endpoint) +# response = client.begin_copy( +# analyzer_id="str", +# body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, +# source_analyzer_id="str", +# ).result() # call '.result()' to poll until service return final result + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# def test_content_analyzers_begin_create_or_replace(self, contentunderstanding_endpoint): +# client = self.create_client(endpoint=contentunderstanding_endpoint) +# response = client.begin_create_or_replace( +# analyzer_id="str", +# resource={ +# "analyzerId": "str", +# "createdAt": "2020-02-20 00:00:00", +# "lastModifiedAt": "2020-02-20 00:00:00", +# "status": "str", +# "baseAnalyzerId": "str", +# "config": { +# "annotationFormat": "str", +# "chartFormat": "str", +# "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, +# "disableFaceBlurring": bool, +# "enableAnnotation": bool, +# "enableFigureAnalysis": bool, +# "enableFigureDescription": bool, +# "enableFormula": bool, +# "enableLayout": bool, +# "enableOcr": bool, +# "enableSegment": bool, +# "estimateFieldSourceAndConfidence": bool, +# "locales": ["str"], +# "omitContent": bool, +# "returnDetails": bool, +# "segmentPerPage": bool, +# "tableFormat": "str", +# }, +# "description": "str", +# "dynamicFieldSchema": bool, +# "fieldSchema": { +# "fields": { +# "str": { +# "$ref": "str", +# "description": "str", +# "enum": ["str"], +# "enumDescriptions": {"str": "str"}, +# "estimateSourceAndConfidence": bool, +# "examples": ["str"], +# "items": ..., +# "method": "str", +# "properties": {"str": ...}, +# "type": "str", +# } +# }, +# "definitions": { +# "str": { +# "$ref": "str", +# "description": "str", +# "enum": ["str"], +# "enumDescriptions": {"str": "str"}, +# "estimateSourceAndConfidence": bool, +# "examples": ["str"], +# "items": ..., +# "method": "str", +# "properties": {"str": ...}, +# "type": "str", +# } +# }, +# "description": "str", +# "name": "str", +# }, +# "knowledgeSources": ["knowledge_source"], +# "models": {"str": "str"}, +# "processingLocation": "str", +# "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, +# "tags": {"str": "str"}, +# "warnings": [...], +# }, +# ).result() # call '.result()' to poll until service return final result + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# def test_content_analyzers_delete_result(self, contentunderstanding_endpoint): +# client = self.create_client(endpoint=contentunderstanding_endpoint) +# response = client.delete_result( +# operation_id="str", +# ) + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# def test_content_analyzers_get_defaults(self, contentunderstanding_endpoint): +# client = self.create_client(endpoint=contentunderstanding_endpoint) +# response = client.get_defaults() + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# def test_content_analyzers_get_operation_status(self, contentunderstanding_endpoint): +# client = self.create_client(endpoint=contentunderstanding_endpoint) +# response = client.get_operation_status( +# analyzer_id="str", +# operation_id="str", +# ) + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# def test_content_analyzers_grant_copy_authorization(self, contentunderstanding_endpoint): +# client = self.create_client(endpoint=contentunderstanding_endpoint) +# response = client.grant_copy_authorization( +# analyzer_id="str", +# body={"targetAzureResourceId": "str", "targetRegion": "str"}, +# target_azure_resource_id="str", +# ) + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# def test_content_analyzers_update_defaults(self, contentunderstanding_endpoint): +# client = self.create_client(endpoint=contentunderstanding_endpoint) +# response = client.update_defaults( +# body={"modelDeployments": {}}, +# ) + +# please add some check logic here by yourself +# ... diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py new file mode 100644 index 000000000000..4e7737911a18 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py @@ -0,0 +1,908 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +import pytest +import os +import re +from typing import Tuple, Union, Dict, Any, Optional, List, Set +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingClientTestBaseAsync, ContentUnderstandingPreparer +from azure.ai.contentunderstanding.models import ContentAnalyzer +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import AnalyzeInput +from test_helpers import ( + generate_analyzer_id, + new_simple_content_analyzer_object, + new_marketing_video_analyzer_object, + assert_poller_properties, + assert_simple_content_analyzer_result, + save_analysis_result_to_file, + save_keyframe_image_to_file, +) +from devtools_testutils import is_live, is_live_and_not_recording + + +async def create_analyzer_and_assert_async( + client: ContentUnderstandingClient, analyzer_id: str, resource: Union[ContentAnalyzer, Dict[str, Any]] +) -> Any: + """Create an analyzer and perform basic assertions (async version). + + Args: + client: The ContentUnderstandingClient instance + analyzer_id: The analyzer ID to create + resource: The analyzer resource (ContentAnalyzer object or dict) + + Returns: + Any: The poller object + + Raises: + AssertionError: If the creation fails or assertions fail + """ + print(f"\nCreating analyzer {analyzer_id}") + + # Start the analyzer creation operation + poller = await client.begin_create_or_replace( + analyzer_id=analyzer_id, + resource=resource, + ) + + # Wait for the operation to complete + print(f" Waiting for analyzer {analyzer_id} to be created") + response = await poller.result() + assert response is not None + assert poller.status() == "Succeeded" + assert poller.done() + print(f" Analyzer {analyzer_id} is created successfully") + + # Additional poller assertions + assert poller is not None + assert poller.status() is not None + assert poller.continuation_token() is not None + + return poller + + +async def delete_analyzer_and_assert( + client: ContentUnderstandingClient, analyzer_id: str, created_analyzer: bool +) -> None: + """Delete an analyzer and assert it was deleted successfully. + + Args: + client: The ContentUnderstandingClient instance + analyzer_id: The analyzer ID to delete + created_analyzer: Whether the analyzer was created (to determine if cleanup is needed) + + Raises: + AssertionError: If the analyzer still exists after deletion + """ + if created_analyzer: + print(f"Cleaning up analyzer {analyzer_id}") + try: + await client.delete(analyzer_id=analyzer_id) + except Exception as e: + # If deletion fails, the test should fail + raise AssertionError(f"Failed to delete analyzer {analyzer_id}: {e}") from e + else: + print(f"Analyzer {analyzer_id} was not created, no cleanup needed") + + +async def download_keyframes_and_assert_async( + client: ContentUnderstandingClient, + analysis_operation_id: str, + result: Any, + test_py_file_dir: str, + identifier: Optional[str] = None, +) -> None: + """Download keyframes from video analysis result and assert their existence (async version). + + Downloads up to 3 keyframes: first, middle, and last frame to avoid duplicates. + + Args: + client: The ContentUnderstandingClient instance + analysis_operation_id: The operation ID from the analysis + result: The analysis result containing markdown with keyframes + test_py_file_dir: The directory where pytest files are located + identifier: Optional unique identifier to avoid conflicts (e.g., analyzer_id) + + Returns: + None + + Raises: + AssertionError: If no keyframes are found in the analysis result + """ + keyframe_ids: Set[str] = set() + + # Iterate over contents to find keyframes from markdown + for content in result.contents: + # Extract keyframe IDs from "markdown" if it exists and is a string + markdown_content = getattr(content, "markdown", "") + if isinstance(markdown_content, str): + # Use the same regex pattern as the official sample: (keyFrame\.d+)\.jpg + keyframe_ids.update(re.findall(r"(keyFrame\.\d+)\.jpg", markdown_content)) + + print(f"Found keyframe IDs in markdown: {keyframe_ids}") + + # Assert that keyframe IDs were found in the video analysis + assert ( + keyframe_ids + ), "No keyframe IDs were found in the video analysis markdown content. Video analysis should generate keyframes that can be extracted using regex pattern." + + print(f"Successfully extracted {len(keyframe_ids)} keyframe IDs from video analysis") + + # Sort keyframes by frame number to get first, middle, and last + # Extract numeric part from "keyFrame.22367" format and convert to "keyframes/22367" format + def extract_frame_number(keyframe_id: str) -> int: + # Extract number after "keyFrame." + match = re.search(r"keyFrame\.(\d+)", keyframe_id) + if match: + return int(match.group(1)) + return 0 + + # Build keyframe paths in the format expected by get_result_file API: "keyframes/{time_ms}" + keyframe_paths = [f"keyframes/{extract_frame_number(kf)}" for kf in keyframe_ids] + + # Sort by frame number + sorted_keyframes: List[str] = sorted(keyframe_paths, key=lambda x: int(x.split("/")[-1])) + + # Create a set with first, middle, and last frames (automatically removes duplicates) + frames_set: Set[str] = {sorted_keyframes[0], sorted_keyframes[-1], sorted_keyframes[len(sorted_keyframes) // 2]} + + # Convert set to list for processing + frames_to_download: List[str] = list(frames_set) + + print(f"Selected frames to download: {frames_to_download}") + + # Try to retrieve the selected keyframe images using get_result_file API + files_retrieved: int = 0 + + for keyframe_id in frames_to_download: + print(f"Trying to get result file with path: {keyframe_id}") + response = await client.get_result_file( + operation_id=analysis_operation_id, + path=keyframe_id, # Use keyframe_id directly as path, no .jpg extension + ) + + # Handle the response - it's an async iterator that needs to be collected + from collections.abc import AsyncIterator + + assert isinstance(response, AsyncIterator), f"Expected AsyncIterator, got {type(response)}" + + # It's an async iterator, collect all bytes efficiently + chunks = [] + async for chunk in response: + chunks.append(chunk) + result_bytes = b"".join(chunks) + + # Assert that we successfully get a response and it's valid image data + assert result_bytes is not None, f"Response for path {keyframe_id} should not be None" + assert isinstance( + result_bytes, bytes + ), f"Response for {keyframe_id} should be bytes (image data), got {type(result_bytes)}" + assert len(result_bytes) > 0, f"Image file content for {keyframe_id} should not be empty" + + # Save the image file using the helper function + saved_file_path = save_keyframe_image_to_file( + image_content=result_bytes, + keyframe_id=keyframe_id, + test_name="test_content_analyzers_get_result_file", + test_py_file_dir=test_py_file_dir, + identifier=identifier, + ) + + # Verify the saved file exists and has content + assert os.path.exists(saved_file_path), f"Saved image file should exist at {saved_file_path}" + assert os.path.getsize(saved_file_path) > 0, f"Saved image file should not be empty" + + files_retrieved += 1 + print(f"Successfully downloaded keyframe image: {keyframe_id}") + + # Assert that we successfully downloaded all expected files + assert files_retrieved == len( + frames_to_download + ), f"Expected to download {len(frames_to_download)} files, but only downloaded {files_retrieved}" + print(f"Successfully completed get_result_file test - downloaded {files_retrieved} keyframe images") + + +import pytest + + +class TestContentUnderstandingContentAnalyzersOperationsAsync(ContentUnderstandingClientTestBaseAsync): + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_begin_create_with_content_analyzer( + self, contentunderstanding_endpoint: str + ) -> None: + """ + Test Summary: + - Create analyzer using ContentAnalyzer object + - Verify analyzer creation and poller properties + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "create_content_analyzer", is_async=True) + created_analyzer = False + + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, description=f"test analyzer: {analyzer_id}", tags={"tag1_name": "tag1_value"} + ) + + try: + # Create analyzer using the refactored function + poller = await create_analyzer_and_assert_async(client, analyzer_id, content_analyzer) + created_analyzer = True + + finally: + # Always clean up the created analyzer, even if the test fails + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_begin_create_with_json(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create analyzer using JSON dictionary + - Verify analyzer creation and poller properties + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "create_json", is_async=True) + created_analyzer = False + + try: + # Create analyzer using the refactored function with JSON resource + poller = await create_analyzer_and_assert_async( + client, + analyzer_id, + { + "analyzerId": analyzer_id, + "baseAnalyzerId": "prebuilt-document", + "config": { + "disableContentFiltering": False, + "disableFaceBlurring": False, + "enableFace": False, + "enableFormula": True, + "enableLayout": True, + "enableOcr": True, + "estimateFieldSourceAndConfidence": True, + "returnDetails": True, + }, + "description": f"test analyzer: {analyzer_id}", + "fieldSchema": { + "fields": { + "total_amount": { + "description": "Total amount of this table", + "method": "extract", + "type": "number", + } + }, + "description": "schema description here", + "name": "schema name here", + }, + "mode": "standard", + "processingLocation": "global", + "models": {"completion": "gpt-4o"}, # Required when using fieldSchema + "tags": {"tag1_name": "tag1_value"}, + }, + ) + created_analyzer = True + + finally: + # Always clean up the created analyzer, even if the test fails + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_update(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create initial analyzer + - Get analyzer before update to verify initial state + - Update analyzer with new description and tags + - Get analyzer after update to verify changes persisted + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "update", is_async=True) + created_analyzer = False + + # Create initial analyzer + initial_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"Initial analyzer for update test: {analyzer_id}", + tags={"initial_tag": "initial_value"}, + ) + + try: + # Create the initial analyzer using the refactored function + poller = await create_analyzer_and_assert_async(client, analyzer_id, initial_analyzer) + created_analyzer = True + + # Get the analyzer before update to verify initial state + print(f"Getting analyzer {analyzer_id} before update") + analyzer_before_update = await client.get(analyzer_id=analyzer_id) + assert analyzer_before_update is not None + assert analyzer_before_update.analyzer_id == analyzer_id + assert analyzer_before_update.description == f"Initial analyzer for update test: {analyzer_id}" + assert analyzer_before_update.tags == {"initial_tag": "initial_value"} + print( + f"Initial analyzer state verified - description: {analyzer_before_update.description}, tags: {analyzer_before_update.tags}" + ) + + # Create updated analyzer with only allowed properties (description and tags) + # Note: Service requires baseAnalyzerId and models even in PATCH update + # This is a service bug - TypeSpec says they should not be required in Update + updated_analyzer = ContentAnalyzer( + base_analyzer_id=analyzer_before_update.base_analyzer_id, # <== SERVICE-FIX: Service will return error without this + models=analyzer_before_update.models, # <== SERVICE-FIX: Service will return error without this + description=f"Updated analyzer for update test: {analyzer_id}", + tags={"initial_tag": "initial_value", "tag1_field": "updated_value"}, + ) + + print(f"Updating analyzer {analyzer_id} with new tag and description") + + # Update the analyzer + response = await client.update( + analyzer_id=analyzer_id, + resource=updated_analyzer, + ) + + # Verify the update response + assert response is not None + print(f"Update response: {response}") + + # Verify the updated analyzer has the new tag and updated description + assert response.analyzer_id == analyzer_id + assert response.tags is not None + assert "tag1_field" in response.tags + assert response.tags["tag1_field"] == "updated_value" + assert response.description == f"Updated analyzer for update test: {analyzer_id}" + + print(f"Successfully updated analyzer {analyzer_id} with new tag and description") + + # Get the analyzer after update to verify the changes persisted + print(f"Getting analyzer {analyzer_id} after update") + analyzer_after_update = await client.get(analyzer_id=analyzer_id) + assert analyzer_after_update is not None + assert analyzer_after_update.analyzer_id == analyzer_id + assert analyzer_after_update.description == f"Updated analyzer for update test: {analyzer_id}" + assert analyzer_after_update.tags == {"initial_tag": "initial_value", "tag1_field": "updated_value"} + print( + f"Updated analyzer state verified - description: {analyzer_after_update.description}, tags: {analyzer_after_update.tags}" + ) + + finally: + # Always clean up the created analyzer, even if the test fails + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_get(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Get existing prebuilt analyzer + - Verify analyzer properties and status + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = await client.get( + analyzer_id="prebuilt-documentSearch", + ) + assert response is not None + print(response) + assert response.analyzer_id == "prebuilt-documentSearch" + assert response.description is not None + assert len(response.description) > 0 + assert response.status == "ready" + assert response.created_at is not None + assert response.config is not None + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_delete(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create analyzer for deletion test + - Delete analyzer + - Clean up if deletion failed + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "delete", is_async=True) + created_analyzer = False + + # Create a simple analyzer for deletion test + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"test analyzer for deletion: {analyzer_id}", + tags={"test_type": "deletion"}, + ) + + try: + # Create analyzer using the refactored function + poller = await create_analyzer_and_assert_async(client, analyzer_id, content_analyzer) + created_analyzer = True + + # Delete the analyzer + print(f"Deleting analyzer {analyzer_id}") + response = await client.delete(analyzer_id=analyzer_id) + + # Verify the delete response + assert response is None + # client, analyzer_id + # ), f"Deleted analyzer with ID '{analyzer_id}' was found in the list" + finally: + # Clean up if the analyzer was created but deletion failed + if created_analyzer: + print(f"Cleaning up analyzer {analyzer_id} that was not properly deleted") + try: + await client.delete(analyzer_id=analyzer_id) + # Verify deletion (NOTE: check disabled - list too long to execute) + # client, analyzer_id + # ), f"Failed to delete analyzer {analyzer_id} during cleanup" + print(f"Analyzer {analyzer_id} is deleted successfully during cleanup") + except Exception as e: + # If cleanup fails, the test should fail + raise AssertionError(f"Failed to delete analyzer {analyzer_id} during cleanup: {e}") from e + elif not created_analyzer: + print(f"Analyzer {analyzer_id} was not created, no cleanup needed") + + @pytest.mark.skip(reason="TEMPORARILY SKIPPED: List operation is too long - too many analyzers") + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_list(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - List all available analyzers + - Verify list response contains expected prebuilt analyzers + - Verify each analyzer has required properties + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + response = client.list() + result = [r async for r in response] + assert len(result) > 0, "Should have at least one analyzer in the list" + print(f"Found {len(result)} analyzers") + prebuilt_found = False + for analyzer in result: + assert hasattr(analyzer, "analyzer_id"), "Each analyzer should have analyzer_id" + assert hasattr(analyzer, "description"), "Each analyzer should have description" + assert hasattr(analyzer, "status"), "Each analyzer should have status" + assert hasattr(analyzer, "created_at"), "Each analyzer should have created_at" + + if analyzer.analyzer_id == "prebuilt-documentSearch": + prebuilt_found = True + assert analyzer.status == "ready", "prebuilt-documentSearch should be ready" + print(f"Found prebuilt-documentSearch: {analyzer.description}") + + assert prebuilt_found, "prebuilt-documentSearch should be in the list" + print("List analyzers test completed successfully") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_begin_analyze_url(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create simple analyzer for URL analysis + - Begin analysis operation with URL input + - Wait for analysis completion + - Save analysis result to output file + - Verify fields node exists in first result + - Verify total_amount field exists and equals 110 + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "analyze_url", is_async=True) + created_analyzer = False + + # Create a simple analyzer for URL analysis + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"test analyzer for URL analysis: {analyzer_id}", + tags={"test_type": "url_analysis"}, + ) + + try: + # Create analyzer using the refactored function + poller = await create_analyzer_and_assert_async(client, analyzer_id, content_analyzer) + created_analyzer = True + + # Use the provided URL for the invoice PDF + invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + print(f"Starting URL analysis with analyzer {analyzer_id}") + + # Begin analysis operation with URL + analysis_poller = await client.begin_analyze( + analyzer_id=analyzer_id, inputs=[AnalyzeInput(url=invoice_url)] + ) + assert_poller_properties(analysis_poller, "Analysis poller") + + # Wait for analysis completion + print(f"Waiting for analysis completion") + analysis_result = await analysis_poller.result() + print(f" Analysis completed") + + # Get test file directory for saving output + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + output_filename = save_analysis_result_to_file( + analysis_result, "test_content_analyzers_begin_analyze_url", test_file_dir, analyzer_id + ) + + # Now assert the field results + assert_simple_content_analyzer_result(analysis_result, "Analysis result") + + finally: + # Always clean up the created analyzer, even if the test fails + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_begin_analyze_binary(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create simple analyzer for binary analysis + - Read sample invoice PDF file + - Begin binary analysis operation with analyzer + - Wait for analysis completion + - Save analysis result to output file + - Verify fields node exists in first result + - Verify total_amount field exists and equals 110 + - Clean up created analyzer + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "analyze_binary", is_async=True) + created_analyzer = False + + # Create a simple analyzer for binary analysis + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"test analyzer for binary analysis: {analyzer_id}", + tags={"test_type": "binary_analysis"}, + ) + + try: + # Create analyzer using the refactored function + poller = await create_analyzer_and_assert_async(client, analyzer_id, content_analyzer) + created_analyzer = True + + # Read the sample invoice PDF file using absolute path based on this test file's location + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + pdf_path = os.path.join(test_file_dir, "test_data", "sample_invoice.pdf") + with open(pdf_path, "rb") as pdf_file: + pdf_content = pdf_file.read() + + print(f"Starting binary analysis with analyzer {analyzer_id}") + + # Begin binary analysis operation + analysis_poller = await client.begin_analyze_binary(analyzer_id=analyzer_id, binary_input=pdf_content) + assert_poller_properties(analysis_poller, "Analysis poller") + + # Wait for analysis completion + print(f"Waiting for analysis completion") + analysis_result = await analysis_poller.result() + print(f" Analysis completed") + + output_filename = save_analysis_result_to_file( + analysis_result, "test_content_analyzers_begin_analyze_binary", test_file_dir, analyzer_id + ) + + # Now assert the field results + assert_simple_content_analyzer_result(analysis_result, "Analysis result") + + finally: + # Always clean up the created analyzer, even if the test fails + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: str) -> None: + """ + Test Summary: + - Create marketing video analyzer based on the marketing video template + - Read FlightSimulator.mp4 file + - Begin video analysis operation with analyzer + - Wait for analysis completion + - Use get_result_file to retrieve image files generated from video analysis + - Verify image file content is returned and save to test_output + - Clean up created analyzer + """ + if not is_live_and_not_recording(): + pytest.skip( + "This test requires live mode to run, as it involves large video files that are too big for test proxy to record" + ) + return # Skip this test in playback mode as it requires large video files is too big for test proxy to record + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "get_result_file", is_async=True) + created_analyzer = False + + # Create a marketing video analyzer based on the template + video_analyzer = new_marketing_video_analyzer_object( + analyzer_id=analyzer_id, + description=f"marketing video analyzer for get result file test: {analyzer_id}", + tags={"test_type": "get_result_file_video"}, + ) + + try: + # Create analyzer using the refactored function + poller = await create_analyzer_and_assert_async(client, analyzer_id, video_analyzer) + created_analyzer = True + + # Use the FlightSimulator.mp4 video file from remote location + video_file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/videos/sdk_samples/FlightSimulator.mp4" + print(f"Using video file from URL: {video_file_url}") + + # Get test file directory for saving output + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + + print(f"Starting video analysis to get operation ID") + + # Begin video analysis operation using URL + analysis_poller = await client.begin_analyze( + analyzer_id=analyzer_id, inputs=[AnalyzeInput(url=video_file_url)] + ) + + # Wait for analysis completion first + print(f"Waiting for analysis completion") + analysis_result = await analysis_poller.result() + print(f"Analysis completed") + + # Save the analysis result to file + output_filename = save_analysis_result_to_file( + analysis_result, "test_content_analyzers_get_result_file", test_file_dir, analyzer_id + ) + + # Extract operation ID for get_result_file test using custom poller's details property + from azure.ai.contentunderstanding.aio.operations._patch import AnalyzeAsyncLROPoller + + assert isinstance(analysis_poller, AnalyzeAsyncLROPoller), "Should return custom AnalyzeAsyncLROPoller" + + details = analysis_poller.details + assert "operation_id" in details, "Details should contain operation_id" + analysis_operation_id = details["operation_id"] + assert analysis_operation_id is not None, "Operation ID should not be None" + assert len(analysis_operation_id) > 0, "Operation ID should not be empty" + print(f"Analysis operation ID: {analysis_operation_id}") + + # Use the analysis result we already have from the poller to see what files are available + result = analysis_result + assert result is not None, "Analysis result should not be None" + print(f"Analysis result contains {len(result.contents)} contents") + + # Use the refactored function to download keyframes by calling client.get_result_file + await download_keyframes_and_assert_async(client, analysis_operation_id, result, test_file_dir, analyzer_id) + + finally: + # Always clean up the created analyzer, even if the test fails + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + # @ContentUnderstandingPreparer() + # @recorded_by_proxy_async + # @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# async def test_content_analyzers_begin_analyze(self, contentunderstanding_endpoint): +# client = self.create_async_client(endpoint=contentunderstanding_endpoint) +# response = await ( +# await client.begin_analyze( +# analyzer_id="str", +# body={ +# "inputs": [ +# { +# "data": bytes("bytes", encoding="utf-8"), +# "mimeType": "str", +# "name": "str", +# "range": "str", +# "url": "str", +# } +# ], +# "modelDeployments": {"str": "str"}, +# }, +# ) +# ).result() # call '.result()' to poll until service return final result + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# async def test_content_analyzers_begin_copy(self, contentunderstanding_endpoint): +# client = self.create_async_client(endpoint=contentunderstanding_endpoint) +# response = await ( +# await client.begin_copy( +# analyzer_id="str", +# body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, +# source_analyzer_id="str", +# ) +# ).result() # call '.result()' to poll until service return final result + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# async def test_content_analyzers_begin_create_or_replace(self, contentunderstanding_endpoint): +# client = self.create_async_client(endpoint=contentunderstanding_endpoint) +# response = await ( +# await client.begin_create_or_replace( +# analyzer_id="str", +# resource={ +# "analyzerId": "str", +# "createdAt": "2020-02-20 00:00:00", +# "lastModifiedAt": "2020-02-20 00:00:00", +# "status": "str", +# "baseAnalyzerId": "str", +# "config": { +# "annotationFormat": "str", +# "chartFormat": "str", +# "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, +# "disableFaceBlurring": bool, +# "enableAnnotation": bool, +# "enableFigureAnalysis": bool, +# "enableFigureDescription": bool, +# "enableFormula": bool, +# "enableLayout": bool, +# "enableOcr": bool, +# "enableSegment": bool, +# "estimateFieldSourceAndConfidence": bool, +# "locales": ["str"], +# "omitContent": bool, +# "returnDetails": bool, +# "segmentPerPage": bool, +# "tableFormat": "str", +# }, +# "description": "str", +# "dynamicFieldSchema": bool, +# "fieldSchema": { +# "fields": { +# "str": { +# "$ref": "str", +# "description": "str", +# "enum": ["str"], +# "enumDescriptions": {"str": "str"}, +# "estimateSourceAndConfidence": bool, +# "examples": ["str"], +# "items": ..., +# "method": "str", +# "properties": {"str": ...}, +# "type": "str", +# } +# }, +# "definitions": { +# "str": { +# "$ref": "str", +# "description": "str", +# "enum": ["str"], +# "enumDescriptions": {"str": "str"}, +# "estimateSourceAndConfidence": bool, +# "examples": ["str"], +# "items": ..., +# "method": "str", +# "properties": {"str": ...}, +# "type": "str", +# } +# }, +# "description": "str", +# "name": "str", +# }, +# "knowledgeSources": ["knowledge_source"], +# "models": {"str": "str"}, +# "processingLocation": "str", +# "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, +# "tags": {"str": "str"}, +# "warnings": [...], +# }, +# ) +# ).result() # call '.result()' to poll until service return final result + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# async def test_content_analyzers_delete_result(self, contentunderstanding_endpoint): +# client = self.create_async_client(endpoint=contentunderstanding_endpoint) +# response = await client.delete_result( +# operation_id="str", +# ) + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# async def test_content_analyzers_get_defaults(self, contentunderstanding_endpoint): +# client = self.create_async_client(endpoint=contentunderstanding_endpoint) +# response = await client.get_defaults() + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# async def test_content_analyzers_get_operation_status(self, contentunderstanding_endpoint): +# client = self.create_async_client(endpoint=contentunderstanding_endpoint) +# response = await client.get_operation_status( +# analyzer_id="str", +# operation_id="str", +# ) + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# async def test_content_analyzers_grant_copy_authorization(self, contentunderstanding_endpoint): +# client = self.create_async_client(endpoint=contentunderstanding_endpoint) +# response = await client.grant_copy_authorization( +# analyzer_id="str", +# body={"targetAzureResourceId": "str", "targetRegion": "str"}, +# target_azure_resource_id="str", +# ) + +# please add some check logic here by yourself +# ... + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") + + +# @ContentUnderstandingPreparer() +# @recorded_by_proxy_async +# @pytest.mark.skip(reason="GA API addition - to be implemented") +# async def test_content_analyzers_update_defaults(self, contentunderstanding_endpoint): +# client = self.create_async_client(endpoint=contentunderstanding_endpoint) +# response = await client.update_defaults( +# body={"modelDeployments": {}}, +# ) +# please add some check logic here by yourself +# diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_data/sample_invoice.pdf b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_data/sample_invoice.pdf new file mode 100644 index 0000000000000000000000000000000000000000..812bcd9b30f3bce77b4e68fbd66d43a7cbba6bd4 GIT binary patch literal 151363 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 str: + """Generate a unique analyzer ID using test name. + + Args: + client: The ContentUnderstandingClient instance (not used, kept for compatibility) + test_name: Short test identifier + is_async: If True, uses 'async' prefix; if False, uses 'sync' prefix + + Returns: + str: A unique analyzer ID (format: python_sdk_{sync|async}_{test_name}) + """ + prefix = "async" if is_async else "sync" + analyzer_id = f"python_sdk_{prefix}_{test_name}" + return analyzer_id + + +def new_simple_content_analyzer_object( + analyzer_id: str, description: Optional[str] = None, tags: Optional[Dict[str, str]] = None +) -> ContentAnalyzer: + """Create a simple ContentAnalyzer object with default configuration. + + Args: + analyzer_id: The analyzer ID + description: Optional description for the analyzer + tags: Optional tags for the analyzer + + Returns: + ContentAnalyzer: A configured ContentAnalyzer object + """ + if description is None: + description = f"test analyzer: {analyzer_id}" + if tags is None: + tags = {"test_type": "simple"} + + return ContentAnalyzer( + base_analyzer_id="prebuilt-document", + config=ContentAnalyzerConfig( + enable_formula=True, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + description=description, + field_schema=ContentFieldSchema( + fields={ + "total_amount": ContentFieldDefinition( + description="Total amount of this table", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.NUMBER, + ) + }, + description="schema description here", + name="schema name here", + ), + processing_location=ProcessingLocation.GLOBAL, + models={"completion": "gpt-4o"}, # Required when using field_schema + tags=tags, + ) + + +def new_marketing_video_analyzer_object( + analyzer_id: str, description: Optional[str] = None, tags: Optional[Dict[str, str]] = None +) -> ContentAnalyzer: + """Create a marketing video ContentAnalyzer object based on the marketing video template. + + Args: + analyzer_id: The analyzer ID + description: Optional description for the analyzer + tags: Optional tags for the analyzer + + Returns: + ContentAnalyzer: A configured ContentAnalyzer object for video analysis + """ + if description is None: + description = f"marketing video analyzer: {analyzer_id}" + if tags is None: + tags = {"test_type": "marketing_video"} + + return ContentAnalyzer( + base_analyzer_id="prebuilt-video", + config=ContentAnalyzerConfig( + return_details=True, + ), + description=description, + processing_location=ProcessingLocation.GLOBAL, + models={"completion": "gpt-4o"}, # Required when using field_schema + tags=tags, + ) + + +def assert_poller_properties(poller: Any, poller_name: str = "Poller") -> None: + """Assert common poller properties for any LROPoller or AsyncLROPoller. + + Args: + poller: The LROPoller or AsyncLROPoller instance to validate + poller_name: Optional name for the poller in log messages + + Raises: + AssertionError: If any poller property assertion fails + """ + assert poller is not None, f"{poller_name} should not be None" + assert poller.status() is not None, f"{poller_name} status should not be None" + assert poller.status() != "", f"{poller_name} status should not be empty" + assert poller.continuation_token() is not None, f"{poller_name} continuation_token should not be None" + print(f"{poller_name} properties verified successfully") + + +def assert_simple_content_analyzer_result(analysis_result: Any, result_name: str = "Analysis result") -> None: + """Assert simple content analyzer result properties and field extraction. + + Args: + analysis_result: The analysis result object to validate + result_name: Optional name for the result in log messages + + Raises: + AssertionError: If any analysis result property assertion fails + """ + print(f"Validating {result_name} properties") + assert analysis_result is not None, f"{result_name} should not be None" + assert ( + analysis_result.__class__.__name__ == "AnalyzeResult" + ), f"{result_name} should be AnalyzeResult, got {analysis_result.__class__.__name__}" + assert analysis_result.contents is not None, f"{result_name} should have contents" + assert len(analysis_result.contents) > 0, f"{result_name} should have at least one content" + + print(f"{result_name} properties verified successfully") + + # Verify fields node exists in the first result of contents + + first_content = analysis_result.contents[0] + assert hasattr(first_content, "fields"), "First content should have fields" + print(f"Verified fields node exists in first result") + + # Verify total_amount field exists and equals 110 + fields = first_content.fields + + # Fields is expected to be a dictionary + assert isinstance(fields, dict), f"Fields should be a dictionary, got {type(fields)}" + assert "total_amount" in fields, f"Fields should contain total_amount. Available fields: {list(fields.keys())}" + + total_amount_field = fields["total_amount"] + assert total_amount_field is not None, "total_amount field should not be None" + assert ( + total_amount_field.__class__.__name__ == "NumberField" + ), f"total_amount field should be of type NumberField, got {total_amount_field.__class__.__name__}" + + total_amount_value = total_amount_field.value + + print(f"Total amount field value: {total_amount_value}") + assert total_amount_value == 110, f"Expected total_amount to be 110, but got {total_amount_value}" + print(f"Total amount field validation successful") + + +def save_analysis_result_to_file( + analysis_result: Any, + test_name: str, + test_py_file_dir: str, + identifier: Optional[str] = None, + output_dir: str = "test_output", +) -> str: + """Save analysis result to output file using pytest naming convention. + + Args: + analysis_result: The analysis result object to save + test_name: Name of the test case (e.g., function name) + test_py_file_dir: Directory where pytest files are located + identifier: Optional unique identifier for the result (e.g., analyzer_id) + output_dir: Directory name to save the output file (default: "test_output") + + Returns: + str: Path to the saved output file + + Raises: + OSError: If there are issues creating directory or writing file + """ + # Create output directory if it doesn't exist + output_dir_path = os.path.join(test_py_file_dir, output_dir) + os.makedirs(output_dir_path, exist_ok=True) + + # Generate output filename with timestamp + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + + # Build filename with test name and optional identifier + if identifier: + output_filename = f"{test_name}_{identifier}_{timestamp}.json" + else: + output_filename = f"{test_name}_{timestamp}.json" + + saved_file_path = os.path.join(output_dir_path, output_filename) + + # Save the analysis result + with open(saved_file_path, "w") as output_file: + json.dump(analysis_result.as_dict(), output_file, indent=2) + + print(f"Analysis result saved to: {saved_file_path}") + return saved_file_path + + +def save_keyframe_image_to_file( + image_content: bytes, + keyframe_id: str, + test_name: str, + test_py_file_dir: str, + identifier: Optional[str] = None, + output_dir: str = "test_output", +) -> str: + """Save keyframe image to output file using pytest naming convention. + + Args: + image_content: The binary image content to save + keyframe_id: The keyframe ID (e.g., "keyframes/733") + test_name: Name of the test case (e.g., function name) + test_py_file_dir: Directory where pytest files are located + identifier: Optional unique identifier to avoid conflicts (e.g., analyzer_id) + output_dir: Directory name to save the output file (default: "test_output") + + Returns: + str: Path to the saved image file + + Raises: + OSError: If there are issues creating directory or writing file + """ + # Generate timestamp and frame ID + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + # Extract the frame time from the keyframe path (e.g., "keyframes/733" -> "733") + if "/" in keyframe_id: + frame_id = keyframe_id.split("/")[-1] + else: + # Fallback: use as-is if no slash found + frame_id = keyframe_id + + # Create output directory if it doesn't exist + output_dir_path = os.path.join(test_py_file_dir, output_dir) + os.makedirs(output_dir_path, exist_ok=True) + + # Generate output filename with optional identifier to avoid conflicts + if identifier: + output_filename = f"{test_name}_{identifier}_{timestamp}_{frame_id}.jpg" + else: + output_filename = f"{test_name}_{timestamp}_{frame_id}.jpg" + + saved_file_path = os.path.join(output_dir_path, output_filename) + + # Write the image content to file + with open(saved_file_path, "wb") as image_file: + image_file.write(image_content) + + print(f"Image file saved to: {saved_file_path}") + return saved_file_path + + +def read_image_bytes(image_path: str) -> bytes: + """Read image file and return raw bytes. + + Args: + image_path: Path to the image file + + Returns: + bytes: Raw image data as bytes + + Raises: + FileNotFoundError: If the image file doesn't exist + OSError: If there are issues reading the file + """ + with open(image_path, "rb") as image_file: + return image_file.read() + + +def get_test_data_path(relative_path: str) -> str: + """Get the absolute path to test data files. + + Args: + relative_path: Relative path from the test data directory + + Returns: + str: Absolute path to the test data file + """ + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + return os.path.join(test_file_dir, "test_data", relative_path) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py new file mode 100644 index 000000000000..e0095d569f6e --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py @@ -0,0 +1,48 @@ +# 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. +# -------------------------------------------------------------------------- +import os +from typing import cast +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential +from devtools_testutils import AzureRecordedTestCase, PowerShellPreparer +import functools + + +def get_content_understanding_credential(): + """Get the appropriate credential for Content Understanding. + + Checks for AZURE_CONTENT_UNDERSTANDING_KEY first, then falls back to DefaultAzureCredential. + """ + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + + if key and key.strip(): + return AzureKeyCredential(key) + else: + return DefaultAzureCredential() + + +class ContentUnderstandingClientTestBase(AzureRecordedTestCase): + + def create_client(self, endpoint: str) -> ContentUnderstandingClient: + credential = self.get_credential(ContentUnderstandingClient, is_async=False) + return cast( + ContentUnderstandingClient, + self.create_client_from_credential( + ContentUnderstandingClient, + credential=credential, + endpoint=endpoint, + ), + ) + + +ContentUnderstandingPreparer = functools.partial( + PowerShellPreparer, + "contentunderstanding", + contentunderstanding_endpoint="https://fake_contentunderstanding_endpoint.services.ai.azure.com/", +) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py new file mode 100644 index 000000000000..6de1d243beba --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py @@ -0,0 +1,50 @@ +# 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. +# -------------------------------------------------------------------------- +import os +from typing import cast +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential +from azure.identity.aio import DefaultAzureCredential as AsyncDefaultAzureCredential +from devtools_testutils import AzureRecordedTestCase, PowerShellPreparer +import functools + + +def get_content_understanding_credential_async(): + """Get the appropriate async credential for Content Understanding. + + Checks for AZURE_CONTENT_UNDERSTANDING_KEY first, then falls back to DefaultAzureCredential. + """ + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + + if key and key.strip(): + return AzureKeyCredential(key) + else: + return AsyncDefaultAzureCredential() + + +class ContentUnderstandingClientTestBaseAsync(AzureRecordedTestCase): + + def create_async_client(self, endpoint: str) -> ContentUnderstandingClient: + credential = self.get_credential(ContentUnderstandingClient, is_async=True) + return cast( + ContentUnderstandingClient, + self.create_client_from_credential( + ContentUnderstandingClient, + credential=credential, + endpoint=endpoint, + connection_verify=False, # Disable SSL verification for localhost + ), + ) + + +ContentUnderstandingPreparer = functools.partial( + PowerShellPreparer, + "contentunderstanding", + contentunderstanding_endpoint="https://fake_contentunderstanding_endpoint.services.ai.azure.com/", +) From 9ce48cdc0e9834bf6faf576c4807c8927466eac7 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 21 Nov 2025 15:34:57 -0800 Subject: [PATCH 020/105] add 4 new samples --- .../azure-ai-contentunderstanding/env.sample | 20 ++ .../samples/create_classifier.py | 205 ++++++++++++++++++ .../samples/delete_result.py | 178 +++++++++++++++ .../samples/get_defaults.py | 124 +++++++++++ .../samples/update_defaults.py | 144 ++++++++++++ 5 files changed, 671 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample index 308daa6f3366..646bd89482ca 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample @@ -54,6 +54,26 @@ AZURE_SKIP_LIVE_RECORDING=false # CONTENTUNDERSTANDING_CLIENT_ID=00000000-0000-0000-0000-000000000000 # CONTENTUNDERSTANDING_CLIENT_SECRET=your-client-secret +# ============================================================================ +# Model Deployment Configuration +# ============================================================================ +# Required for prebuilt analyzers: +# - prebuilt-documentSearch, prebuilt-audioSearch, prebuilt-videoSearch require GPT-4.1-mini and text-embedding-3-large +# - prebuilt-invoice, prebuilt-receipt, and others require GPT-4.1 and text-embedding-3-large +# Deploy these models in Azure AI Foundry and specify their deployment names here +# By convention, deployment names typically match the model name +# but you can use any name you chose during deployment +# Learn more: https://learn.microsoft.com/en-us/azure/ai-studio/how-to/deploy-models-openai + +# GPT-4.1 deployment (required for prebuilt-invoice, prebuilt-receipt, etc., along with text-embedding-3-large) +GPT_4_1_DEPLOYMENT=gpt-4.1 + +# GPT-4.1-mini deployment (required for prebuilt-documentSearch, prebuilt-audioSearch, prebuilt-videoSearch) +GPT_4_1_MINI_DEPLOYMENT=gpt-4.1-mini + +# Text-embedding-3-large deployment (required for prebuilt-documentSearch, prebuilt-audioSearch, prebuilt-videoSearch) +TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=text-embedding-3-large + # ============================================================================ # Custom Model Training Configuration # ============================================================================ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py new file mode 100644 index 000000000000..55f83531c63a --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py @@ -0,0 +1,205 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: create a classifier to categorize documents. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python create_classifier.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentCategoryDefinition, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Create a classifier for document categorization +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Create a custom classifier with content categories +# 3. Configure the classifier to segment multi-document files +# 4. Wait for classifier creation to complete +# 5. Verify the classifier was created successfully +# 6. Clean up by deleting the classifier +# +# Note: In Azure AI Content Understanding, classification is integrated into +# analyzers using the contentCategories configuration. The enableSegment parameter +# controls whether to split multi-document files (e.g., a loan package with multiple forms). + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + await create_document_classifier(client) + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +async def create_document_classifier(client: ContentUnderstandingClient) -> None: + """Create and configure a classifier for document categorization.""" + + # Generate a unique classifier ID + analyzer_id = f"sdk_sample_classifier_{int(asyncio.get_event_loop().time())}" + + print(f"\n🔧 Creating classifier '{analyzer_id}'...") + print("\nClassifier Configuration:") + print("=" * 60) + + # Define content categories for classification + # Each category has a name and description to guide the classification + categories = { + "Loan_Application": ContentCategoryDefinition( + description=( + "Documents submitted by individuals or businesses to request funding, " + "typically including personal or business details, financial history, " + "loan amount, purpose, and supporting documentation." + ) + ), + "Invoice": ContentCategoryDefinition( + description=( + "Billing documents issued by sellers or service providers to request " + "payment for goods or services, detailing items, prices, taxes, totals, " + "and payment terms." + ) + ), + "Bank_Statement": ContentCategoryDefinition( + description=( + "Official statements issued by banks that summarize account activity " + "over a period, including deposits, withdrawals, fees, and balances." + ) + ), + } + + # Display the categories being configured + print(" Content Categories:") + for category_name, category_obj in categories.items(): + print(f" • {category_name}") + if category_obj.description: + desc_preview = category_obj.description[:80] + "..." if len(category_obj.description) > 80 else category_obj.description + print(f" {desc_preview}") + + print("=" * 60) + + try: + # Create classifier configuration + # - base_analyzer_id: Use prebuilt-document for general document classification + # - enable_segment: Split multi-document files and classify each segment + # - return_details: Include detailed classification information + # - content_categories: Define the classification categories + classifier = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom classifier for financial document categorization", + config=ContentAnalyzerConfig( + return_details=True, + enable_segment=True, # Automatically split and classify multi-document files + content_categories=categories, + ), + models={"completion": "gpt-4o"}, # Model used for classification + tags={"sample_type": "classifier_demo", "document_type": "financial"}, + ) + + # Start the classifier creation operation + print(f"\n⏳ Starting classifier creation operation...") + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=classifier, + ) + + # Wait for the operation to complete + print(f"⏳ Waiting for classifier creation to complete...") + result = await poller.result() + print(f"\n✅ Classifier '{analyzer_id}' created successfully!") + + # Display any warnings from the creation process + if result.warnings: + print("\n⚠️ Warnings encountered while creating the classifier:") + for warning in result.warnings: + print(f" - {warning}") + + # Retrieve the full analyzer details using get_analyzer + print(f"\n📋 Retrieving classifier details...") + analyzer_details = await client.get_analyzer(analyzer_id=analyzer_id) + + print("\nClassifier Properties:") + print("=" * 60) + print(f" Analyzer ID: {analyzer_details.analyzer_id}") + print(f" Description: {analyzer_details.description}") + print(f" Base Analyzer: {analyzer_details.base_analyzer_id}") + print(f" Status: {analyzer_details.status}") + + if analyzer_details.config: + if hasattr(analyzer_details.config, "enable_segment"): + print(f" Enable Segment: {analyzer_details.config.enable_segment}") + if hasattr(analyzer_details.config, "content_categories") and analyzer_details.config.content_categories: + print(f" Categories: {len(analyzer_details.config.content_categories)}") + for cat_name in analyzer_details.config.content_categories.keys(): + print(f" • {cat_name}") + + if analyzer_details.models: + print(f" Models: {analyzer_details.models}") + + if analyzer_details.tags: + print(f" Tags: {analyzer_details.tags}") + + print("=" * 60) + + print("\n💡 Usage Tips:") + print(" • Use this classifier with begin_analyze() or begin_analyze_binary()") + print(" • Set enable_segment=True to classify different document types in a single file") + print(" • Each segment in the result will have a 'category' field with the classification") + print(" • You can add up to 200 content categories per classifier") + + # Clean up: Delete the classifier + print(f"\n🗑️ Cleaning up: Deleting classifier '{analyzer_id}'...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"✅ Classifier '{analyzer_id}' deleted successfully!") + + except Exception as e: + print(f"\n❌ Error creating classifier: {e}") + print("\nThis error may occur if:") + print(" - The GPT-4.1 model deployment is not configured (run update_defaults.py)") + print(" - You don't have permission to create analyzers") + print(" - The analyzer ID already exists (try running the sample again)") + print("\nTroubleshooting steps:") + print(" 1. Ensure default model deployments are configured (run get_defaults.py)") + print(" 2. Verify you have permissions to create analyzers") + print(" 3. Check that the endpoint and credentials are correct") + raise + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py new file mode 100644 index 000000000000..dfb10bcccd58 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py @@ -0,0 +1,178 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: analyze a document with prebuilt-invoice and delete the result. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python delete_result.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import AnalyzeInput +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Analyze document and delete the result +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Analyze an invoice document using prebuilt-invoice analyzer +# 3. Extract the operation ID from the analysis operation +# 4. Get the analysis result using the operation ID +# 5. Delete the analysis result to free up storage +# +# Note: Deleting results is useful for managing storage and cleaning up +# temporary analysis results that are no longer needed. + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + await analyze_and_delete_result(client) + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: + """Analyze a document and demonstrate result deletion.""" + + # Use a sample invoice document from GitHub + file_url = ( + "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + ) + + print("\n📄 Document Analysis Workflow") + print("=" * 60) + print(f" Document URL: {file_url}") + print(f" Analyzer: prebuilt-invoice") + print("=" * 60) + + try: + # Step 1: Start the analysis operation + print(f"\n🔍 Step 1: Starting document analysis...") + poller = await client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(url=file_url)], + ) + + # Extract the operation ID from the poller + # The operation ID is used to track and manage the analysis operation + operation_id = poller.operation_id + + if not operation_id: + print("❌ Error: Could not extract operation ID from response") + return + + print(f"✅ Analysis operation started") + print(f" Operation ID: {operation_id}") + + # Step 2: Wait for analysis to complete + print(f"\n⏳ Step 2: Waiting for analysis to complete...") + result = await poller.result() + print(f"✅ Analysis completed successfully!") + + # Step 3: Display sample results from the analysis + print(f"\n📊 Step 3: Analysis Results Summary") + print("=" * 60) + + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.fields: + # Display a few key fields from the invoice + fields_to_show = ["CustomerName", "InvoiceId", "InvoiceDate", "TotalAmount"] + print(" Sample Fields:") + for field_name in fields_to_show: + if field_name in content.fields: + field = content.fields[field_name] + if field_name == "TotalAmount" and hasattr(field, "value") and isinstance(field.value, dict): + # TotalAmount is an ObjectField with Amount and CurrencyCode + amount = field.value.get("Amount") + if amount and hasattr(amount, "value"): + print(f" • {field_name}: {amount.value}") + elif hasattr(field, "value"): + print(f" • {field_name}: {field.value}") + + print(f" Total fields extracted: {len(content.fields)}") + else: + print(" No fields found in analysis result") + else: + print(" No content found in analysis result") + + print("=" * 60) + + # Step 4: Delete the analysis result + print(f"\n🗑️ Step 4: Deleting analysis result...") + print(f" Operation ID: {operation_id}") + + await client.delete_result(operation_id=operation_id) + print(f"✅ Analysis result deleted successfully!") + + # Step 5: Verify deletion by attempting to get the result again + print(f"\n🔍 Step 5: Verifying deletion...") + print(f" Attempting to access the deleted result...") + try: + # Try to get the operation status after deletion (this is for demonstration only) + deleted_status = await client._operations._get_result(operation_id=operation_id) # type: ignore[attr-defined] + print("❌ Unexpected: Result still exists after deletion!") + except Exception as delete_error: + print(f"✅ Verification successful: Result properly deleted") + print(f" Expected error when trying to access deleted result: {type(delete_error).__name__}") + if "404" in str(delete_error) or "Not Found" in str(delete_error): + print(f" ✓ Confirmed: 404 error as expected for deleted result") + + print("\n💡 Why delete results?") + print(" • Free up storage space in your Content Understanding resource") + print(" • Remove temporary or sensitive analysis results") + print(" • Manage resource quotas and limits") + print(" • Clean up test or development analysis operations") + + print("\n📋 Note: Deleting a result marks it for deletion.") + print(" The result data will be permanently removed and cannot be recovered.") + + except Exception as e: + print(f"\n❌ Error during analysis or deletion: {e}") + print("\nThis error may occur if:") + print(" - Default model deployments are not configured (run update_defaults.py)") + print(" - The prebuilt-invoice analyzer is not available") + print(" - The document URL is not accessible") + print(" - You don't have permission to delete results") + print("\nTroubleshooting steps:") + print(" 1. Run get_defaults.py to verify model deployments are configured") + print(" 2. Check that the document URL is accessible") + print(" 3. Verify you have permissions to analyze and delete results") + print(" 4. Ensure the endpoint and credentials are correct") + raise + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py new file mode 100644 index 000000000000..a657533c228a --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py @@ -0,0 +1,124 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: retrieve default model deployment settings for Content Understanding resource. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python get_defaults.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Retrieve default model deployment settings +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Retrieve the current default model deployment mappings +# 3. Display configured model deployments +# 4. Show which prebuilt analyzers are ready to use +# +# Note: Default model deployments must be configured using update_defaults +# before prebuilt analyzers can be used. See update_defaults.py sample. + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + await get_deployment_settings(client) + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +async def get_deployment_settings(client: ContentUnderstandingClient) -> None: + """Retrieve and display default model deployment settings.""" + + print("\n📋 Retrieving default model deployment settings...") + + try: + # Get the current default settings + defaults = await client.get_defaults() + + print("\n✅ Successfully retrieved default settings") + print("\nModel Deployment Mappings:") + print("=" * 60) + + # Check if model deployments are configured + if hasattr(defaults, "model_deployments") and defaults.model_deployments: + # Display each model deployment mapping + for model_name, deployment_name in defaults.model_deployments.items(): + print(f" {model_name:<30} → {deployment_name}") + + print("=" * 60) + + # Provide context about what these models are used for + print("\n💡 Model Usage:") + if "gpt-4.1" in defaults.model_deployments: + print(" • GPT-4.1: Used by most prebuilt analyzers") + print(" (prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument, etc.)") + + if "gpt-4.1-mini" in defaults.model_deployments: + print(" • GPT-4.1-mini: Used by RAG analyzers") + print(" (prebuilt-documentSearch, prebuilt-audioSearch, prebuilt-videoSearch)") + + if "text-embedding-3-large" in defaults.model_deployments: + print(" • text-embedding-3-large: Used for semantic search and embeddings") + + print("\n✨ Your Content Understanding resource is configured!") + print(" You can now use prebuilt analyzers that depend on these models.") + + else: + print(" No model deployments configured") + print("=" * 60) + print("\n⚠️ Model deployments have not been configured yet.") + print("\n To use prebuilt analyzers, you need to:") + print(" 1. Deploy GPT-4.1, GPT-4.1-mini, and text-embedding-3-large in Azure AI Foundry") + print(" 2. Run the update_defaults.py sample to configure the mappings") + print(" 3. Run this sample again to verify the configuration") + + except Exception as e: + print(f"\n❌ Error retrieving defaults: {e}") + print("\nThis error may occur if:") + print(" - The Content Understanding resource is not properly configured") + print(" - You don't have permission to read resource settings") + print(" - The endpoint URL is incorrect") + print("\nTroubleshooting steps:") + print(" 1. Verify AZURE_CONTENT_UNDERSTANDING_ENDPOINT is correct") + print(" 2. Check your authentication credentials") + print(" 3. Ensure you have read permissions on the resource") + raise + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py new file mode 100644 index 000000000000..05817aa4ded1 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py @@ -0,0 +1,144 @@ +# pylint: disable=line-too-long,useless-suppression + +# 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. +# -------------------------------------------------------------------------- +""" +Async sample: configure default model deployments for Content Understanding resource. + +Prerequisites: + pip install azure-ai-contentunderstanding python-dotenv + az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable + +Environment variables: + AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) + AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) + GPT_4_1_DEPLOYMENT (required) - Your GPT-4.1 deployment name in Azure AI Foundry + GPT_4_1_MINI_DEPLOYMENT (required) - Your GPT-4.1-mini deployment name in Azure AI Foundry + TEXT_EMBEDDING_3_LARGE_DEPLOYMENT (required) - Your text-embedding-3-large deployment name in Azure AI Foundry + These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. + +Run: + python update_defaults.py +""" + +from __future__ import annotations +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +# --------------------------------------------------------------------------- +# Sample: Update default model deployments for Content Understanding resource +# --------------------------------------------------------------------------- +# This sample demonstrates: +# 1. Authenticate with Azure AI Content Understanding +# 2. Configure default model deployment mappings for the resource +# 3. Verify the configuration was applied successfully +# 4. Display the updated model deployment mappings +# +# Note: This configuration step is required ONCE per Azure Content Understanding resource +# before using prebuilt analyzers. It maps model names to your specific deployments. + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + print(f"Using endpoint: {endpoint}") + # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + await update_model_deployments(client) + + # Manually close DefaultAzureCredential if it was used + if isinstance(credential, DefaultAzureCredential): + await credential.close() + + +async def update_model_deployments(client: ContentUnderstandingClient) -> None: + """Configure default model deployment mappings for the Content Understanding resource.""" + + # Get deployment names from environment variables + gpt_4_1_deployment = os.getenv("GPT_4_1_DEPLOYMENT") + gpt_4_1_mini_deployment = os.getenv("GPT_4_1_MINI_DEPLOYMENT") + text_embedding_3_large_deployment = os.getenv("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + # Check if required deployments are configured + missing_deployments = [] + if not gpt_4_1_deployment: + missing_deployments.append("GPT_4_1_DEPLOYMENT") + if not gpt_4_1_mini_deployment: + missing_deployments.append("GPT_4_1_MINI_DEPLOYMENT") + if not text_embedding_3_large_deployment: + missing_deployments.append("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + if missing_deployments: + print("\n⚠️ Error: Missing required model deployment configuration(s):") + for deployment in missing_deployments: + print(f" - {deployment}") + print("\nPrebuilt analyzers require these model deployments to function correctly.") + print("\nPlease complete the following steps:") + print("1. Deploy GPT-4.1, GPT-4.1-mini, and text-embedding-3-large models in Azure AI Foundry") + print("2. Add the following to your .env file in the samples directory:") + print(" GPT_4_1_DEPLOYMENT=") + print(" GPT_4_1_MINI_DEPLOYMENT=") + print(" TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=") + print("3. Run this sample again") + return + + print("\n📋 Configuring default model deployments...") + print(f" GPT-4.1 deployment: {gpt_4_1_deployment}") + print(f" GPT-4.1-mini deployment: {gpt_4_1_mini_deployment}") + print(f" text-embedding-3-large deployment: {text_embedding_3_large_deployment}") + + try: + # Update defaults to map model names to your deployments + # The keys are the standard model names used by Content Understanding + # The values are your deployment names in Azure AI Foundry + result = await client.update_defaults( + model_deployments={ + "gpt-4.1": gpt_4_1_deployment, + "gpt-4.1-mini": gpt_4_1_mini_deployment, + "text-embedding-3-large": text_embedding_3_large_deployment, + } + ) + + print("\n✅ Default model deployments configured successfully!") + print("\nModel Mappings:") + print("=" * 60) + + # Display the configured mappings + if hasattr(result, "model_deployments") and result.model_deployments: + for model, deployment in result.model_deployments.items(): + print(f" {model:<30} → {deployment}") + else: + print(" No model deployments returned in response") + + print("=" * 60) + print("\n💡 These mappings are now configured for your Content Understanding resource.") + print(" You can now use prebuilt analyzers like 'prebuilt-invoice' and 'prebuilt-receipt'.") + + except Exception as e: + print(f"\n❌ Failed to configure defaults: {e}") + print("\nThis error may occur if:") + print(" - One or more deployment names don't exist in your Azure AI Foundry project") + print(" - The deployments exist but use different names than specified") + print(" - You don't have permission to update defaults for this resource") + print("\nPlease verify:") + print(" 1. All three models are deployed in Azure AI Foundry") + print(" 2. The deployment names in your .env file match exactly") + print(" 3. You have the necessary permissions on the Content Understanding resource") + raise + + +if __name__ == "__main__": + asyncio.run(main()) From 7bd327cb5b31339b409132903cecfe6d55fd9f03 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 21 Nov 2025 15:56:44 -0800 Subject: [PATCH 021/105] update the flow of delete result --- .../samples/delete_result.py | 29 +++++++++++++++---- 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py index dfb10bcccd58..6b82473786af 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py @@ -29,6 +29,7 @@ from azure.ai.contentunderstanding.aio import ContentUnderstandingClient from azure.ai.contentunderstanding.models import AnalyzeInput from azure.core.credentials import AzureKeyCredential +from azure.core.exceptions import ResourceNotFoundError from azure.identity.aio import DefaultAzureCredential load_dotenv() @@ -41,8 +42,9 @@ # 1. Authenticate with Azure AI Content Understanding # 2. Analyze an invoice document using prebuilt-invoice analyzer # 3. Extract the operation ID from the analysis operation -# 4. Get the analysis result using the operation ID +# 4. Get the analysis result using the operation ID and verify accessibility # 5. Delete the analysis result to free up storage +# 6. Verify deletion by confirming the result is no longer accessible (404 error) # # Note: Deleting results is useful for managing storage and cleaning up # temporary analysis results that are no longer needed. @@ -101,6 +103,14 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: result = await poller.result() print(f"✅ Analysis completed successfully!") + # Verify we can access the result before deletion (this is for demonstration only) + print(f"\n🔍 Step 2.5: Verifying result accessibility before deletion...") + try: + status_before = await client._get_result(operation_id=operation_id) # type: ignore[attr-defined] + print(f"✅ Result accessible before deletion (status: {status_before.status})") + except Exception as e: + print(f"⚠️ Unexpected error accessing result before deletion: {e}") + # Step 3: Display sample results from the analysis print(f"\n📊 Step 3: Analysis Results Summary") print("=" * 60) @@ -142,13 +152,20 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: print(f" Attempting to access the deleted result...") try: # Try to get the operation status after deletion (this is for demonstration only) - deleted_status = await client._operations._get_result(operation_id=operation_id) # type: ignore[attr-defined] + deleted_status = await client._get_result(operation_id=operation_id) # type: ignore[attr-defined] print("❌ Unexpected: Result still exists after deletion!") except Exception as delete_error: - print(f"✅ Verification successful: Result properly deleted") - print(f" Expected error when trying to access deleted result: {type(delete_error).__name__}") - if "404" in str(delete_error) or "Not Found" in str(delete_error): - print(f" ✓ Confirmed: 404 error as expected for deleted result") + if isinstance(delete_error, ResourceNotFoundError): + print(f"✅ Verification successful: Result properly deleted") + print(f" Error type: {type(delete_error).__name__}") + if hasattr(delete_error, 'error') and delete_error.error: + print(f" Code: {delete_error.error.code}") + print(f" Message: {delete_error.error.message}") + print(f" ✓ Confirmed: Result is no longer accessible as expected") + else: + print(f"❌ Unexpected error type: {type(delete_error).__name__}") + print(f" Error details: {delete_error}") + print(f" Expected ResourceNotFoundError for deleted result") print("\n💡 Why delete results?") print(" • Free up storage space in your Content Understanding resource") From 64639b0528113d4e05e18afe45bc4bc528a0eeed Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 21 Nov 2025 16:11:16 -0800 Subject: [PATCH 022/105] add note --- .../azure-ai-contentunderstanding/samples/delete_result.py | 1 + 1 file changed, 1 insertion(+) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py index 6b82473786af..33be1d9f3d62 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py @@ -175,6 +175,7 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: print("\n📋 Note: Deleting a result marks it for deletion.") print(" The result data will be permanently removed and cannot be recovered.") + print(" If not deleted manually, results are automatically deleted after 24 hours.") except Exception as e: print(f"\n❌ Error during analysis or deletion: {e}") From 01ca41df4a507d1f0e070ca312904cfca3fd581a Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 21 Nov 2025 16:51:28 -0800 Subject: [PATCH 023/105] update readme --- .../azure-ai-contentunderstanding/README.md | 121 ++++++++++++++++++ .../samples/README.md | 59 ++++++++- 2 files changed, 179 insertions(+), 1 deletion(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index b2d2861e025f..d0a87549075a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -23,6 +23,127 @@ This table shows the relationship between SDK versions and supported API service python -m pip install azure-ai-contentunderstanding ``` +### Configure your Azure AI Foundry resource and required model deployments + +Before running most samples (especially those that use prebuilt analyzers) you need to: + +1. Create (or reuse) an Azure AI Foundry resource +2. Assign the correct role so you can configure default model deployments +3. Deploy the required foundation models (GPT and Embeddings) in that resource +4. Map those deployments to standard model names using the SDK's `update_defaults` API (one-time per resource) +5. Provide environment variables (via a `.env` file at the repository root for tests, or your shell/session for ad‑hoc runs) + +#### 1. Create the Azure AI Foundry resource + +Follow the steps in the Azure portal (Create a resource > AI Foundry). The Content Understanding service is hosted within this resource. After creation, locate the endpoint under: Resource Management > Keys and Endpoint. It typically looks like: + +``` +https://.services.ai.azure.com/ +``` + +Set this as `AZURE_CONTENT_UNDERSTANDING_ENDPOINT`. + +#### 2. Grant required permissions + +To configure default model deployments you (or the service principal / managed identity you use) must have the **Cognitive Services User** role on the Azure AI Foundry resource, even if you are already an Owner. In the Azure portal: + +1. Go to your resource +2. Access Control (IAM) > Add > Add role assignment +3. Choose Cognitive Services User +4. Assign it to your identity + +Without this role, calls to `update_defaults` will fail. + +#### 3. Deploy required models + +Prebuilt analyzers rely on specific model families: + +| Prebuilt analyzers | Required deployments | +| ------------------ | -------------------- | +| `prebuilt-documentSearch`, `prebuilt-audioSearch`, `prebuilt-videoSearch` | `gpt-4.1-mini`, `text-embedding-3-large` | +| `prebuilt-invoice`, `prebuilt-receipt` and similar structured document analyzers | `gpt-4.1`, `text-embedding-3-large` | + +In Azure AI Foundry: Deployments > Deploy model > Deploy base model. Deploy each of: + +- GPT-4.1 (suggested deployment name: `gpt-4.1`) +- GPT-4.1-mini (suggested deployment name: `gpt-4.1-mini`) +- text-embedding-3-large (suggested deployment name: `text-embedding-3-large`) + +If you choose different deployment names, record them—you will use them in environment variables and when calling `update_defaults`. + +#### 4. Configure environment variables + +For local development and tests this repository uses a root-level `.env` file. A template is provided at: + +`sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample` + +Copy it to the repository root: + +```bash +cp sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample .env +``` + +Then edit `.env` and set at minimum: + +```env +AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://.services.ai.azure.com/ +# Optionally provide a key; if omitted DefaultAzureCredential is used. +AZURE_CONTENT_UNDERSTANDING_KEY= +GPT_4_1_DEPLOYMENT=gpt-4.1 +GPT_4_1_MINI_DEPLOYMENT=gpt-4.1-mini +TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=text-embedding-3-large +``` + +Notes: +- If `AZURE_CONTENT_UNDERSTANDING_KEY` is not set the SDK will fall back to `DefaultAzureCredential`. Ensure you have authenticated (e.g. `az login`). +- Keep the `.env` file out of version control—do not commit secrets. +- The model deployment variables are required for configuring defaults and for samples that use prebuilt analyzers. + +#### 5. Set default model deployments (one-time) + +Content Understanding expects a mapping from standard model names to your deployment names. Run the sample `update_defaults.py` (located in `samples/`) after the environment variables are set and roles assigned. + +Short example (async): + +```python +import os, asyncio +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +async def configure(): + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + await client.update_defaults( + model_deployments={ + "gpt-4.1": os.environ["GPT_4_1_DEPLOYMENT"], + "gpt-4.1-mini": os.environ["GPT_4_1_MINI_DEPLOYMENT"], + "text-embedding-3-large": os.environ["TEXT_EMBEDDING_3_LARGE_DEPLOYMENT"], + } + ) + if isinstance(credential, DefaultAzureCredential): + await credential.close() + +asyncio.run(configure()) +``` + +After a successful run you can immediately use prebuilt analyzers such as `prebuilt-invoice` or `prebuilt-documentSearch`. If you encounter errors: + +- Recheck deployment names (they must match exactly) +- Confirm the **Cognitive Services User** role assignment +- Verify the endpoint points to the correct resource + +You only need to perform this configuration again if you change deployment names or create a new Azure AI Foundry resource. + +#### Troubleshooting quick tips +- Missing model variables: ensure all three deployment environment variables are present; samples will warn politely if any are absent. +- Permission errors calling `update_defaults`: add (or re-add) the Cognitive Services User role. +- Authentication failures with DefaultAzureCredential: run `az login` (CLI) or configure another supported credential method. + +For more detailed setup guidance, see the official service quickstart (linked below) and the inline comments in `env.sample`. + ## Key concepts Content Understanding provides the following main capability: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index 38adb2533070..6d52a5b29e8d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -18,6 +18,7 @@ These code samples demonstrate common scenarios with the Azure AI Content Unders * Python 3.9 or later is required to use this package * You need an [Azure subscription][azure_sub] and an [Azure AI Foundry resource][contentunderstanding_quickstart] to use this package. * The Azure AI Foundry resource must be created in a [supported region][contentunderstanding_regions]. +* **Required setup:** GPT-4.1, GPT-4.1-mini, and text-embedding-3-large models must be deployed in your Azure AI Foundry project and configured using `update_defaults.py` before using prebuilt analyzers. ## Setup @@ -40,7 +41,10 @@ cd samples cp ../env.sample .env # Edit .env with your credentials -# 5. Run a sample +# 5. Configure model deployments (required for prebuilt analyzers) +python update_defaults.py + +# 6. Run a sample python analyze_url.py ``` @@ -95,11 +99,17 @@ cp ../env.sample .env Set the following in `.env`: * `AZURE_CONTENT_UNDERSTANDING_ENDPOINT` (required) - Your Azure AI Foundry resource endpoint * `AZURE_CONTENT_UNDERSTANDING_KEY` (optional) - Your API key. If not set, `DefaultAzureCredential` will be used. +* `GPT_4_1_DEPLOYMENT` (required for update_defaults.py) - Your GPT-4.1 deployment name in Azure AI Foundry +* `GPT_4_1_MINI_DEPLOYMENT` (required for update_defaults.py) - Your GPT-4.1-mini deployment name in Azure AI Foundry +* `TEXT_EMBEDDING_3_LARGE_DEPLOYMENT` (required for update_defaults.py) - Your text-embedding-3-large deployment name in Azure AI Foundry **Example `.env` file:** ```bash AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://your-resource.services.ai.azure.com/ AZURE_CONTENT_UNDERSTANDING_KEY=your-api-key-here # Optional +GPT_4_1_DEPLOYMENT=your-gpt-4.1-deployment-name +GPT_4_1_MINI_DEPLOYMENT=your-gpt-4.1-mini-deployment-name +TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=your-text-embedding-3-large-deployment-name ``` #### 4. Authenticate (if using DefaultAzureCredential) @@ -167,6 +177,24 @@ Creates a custom analyzer with content categories for document classification an **Use case:** Multi-page documents with mixed content types (e.g., PDF with invoices and bank statements) +### Resource Configuration + +#### `update_defaults.py` ⭐ +**Required setup!** Configures default model deployments for your Content Understanding resource. Maps model names (GPT-4.1, GPT-4.1-mini, text-embedding-3-large) to your Azure AI Foundry deployments. + +**Key concepts:** +- Setting up model deployment mappings +- Required before using prebuilt analyzers +- Configuring GPT-4.1, GPT-4.1-mini, and text-embedding-3-large deployments + +#### `get_defaults.py` +Retrieves and displays current default model deployment settings for your Content Understanding resource. Shows which models are configured and what they're used for. + +**Key concepts:** +- Checking current model deployment configuration +- Verifying prebuilt analyzer readiness +- Understanding model usage across different analyzers + ### Custom Analyzer Management #### `create_analyzer.py` @@ -184,6 +212,15 @@ Updates an existing analyzer configuration. #### `delete_analyzer.py` Deletes a custom analyzer. +#### `create_classifier.py` +Creates a custom classifier for document categorization with content categories. Demonstrates how to define classification categories and enable document segmentation for multi-document files. + +**Key concepts:** +- Creating classifiers with content categories +- Document categorization (Loan_Application, Invoice, Bank_Statement) +- Enabling segmentation for multi-document files +- Using GPT-4o for classification tasks + ### Advanced Features #### `create_analyzer_with_labels.py` @@ -195,6 +232,15 @@ Copies an analyzer from one location/region to another. #### `get_result_file.py` Downloads result files from analysis operations (e.g., extracted video keyframes). +#### `delete_result.py` +Demonstrates the complete workflow of analyzing a document, extracting results, and then deleting the analysis result to free up storage. Shows proper result lifecycle management. + +**Key concepts:** +- Extracting operation IDs from analysis operations +- Deleting analysis results to manage storage +- Verifying result deletion with error handling +- Understanding result retention policies (24-hour auto-deletion) + ### Utility #### `sample_helper.py` @@ -297,6 +343,17 @@ source .venv/bin/activate pip install -e . --force-reinstall ``` +### "Model deployments not configured" or "prebuilt analyzers not available" + +**Solution:** Run the setup sample to configure model deployments: +```bash +source .venv/bin/activate +cd samples +python update_defaults.py +``` + +This configures the required GPT-4.1, GPT-4.1-mini, and text-embedding-3-large model deployments that prebuilt analyzers depend on. + ## Next Steps * Review the [Azure AI Content Understanding documentation][contentunderstanding_docs] From 7f1e1a675ab3ac582328c592d488cd375f765285 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 21 Nov 2025 16:57:47 -0800 Subject: [PATCH 024/105] update sample env variables --- .../azure-ai-contentunderstanding/env.sample | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample index 646bd89482ca..d0e113808bed 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample @@ -66,13 +66,13 @@ AZURE_SKIP_LIVE_RECORDING=false # Learn more: https://learn.microsoft.com/en-us/azure/ai-studio/how-to/deploy-models-openai # GPT-4.1 deployment (required for prebuilt-invoice, prebuilt-receipt, etc., along with text-embedding-3-large) -GPT_4_1_DEPLOYMENT=gpt-4.1 +GPT_4_1_DEPLOYMENT=your-gpt-4.1-deployment # GPT-4.1-mini deployment (required for prebuilt-documentSearch, prebuilt-audioSearch, prebuilt-videoSearch) -GPT_4_1_MINI_DEPLOYMENT=gpt-4.1-mini +GPT_4_1_MINI_DEPLOYMENT=your-gpt-4.1-mini-deployment # Text-embedding-3-large deployment (required for prebuilt-documentSearch, prebuilt-audioSearch, prebuilt-videoSearch) -TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=text-embedding-3-large +TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=your-text-embedding-3-large-deployment # ============================================================================ # Custom Model Training Configuration From e1af4993a65c695c10732b78d3624c0d7db98d10 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Sun, 23 Nov 2025 00:34:33 +0000 Subject: [PATCH 025/105] SAMPLE: Update models in samples to use GPT-4.1 instead of GPT-4o for improved performance and consistency across various analyzer and classification scripts. --- .../samples/README.md | 2 +- .../samples/analyze_category.py | 2 +- .../analyze_category_enable_segments.py | 2 +- .../samples/copy_analyzer.py | 123 +++++++++++------- .../samples/create_analyzer.py | 2 +- .../samples/create_analyzer_with_labels.py | 2 +- .../samples/create_classifier.py | 2 +- .../samples/delete_analyzer.py | 2 +- .../samples/get_analyzer.py | 2 +- .../samples/get_result_file.py | 2 +- .../samples/grant_copy_auth.py | 2 +- .../samples/update_analyzer.py | 2 +- 12 files changed, 87 insertions(+), 58 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index 6d52a5b29e8d..b3eda7e9c3bf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -219,7 +219,7 @@ Creates a custom classifier for document categorization with content categories. - Creating classifiers with content categories - Document categorization (Loan_Application, Invoice, Bank_Statement) - Enabling segmentation for multi-document files -- Using GPT-4o for classification tasks +- Using GPT-4.1 for classification tasks ### Advanced Features diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py index ff5a847e4227..187b6f0612ea 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py @@ -97,7 +97,7 @@ async def main() -> None: enable_segment=False, # Disable automatic page segmentation by category ), description=f"Custom analyzer for financial document categorization without segmentation", - models={"completion": "gpt-4o"}, + models={"completion": "gpt-4.1"}, tags={"demo_type": "category_classification_without_segmentation"}, ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py index 76b9224bcf12..d514952b6a26 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py @@ -98,7 +98,7 @@ async def main() -> None: enable_segment=True, # Enable automatic page segmentation by category ), description=f"Custom analyzer for financial document categorization with automatic segmentation", - models={"completion": "gpt-4o"}, + models={"completion": "gpt-4.1"}, tags={"demo_type": "category_classification_with_segmentation"}, ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py index 9abacfeaa16b..7275a5951456 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py @@ -6,7 +6,7 @@ # Licensed under the MIT License. See License.txt in the project root for license information. # -------------------------------------------------------------------------- """ -Async sample: copy an analyzer from dev to prod using begin_copy_analyzer API. +Async sample: copy an analyzer from source to target using begin_copy_analyzer API. Prerequisites: pip install azure-ai-contentunderstanding python-dotenv @@ -18,7 +18,7 @@ These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. Run: - python copy_analyzer_to_prod.py + python copy_analyzer.py """ from __future__ import annotations @@ -42,14 +42,15 @@ # --------------------------------------------------------------------------- -# Sample: Copy analyzer from dev to prod using begin_copy_analyzer API +# Sample: Copy analyzer from source to target using begin_copy_analyzer API # --------------------------------------------------------------------------- # This sample demonstrates: # 1. Authenticate with Azure AI Content Understanding -# 2. Create a dev analyzer with "-dev" postfix and tag "modelType": "dev" -# 3. Copy the dev analyzer to prod with "-prod" postfix and tag "modelType": "prod" +# 2. Create a source analyzer with tag "modelType": "in_development" +# 3. Copy the source analyzer to target with tag "modelType": "in_production" # 4. Wait for copy operation to complete -# 5. Clean up both analyzers +# 5. Retrieve analyzer details using get_analyzer (workaround for service bug where result is empty) +# 6. Clean up both analyzers async def main() -> None: @@ -61,17 +62,17 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: base_analyzer_id = f"sdk_sample_custom_analyzer_{int(asyncio.get_event_loop().time())}" - dev_analyzer_id = f"{base_analyzer_id}_dev" - prod_analyzer_id = f"{base_analyzer_id}_prod" + source_analyzer_id = f"{base_analyzer_id}_source" + target_analyzer_id = f"{base_analyzer_id}_target" - # Step 1: Create the dev analyzer with "-dev" postfix and tag "modelType": "dev" - print(f"Creating dev analyzer '{dev_analyzer_id}' with tag 'modelType': 'dev'...") + # Step 1: Create the source analyzer with tag "modelType": "in_development" + print(f"Creating source analyzer '{source_analyzer_id}' with tag 'modelType': 'in_development'...") # Create a custom analyzer using object model (following pattern from create_analyzer.py) - dev_analyzer = ContentAnalyzer( + source_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", - description="Development analyzer for extracting company information", - tags={"modelType": "dev"}, + description="Source analyzer for extracting company information", + tags={"modelType": "in_development"}, config=ContentAnalyzerConfig( enable_formula=False, enable_layout=True, @@ -107,62 +108,90 @@ async def main() -> None: ) }, ), - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema ) poller = await client.begin_create_analyzer( - analyzer_id=dev_analyzer_id, - resource=dev_analyzer, + analyzer_id=source_analyzer_id, + resource=source_analyzer, ) - dev_result = await poller.result() - print(f"Dev analyzer '{dev_analyzer_id}' created successfully!") - print(f"Dev analyzer tags: {dev_result.tags}") - - # Step 2: Copy the dev analyzer to prod using begin_copy_analyzer API - print(f"\nCopying analyzer from '{dev_analyzer_id}' to '{prod_analyzer_id}' with tag 'modelType': 'prod'...") + await poller.result() + print(f"Source analyzer '{source_analyzer_id}' created successfully!") + + # Retrieve the full analyzer details using get_analyzer + # Note: This is a workaround for a service bug where begin_create_analyzer result + # returns empty/None values. See SERVICE-BUG.md Bug #3 for details. + print(f"\nRetrieving source analyzer details using get_analyzer...") + source_analyzer_details = await client.get_analyzer(analyzer_id=source_analyzer_id) + print(f"\n=== Source Analyzer Details ===") + print(f"Analyzer ID: {source_analyzer_details.analyzer_id}") + print(f"Description: {source_analyzer_details.description}") + print(f"Tags: {source_analyzer_details.tags}") + print(f"=== End Source Analyzer Details ===\n") + + # Step 2: Copy the source analyzer to target using begin_copy_analyzer API + print(f"Copying analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'...") # Use begin_copy_analyzer with source_analyzer_id keyword argument # The body will include sourceAnalyzerId and we can add tags to the target analyzer # Note: Tags may need to be set via update after copy, or included in the copy body if supported try: copy_poller = await client.begin_copy_analyzer( - analyzer_id=prod_analyzer_id, - source_analyzer_id=dev_analyzer_id, + analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id, ) - prod_result = await copy_poller.result() - print(f"Prod analyzer '{prod_analyzer_id}' copied successfully!") - print(f"Prod analyzer tags (before update): {prod_result.tags}") + await copy_poller.result() + print(f"Target analyzer '{target_analyzer_id}' copied successfully!") + + # Retrieve the full analyzer details using get_analyzer + # Note: This is a workaround for a service bug where begin_copy_analyzer result + # returns empty/None values. See SERVICE-BUG.md Bug #3 for details. + print(f"\nRetrieving target analyzer details using get_analyzer...") + target_analyzer_details = await client.get_analyzer(analyzer_id=target_analyzer_id) + print(f"\n=== Target Analyzer Details (before update) ===") + print(f"Analyzer ID: {target_analyzer_details.analyzer_id}") + print(f"Description: {target_analyzer_details.description}") + print(f"Tags: {target_analyzer_details.tags}") + print(f"=== End Target Analyzer Details ===\n") except Exception as e: print(f"Error copying analyzer: {e}") print("Note: The copy operation may not be available on all service endpoints.") - # Clean up dev analyzer before raising - print(f"\nDeleting dev analyzer '{dev_analyzer_id}' (cleanup after error)...") - await client.delete_analyzer(analyzer_id=dev_analyzer_id) - print(f"Dev analyzer '{dev_analyzer_id}' deleted successfully!") + # Clean up source analyzer before raising + print(f"\nDeleting source analyzer '{source_analyzer_id}' (cleanup after error)...") + await client.delete_analyzer(analyzer_id=source_analyzer_id) + print(f"Source analyzer '{source_analyzer_id}' deleted successfully!") raise - # Update the prod analyzer to add the "modelType": "prod" tag + # Update the target analyzer to add the "modelType": "in_production" tag # Since copy may not preserve or set tags, we update after copying - print(f"\nUpdating prod analyzer '{prod_analyzer_id}' with tag 'modelType': 'prod'...") - updated_prod_analyzer = ContentAnalyzer( - tags={"modelType": "prod"} + print(f"Updating target analyzer '{target_analyzer_id}' with tag 'modelType': 'in_production'...") + updated_target_analyzer = ContentAnalyzer( + tags={"modelType": "in_production"} ) - final_prod_result = await client.update_analyzer( - analyzer_id=prod_analyzer_id, - resource=updated_prod_analyzer, + await client.update_analyzer( + analyzer_id=target_analyzer_id, + resource=updated_target_analyzer, ) - print(f"Prod analyzer '{prod_analyzer_id}' updated successfully!") - print(f"Prod analyzer tags: {final_prod_result.tags}") + print(f"Target analyzer '{target_analyzer_id}' updated successfully!") + + # Retrieve the updated analyzer details + print(f"\nRetrieving updated target analyzer details...") + final_target_analyzer_details = await client.get_analyzer(analyzer_id=target_analyzer_id) + print(f"\n=== Target Analyzer Details (after update) ===") + print(f"Analyzer ID: {final_target_analyzer_details.analyzer_id}") + print(f"Description: {final_target_analyzer_details.description}") + print(f"Tags: {final_target_analyzer_details.tags}") + print(f"=== End Target Analyzer Details ===\n") # Clean up the created analyzers (demo cleanup) - print(f"\nDeleting analyzers (demo cleanup)...") - print(f"Deleting dev analyzer '{dev_analyzer_id}'...") - await client.delete_analyzer(analyzer_id=dev_analyzer_id) - print(f"Dev analyzer '{dev_analyzer_id}' deleted successfully!") + print(f"Deleting analyzers (demo cleanup)...") + print(f"Deleting source analyzer '{source_analyzer_id}'...") + await client.delete_analyzer(analyzer_id=source_analyzer_id) + print(f"Source analyzer '{source_analyzer_id}' deleted successfully!") - print(f"Deleting prod analyzer '{prod_analyzer_id}'...") - await client.delete_analyzer(analyzer_id=prod_analyzer_id) - print(f"Prod analyzer '{prod_analyzer_id}' deleted successfully!") + print(f"Deleting target analyzer '{target_analyzer_id}'...") + await client.delete_analyzer(analyzer_id=target_analyzer_id) + print(f"Target analyzer '{target_analyzer_id}' deleted successfully!") # Manually close DefaultAzureCredential if it was used if isinstance(credential, DefaultAzureCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py index 1b23ab195753..94f944a8befc 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py @@ -113,7 +113,7 @@ async def main() -> None: ), }, ), - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema ) print(f"Creating custom analyzer '{analyzer_id}'...") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py index 62dc7fb09e08..131e83537c7b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py @@ -202,7 +202,7 @@ async def main() -> None: ), field_schema=field_schema, knowledge_sources=cast(list[KnowledgeSource] | None, knowledge_sources) if knowledge_sources else None, - models={"completion": "gpt-4o", "embedding": "text-embedding-ada-002"}, # Required when using field_schema + models={"completion": "gpt-4.1", "embedding": "text-embedding-ada-002"}, # Required when using field_schema ) poller = await client.begin_create_analyzer( diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py index 55f83531c63a..0381fdfbe5a0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py @@ -128,7 +128,7 @@ async def create_document_classifier(client: ContentUnderstandingClient) -> None enable_segment=True, # Automatically split and classify multi-document files content_categories=categories, ), - models={"completion": "gpt-4o"}, # Model used for classification + models={"completion": "gpt-4.1"}, # Model used for classification tags={"sample_type": "classifier_demo", "document_type": "financial"}, ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py index a3b269f30140..0723af133c24 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py @@ -78,7 +78,7 @@ async def main() -> None: ), }, ), - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema ) poller = await client.begin_create_analyzer( diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py index 7773d9ba2145..46a5634c3ce3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py @@ -103,7 +103,7 @@ async def main() -> None: ), }, ), - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema ) poller = await client.begin_create_analyzer( diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py index 61040cb71096..87d3ac520709 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py @@ -137,7 +137,7 @@ async def main(): config=ContentAnalyzerConfig( return_details=True, ), - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema description="Marketing video analyzer for result file demo", tags={"demo_type": "video_analysis"}, ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py index 4fb05768fbfa..efb89dc05189 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py @@ -117,7 +117,7 @@ async def main() -> None: ) }, ), - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema ) poller = await source_client.begin_create_analyzer( diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py index 80bc1f12d32f..79af603087b3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py @@ -93,7 +93,7 @@ async def main(): description="Schema for update demo", name="update_demo_schema", ), - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema processing_location=ProcessingLocation.GLOBAL, tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, ) From c90668f89bdef8de0dce6c520c661d520fb893b4 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Sun, 23 Nov 2025 00:39:27 +0000 Subject: [PATCH 026/105] Clean up sample output --- .../samples/analyze_category.py | 14 +++++----- .../analyze_category_enable_segments.py | 14 +++++----- .../samples/create_classifier.py | 16 +++++------ .../samples/delete_result.py | 28 +++++++++---------- .../samples/get_defaults.py | 8 +++--- .../samples/update_defaults.py | 6 ++-- 6 files changed, 43 insertions(+), 43 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py index 187b6f0612ea..dc36e513570d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py @@ -109,7 +109,7 @@ async def main() -> None: print("Waiting for analyzer creation to complete...") result = await poller.result() - print(f"✅ Analyzer '{analyzer_id}' created successfully!\n") + print(f"Analyzer '{analyzer_id}' created successfully!\n") if result.warnings: print("⚠️ Warnings encountered while building the analyzer:") @@ -140,7 +140,7 @@ async def main() -> None: continue print(f"{'=' * 60}") - print(f"📄 Analyzing: {test_file}") + print(f"Analyzing: {test_file}") print(f"{'=' * 60}") # Read and analyze the document @@ -154,10 +154,10 @@ async def main() -> None: ) analyze_result: AnalyzeResult = await analyze_poller.result() - print("✅ Classification completed!\n") + print("Classification completed!\n") # Display classification results - print("📊 Classification Results:") + print("Classification Results:") print("-" * 60) for content in analyze_result.contents: @@ -187,13 +187,13 @@ async def main() -> None: with open(result_file, "w") as f: json.dump(analyze_result.as_dict(), f, indent=2, default=str) - print(f"💾 Results saved to: {result_file}\n") + print(f"Results saved to: {result_file}\n") # Cleanup print(f"{'=' * 60}") - print(f"🗑️ Deleting analyzer '{analyzer_id}' (demo cleanup)...") + print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"✅ Analyzer '{analyzer_id}' deleted successfully!") + print(f"Analyzer '{analyzer_id}' deleted successfully!") print(f"{'=' * 60}") # Close DefaultAzureCredential if used diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py index d514952b6a26..679e04e4cea9 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py @@ -110,7 +110,7 @@ async def main() -> None: print("Waiting for analyzer creation to complete...") result = await poller.result() - print(f"✅ Analyzer '{analyzer_id}' created successfully!\n") + print(f"Analyzer '{analyzer_id}' created successfully!\n") if result.warnings: print("⚠️ Warnings encountered while building the analyzer:") @@ -141,7 +141,7 @@ async def main() -> None: continue print(f"{'=' * 60}") - print(f"📄 Analyzing: {test_file}") + print(f"Analyzing: {test_file}") print(f"{'=' * 60}") # Read and analyze the document @@ -155,10 +155,10 @@ async def main() -> None: ) analyze_result: AnalyzeResult = await analyze_poller.result() - print("✅ Classification completed!\n") + print("Classification completed!\n") # Display classification results - print("📊 Classification Results (with automatic segmentation):") + print("Classification Results (with automatic segmentation):") print("-" * 60) for content in analyze_result.contents: @@ -189,13 +189,13 @@ async def main() -> None: with open(result_file, "w") as f: json.dump(analyze_result.as_dict(), f, indent=2, default=str) - print(f"💾 Results saved to: {result_file}\n") + print(f"Results saved to: {result_file}\n") # Cleanup print(f"{'=' * 60}") - print(f"🗑️ Deleting analyzer '{analyzer_id}' (demo cleanup)...") + print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"✅ Analyzer '{analyzer_id}' deleted successfully!") + print(f"Analyzer '{analyzer_id}' deleted successfully!") print(f"{'=' * 60}") # Close DefaultAzureCredential if used diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py index 0381fdfbe5a0..fb54e595e236 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py @@ -75,7 +75,7 @@ async def create_document_classifier(client: ContentUnderstandingClient) -> None # Generate a unique classifier ID analyzer_id = f"sdk_sample_classifier_{int(asyncio.get_event_loop().time())}" - print(f"\n🔧 Creating classifier '{analyzer_id}'...") + print(f"\nCreating classifier '{analyzer_id}'...") print("\nClassifier Configuration:") print("=" * 60) @@ -133,16 +133,16 @@ async def create_document_classifier(client: ContentUnderstandingClient) -> None ) # Start the classifier creation operation - print(f"\n⏳ Starting classifier creation operation...") + print(f"\nStarting classifier creation operation...") poller = await client.begin_create_analyzer( analyzer_id=analyzer_id, resource=classifier, ) # Wait for the operation to complete - print(f"⏳ Waiting for classifier creation to complete...") + print(f"Waiting for classifier creation to complete...") result = await poller.result() - print(f"\n✅ Classifier '{analyzer_id}' created successfully!") + print(f"\nClassifier '{analyzer_id}' created successfully!") # Display any warnings from the creation process if result.warnings: @@ -151,7 +151,7 @@ async def create_document_classifier(client: ContentUnderstandingClient) -> None print(f" - {warning}") # Retrieve the full analyzer details using get_analyzer - print(f"\n📋 Retrieving classifier details...") + print(f"\nRetrieving classifier details...") analyzer_details = await client.get_analyzer(analyzer_id=analyzer_id) print("\nClassifier Properties:") @@ -177,16 +177,16 @@ async def create_document_classifier(client: ContentUnderstandingClient) -> None print("=" * 60) - print("\n💡 Usage Tips:") + print("\nUsage Tips:") print(" • Use this classifier with begin_analyze() or begin_analyze_binary()") print(" • Set enable_segment=True to classify different document types in a single file") print(" • Each segment in the result will have a 'category' field with the classification") print(" • You can add up to 200 content categories per classifier") # Clean up: Delete the classifier - print(f"\n🗑️ Cleaning up: Deleting classifier '{analyzer_id}'...") + print(f"\nCleaning up: Deleting classifier '{analyzer_id}'...") await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"✅ Classifier '{analyzer_id}' deleted successfully!") + print(f"Classifier '{analyzer_id}' deleted successfully!") except Exception as e: print(f"\n❌ Error creating classifier: {e}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py index 33be1d9f3d62..7f6db6f52b04 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py @@ -73,7 +73,7 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" ) - print("\n📄 Document Analysis Workflow") + print("\nDocument Analysis Workflow") print("=" * 60) print(f" Document URL: {file_url}") print(f" Analyzer: prebuilt-invoice") @@ -81,7 +81,7 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: try: # Step 1: Start the analysis operation - print(f"\n🔍 Step 1: Starting document analysis...") + print(f"\nStep 1: Starting document analysis...") poller = await client.begin_analyze( analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(url=file_url)], @@ -95,24 +95,24 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: print("❌ Error: Could not extract operation ID from response") return - print(f"✅ Analysis operation started") + print(f"Analysis operation started") print(f" Operation ID: {operation_id}") # Step 2: Wait for analysis to complete - print(f"\n⏳ Step 2: Waiting for analysis to complete...") + print(f"\nStep 2: Waiting for analysis to complete...") result = await poller.result() - print(f"✅ Analysis completed successfully!") + print(f"Analysis completed successfully!") # Verify we can access the result before deletion (this is for demonstration only) - print(f"\n🔍 Step 2.5: Verifying result accessibility before deletion...") + print(f"\nStep 2.5: Verifying result accessibility before deletion...") try: status_before = await client._get_result(operation_id=operation_id) # type: ignore[attr-defined] - print(f"✅ Result accessible before deletion (status: {status_before.status})") + print(f"Result accessible before deletion (status: {status_before.status})") except Exception as e: print(f"⚠️ Unexpected error accessing result before deletion: {e}") # Step 3: Display sample results from the analysis - print(f"\n📊 Step 3: Analysis Results Summary") + print(f"\nStep 3: Analysis Results Summary") print("=" * 60) if result.contents and len(result.contents) > 0: @@ -141,14 +141,14 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: print("=" * 60) # Step 4: Delete the analysis result - print(f"\n🗑️ Step 4: Deleting analysis result...") + print(f"\nStep 4: Deleting analysis result...") print(f" Operation ID: {operation_id}") await client.delete_result(operation_id=operation_id) - print(f"✅ Analysis result deleted successfully!") + print(f"Analysis result deleted successfully!") # Step 5: Verify deletion by attempting to get the result again - print(f"\n🔍 Step 5: Verifying deletion...") + print(f"\nStep 5: Verifying deletion...") print(f" Attempting to access the deleted result...") try: # Try to get the operation status after deletion (this is for demonstration only) @@ -156,7 +156,7 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: print("❌ Unexpected: Result still exists after deletion!") except Exception as delete_error: if isinstance(delete_error, ResourceNotFoundError): - print(f"✅ Verification successful: Result properly deleted") + print(f"Verification successful: Result properly deleted") print(f" Error type: {type(delete_error).__name__}") if hasattr(delete_error, 'error') and delete_error.error: print(f" Code: {delete_error.error.code}") @@ -167,13 +167,13 @@ async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: print(f" Error details: {delete_error}") print(f" Expected ResourceNotFoundError for deleted result") - print("\n💡 Why delete results?") + print("\nWhy delete results?") print(" • Free up storage space in your Content Understanding resource") print(" • Remove temporary or sensitive analysis results") print(" • Manage resource quotas and limits") print(" • Clean up test or development analysis operations") - print("\n📋 Note: Deleting a result marks it for deletion.") + print("\nNote: Deleting a result marks it for deletion.") print(" The result data will be permanently removed and cannot be recovered.") print(" If not deleted manually, results are automatically deleted after 24 hours.") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py index a657533c228a..045ad20e1a55 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py @@ -64,13 +64,13 @@ async def main() -> None: async def get_deployment_settings(client: ContentUnderstandingClient) -> None: """Retrieve and display default model deployment settings.""" - print("\n📋 Retrieving default model deployment settings...") + print("\nRetrieving default model deployment settings...") try: # Get the current default settings defaults = await client.get_defaults() - print("\n✅ Successfully retrieved default settings") + print("\nSuccessfully retrieved default settings") print("\nModel Deployment Mappings:") print("=" * 60) @@ -83,7 +83,7 @@ async def get_deployment_settings(client: ContentUnderstandingClient) -> None: print("=" * 60) # Provide context about what these models are used for - print("\n💡 Model Usage:") + print("\nModel Usage:") if "gpt-4.1" in defaults.model_deployments: print(" • GPT-4.1: Used by most prebuilt analyzers") print(" (prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument, etc.)") @@ -95,7 +95,7 @@ async def get_deployment_settings(client: ContentUnderstandingClient) -> None: if "text-embedding-3-large" in defaults.model_deployments: print(" • text-embedding-3-large: Used for semantic search and embeddings") - print("\n✨ Your Content Understanding resource is configured!") + print("\nYour Content Understanding resource is configured!") print(" You can now use prebuilt analyzers that depend on these models.") else: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py index 05817aa4ded1..5772b80204b2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py @@ -95,7 +95,7 @@ async def update_model_deployments(client: ContentUnderstandingClient) -> None: print("3. Run this sample again") return - print("\n📋 Configuring default model deployments...") + print("\nConfiguring default model deployments...") print(f" GPT-4.1 deployment: {gpt_4_1_deployment}") print(f" GPT-4.1-mini deployment: {gpt_4_1_mini_deployment}") print(f" text-embedding-3-large deployment: {text_embedding_3_large_deployment}") @@ -112,7 +112,7 @@ async def update_model_deployments(client: ContentUnderstandingClient) -> None: } ) - print("\n✅ Default model deployments configured successfully!") + print("\nDefault model deployments configured successfully!") print("\nModel Mappings:") print("=" * 60) @@ -124,7 +124,7 @@ async def update_model_deployments(client: ContentUnderstandingClient) -> None: print(" No model deployments returned in response") print("=" * 60) - print("\n💡 These mappings are now configured for your Content Understanding resource.") + print("\nThese mappings are now configured for your Content Understanding resource.") print(" You can now use prebuilt analyzers like 'prebuilt-invoice' and 'prebuilt-receipt'.") except Exception as e: From 98fdfbc2f1df0272b037563e9e192af5d32640cd Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 25 Nov 2025 16:58:48 -0800 Subject: [PATCH 027/105] first version --- .../samples/analyze_binary.py | 131 ------ .../samples/analyze_binary_features.py | 380 ------------------ .../samples/analyze_binary_raw_json.py | 105 ----- .../samples/analyze_category.py | 206 ---------- .../analyze_category_enable_segments.py | 207 ---------- .../samples/analyze_url.py | 124 ------ .../samples/analyze_url_prebuilt_invoice.py | 160 -------- .../samples/copy_analyzer.py | 203 ---------- .../samples/create_analyzer.py | 143 ------- .../samples/create_analyzer_with_labels.py | 264 ------------ .../samples/create_classifier.py | 205 ---------- .../samples/delete_analyzer.py | 102 ----- .../samples/delete_result.py | 196 --------- .../samples/get_analyzer.py | 144 ------- .../samples/get_defaults.py | 124 ------ .../samples/get_result_file.py | 266 ------------ .../samples/grant_copy_auth.py | 260 ------------ .../samples/list_analyzers.py | 114 ------ .../samples/sample_analyze_binary.py | 133 ++++++ .../samples/sample_analyze_configs.py | 205 ++++++++++ .../samples/sample_analyze_invoice.py | 161 ++++++++ .../samples/sample_analyze_return_raw_json.py | 122 ++++++ .../samples/sample_analyze_url.py | 97 +++++ .../samples/sample_configure_defaults.py | 114 ++++++ .../samples/sample_copy_analyzer.py | 185 +++++++++ .../samples/sample_create_analyzer.py | 153 +++++++ .../samples/sample_create_classifier.py | 177 ++++++++ .../samples/sample_delete_analyzer.py | 104 +++++ .../samples/sample_delete_result.py | 125 ++++++ .../samples/sample_get_analyzer.py | 160 ++++++++ .../samples/sample_get_result_file.py | 151 +++++++ .../samples/sample_grant_copy_auth.py | 213 ++++++++++ .../samples/sample_helper.py | 69 ---- .../samples/sample_list_analyzers.py | 92 +++++ .../samples/sample_update_analyzer.py | 145 +++++++ .../samples/update_analyzer.py | 161 -------- 36 files changed, 2337 insertions(+), 3564 deletions(-) delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_features.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_raw_json.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url_prebuilt_invoice.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/list_analyzers.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary.py deleted file mode 100644 index c3a88a3de588..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary.py +++ /dev/null @@ -1,131 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: use the prebuilt-documentSearch to extract content from a PDF. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python analyze_binary.py -""" - -from __future__ import annotations - -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - AnalyzeResult, - MediaContent, - DocumentContent, - MediaContentKind, -) -from sample_helper import save_json_to_file -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Extract content from PDF using begin_analyze_binary API -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Read a PDF file from disk -# 3. Analyze the document using begin_analyze_binary with prebuilt-documentSearch -# 4. Print the markdown content from the analysis result -# -# prebuilt-documentSearch is an AI-enhanced analyzer that extends prebuilt-document with: -# - Document summarization: Returns a "Summary" field with AI-generated document summaries -# - Figure analysis: Extracts descriptions and analyzes figures in documents (enableFigureDescription, enableFigureAnalysis) -# - Enhanced output: Provides more detailed analysis results (returnDetails: true) -# - AI completion model: Uses gpt-4.1-mini for intelligent content extraction - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - with open("sample_files/sample_invoice.pdf", "rb") as f: - pdf_bytes: bytes = f.read() - - print("Analyzing sample_files/sample_invoice.pdf with prebuilt-documentSearch...") - poller = await client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=pdf_bytes, - ) - result: AnalyzeResult = await poller.result() - - # AnalyzeResult contains the full analysis result and can be used to access various properties - # We are using markdown content as an example of what can be extracted - print("\nMarkdown Content:") - print("=" * 50) - # A PDF file has only one content element even if it contains multiple pages - content: MediaContent = result.contents[0] - print(content.markdown) - print("=" * 50) - - # Check if this is document content to access document-specific properties - if content.kind == MediaContentKind.DOCUMENT: - # Type assertion: we know this is DocumentContent for PDF files - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f"Start page: {document_content.start_page_number}") - print(f"End page: {document_content.end_page_number}") - print(f"Total pages: {document_content.end_page_number - document_content.start_page_number + 1}") - - # Check for pages - if document_content.pages is not None: - print(f"\nPages ({len(document_content.pages)}):") - for i, page in enumerate(document_content.pages): - unit = document_content.unit or "units" - print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") - - # The following code shows how to access DocumentContent properties - # Check if there are tables in the document - if document_content.tables is not None: - print(f"\nTables ({len(document_content.tables)}):") - table_counter = 1 - # Iterate through tables, each table is of type DocumentTable - for table in document_content.tables: - # Type: table is DocumentTable - # Get basic table dimensions - row_count: int = table.row_count - col_count: int = table.column_count - print(f" Table {table_counter}: {row_count} rows x {col_count} columns") - table_counter += 1 - # You can use the table object model to get detailed information - # such as cell content, borders, spans, etc. (not shown to keep code concise) - else: - print("\nDocument Information: Not available for this content type") - - # Uncomment the following line to save the response to a file for object model inspection - # Note: This saves the object model, not the raw JSON response - # To get the full raw JSON response, see the sample: analyze_binary_raw_json.py - # save_json_to_file(result.as_dict(), filename_prefix="analyze_binary") - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_features.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_features.py deleted file mode 100644 index 87314a39ec6a..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_features.py +++ /dev/null @@ -1,380 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: demonstrate additional features on prebuilt-documentSearch to show results for charts, hyperlinks, and PDF annotations from PDF. - -This sample demonstrates the additional features available in the prebuilt-documentSearch analyzer: -- Charts: Extraction and analysis of charts from PDF documents -- Hyperlinks: Detection and extraction of hyperlinks in PDF documents -- PDF Annotations: Detection and extraction of annotations (highlights, comments, etc.) from PDF documents - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python analyze_binary_features.py -""" - -from __future__ import annotations - -import asyncio -import json -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - AnalyzeResult, - MediaContent, - DocumentContent, - MediaContentKind, - DocumentChartFigure, - DocumentFigureKind, - DocumentAnnotation, - DocumentAnnotationKind, - DocumentHyperlink, - DocumentFormula, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential -from sample_helper import save_json_to_file - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Demonstrate additional features on prebuilt-documentSearch -# --------------------------------------------------------------------------- -# This sample demonstrates additional features on prebuilt-documentSearch to show -# results for charts, hyperlinks, and PDF annotations from PDF documents. -# -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Read a PDF file from disk -# 3. Analyze the document using begin_analyze_binary with prebuilt-documentSearch -# 4. Extract and display chart information from figures -# 5. Extract and display annotation information -# 6. Extract and display hyperlink information -# 7. Extract and display formula information -# -# The prebuilt-documentSearch analyzer has the following additional features enabled: -# - enableFigureDescription: True - Enables figure descriptions -# - enableFigureAnalysis: True - Enables figure analysis including charts -# - chartFormat: 'chartjs' - Charts are represented as Chart.js config in the figure content -# - annotationFormat: 'markdown' - Enables annotation detection and represents annotations in markdown format -# - returnDetails: True - Returns detailed information including figures and annotations -# -# Note: The analyzer also has other features enabled (enableOcr, enableLayout, enableFormula, etc.) -# but this sample focuses on demonstrating charts, hyperlinks, and PDF annotations. -# -# Charts are accessed via: -# - document_content.figures - List of all figures (including charts) -# - Filter figures where figure.kind == DocumentFigureKind.CHART to get charts -# - Each DocumentChartFigure has a 'content' property containing Chart.js configuration -# - Charts are also embedded in the markdown content based on chartFormat setting -# -# Annotations are accessed via: -# - document_content.annotations - List of all annotations in the document -# - Each DocumentAnnotation has properties like kind, spans, comments, author, etc. -# - Annotations are also represented in the markdown content based on annotationFormat setting -# -# Hyperlinks are accessed via: -# - document_content.hyperlinks - List of all hyperlinks in the document -# - Each DocumentHyperlink has properties like content (link text), url, span, source -# - Hyperlinks are also represented in the markdown content as [text](url) format - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - # Read the sample_document_features.pdf file - pdf_path = "sample_files/sample_document_features.pdf" - with open(pdf_path, "rb") as f: - pdf_bytes: bytes = f.read() - - print(f"Analyzing {pdf_path} with prebuilt-documentSearch...") - print("This sample demonstrates additional features: charts, hyperlinks, and PDF annotations.") - print() - - # Analyze the document using prebuilt-documentSearch - # The analyzer config includes: - # - enableFigureAnalysis: True (enables chart detection and analysis) - # - chartFormat: 'chartjs' (charts represented as Chart.js config) - # - annotationFormat: 'markdown' (enables annotation detection and represents annotations in markdown format) - poller = await client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=pdf_bytes, - ) - result: AnalyzeResult = await poller.result() - - # Get the document content from the analysis result - content: MediaContent = result.contents[0] - - # Verify this is document content - if content.kind != MediaContentKind.DOCUMENT: - print("Error: Expected document content") - return - - # Type assertion: we know this is DocumentContent for PDF files - document_content: DocumentContent = content # type: ignore - - print("=" * 80) - print("DOCUMENT ANALYSIS RESULTS") - print("=" * 80) - print(f"Start page: {document_content.start_page_number}") - print(f"End page: {document_content.end_page_number}") - print(f"Total pages: {document_content.end_page_number - document_content.start_page_number + 1}") - print() - - # ===================================================================== - # PART 1: EXTRACT AND DISPLAY CHARTS - # ===================================================================== - # Charts are stored in document_content.figures - # We need to filter for figures where kind == DocumentFigureKind.CHART - # Each chart figure (DocumentChartFigure) contains: - # - id: Unique identifier for the chart - # - content: Chart.js configuration object (when chartFormat is 'chartjs') - # - description: AI-generated description of the chart - # - caption: Chart caption if present - # - span: Location of the chart in the markdown content - # - source: Position of the chart in the document - print("=" * 80) - print("CHARTS EXTRACTION") - print("=" * 80) - - if document_content.figures: - # Filter for chart figures - # Charts are a subtype of DocumentFigure with kind == DocumentFigureKind.CHART - # We can check the kind property or use isinstance with DocumentChartFigure - chart_figures = [ - figure for figure in document_content.figures - if isinstance(figure, DocumentChartFigure) or - (hasattr(figure, 'kind') and figure.kind == DocumentFigureKind.CHART) - ] - - print(f"Found {len(chart_figures)} chart(s) in the document") - print() - - for i, figure in enumerate(chart_figures, 1): - # Cast to DocumentChartFigure for type safety - chart: DocumentChartFigure = figure # type: ignore - - print(f"Chart {i}:") - print(f" ID: {chart.id}") - print(f" Source: {chart.source}") - - if chart.description: - print(f" Description: {chart.description}") - - if chart.caption: - print(f" Caption: {chart.caption.content}") - - if chart.span: - print(f" Location in markdown: offset={chart.span.offset}, length={chart.span.length}") - - # The chart content contains Chart.js configuration - # This is a JSON object that can be used with Chart.js library to render the chart - if chart.content: - print(f" Chart.js Config:") - print(f" {json.dumps(chart.content, indent=4, default=str)}") - - print() - else: - print("No figures found in the document") - print() - - # ===================================================================== - # PART 2: EXTRACT AND DISPLAY ANNOTATIONS - # ===================================================================== - # Annotations are stored in document_content.annotations - # Each annotation (DocumentAnnotation) contains: - # - id: Unique identifier for the annotation - # - kind: Type of annotation (highlight, strikethrough, underline, italic, bold, circle, note) - # - spans: List of content spans where the annotation appears - # - comments: List of comments associated with the annotation - # - author: Author of the annotation - # - created_at: When the annotation was created - # - tags: Tags associated with the annotation - print("=" * 80) - print("ANNOTATIONS EXTRACTION") - print("=" * 80) - - if document_content.annotations: - print(f"Found {len(document_content.annotations)} annotation(s) in the document") - print() - - for i, annotation in enumerate(document_content.annotations, 1): - print(f"Annotation {i}:") - print(f" ID: {annotation.id}") - print(f" Kind: {annotation.kind}") - - if annotation.spans: - print(f" Spans ({len(annotation.spans)}):") - for span in annotation.spans: - print(f" - offset={span.offset}, length={span.length}") - - if annotation.comments: - print(f" Comments ({len(annotation.comments)}):") - for comment in annotation.comments: - print(f" - {comment.message}") - - if annotation.author: - print(f" Author: {annotation.author}") - - if annotation.created_at: - print(f" Created at: {annotation.created_at}") - - if annotation.tags: - print(f" Tags: {annotation.tags}") - - if annotation.source: - print(f" Source: {annotation.source}") - - print() - else: - print("No annotations found in the document") - print() - - # ===================================================================== - # PART 3: EXTRACT AND DISPLAY HYPERLINKS - # ===================================================================== - # Hyperlinks are stored in document_content.hyperlinks - # Each hyperlink (DocumentHyperlink) contains: - # - content: The text/content that is hyperlinked - # - url: The URL of the hyperlink - # - span: Location of the hyperlink in the markdown content - # - source: Position of the hyperlink in the document - print("=" * 80) - print("HYPERLINKS EXTRACTION") - print("=" * 80) - - if document_content.hyperlinks: - print(f"Found {len(document_content.hyperlinks)} hyperlink(s) in the document") - print() - - for i, hyperlink in enumerate(document_content.hyperlinks, 1): - print(f"Hyperlink {i}:") - print(f" Content: {hyperlink.content}") - print(f" URL: {hyperlink.url}") - - if hyperlink.span: - print(f" Location in markdown: offset={hyperlink.span.offset}, length={hyperlink.span.length}") - - if hyperlink.source: - print(f" Source: {hyperlink.source}") - - print() - else: - print("No hyperlinks found in the document") - print() - - # ===================================================================== - # PART 4: EXTRACT AND DISPLAY FORMULAS - # ===================================================================== - # Formulas are stored in document_content.pages[].formulas (per page) - # Each formula (DocumentFormula) contains: - # - kind: Type of formula (inline or display) - # - value: The LaTeX representation of the formula (may contain extra spaces) - # - span: Location of the formula in the markdown content - # - source: Position of the formula in the document - # - confidence: Confidence of predicting the formula - # - # Note: The LaTeX value extracted from PDFs may have extra spaces between - # commands and arguments (e.g., "\frac { 1 } { n }" instead of "\frac{1}{n}"). - # While this will still render correctly in most LaTeX processors, you may - # want to clean it up for production use by removing extra spaces. - print("=" * 80) - print("FORMULAS EXTRACTION") - print("=" * 80) - - # Collect all formulas from all pages - all_formulas = [] - if document_content.pages: - for page in document_content.pages: - if page.formulas: - all_formulas.extend(page.formulas) - - if all_formulas: - print(f"Found {len(all_formulas)} formula(s) in the document") - print() - print("Note: LaTeX values may contain extra spaces (e.g., '\\frac { 1 } { n }').") - print(" This is expected from PDF extraction and will still render correctly.") - print() - - for i, formula in enumerate(all_formulas, 1): - print(f"Formula {i}:") - print(f" Kind: {formula.kind}") - print(f" LaTeX: {formula.value}") - - if formula.confidence: - print(f" Confidence: {formula.confidence}") - - if formula.span: - print(f" Location in markdown: offset={formula.span.offset}, length={formula.span.length}") - - if formula.source: - print(f" Source: {formula.source}") - - print() - else: - print("No formulas found in the document") - print() - - # ===================================================================== - # PART 5: MARKDOWN CONTENT - # ===================================================================== - # The markdown content is also available in the result and contains embedded - # representations of charts, annotations, hyperlinks, and formulas: - # - Charts appear in markdown using image syntax: ![chart data](path "description") - # - Annotations appear as markdown formatting (e.g., ==highlighted text== for highlights) - # - Hyperlinks appear as [text](url) format - # - Formulas appear as LaTeX syntax: $formula$ for inline, $$formula$$ for display - # - # To see how to extract and display markdown content, see the analyze_binary.py sample. - # The markdown can be accessed via: content.markdown or document_content.markdown - print("=" * 80) - print("MARKDOWN CONTENT") - print("=" * 80) - print("Note: Markdown content is available in the result and contains embedded") - print("representations of charts, annotations, and hyperlinks.") - print("See analyze_binary.py for how to extract and display markdown content.") - print("=" * 80) - print() - - # ===================================================================== - # PART 6: DUMP ANALYZE RESULT AS JSON - # ===================================================================== - # Save the full AnalyzeResult as JSON for inspection - # This includes all the data structures: contents, figures, annotations, etc. - print() - print("=" * 80) - print("SAVING ANALYZE RESULT AS JSON") - print("=" * 80) - # Convert the result to a dictionary and save as JSON - # This saves the object model, not the raw JSON response - result_dict = result.as_dict() - save_json_to_file(result_dict, filename_prefix="analyze_binary_features") - print("=" * 80) - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_raw_json.py deleted file mode 100644 index b8f84b860b9d..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_binary_raw_json.py +++ /dev/null @@ -1,105 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: use the prebuilt-documentSearch to extract content from a PDF and save raw JSON response. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python analyze_binary_raw_json.py -""" - -from __future__ import annotations - -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import AnalyzeResult -from sample_helper import save_json_to_file -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Extract content from PDF using begin_analyze_binary API and save raw JSON -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Read a PDF file from disk -# 3. Analyze the document using begin_analyze_binary with prebuilt-documentSearch -# 4. Save the raw JSON response to a file using a customized callback in poller parameter -# -# prebuilt-documentSearch is an AI-enhanced analyzer that extends prebuilt-document with: -# - Document summarization: Returns a "Summary" field with AI-generated document summaries -# - Figure analysis: Extracts descriptions and analyzes figures in documents (enableFigureDescription, enableFigureAnalysis) -# - Enhanced output: Provides more detailed analysis results (returnDetails: true) -# - AI completion model: Uses gpt-4.1-mini for intelligent content extraction -# -# IMPORTANT NOTES: -# - The SDK returns analysis results with an object model, which is easier to navigate and retrieve -# the desired results compared to parsing raw JSON -# - This sample is ONLY for demonstration purposes to show how to access raw JSON responses -# - For production use, prefer the object model approach shown in: -# - analyze_binary.py -# - analyze_url.py - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - with open("sample_files/sample_invoice.pdf", "rb") as f: - pdf_bytes: bytes = f.read() - - print("Analyzing sample_files/sample_invoice.pdf with prebuilt-documentSearch...") - - # Use poller callback to save raw JSON response - # The 'cls' parameter allows us to intercept the response before it gets deserialized as an object model - # We return a tuple: (deserialized_object, raw_http_response) - poller = await client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=pdf_bytes, - content_type="application/pdf", - cls=lambda pipeline_response, deserialized_obj, response_headers: ( - deserialized_obj, - pipeline_response.http_response, - ), - ) - - # Wait for completion and get both model and raw HTTP response - _, raw_http_response = await poller.result() - - # Save the raw JSON response - save_json_to_file(raw_http_response.json(), filename_prefix="analyze_binary_raw_json") # type: ignore[attr-defined] - # Note: For easier data access, see object model samples: - # analyze_binary.py - # analyze_url.py - - print("Analysis completed and raw JSON response saved!") - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py deleted file mode 100644 index dc36e513570d..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category.py +++ /dev/null @@ -1,206 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: Create a classifier to categorize financial documents without automatic page segmentation. - -This sample demonstrates how to: -1. Create a custom analyzer with content categories for document classification -2. Disable automatic page segmentation by category (enable_segment=False) -3. Classify documents into categories (Invoice, Bank Statement, Loan Application) -4. View classification results without automatic segmentation -5. Clean up resources - -The key difference from analyze_category_enable_segments.py is that enable_segment=False, -which means the analyzer will classify the entire document as a single unit without -automatically segmenting pages by category. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python analyze_category.py -""" - -from __future__ import annotations - -import asyncio -import json -import os -from datetime import datetime -from typing import cast - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - AnalyzeResult, - ContentAnalyzer, - ContentAnalyzerConfig, - ContentCategoryDefinition, - DocumentContent, - MediaContentKind, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}\n") - - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - print("Environment Variables:") - print("=" * 50) - print(f"AZURE_CONTENT_UNDERSTANDING_ENDPOINT: {endpoint}") - print(f"AZURE_CONTENT_UNDERSTANDING_KEY: {'***' if key else '(not set, using DefaultAzureCredential)'}") - print("=" * 50) - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - # Create a unique analyzer ID - analyzer_id = f"financial_doc_classifier_{int(asyncio.get_event_loop().time())}" - - print(f"\nCreating analyzer '{analyzer_id}'...") - print("Categories: Invoice, Bank Statement, Loan Application") - print("Note: enable_segment=False - document will be classified as a single unit\n") - - # Create an analyzer with content categories for document classification - # enable_segment=False disables automatic segmentation - entire document is classified as one unit - content_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - config=ContentAnalyzerConfig( - return_details=True, - content_categories={ - "Loan application": ContentCategoryDefinition( - description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." - ), - "Invoice": ContentCategoryDefinition( - description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." - ), - "Bank Statement": ContentCategoryDefinition( - description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." - ), - }, - enable_segment=False, # Disable automatic page segmentation by category - ), - description=f"Custom analyzer for financial document categorization without segmentation", - models={"completion": "gpt-4.1"}, - tags={"demo_type": "category_classification_without_segmentation"}, - ) - - # Create the analyzer - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=content_analyzer, - ) - - print("Waiting for analyzer creation to complete...") - result = await poller.result() - print(f"Analyzer '{analyzer_id}' created successfully!\n") - - if result.warnings: - print("⚠️ Warnings encountered while building the analyzer:") - for warning in result.warnings: - print(f" - {warning}") - print() - - # Test files to classify - # Note: With enable_segment=False, each document will be classified as a single unit. - # Even mixed_financial_docs.pdf (which contains multiple document types) will be - # classified as one category covering all pages, not segmented by page content. - test_files = [ - "sample_invoice.pdf", - "sample_bank_statement.pdf", - "mixed_financial_docs.pdf", # Will be classified as a unit, not segmented - ] - - samples_dir = os.path.dirname(__file__) - output_dir = os.path.join(samples_dir, "sample_output") - os.makedirs(output_dir, exist_ok=True) - - # Classify each document - for test_file in test_files: - test_file_path = os.path.join(samples_dir, "sample_files", test_file) - - if not os.path.exists(test_file_path): - print(f"⚠️ Skipping {test_file} - file not found") - continue - - print(f"{'=' * 60}") - print(f"Analyzing: {test_file}") - print(f"{'=' * 60}") - - # Read and analyze the document - with open(test_file_path, "rb") as f: - pdf_bytes = f.read() - - analyze_poller = await client.begin_analyze_binary( - analyzer_id=analyzer_id, - binary_input=pdf_bytes, - content_type="application/pdf", - ) - - analyze_result: AnalyzeResult = await analyze_poller.result() - print("Classification completed!\n") - - # Display classification results - print("Classification Results:") - print("-" * 60) - - for content in analyze_result.contents: - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = cast(DocumentContent, content) - - # When enable_segment=False, the document is classified as a single unit - # Display the page range for the entire document - print(f"\nPages: {document_content.start_page_number}-{document_content.end_page_number}") - - # Note: segments may still exist but won't be automatically created by category - if document_content.segments: - print(f"\nFound {len(document_content.segments)} segment(s):") - for i, segment in enumerate(document_content.segments, 1): - print(f" Segment {i}:") - print(f" Category: {segment.category}") - print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") - print(f" Segment ID: {segment.segment_id}") - - print() - - # Save results to JSON file - timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") - result_filename = f"analyze_category_{test_file.replace('.pdf', '')}_{timestamp}.json" - result_file = os.path.join(output_dir, result_filename) - - with open(result_file, "w") as f: - json.dump(analyze_result.as_dict(), f, indent=2, default=str) - - print(f"Results saved to: {result_file}\n") - - # Cleanup - print(f"{'=' * 60}") - print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully!") - print(f"{'=' * 60}") - - # Close DefaultAzureCredential if used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py deleted file mode 100644 index 679e04e4cea9..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_category_enable_segments.py +++ /dev/null @@ -1,207 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: Create a classifier to categorize financial documents with automatic page segmentation. - -This sample demonstrates how to: -1. Create a custom analyzer with content categories for document classification -2. Enable automatic page segmentation by category (enable_segment=True) -3. Classify documents into categories (Invoice, Bank Statement, Loan Application) -4. View classification results with automatic segmentation - pages are automatically grouped by category -5. Clean up resources - -The key feature of this sample is the enable_segment=True option, which allows the analyzer to -automatically segment multi-page documents by their category. For example, if a document contains -both an invoice and a bank statement, each will be identified as separate segments with their -respective categories and page ranges. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python analyze_category_enable_segments.py -""" - -from __future__ import annotations - -import asyncio -import json -import os -from datetime import datetime -from typing import cast - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - AnalyzeResult, - ContentAnalyzer, - ContentAnalyzerConfig, - ContentCategoryDefinition, - DocumentContent, - MediaContentKind, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}\n") - - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - print("Environment Variables:") - print("=" * 50) - print(f"AZURE_CONTENT_UNDERSTANDING_ENDPOINT: {endpoint}") - print(f"AZURE_CONTENT_UNDERSTANDING_KEY: {'***' if key else '(not set, using DefaultAzureCredential)'}") - print("=" * 50) - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - # Create a unique analyzer ID - analyzer_id = f"financial_doc_classifier_{int(asyncio.get_event_loop().time())}" - - print(f"\nCreating analyzer '{analyzer_id}'...") - print("Categories: Invoice, Bank Statement, Loan Application") - print("Note: enable_segment=True allows automatic page segmentation by category\n") - - # Create an analyzer with content categories for document classification - # enable_segment=True enables automatic segmentation of pages by their category - content_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - config=ContentAnalyzerConfig( - return_details=True, - content_categories={ - "Loan application": ContentCategoryDefinition( - description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." - ), - "Invoice": ContentCategoryDefinition( - description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." - ), - "Bank Statement": ContentCategoryDefinition( - description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." - ), - }, - enable_segment=True, # Enable automatic page segmentation by category - ), - description=f"Custom analyzer for financial document categorization with automatic segmentation", - models={"completion": "gpt-4.1"}, - tags={"demo_type": "category_classification_with_segmentation"}, - ) - - # Create the analyzer - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=content_analyzer, - ) - - print("Waiting for analyzer creation to complete...") - result = await poller.result() - print(f"Analyzer '{analyzer_id}' created successfully!\n") - - if result.warnings: - print("⚠️ Warnings encountered while building the analyzer:") - for warning in result.warnings: - print(f" - {warning}") - print() - - # Test files to classify - # Note: With enable_segment=True, documents will be automatically segmented by category. - # mixed_financial_docs.pdf contains multiple document types (invoice, bank statement, etc.) - # and will be automatically split into separate segments based on content category. - test_files = [ - "sample_invoice.pdf", # Single category - "sample_bank_statement.pdf", # Single category - "mixed_financial_docs.pdf", # Will be auto-segmented into multiple categories - ] - - samples_dir = os.path.dirname(__file__) - output_dir = os.path.join(samples_dir, "sample_output") - os.makedirs(output_dir, exist_ok=True) - - # Classify each document - for test_file in test_files: - test_file_path = os.path.join(samples_dir, "sample_files", test_file) - - if not os.path.exists(test_file_path): - print(f"⚠️ Skipping {test_file} - file not found") - continue - - print(f"{'=' * 60}") - print(f"Analyzing: {test_file}") - print(f"{'=' * 60}") - - # Read and analyze the document - with open(test_file_path, "rb") as f: - pdf_bytes = f.read() - - analyze_poller = await client.begin_analyze_binary( - analyzer_id=analyzer_id, - binary_input=pdf_bytes, - content_type="application/pdf", - ) - - analyze_result: AnalyzeResult = await analyze_poller.result() - print("Classification completed!\n") - - # Display classification results - print("Classification Results (with automatic segmentation):") - print("-" * 60) - - for content in analyze_result.contents: - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = cast(DocumentContent, content) - - # Display segments with their categories - # When enable_segment=True, pages are automatically grouped by category - if document_content.segments: - print(f"\nFound {len(document_content.segments)} segment(s):") - for i, segment in enumerate(document_content.segments, 1): - print(f"\n Segment {i}:") - print(f" Category: {segment.category}") - print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") - print(f" Segment ID: {segment.segment_id}") - else: - # Fallback if no segments (shouldn't happen with enable_segment=True) - print(f"\n⚠️ No segments found for this document") - print(f" Pages: {document_content.start_page_number}-{document_content.end_page_number}") - - print() - - # Save results to JSON file - timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") - result_filename = f"analyze_category_segments_{test_file.replace('.pdf', '')}_{timestamp}.json" - result_file = os.path.join(output_dir, result_filename) - - with open(result_file, "w") as f: - json.dump(analyze_result.as_dict(), f, indent=2, default=str) - - print(f"Results saved to: {result_file}\n") - - # Cleanup - print(f"{'=' * 60}") - print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully!") - print(f"{'=' * 60}") - - # Close DefaultAzureCredential if used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py deleted file mode 100644 index 176dbfc96359..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url.py +++ /dev/null @@ -1,124 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: use the prebuilt-documentSearch to extract content from a URL. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python analyze_url.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - AnalyzeInput, - AnalyzeResult, - MediaContent, - DocumentContent, - MediaContentKind, -) -from sample_helper import save_json_to_file -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Extract content from URL using begin_analyze API -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Analyze a document from a remote URL using begin_analyze with prebuilt-documentSearch -# 3. Print the markdown content from the analysis result -# -# prebuilt-documentSearch is an AI-enhanced analyzer that extends prebuilt-document with: -# - Document summarization: Returns a "Summary" field with AI-generated document summaries -# - Figure analysis: Extracts descriptions and analyzes figures in documents (enableFigureDescription, enableFigureAnalysis) -# - Enhanced output: Provides more detailed analysis results (returnDetails: true) -# - AI completion model: Uses gpt-4.1-mini for intelligent content extraction - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" - print(f"Analyzing remote document from {file_url} with prebuilt-documentSearch...") - poller = await client.begin_analyze(analyzer_id="prebuilt-documentSearch", inputs=[AnalyzeInput(url=file_url)]) - result: AnalyzeResult = await poller.result() - - # AnalyzeResult contains the full analysis result and can be used to access various properties - # We are using markdown content as an example of what can be extracted - print("\nMarkdown Content:") - print("=" * 50) - # A PDF file has only one content element even if it contains multiple pages - content: MediaContent = result.contents[0] - print(content.markdown) - print("=" * 50) - - # Check if this is document content to access document-specific properties - assert content.kind == MediaContentKind.DOCUMENT, "\nDocument Information: Not available for this content type" - # Type assertion: we know this is DocumentContent for PDF files - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f"Start page: {document_content.start_page_number}") - print(f"End page: {document_content.end_page_number}") - print(f"Total pages: {document_content.end_page_number - document_content.start_page_number + 1}") - - # Check for pages - if document_content.pages is not None: - print(f"\nPages ({len(document_content.pages)}):") - for i, page in enumerate(document_content.pages): - unit = document_content.unit or "units" - print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") - - # The following code shows how to access DocumentContent properties - # Check if there are tables in the document - if document_content.tables is not None: - print(f"\nTables ({len(document_content.tables)}):") - table_counter = 1 - # Iterate through tables, each table is of type DocumentTable - for table in document_content.tables: - # Type: table is DocumentTable - # Get basic table dimensions - row_count: int = table.row_count - col_count: int = table.column_count - print(f" Table {table_counter}: {row_count} rows x {col_count} columns") - table_counter += 1 - # You can use the table object model to get detailed information - # such as cell content, borders, spans, etc. (not shown to keep code concise) - - # Uncomment the following line to save the response to a file for object model inspection - # Note: This saves the object model, not the raw JSON response - # To get the full raw JSON response, see the sample: analyze_binary_raw_json.py - # save_json_to_file(result.as_dict(), filename_prefix="analyze_url") - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url_prebuilt_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url_prebuilt_invoice.py deleted file mode 100644 index 95f10a85ac86..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/analyze_url_prebuilt_invoice.py +++ /dev/null @@ -1,160 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: use the prebuilt-invoice analyzer to extract invoice fields from a URL. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python analyze_url_prebuilt_invoice.py -""" - -from __future__ import annotations -import asyncio -import os - - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - AnalyzeInput, - AnalyzeResult, - ContentField, - MediaContent, -) -from sample_helper import save_json_to_file -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Extract invoice fields from URL using begin_analyze API with prebuilt-invoice -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Analyze an invoice from a remote URL using begin_analyze with prebuilt-invoice analyzer -# 3. Save the complete analysis result to JSON file -# 4. Show examples of extracting different field types (string, number, object, array) - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - await analyze_invoice(client) - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -async def analyze_invoice(client: ContentUnderstandingClient) -> None: - """Analyze an invoice and display the extracted fields.""" - file_url = ( - "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" - ) - print(f"Analyzing invoice from {file_url} with prebuilt-invoice analyzer...") - poller = await client.begin_analyze(analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(url=file_url)]) - result: AnalyzeResult = await poller.result() - - # AnalyzeResult contains the full analysis result and can be used to access various properties - print("\nInvoice Analysis Result:") - print("=" * 50) - - # A PDF file has only one content element even if it contains multiple pages - content: MediaContent = result.contents[0] - - if not content.fields: - print("No fields found in the analysis result") - return - - print("\nSample Field Extractions:") - print("-" * 40) - - # Example 1: Simple string fields - # Note: Use .get() to check if field exists: field = content.fields.get("FieldName") - # Use [] when field is known to exist (cleaner code) - customer_name = content.fields["CustomerName"].value - - # TotalAmount is an ObjectField containing Amount and CurrencyCode fields - total_amount_obj: dict[str, ContentField] | None = content.fields["TotalAmount"].value # type: ignore[attr-defined] - invoice_total = total_amount_obj["Amount"].value if total_amount_obj else None # type: ignore[union-attr] - - invoice_date = content.fields["InvoiceDate"].value - - print(f"Customer Name: {customer_name or '(None)'}") - print(f"Invoice Total: ${invoice_total or '(None)'}") - print(f"Invoice Date: {invoice_date or '(None)'}") - - # Example 2: Array field (Items) - items: list[ContentField] | None = content.fields["LineItems"].value # type: ignore[attr-defined] - print(f"\nInvoice Items (Array):") - if items: - for i, item in enumerate(items): - # item is a ContentField (ObjectField at runtime), get its value - item_obj: dict[str, Any] | None = item.value_object # type: ignore[attr-defined] - if item_obj: - print(f" Item {i + 1}:") - - # Extract fields from line item - # Note: For nested field access, we use value_* attributes directly - # to avoid type checker issues with dictionary value types - description = item_obj["Description"].value_string # type: ignore[attr-defined] - quantity = item_obj["Quantity"].value_number # type: ignore[attr-defined] - - # UnitPrice and TotalAmount are ObjectFields, extract Amount from them - # Note: Some fields might be optional in some line items - unit_price_field = item_obj.get("UnitPrice") - if unit_price_field and hasattr(unit_price_field, 'value_object'): - unit_price_obj = unit_price_field.value_object # type: ignore[attr-defined] - unit_price = unit_price_obj["Amount"].value_number if unit_price_obj else None # type: ignore[attr-defined,union-attr] - else: - unit_price = None - - total_amount_field = item_obj.get("TotalAmount") - if total_amount_field and hasattr(total_amount_field, 'value_object'): - total_amount_obj_inner = total_amount_field.value_object # type: ignore[attr-defined] - total_amount = total_amount_obj_inner["Amount"].value_number if total_amount_obj_inner else None # type: ignore[attr-defined,union-attr] - else: - total_amount = None - - print(f" Description: {description or 'N/A'}") - print(f" Quantity: {quantity or 'N/A'}") - print(f" Unit Price: ${unit_price or 'N/A'}") - print(f" Total Amount: ${total_amount or 'N/A'}") - else: - print(f" Item {i + 1}: No item object found") - else: - print(" No items found") - - print(f"\nTotal fields extracted: {len(content.fields)}") - - # Save the full result to JSON for detailed inspection - save_json_to_file( - result.as_dict(), - filename_prefix="analyze_url_prebuilt_invoice", - ) - print("Invoice fields saved to JSON file for detailed inspection") - - -if __name__ == "__main__": - asyncio.run(main()) - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py deleted file mode 100644 index 7275a5951456..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/copy_analyzer.py +++ /dev/null @@ -1,203 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: copy an analyzer from source to target using begin_copy_analyzer API. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python copy_analyzer.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Copy analyzer from source to target using begin_copy_analyzer API -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Create a source analyzer with tag "modelType": "in_development" -# 3. Copy the source analyzer to target with tag "modelType": "in_production" -# 4. Wait for copy operation to complete -# 5. Retrieve analyzer details using get_analyzer (workaround for service bug where result is empty) -# 6. Clean up both analyzers - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - base_analyzer_id = f"sdk_sample_custom_analyzer_{int(asyncio.get_event_loop().time())}" - source_analyzer_id = f"{base_analyzer_id}_source" - target_analyzer_id = f"{base_analyzer_id}_target" - - # Step 1: Create the source analyzer with tag "modelType": "in_development" - print(f"Creating source analyzer '{source_analyzer_id}' with tag 'modelType': 'in_development'...") - - # Create a custom analyzer using object model (following pattern from create_analyzer.py) - source_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - description="Source analyzer for extracting company information", - tags={"modelType": "in_development"}, - config=ContentAnalyzerConfig( - enable_formula=False, - enable_layout=True, - enable_ocr=True, - estimate_field_source_and_confidence=True, - return_details=True, - ), - field_schema=ContentFieldSchema( - name="company_schema", - description="Schema for extracting company information", - fields={ - # EXTRACT: Extract information directly from document content - "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company", - ), - "total_amount": ContentFieldDefinition( - type=ContentFieldType.NUMBER, - method=GenerationMethod.EXTRACT, - description="Total amount on the document", - ), - # GENERATE: AI generates content based on document understanding - "document_summary": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.GENERATE, - description="A concise summary of the document's main content", - ), - "key_insights": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.GENERATE, - description="Key business insights or actionable items from the document", - ) - }, - ), - models={"completion": "gpt-4.1"}, # Required when using field_schema - ) - - poller = await client.begin_create_analyzer( - analyzer_id=source_analyzer_id, - resource=source_analyzer, - ) - await poller.result() - print(f"Source analyzer '{source_analyzer_id}' created successfully!") - - # Retrieve the full analyzer details using get_analyzer - # Note: This is a workaround for a service bug where begin_create_analyzer result - # returns empty/None values. See SERVICE-BUG.md Bug #3 for details. - print(f"\nRetrieving source analyzer details using get_analyzer...") - source_analyzer_details = await client.get_analyzer(analyzer_id=source_analyzer_id) - print(f"\n=== Source Analyzer Details ===") - print(f"Analyzer ID: {source_analyzer_details.analyzer_id}") - print(f"Description: {source_analyzer_details.description}") - print(f"Tags: {source_analyzer_details.tags}") - print(f"=== End Source Analyzer Details ===\n") - - # Step 2: Copy the source analyzer to target using begin_copy_analyzer API - print(f"Copying analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'...") - - # Use begin_copy_analyzer with source_analyzer_id keyword argument - # The body will include sourceAnalyzerId and we can add tags to the target analyzer - # Note: Tags may need to be set via update after copy, or included in the copy body if supported - try: - copy_poller = await client.begin_copy_analyzer( - analyzer_id=target_analyzer_id, - source_analyzer_id=source_analyzer_id, - ) - await copy_poller.result() - print(f"Target analyzer '{target_analyzer_id}' copied successfully!") - - # Retrieve the full analyzer details using get_analyzer - # Note: This is a workaround for a service bug where begin_copy_analyzer result - # returns empty/None values. See SERVICE-BUG.md Bug #3 for details. - print(f"\nRetrieving target analyzer details using get_analyzer...") - target_analyzer_details = await client.get_analyzer(analyzer_id=target_analyzer_id) - print(f"\n=== Target Analyzer Details (before update) ===") - print(f"Analyzer ID: {target_analyzer_details.analyzer_id}") - print(f"Description: {target_analyzer_details.description}") - print(f"Tags: {target_analyzer_details.tags}") - print(f"=== End Target Analyzer Details ===\n") - except Exception as e: - print(f"Error copying analyzer: {e}") - print("Note: The copy operation may not be available on all service endpoints.") - # Clean up source analyzer before raising - print(f"\nDeleting source analyzer '{source_analyzer_id}' (cleanup after error)...") - await client.delete_analyzer(analyzer_id=source_analyzer_id) - print(f"Source analyzer '{source_analyzer_id}' deleted successfully!") - raise - - # Update the target analyzer to add the "modelType": "in_production" tag - # Since copy may not preserve or set tags, we update after copying - print(f"Updating target analyzer '{target_analyzer_id}' with tag 'modelType': 'in_production'...") - updated_target_analyzer = ContentAnalyzer( - tags={"modelType": "in_production"} - ) - await client.update_analyzer( - analyzer_id=target_analyzer_id, - resource=updated_target_analyzer, - ) - print(f"Target analyzer '{target_analyzer_id}' updated successfully!") - - # Retrieve the updated analyzer details - print(f"\nRetrieving updated target analyzer details...") - final_target_analyzer_details = await client.get_analyzer(analyzer_id=target_analyzer_id) - print(f"\n=== Target Analyzer Details (after update) ===") - print(f"Analyzer ID: {final_target_analyzer_details.analyzer_id}") - print(f"Description: {final_target_analyzer_details.description}") - print(f"Tags: {final_target_analyzer_details.tags}") - print(f"=== End Target Analyzer Details ===\n") - - # Clean up the created analyzers (demo cleanup) - print(f"Deleting analyzers (demo cleanup)...") - print(f"Deleting source analyzer '{source_analyzer_id}'...") - await client.delete_analyzer(analyzer_id=source_analyzer_id) - print(f"Source analyzer '{source_analyzer_id}' deleted successfully!") - - print(f"Deleting target analyzer '{target_analyzer_id}'...") - await client.delete_analyzer(analyzer_id=target_analyzer_id) - print(f"Target analyzer '{target_analyzer_id}' deleted successfully!") - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py deleted file mode 100644 index 94f944a8befc..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer.py +++ /dev/null @@ -1,143 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: create a custom analyzer using begin_create_analyzer API. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python create_analyzer.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Create custom analyzer using begin_create_analyzer API -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Create a custom analyzer with field schema using object model -# 3. Wait for analyzer creation to complete -# 4. Save the analyzer definition to a JSON file - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - analyzer_id = f"sdk_sample_custom_analyzer_{int(asyncio.get_event_loop().time())}" - - # Create a custom analyzer using object model - custom_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - description="Custom analyzer for extracting company information", - config=ContentAnalyzerConfig( - enable_formula=False, - enable_layout=True, - enable_ocr=True, - estimate_field_source_and_confidence=True, - return_details=True, - ), - field_schema=ContentFieldSchema( - name="company_schema", - description="Schema for extracting company information", - fields={ - # EXTRACT: Extract information directly from document content - "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company", - ), - "total_amount": ContentFieldDefinition( - type=ContentFieldType.NUMBER, - method=GenerationMethod.EXTRACT, - description="Total amount on the document", - ), - # GENERATE: AI generates content based on document understanding - "document_summary": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.GENERATE, - description="A concise summary of the document's main content", - ), - "key_insights": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.GENERATE, - description="Key business insights or actionable items from the document", - ), - # CLASSIFY: Categorize the document or content - "document_category": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.CLASSIFY, - description="Category of the document", - enum=["invoice", "contract", "receipt", "report", "other"], - ), - "urgency_level": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.CLASSIFY, - description="Urgency level of the document", - enum=["high", "medium", "low"], - ), - }, - ), - models={"completion": "gpt-4.1"}, # Required when using field_schema - ) - - print(f"Creating custom analyzer '{analyzer_id}'...") - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=custom_analyzer, - ) - result = await poller.result() - print(f"Analyzer '{analyzer_id}' created successfully!") - - # Clean up the created analyzer (demo cleanup) - print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully!") - - # Next steps: - # - To retrieve the analyzer: see get_analyzer.py - # - To use the analyzer for analysis: see analyze_binary.py - # - To delete the analyzer: see delete_analyzer.py - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py deleted file mode 100644 index 131e83537c7b..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_analyzer_with_labels.py +++ /dev/null @@ -1,264 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: build a custom model using training files and test it. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL (required) - - SAS URL to Azure Blob Storage container with training files - - SAS token must have 'read' and 'list' permissions - - Format: https://.blob.core.windows.net/? - - Training files: Copy the files from sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/ - into your blob storage container before running this sample - CONTENT_UNDERSTANDING_STORAGE_PREFIX (optional) - - Prefix (folder path) to filter blobs within the container - - Example: "training_data/" to only use files in that folder - - If not set, all files in the container will be used - CONTENT_UNDERSTANDING_FILE_LIST_PATH (optional) - - Path to a file listing specific blobs to include in training - - If not set, all files in the container (or prefix) will be used - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python create_analyzer_with_labels.py -""" - -from __future__ import annotations - -import asyncio -import json -import os -from datetime import datetime -from typing import cast - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod, - LabeledDataKnowledgeSource, - KnowledgeSource, - AnalyzeResult, -) -from sample_helper import save_json_to_file -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -def create_irs_1040_schema() -> ContentFieldSchema: - """Create a simplified IRS 1040 field schema with 5 key fields for demonstration.""" - return ContentFieldSchema( - name="IRS_1040", - description="Simplified IRS 1040 form schema for demonstration", - fields={ - "FieldYourFirstNameAndMiddleInitial": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="", - ), - "FieldYourFirstNameAndMiddleInitialLastName": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="", - ), - "CheckboxYouAsADependent": ContentFieldDefinition( - type=ContentFieldType.BOOLEAN, - method=GenerationMethod.EXTRACT, - description="", - ), - "TableDependents": ContentFieldDefinition( - type=ContentFieldType.ARRAY, - method=GenerationMethod.GENERATE, - description="", - item_definition=ContentFieldDefinition( - type=ContentFieldType.OBJECT, - method=GenerationMethod.EXTRACT, - description="", - properties={ - "FirstNameLastName": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="", - ), - "SocialSecurityNumber": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="", - ), - "RelationshipToYou": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="", - ), - "CheckboxChildTaxCredit": ContentFieldDefinition( - type=ContentFieldType.BOOLEAN, - method=GenerationMethod.EXTRACT, - description="", - ), - "CheckboxCreditForOtherDependents": ContentFieldDefinition( - type=ContentFieldType.BOOLEAN, - method=GenerationMethod.EXTRACT, - description="", - ), - }, - ), - ), - "FieldWagesSalariesTipsEtcAttachFormSW2": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="", - ), - }, - ) - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}\n") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - # Get training data container URL - container_sas_url = os.getenv("CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL") - if not container_sas_url: - raise ValueError( - "CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL environment variable is required. " - "Set it in your .env file or environment." - ) - - # Print environment variable values before training - print("Environment Variables:") - print("=" * 50) - print(f"AZURE_CONTENT_UNDERSTANDING_ENDPOINT: {endpoint}") - print(f"AZURE_CONTENT_UNDERSTANDING_KEY: {'***' if key else '(not set, using DefaultAzureCredential)'}") - - # Extract storage account and container from SAS URL (for security, don't print the full SAS token) - try: - from urllib.parse import urlparse - parsed_url = urlparse(container_sas_url) - storage_info = f"{parsed_url.scheme}://{parsed_url.netloc}{parsed_url.path}?" - print(f"CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL: {storage_info}") - except Exception: - # Fallback if parsing fails - print(f"CONTENT_UNDERSTANDING_STORAGE_CONTAINER_SAS_URL: ") - - file_list_path = os.getenv("CONTENT_UNDERSTANDING_FILE_LIST_PATH", "") - storage_prefix = os.getenv("CONTENT_UNDERSTANDING_STORAGE_PREFIX", "") - print(f"CONTENT_UNDERSTANDING_FILE_LIST_PATH: {file_list_path if file_list_path else '(not set, using all files)'}") - print(f"CONTENT_UNDERSTANDING_STORAGE_PREFIX: {storage_prefix if storage_prefix else '(not set, using all files in container)'}") - print("=" * 50) - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - # Define the IRS 1040 field schema - print("Defining IRS 1040 field schema...") - field_schema = create_irs_1040_schema() - - # Create analyzer ID - analyzer_id = f"irs_1040_custom_model_{int(asyncio.get_event_loop().time())}" - - # Build analyzer with training data - description = "Custom IRS 1040 form analyzer built with training files" - print(f"\nCreating analyzer '{analyzer_id}' {description}...") - - knowledge_sources: list[LabeledDataKnowledgeSource] | None = None - if container_sas_url: - file_list_path = os.getenv("CONTENT_UNDERSTANDING_FILE_LIST_PATH", "") - storage_prefix = os.getenv("CONTENT_UNDERSTANDING_STORAGE_PREFIX", "") - - # Build kwargs dynamically - only include non-empty optional parameters - lds_kwargs = {"container_url": container_sas_url} - if file_list_path: - lds_kwargs["file_list_path"] = file_list_path - if storage_prefix: - lds_kwargs["prefix"] = storage_prefix - - knowledge_sources = [LabeledDataKnowledgeSource(**lds_kwargs)] - - custom_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - description=description, - config=ContentAnalyzerConfig( - return_details=True, - enable_layout=True, - enable_formula=False, - estimate_field_source_and_confidence=True, - ), - field_schema=field_schema, - knowledge_sources=cast(list[KnowledgeSource] | None, knowledge_sources) if knowledge_sources else None, - models={"completion": "gpt-4.1", "embedding": "text-embedding-ada-002"}, # Required when using field_schema - ) - - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=custom_analyzer, - ) - - print("Waiting for analyzer creation to complete...") - result = await poller.result() - print(f"Analyzer '{analyzer_id}' created successfully!") - print(f"Status: {result.status}") - print(f"Created at: {result.created_at}") - - if result.warnings: - print("Warnings encountered while building the analyzer:") - for warning in result.warnings: - print(f" - {warning}") - - # Test the analyzer - test_file_path = os.path.join( - os.path.dirname(__file__), - "sample_files", - "IRS_1040_test.pdf", - ) - print(f"\nTesting analyzer with {test_file_path}...") - with open(test_file_path, "rb") as f: - pdf_bytes = f.read() - - analyze_poller = await client.begin_analyze_binary( - analyzer_id=analyzer_id, - binary_input=pdf_bytes, - content_type="application/pdf", - ) - analyze_result = await analyze_poller.result() - print("Analysis completed successfully!") - - # Save results - timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") - output_dir = os.path.join(os.path.dirname(__file__), "sample_output") - os.makedirs(output_dir, exist_ok=True) - - result_file = os.path.join(output_dir, f"build_custom_model_test_result_{timestamp}.json") - with open(result_file, "w") as f: - json.dump(analyze_result.as_dict(), f, indent=2, default=str) - print(f"Analysis result saved to: {result_file}") - print("Analysis result saved to JSON file for detailed inspection") - - # Cleanup - print(f"\nDeleting analyzer '{analyzer_id}' (demo cleanup)...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully!") - - # Close DefaultAzureCredential if used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py deleted file mode 100644 index fb54e595e236..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/create_classifier.py +++ /dev/null @@ -1,205 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: create a classifier to categorize documents. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python create_classifier.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentCategoryDefinition, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Create a classifier for document categorization -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Create a custom classifier with content categories -# 3. Configure the classifier to segment multi-document files -# 4. Wait for classifier creation to complete -# 5. Verify the classifier was created successfully -# 6. Clean up by deleting the classifier -# -# Note: In Azure AI Content Understanding, classification is integrated into -# analyzers using the contentCategories configuration. The enableSegment parameter -# controls whether to split multi-document files (e.g., a loan package with multiple forms). - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - await create_document_classifier(client) - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -async def create_document_classifier(client: ContentUnderstandingClient) -> None: - """Create and configure a classifier for document categorization.""" - - # Generate a unique classifier ID - analyzer_id = f"sdk_sample_classifier_{int(asyncio.get_event_loop().time())}" - - print(f"\nCreating classifier '{analyzer_id}'...") - print("\nClassifier Configuration:") - print("=" * 60) - - # Define content categories for classification - # Each category has a name and description to guide the classification - categories = { - "Loan_Application": ContentCategoryDefinition( - description=( - "Documents submitted by individuals or businesses to request funding, " - "typically including personal or business details, financial history, " - "loan amount, purpose, and supporting documentation." - ) - ), - "Invoice": ContentCategoryDefinition( - description=( - "Billing documents issued by sellers or service providers to request " - "payment for goods or services, detailing items, prices, taxes, totals, " - "and payment terms." - ) - ), - "Bank_Statement": ContentCategoryDefinition( - description=( - "Official statements issued by banks that summarize account activity " - "over a period, including deposits, withdrawals, fees, and balances." - ) - ), - } - - # Display the categories being configured - print(" Content Categories:") - for category_name, category_obj in categories.items(): - print(f" • {category_name}") - if category_obj.description: - desc_preview = category_obj.description[:80] + "..." if len(category_obj.description) > 80 else category_obj.description - print(f" {desc_preview}") - - print("=" * 60) - - try: - # Create classifier configuration - # - base_analyzer_id: Use prebuilt-document for general document classification - # - enable_segment: Split multi-document files and classify each segment - # - return_details: Include detailed classification information - # - content_categories: Define the classification categories - classifier = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - description="Custom classifier for financial document categorization", - config=ContentAnalyzerConfig( - return_details=True, - enable_segment=True, # Automatically split and classify multi-document files - content_categories=categories, - ), - models={"completion": "gpt-4.1"}, # Model used for classification - tags={"sample_type": "classifier_demo", "document_type": "financial"}, - ) - - # Start the classifier creation operation - print(f"\nStarting classifier creation operation...") - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=classifier, - ) - - # Wait for the operation to complete - print(f"Waiting for classifier creation to complete...") - result = await poller.result() - print(f"\nClassifier '{analyzer_id}' created successfully!") - - # Display any warnings from the creation process - if result.warnings: - print("\n⚠️ Warnings encountered while creating the classifier:") - for warning in result.warnings: - print(f" - {warning}") - - # Retrieve the full analyzer details using get_analyzer - print(f"\nRetrieving classifier details...") - analyzer_details = await client.get_analyzer(analyzer_id=analyzer_id) - - print("\nClassifier Properties:") - print("=" * 60) - print(f" Analyzer ID: {analyzer_details.analyzer_id}") - print(f" Description: {analyzer_details.description}") - print(f" Base Analyzer: {analyzer_details.base_analyzer_id}") - print(f" Status: {analyzer_details.status}") - - if analyzer_details.config: - if hasattr(analyzer_details.config, "enable_segment"): - print(f" Enable Segment: {analyzer_details.config.enable_segment}") - if hasattr(analyzer_details.config, "content_categories") and analyzer_details.config.content_categories: - print(f" Categories: {len(analyzer_details.config.content_categories)}") - for cat_name in analyzer_details.config.content_categories.keys(): - print(f" • {cat_name}") - - if analyzer_details.models: - print(f" Models: {analyzer_details.models}") - - if analyzer_details.tags: - print(f" Tags: {analyzer_details.tags}") - - print("=" * 60) - - print("\nUsage Tips:") - print(" • Use this classifier with begin_analyze() or begin_analyze_binary()") - print(" • Set enable_segment=True to classify different document types in a single file") - print(" • Each segment in the result will have a 'category' field with the classification") - print(" • You can add up to 200 content categories per classifier") - - # Clean up: Delete the classifier - print(f"\nCleaning up: Deleting classifier '{analyzer_id}'...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Classifier '{analyzer_id}' deleted successfully!") - - except Exception as e: - print(f"\n❌ Error creating classifier: {e}") - print("\nThis error may occur if:") - print(" - The GPT-4.1 model deployment is not configured (run update_defaults.py)") - print(" - You don't have permission to create analyzers") - print(" - The analyzer ID already exists (try running the sample again)") - print("\nTroubleshooting steps:") - print(" 1. Ensure default model deployments are configured (run get_defaults.py)") - print(" 2. Verify you have permissions to create analyzers") - print(" 3. Check that the endpoint and credentials are correct") - raise - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py deleted file mode 100644 index 0723af133c24..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_analyzer.py +++ /dev/null @@ -1,102 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: delete a custom analyzer using the delete API. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python delete_analyzer.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Delete custom analyzer using delete API -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Create a custom analyzer (for deletion demo) -# 3. Delete the analyzer using the delete API -# 4. Verify the analyzer is no longer available - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - analyzer_id = f"sdk_sample_analyzer_to_delete_{int(asyncio.get_event_loop().time())}" - - # First, create an analyzer to delete (for demo purposes) - print(f"Creating analyzer '{analyzer_id}' for deletion demo...") - custom_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - description="Temporary analyzer for deletion demo", - config=ContentAnalyzerConfig(return_details=True), - field_schema=ContentFieldSchema( - name="demo_schema", - description="Schema for deletion demo", - fields={ - "demo_field": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Demo field for deletion", - ), - }, - ), - models={"completion": "gpt-4.1"}, # Required when using field_schema - ) - - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=custom_analyzer, - ) - await poller.result() - print(f"Analyzer '{analyzer_id}' created successfully!") - - # Now delete the analyzer - print(f"Deleting analyzer '{analyzer_id}'...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully!") - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py deleted file mode 100644 index 7f6db6f52b04..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/delete_result.py +++ /dev/null @@ -1,196 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: analyze a document with prebuilt-invoice and delete the result. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python delete_result.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import AnalyzeInput -from azure.core.credentials import AzureKeyCredential -from azure.core.exceptions import ResourceNotFoundError -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Analyze document and delete the result -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Analyze an invoice document using prebuilt-invoice analyzer -# 3. Extract the operation ID from the analysis operation -# 4. Get the analysis result using the operation ID and verify accessibility -# 5. Delete the analysis result to free up storage -# 6. Verify deletion by confirming the result is no longer accessible (404 error) -# -# Note: Deleting results is useful for managing storage and cleaning up -# temporary analysis results that are no longer needed. - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - await analyze_and_delete_result(client) - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -async def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: - """Analyze a document and demonstrate result deletion.""" - - # Use a sample invoice document from GitHub - file_url = ( - "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" - ) - - print("\nDocument Analysis Workflow") - print("=" * 60) - print(f" Document URL: {file_url}") - print(f" Analyzer: prebuilt-invoice") - print("=" * 60) - - try: - # Step 1: Start the analysis operation - print(f"\nStep 1: Starting document analysis...") - poller = await client.begin_analyze( - analyzer_id="prebuilt-invoice", - inputs=[AnalyzeInput(url=file_url)], - ) - - # Extract the operation ID from the poller - # The operation ID is used to track and manage the analysis operation - operation_id = poller.operation_id - - if not operation_id: - print("❌ Error: Could not extract operation ID from response") - return - - print(f"Analysis operation started") - print(f" Operation ID: {operation_id}") - - # Step 2: Wait for analysis to complete - print(f"\nStep 2: Waiting for analysis to complete...") - result = await poller.result() - print(f"Analysis completed successfully!") - - # Verify we can access the result before deletion (this is for demonstration only) - print(f"\nStep 2.5: Verifying result accessibility before deletion...") - try: - status_before = await client._get_result(operation_id=operation_id) # type: ignore[attr-defined] - print(f"Result accessible before deletion (status: {status_before.status})") - except Exception as e: - print(f"⚠️ Unexpected error accessing result before deletion: {e}") - - # Step 3: Display sample results from the analysis - print(f"\nStep 3: Analysis Results Summary") - print("=" * 60) - - if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.fields: - # Display a few key fields from the invoice - fields_to_show = ["CustomerName", "InvoiceId", "InvoiceDate", "TotalAmount"] - print(" Sample Fields:") - for field_name in fields_to_show: - if field_name in content.fields: - field = content.fields[field_name] - if field_name == "TotalAmount" and hasattr(field, "value") and isinstance(field.value, dict): - # TotalAmount is an ObjectField with Amount and CurrencyCode - amount = field.value.get("Amount") - if amount and hasattr(amount, "value"): - print(f" • {field_name}: {amount.value}") - elif hasattr(field, "value"): - print(f" • {field_name}: {field.value}") - - print(f" Total fields extracted: {len(content.fields)}") - else: - print(" No fields found in analysis result") - else: - print(" No content found in analysis result") - - print("=" * 60) - - # Step 4: Delete the analysis result - print(f"\nStep 4: Deleting analysis result...") - print(f" Operation ID: {operation_id}") - - await client.delete_result(operation_id=operation_id) - print(f"Analysis result deleted successfully!") - - # Step 5: Verify deletion by attempting to get the result again - print(f"\nStep 5: Verifying deletion...") - print(f" Attempting to access the deleted result...") - try: - # Try to get the operation status after deletion (this is for demonstration only) - deleted_status = await client._get_result(operation_id=operation_id) # type: ignore[attr-defined] - print("❌ Unexpected: Result still exists after deletion!") - except Exception as delete_error: - if isinstance(delete_error, ResourceNotFoundError): - print(f"Verification successful: Result properly deleted") - print(f" Error type: {type(delete_error).__name__}") - if hasattr(delete_error, 'error') and delete_error.error: - print(f" Code: {delete_error.error.code}") - print(f" Message: {delete_error.error.message}") - print(f" ✓ Confirmed: Result is no longer accessible as expected") - else: - print(f"❌ Unexpected error type: {type(delete_error).__name__}") - print(f" Error details: {delete_error}") - print(f" Expected ResourceNotFoundError for deleted result") - - print("\nWhy delete results?") - print(" • Free up storage space in your Content Understanding resource") - print(" • Remove temporary or sensitive analysis results") - print(" • Manage resource quotas and limits") - print(" • Clean up test or development analysis operations") - - print("\nNote: Deleting a result marks it for deletion.") - print(" The result data will be permanently removed and cannot be recovered.") - print(" If not deleted manually, results are automatically deleted after 24 hours.") - - except Exception as e: - print(f"\n❌ Error during analysis or deletion: {e}") - print("\nThis error may occur if:") - print(" - Default model deployments are not configured (run update_defaults.py)") - print(" - The prebuilt-invoice analyzer is not available") - print(" - The document URL is not accessible") - print(" - You don't have permission to delete results") - print("\nTroubleshooting steps:") - print(" 1. Run get_defaults.py to verify model deployments are configured") - print(" 2. Check that the document URL is accessible") - print(" 3. Verify you have permissions to analyze and delete results") - print(" 4. Ensure the endpoint and credentials are correct") - raise - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py deleted file mode 100644 index 46a5634c3ce3..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_analyzer.py +++ /dev/null @@ -1,144 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: retrieve an analyzer using the get API. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python get_analyzer.py -""" - -from __future__ import annotations -import asyncio -import json -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Retrieve analyzer using get API -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Retrieve a prebuilt analyzer and dump it as JSON -# 3. Create a custom analyzer -# 4. Retrieve the custom analyzer using the get API -# 5. Display analyzer details and dump as JSON -# 6. Clean up by deleting the analyzer (demo purposes) - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - # First, retrieve and dump the prebuilt-document analyzer - print("Retrieving prebuilt-document analyzer...") - prebuilt_analyzer: ContentAnalyzer = await client.get_analyzer(analyzer_id="prebuilt-documentSearch") - print("Prebuilt-document analyzer retrieved successfully!") - - # Dump prebuilt analyzer as JSON - print("\n" + "=" * 80) - print("Dump ContentAnalyzer object for prebuilt-document") - print("=" * 80) - prebuilt_json = json.dumps(prebuilt_analyzer.as_dict(), indent=2, default=str) - print(prebuilt_json) - print("=" * 80 + "\n") - - # Now create a custom analyzer for piano student registration form processing - analyzer_id = f"piano_student_registration_{int(asyncio.get_event_loop().time())}" - print(f"Creating custom analyzer '{analyzer_id}' for piano student registration form processing...") - custom_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - description="Custom analyzer for processing piano student registration forms", - config=ContentAnalyzerConfig(return_details=True), - field_schema=ContentFieldSchema( - name="piano_student_registration_schema", - description="Schema for extracting and analyzing piano student registration form data", - fields={ - "student_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="The full name of the student registering for piano lessons", - ), - "years_of_playing": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.GENERATE, - description="Number of years the student has been playing piano, inferred from experience level or dates mentioned", - ), - "learning_goals_summary": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.GENERATE, - description="A concise summary of the student's learning goals and musical aspirations", - ), - }, - ), - models={"completion": "gpt-4.1"}, # Required when using field_schema - ) - - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=custom_analyzer, - ) - await poller.result() - print(f"Custom analyzer '{analyzer_id}' created successfully!") - - # Now retrieve the custom analyzer - print(f"\nRetrieving custom analyzer '{analyzer_id}'...") - retrieved_analyzer: ContentAnalyzer = await client.get_analyzer(analyzer_id=analyzer_id) - print(f"Custom analyzer '{analyzer_id}' retrieved successfully!") - print(f" Description: {retrieved_analyzer.description}") - print(f" Status: {retrieved_analyzer.status}") - print(f" Created at: {retrieved_analyzer.created_at}") - - # Dump custom analyzer as JSON - print("\n" + "=" * 80) - print(f"Dump ContentAnalyzer object for {analyzer_id}") - print("=" * 80) - custom_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) - print(custom_json) - print("=" * 80 + "\n") - - # Clean up: delete the analyzer (demo purposes only) - # Note: You can leave the analyzer for later use if desired - print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully!") - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py deleted file mode 100644 index 045ad20e1a55..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_defaults.py +++ /dev/null @@ -1,124 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: retrieve default model deployment settings for Content Understanding resource. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python get_defaults.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Retrieve default model deployment settings -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Retrieve the current default model deployment mappings -# 3. Display configured model deployments -# 4. Show which prebuilt analyzers are ready to use -# -# Note: Default model deployments must be configured using update_defaults -# before prebuilt analyzers can be used. See update_defaults.py sample. - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - await get_deployment_settings(client) - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -async def get_deployment_settings(client: ContentUnderstandingClient) -> None: - """Retrieve and display default model deployment settings.""" - - print("\nRetrieving default model deployment settings...") - - try: - # Get the current default settings - defaults = await client.get_defaults() - - print("\nSuccessfully retrieved default settings") - print("\nModel Deployment Mappings:") - print("=" * 60) - - # Check if model deployments are configured - if hasattr(defaults, "model_deployments") and defaults.model_deployments: - # Display each model deployment mapping - for model_name, deployment_name in defaults.model_deployments.items(): - print(f" {model_name:<30} → {deployment_name}") - - print("=" * 60) - - # Provide context about what these models are used for - print("\nModel Usage:") - if "gpt-4.1" in defaults.model_deployments: - print(" • GPT-4.1: Used by most prebuilt analyzers") - print(" (prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument, etc.)") - - if "gpt-4.1-mini" in defaults.model_deployments: - print(" • GPT-4.1-mini: Used by RAG analyzers") - print(" (prebuilt-documentSearch, prebuilt-audioSearch, prebuilt-videoSearch)") - - if "text-embedding-3-large" in defaults.model_deployments: - print(" • text-embedding-3-large: Used for semantic search and embeddings") - - print("\nYour Content Understanding resource is configured!") - print(" You can now use prebuilt analyzers that depend on these models.") - - else: - print(" No model deployments configured") - print("=" * 60) - print("\n⚠️ Model deployments have not been configured yet.") - print("\n To use prebuilt analyzers, you need to:") - print(" 1. Deploy GPT-4.1, GPT-4.1-mini, and text-embedding-3-large in Azure AI Foundry") - print(" 2. Run the update_defaults.py sample to configure the mappings") - print(" 3. Run this sample again to verify the configuration") - - except Exception as e: - print(f"\n❌ Error retrieving defaults: {e}") - print("\nThis error may occur if:") - print(" - The Content Understanding resource is not properly configured") - print(" - You don't have permission to read resource settings") - print(" - The endpoint URL is incorrect") - print("\nTroubleshooting steps:") - print(" 1. Verify AZURE_CONTENT_UNDERSTANDING_ENDPOINT is correct") - print(" 2. Check your authentication credentials") - print(" 3. Ensure you have read permissions on the resource") - raise - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py deleted file mode 100644 index 87d3ac520709..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/get_result_file.py +++ /dev/null @@ -1,266 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- - -import asyncio -import os -from datetime import datetime -import uuid -from collections.abc import AsyncIterator - -from typing import Any, Optional - -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - AnalyzeInput, - AnalyzeResult, - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod, - ProcessingLocation, - AudioVisualContent, -) - -from sample_helper import ( - save_json_to_file, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -from dotenv import load_dotenv - -load_dotenv() - -""" -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python get_result_file.py -""" - - -def save_keyframe_image_to_file( - image_content: bytes, - keyframe_id: str, - test_name: str, - test_py_file_dir: str, - identifier: Optional[str] = None, - output_dir: str = "sample_output", -) -> str: - """Save keyframe image to output file using pytest naming convention. - - Args: - image_content: The binary image content to save - keyframe_id: The keyframe ID (e.g., "keyframes/733") - test_name: Name of the test case (e.g., function name) - test_py_file_dir: Directory where pytest files are located - identifier: Optional unique identifier to avoid conflicts (e.g., analyzer_id) - output_dir: Directory name to save the output file (default: "sample_output") - - Returns: - str: Path to the saved image file - - Raises: - OSError: If there are issues creating directory or writing file - """ - # Generate timestamp and frame ID - timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") - # Extract the frame time from the keyframe path (e.g., "keyframes/733" -> "733") - if "/" in keyframe_id: - frame_id = keyframe_id.split("/")[-1] - else: - # Fallback: use as-is if no slash found - frame_id = keyframe_id - - # Create output directory if it doesn't exist - output_dir_path = os.path.join(test_py_file_dir, output_dir) - os.makedirs(output_dir_path, exist_ok=True) - - # Generate output filename with optional identifier to avoid conflicts - if identifier: - output_filename = f"{test_name}_{identifier}_{timestamp}_{frame_id}.jpg" - else: - output_filename = f"{test_name}_{timestamp}_{frame_id}.jpg" - - saved_file_path = os.path.join(output_dir_path, output_filename) - - # Write the image content to file - with open(saved_file_path, "wb") as image_file: - image_file.write(image_content) - - print(f"Image file saved to: {saved_file_path}") - return saved_file_path - - -async def main(): - """ - Get result files using get_result_file API. - - High-level steps: - 1. Create a marketing video analyzer - 2. Analyze a video file to generate keyframes - 3. Extract operation ID from the analysis - 4. Get result files (keyframe images) using the operation ID - 5. Save the keyframe images to local files - 6. Clean up the created analyzer - """ - endpoint = os.getenv("AZURE_CONTENT_UNDERSTANDING_ENDPOINT") or "" - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - analyzer_id = f"sdk_sample_video_{datetime.now().strftime('%Y%m%d')}_{datetime.now().strftime('%H%M%S')}_{uuid.uuid4().hex[:8]}" - - # Create a marketing video analyzer using object model - print(f"Creating marketing video analyzer '{analyzer_id}'...") - - video_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-video", - config=ContentAnalyzerConfig( - return_details=True, - ), - models={"completion": "gpt-4.1"}, # Required when using field_schema - description="Marketing video analyzer for result file demo", - tags={"demo_type": "video_analysis"}, - ) - - # Start the analyzer creation operation - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=video_analyzer, - ) - - # Wait for the analyzer to be created - print(f"Waiting for analyzer creation to complete...") - await poller.result() - print(f"Analyzer '{analyzer_id}' created successfully!") - - # Use the FlightSimulator.mp4 video file from remote location - video_file_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/videos/sdk_samples/FlightSimulator.mp4" - print(f"Using video file from URL: {video_file_url}") - - # Begin video analysis operation - print(f"Starting video analysis with analyzer '{analyzer_id}'...") - analysis_poller = await client.begin_analyze(analyzer_id=analyzer_id, inputs=[AnalyzeInput(url=video_file_url)]) - - # Wait for analysis completion - print(f"Waiting for video analysis to complete...") - analysis_result = await analysis_poller.result() - print(f"Video analysis completed successfully!") - - # Save the full analysis result to JSON for detailed inspection - save_json_to_file( - analysis_result.as_dict(), - filename_prefix="get_result_file", - ) - print("Analysis result saved to JSON file for detailed inspection") - - # Extract operation ID for get_result_file using the poller's details property - analysis_operation_id = analysis_poller.operation_id - print(f"Extracted analysis operation ID: {analysis_operation_id}") - - # Use the analysis result we already have from the poller to see what files are available - print(f"Using analysis result to find available files...") - operation_result: Any = analysis_result - if operation_result is None: - print("No analysis result available") - return - print(f"Analysis result contains {len(operation_result.contents)} contents") - - # Look for keyframe times in the analysis result - keyframe_times_ms: list[int] = [] - for content in operation_result.contents: - if isinstance(content, AudioVisualContent): - video_content: AudioVisualContent = content - print(f"KeyFrameTimesMs: {video_content.key_frame_times_ms}") - keyframe_times_ms.extend(video_content.key_frame_times_ms or []) - print(f"Found keyframes in video content") - break - else: - print(f"Content is not an AudioVisualContent: {content}") - - if not keyframe_times_ms: - print("No keyframe times found in the analysis result") - return - - print(f"Found {len(keyframe_times_ms)} keyframe times in milliseconds") - - # Build keyframe filenames using the time values - keyframe_files = [f"keyframes/{time_ms}" for time_ms in keyframe_times_ms] - - # Download and save a few keyframe images as examples (first, middle, last) - if len(keyframe_files) >= 3: - frames_to_download = { - keyframe_files[0], - keyframe_files[-1], - keyframe_files[len(keyframe_files) // 2], - } - else: - frames_to_download = set(keyframe_files) - - files_to_download = list(frames_to_download) - print(f"Downloading {len(files_to_download)} keyframe images as examples: {files_to_download}") - - for keyframe_id in files_to_download: - print(f"Getting result file: {keyframe_id}") - - # Get the result file (keyframe image) - response: Any = await client.get_result_file( - operation_id=analysis_operation_id, - path=keyframe_id, - ) - - # Handle the response - it's an async iterator that needs to be collected - from collections.abc import AsyncIterator - - assert isinstance(response, AsyncIterator), f"Expected AsyncIterator, got {type(response)}" - - # It's an async iterator, collect all bytes efficiently - chunks: list[bytes] = [] - async for chunk in response: - chunks.append(chunk) - image_content = b"".join(chunks) - - print(f"Retrieved image file for {keyframe_id} ({len(image_content)} bytes)") - - # Save the image file - saved_file_path = save_keyframe_image_to_file( - image_content=image_content, - keyframe_id=keyframe_id, - test_name="get_result_file", - test_py_file_dir=os.path.dirname(os.path.abspath(__file__)), - identifier=analyzer_id, - ) - print(f"Keyframe image saved to: {saved_file_path}") - - # Clean up the created analyzer (demo cleanup) - print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully!") - - # x-ms-original-file: 2025-11-01/ContentAnalyzers_GetResultFile.json - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py deleted file mode 100644 index efb89dc05189..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/grant_copy_auth.py +++ /dev/null @@ -1,260 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: grant copy authorization and copy an analyzer from source to target. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - Source endpoint - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID (required) - Full Azure Resource Manager resource ID of source - AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION (required) - Azure region of source resource - AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT (required) - Target endpoint for cross-subscription copy - AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID (required) - Full Azure Resource Manager resource ID of target - AZURE_CONTENT_UNDERSTANDING_TARGET_REGION (required) - Azure region of target resource - AZURE_CONTENT_UNDERSTANDING_TARGET_KEY (optional) - Target API key if different from source - Example resource ID format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name} - Note: Both source and target AI Foundry Resources require Cognitive Services User Role for cross-subscription copy - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python grant_copy_auth.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod, - CopyAuthorization, -) -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Grant copy authorization and copy analyzer from source to target -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Create a source analyzer -# 3. Grant copy authorization for copying the analyzer -# 4. Print the authorization result -# 5. Copy the source analyzer to target -# 6. Wait for copy operation to complete -# 7. Clean up both analyzers - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as source_client: - base_analyzer_id = f"sdk_sample_custom_analyzer_{int(asyncio.get_event_loop().time())}" - source_analyzer_id = f"{base_analyzer_id}_source" - target_analyzer_id = f"{base_analyzer_id}_target" - - # Step 1: Create the source analyzer - print(f"Creating source analyzer '{source_analyzer_id}'...") - - # Create a custom analyzer using object model (following pattern from create_analyzer.py) - source_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - description="Source analyzer for extracting company information", - config=ContentAnalyzerConfig( - enable_formula=False, - enable_layout=True, - enable_ocr=True, - estimate_field_source_and_confidence=True, - return_details=True, - ), - field_schema=ContentFieldSchema( - name="company_schema", - description="Schema for extracting company information", - fields={ - # EXTRACT: Extract information directly from document content - "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company", - ), - "total_amount": ContentFieldDefinition( - type=ContentFieldType.NUMBER, - method=GenerationMethod.EXTRACT, - description="Total amount on the document", - ), - # GENERATE: AI generates content based on document understanding - "document_summary": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.GENERATE, - description="A concise summary of the document's main content", - ), - "key_insights": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.GENERATE, - description="Key business insights or actionable items from the document", - ) - }, - ), - models={"completion": "gpt-4.1"}, # Required when using field_schema - ) - - poller = await source_client.begin_create_analyzer( - analyzer_id=source_analyzer_id, - resource=source_analyzer, - ) - source_result = await poller.result() - print(f"Source analyzer '{source_analyzer_id}' created successfully!") - print(f"Source analyzer tags: {source_result.tags}") - - # Step 2: Grant copy authorization before copying - print(f"\nGranting copy authorization for analyzer '{source_analyzer_id}'...") - - # Source Azure Resource Manager resource ID (where the analyzer currently exists) - source_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID"] - source_region = os.environ["AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION"] - - # Target endpoint and region for cross-subscription copy - target_endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT"] - target_region = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_REGION"] - - # Target resource ID (where we want to copy the analyzer to) - target_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID"] - - copy_auth: CopyAuthorization = await source_client.grant_copy_authorization( - analyzer_id=source_analyzer_id, - target_azure_resource_id=target_resource_id, - target_region=target_region, - ) - - # Step 3: Print the authorization result - print(f"\nCopy authorization granted successfully!") - print(f"Authorization details:") - print(f" Source: {copy_auth.source}") - print(f" Target Azure Resource ID: {copy_auth.target_azure_resource_id}") - print(f" Target Region: {target_region}") - print(f" Expires at: {copy_auth.expires_at}") - - # Step 4: Create target client for cross-subscription copy - print(f"\nCreating target client for cross-subscription copy...") - print(f"Target endpoint: {target_endpoint}") - print(f"Target region: {target_region}") - - # Create target client with the target endpoint - # Use the same credential (should work across subscriptions if properly configured) - target_key = os.getenv("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") - target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=target_endpoint, credential=target_credential) as target_client: - # Step 5: Copy the source analyzer to target using begin_copy_analyzer API on target client - print(f"\nCopying analyzer from '{source_analyzer_id}' to '{target_analyzer_id}' on target subscription...") - print(f"Source resource ID: {source_resource_id}") - print(f"Source region: {source_region}") - print(f"Target region: {target_region}") - - # For cross-subscription copy, use parameters to specify source location - # Note: Copy authorization was granted above, but we'll use parameters instead of the CopyAuthorization object - # since the CopyAuthorization might not be correctly populated (source: None) - try: - copy_poller = await target_client.begin_copy_analyzer( - analyzer_id=target_analyzer_id, - source_analyzer_id=source_analyzer_id, - source_azure_resource_id=source_resource_id, - source_region=source_region, - ) - target_result = await copy_poller.result() - print(f"Target analyzer '{target_analyzer_id}' copied successfully to target subscription!") - print(f"Target analyzer tags (before update): {target_result.tags}") - except Exception as e: - print(f"Error copying analyzer: {e}") - print("Note: The copy operation may not be available on all service endpoints or may require additional permissions.") - # Continue to cleanup section - raise - - # Step 6: Get the target analyzer using target client and dump values - print(f"\nRetrieving target analyzer '{target_analyzer_id}' from target client...") - retrieved_analyzer = await target_client.get_analyzer(analyzer_id=target_analyzer_id) - - # Dump all analyzer values - print(f"\n=== Target Analyzer Details ===") - print(f"Analyzer ID: {retrieved_analyzer.analyzer_id}") - print(f"Description: {retrieved_analyzer.description}") - print(f"Status: {retrieved_analyzer.status}") - print(f"Created at: {retrieved_analyzer.created_at}") - print(f"Last modified: {retrieved_analyzer.last_modified_at}") - print(f"Tags: {retrieved_analyzer.tags}") - if retrieved_analyzer.base_analyzer_id: - print(f"Base analyzer ID: {retrieved_analyzer.base_analyzer_id}") - if retrieved_analyzer.config: - print(f"Config: {retrieved_analyzer.config}") - if retrieved_analyzer.field_schema: - print(f"Field schema name: {retrieved_analyzer.field_schema.name}") - print(f"Field schema description: {retrieved_analyzer.field_schema.description}") - if retrieved_analyzer.field_schema.fields: - print(f"Number of fields: {len(retrieved_analyzer.field_schema.fields)}") - for field_name, field_def in retrieved_analyzer.field_schema.fields.items(): - print(f" - {field_name}: {field_def.type} ({field_def.method})") - if retrieved_analyzer.models: - print(f"Models: {retrieved_analyzer.models}") - print(f"=== End Target Analyzer Details ===\n") - - # Update the target analyzer tags if needed - # Since copy may not preserve or set tags, we update after copying - print(f"\nUpdating target analyzer '{target_analyzer_id}' tags...") - updated_target_analyzer = ContentAnalyzer( - tags={"copiedFrom": source_analyzer_id} - ) - final_target_result = await target_client.update_analyzer( - analyzer_id=target_analyzer_id, - resource=updated_target_analyzer, - ) - print(f"Target analyzer '{target_analyzer_id}' updated successfully!") - print(f"Target analyzer tags: {final_target_result.tags}") - - # Clean up the target analyzer on target subscription - print(f"\nDeleting target analyzer '{target_analyzer_id}' from target subscription (demo cleanup)...") - await target_client.delete_analyzer(analyzer_id=target_analyzer_id) - print(f"Target analyzer '{target_analyzer_id}' deleted successfully from target subscription!") - - # Manually close DefaultAzureCredential if it was used for target client - if isinstance(target_credential, DefaultAzureCredential): - await target_credential.close() - - # Clean up the created analyzers (demo cleanup) - print(f"\nDeleting analyzers (demo cleanup)...") - print(f"Deleting source analyzer '{source_analyzer_id}'...") - await source_client.delete_analyzer(analyzer_id=source_analyzer_id) - print(f"Source analyzer '{source_analyzer_id}' deleted successfully!") - - # Note: Target analyzer is already deleted from target subscription above - print(f"Target analyzer '{target_analyzer_id}' was already deleted from target subscription.") - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/list_analyzers.py deleted file mode 100644 index d3b08dc1aa58..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/list_analyzers.py +++ /dev/null @@ -1,114 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- - -import asyncio -import os - -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient - -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -from dotenv import load_dotenv - -load_dotenv() - -""" -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python list_analyzers.py -""" - - -async def main(): - """ - List all available analyzers using list API. - - High-level steps: - 1. Connect to Azure AI Content Understanding - 2. List all available analyzers - 3. Display detailed information about each analyzer - 4. Show summary statistics - """ - endpoint = os.getenv("AZURE_CONTENT_UNDERSTANDING_ENDPOINT") or "" - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - print(f"Listing all available analyzers...") - - # List all analyzers - response = client.list_analyzers() - analyzers = [analyzer async for analyzer in response] - - print(f"Found {len(analyzers)} analyzers") - print() - - # Display detailed information about each analyzer - for i, analyzer in enumerate(analyzers, 1): - print(f"Analyzer {i}:") - print(f" ID: {analyzer.analyzer_id}") - print(f" Description: {analyzer.description}") - print(f" Status: {analyzer.status}") - print(f" Created at: {analyzer.created_at}") - - # Check if it's a prebuilt analyzer - if analyzer.analyzer_id.startswith("prebuilt-"): - print(f" Type: Prebuilt analyzer") - else: - print(f" Type: Custom analyzer") - - # Show tags if available - if hasattr(analyzer, "tags") and analyzer.tags: - print(f" Tags: {analyzer.tags}") - - # Get full analyzer details including config using get API - try: - full_analyzer = await client.get_analyzer(analyzer_id=analyzer.analyzer_id) - if full_analyzer.config: - print(f" Config: {full_analyzer.config}") - if full_analyzer.base_analyzer_id: - print(f" Base analyzer ID: {full_analyzer.base_analyzer_id}") - if full_analyzer.field_schema: - print(f" Field schema: {full_analyzer.field_schema.name if hasattr(full_analyzer.field_schema, 'name') else 'Available'}") - if hasattr(full_analyzer.field_schema, 'fields') and full_analyzer.field_schema.fields: - print(f" Number of fields: {len(full_analyzer.field_schema.fields)}") - if full_analyzer.models: - print(f" Models: {full_analyzer.models}") - except Exception as e: - print(f" Error getting analyzer details: {e}") - - print() - - # Check for specific prebuilt analyzers - prebuilt_ids = [analyzer.analyzer_id for analyzer in analyzers if analyzer.analyzer_id.startswith("prebuilt-")] - if "prebuilt-document" in prebuilt_ids: - print(f" prebuilt-document is available") - if "prebuilt-videoSearch" in prebuilt_ids: - print(f" prebuilt-videoSearch is available") - - # x-ms-original-file: 2025-11-01/ContentAnalyzers_List.json - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -if __name__ == "__main__": - asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py new file mode 100644 index 000000000000..7309bbccde76 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py @@ -0,0 +1,133 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_binary.py + +DESCRIPTION: + This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + analyzer. The prebuilt-documentSearch analyzer transforms unstructured documents into structured, + machine-readable data optimized for RAG scenarios. + + Content Understanding supports multiple content types: + - Documents: Extract text, tables, figures, layout information, and structured markdown + - Images: Analyze standalone images to generate descriptions and extract visual features + - Audio: Transcribe audio content with speaker diarization and timing information + - Video: Analyze video content with visual frame extraction and audio transcription + +USAGE: + python sample_analyze_binary.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeResult, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Analyze document from binary data + analyze_document_binary(client) + + +# [START ContentUnderstandingAnalyzeBinaryAsync] +def analyze_document_binary(client: ContentUnderstandingClient) -> None: + """Analyze a document from binary data using prebuilt-documentSearch analyzer.""" + + file_path = "sample_files/sample_invoice.pdf" + + with open(file_path, "rb") as f: + pdf_bytes = f.read() + + print(f"Analyzing {file_path} with prebuilt-documentSearch...") + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=pdf_bytes, + ) + result: AnalyzeResult = poller.result() + + # Extract markdown content + extract_markdown_content(result) + + # Extract document properties + extract_document_properties(result) +# [END ContentUnderstandingAnalyzeBinaryAsync] + + +# [START ContentUnderstandingExtractMarkdown] +def extract_markdown_content(result: AnalyzeResult) -> None: + """Extract and display markdown content from the analysis result.""" + + print("\nMarkdown Content:") + print("=" * 50) + + # A PDF file has only one content element even if it contains multiple pages + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.markdown: + print(content.markdown) + else: + print("No markdown content available.") + else: + print("No content found in the analysis result.") + + print("=" * 50) +# [END ContentUnderstandingExtractMarkdown] + + +def extract_document_properties(result: AnalyzeResult) -> None: + """Extract and display document properties from the analysis result.""" + + if not result.contents or len(result.contents) == 0: + print("No content found in the analysis result.") + return + + content = result.contents[0] + + # Check if this is document content to access document-specific properties + if content.kind == MediaContentKind.DOCUMENT: + # Type assertion: we know this is DocumentContent for PDF files + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f" Start page: {document_content.start_page_number}") + print(f" End page: {document_content.end_page_number}") + + if document_content.start_page_number and document_content.end_page_number: + total_pages = document_content.end_page_number - document_content.start_page_number + 1 + print(f" Total pages: {total_pages}") + + # Check for pages + if document_content.pages: + print(f"\nPages ({len(document_content.pages)}):") + for page in document_content.pages: + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py new file mode 100644 index 000000000000..792ac2b19e6f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -0,0 +1,205 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_configs.py + +DESCRIPTION: + This sample demonstrates how to extract additional features from documents such as charts, + hyperlinks, formulas, and annotations using the prebuilt-documentSearch analyzer. + + The prebuilt-documentSearch analyzer has the following configurations enabled by default: + - EnableFormula: Extracts mathematical formulas from documents + - EnableLayout: Extracts layout information (tables, figures, etc.) + - EnableOcr: Performs OCR on documents + + These configs enable extraction of: + - Charts: Chart figures with Chart.js configuration + - Hyperlinks: URLs and links found in the document + - Formulas: Mathematical formulas in LaTeX format + - Annotations: PDF annotations, comments, and markup + +USAGE: + python sample_analyze_configs.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeResult, + DocumentContent, + MediaContentKind, + DocumentChartFigure, + DocumentFigureKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Analyze with configs + analyze_with_configs(client) + + +# [START ContentUnderstandingAnalyzeWithConfigs] +def analyze_with_configs(client: ContentUnderstandingClient) -> None: + """Analyze a document using prebuilt-documentSearch with formulas, layout, and OCR enabled.""" + + file_path = "sample_files/sample_invoice.pdf" + + with open(file_path, "rb") as f: + pdf_bytes = f.read() + + print(f"Analyzing {file_path} with prebuilt-documentSearch...") + print("Note: prebuilt-documentSearch has formulas, layout, and OCR enabled by default.") + + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=pdf_bytes, + ) + result: AnalyzeResult = poller.result() + + # Extract various features + extract_charts(result) + extract_hyperlinks(result) + extract_formulas(result) + extract_annotations(result) +# [END ContentUnderstandingAnalyzeWithConfigs] + + +# [START ContentUnderstandingExtractCharts] +def extract_charts(result: AnalyzeResult) -> None: + """Extract chart figures from the document.""" + + if not result.contents or len(result.contents) == 0: + print("\nNo content found in the analysis result.") + return + + content = result.contents[0] + + if content.kind != MediaContentKind.DOCUMENT: + print("\nContent is not a document.") + return + + document_content: DocumentContent = content # type: ignore + + if document_content.figures and len(document_content.figures) > 0: + # Filter for chart figures + chart_figures = [ + f for f in document_content.figures + if isinstance(f, DocumentChartFigure) or (hasattr(f, 'kind') and f.kind == DocumentFigureKind.CHART) + ] + + print(f"\nFound {len(chart_figures)} chart(s)") + for chart in chart_figures: + print(f" Chart ID: {chart.id}") + if hasattr(chart, 'description') and chart.description: + print(f" Description: {chart.description}") + if hasattr(chart, 'caption') and chart.caption and chart.caption.content: + print(f" Caption: {chart.caption.content}") + else: + print("\nNo figures found in the document.") +# [END ContentUnderstandingExtractCharts] + + +# [START ContentUnderstandingExtractHyperlinks] +def extract_hyperlinks(result: AnalyzeResult) -> None: + """Extract hyperlinks from the document.""" + + if not result.contents or len(result.contents) == 0: + return + + content = result.contents[0] + + if content.kind != MediaContentKind.DOCUMENT: + return + + document_content: DocumentContent = content # type: ignore + + if document_content.hyperlinks and len(document_content.hyperlinks) > 0: + print(f"\nFound {len(document_content.hyperlinks)} hyperlink(s)") + for hyperlink in document_content.hyperlinks: + print(f" URL: {hyperlink.url or '(not available)'}") + print(f" Content: {hyperlink.content or '(not available)'}") + else: + print("\nNo hyperlinks found in the document.") +# [END ContentUnderstandingExtractHyperlinks] + + +# [START ContentUnderstandingExtractFormulas] +def extract_formulas(result: AnalyzeResult) -> None: + """Extract mathematical formulas from document pages.""" + + if not result.contents or len(result.contents) == 0: + return + + content = result.contents[0] + + if content.kind != MediaContentKind.DOCUMENT: + return + + document_content: DocumentContent = content # type: ignore + + all_formulas = [] + if document_content.pages: + for page in document_content.pages: + if hasattr(page, 'formulas') and page.formulas: + all_formulas.extend(page.formulas) + + if len(all_formulas) > 0: + print(f"\nFound {len(all_formulas)} formula(s)") + for formula in all_formulas: + print(f" Formula: {formula.value or '(no value)'}") + if hasattr(formula, 'kind') and formula.kind: + print(f" Kind: {formula.kind}") + else: + print("\nNo formulas found in the document.") +# [END ContentUnderstandingExtractFormulas] + + +def extract_annotations(result: AnalyzeResult) -> None: + """Extract annotations from the document.""" + + if not result.contents or len(result.contents) == 0: + return + + content = result.contents[0] + + if content.kind != MediaContentKind.DOCUMENT: + return + + document_content: DocumentContent = content # type: ignore + + if hasattr(document_content, 'annotations') and document_content.annotations and len(document_content.annotations) > 0: + print(f"\nFound {len(document_content.annotations)} annotation(s)") + for annotation in document_content.annotations: + print(f" Kind: {annotation.kind or '(unknown)'}") + if hasattr(annotation, 'content') and annotation.content: + print(f" Content: {annotation.content}") + else: + print("\nNo annotations found in the document.") + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py new file mode 100644 index 000000000000..e1432ea3c623 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -0,0 +1,161 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_invoice.py + +DESCRIPTION: + This sample demonstrates how to analyze an invoice from a URL using the prebuilt-invoice + analyzer and extract structured fields from the result. + + Content Understanding provides 70+ production-ready prebuilt analyzers that are ready to use + without any training or configuration. The prebuilt-invoice analyzer automatically extracts: + - Customer/Vendor information: Name, address, contact details + - Invoice metadata: Invoice number, date, due date, purchase order number + - Line items: Description, quantity, unit price, total for each item + - Financial totals: Subtotal, tax amount, shipping charges, total amount + - Payment information: Payment terms, payment method, remittance address + +USAGE: + python sample_analyze_invoice.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + DocumentContent, + ContentField, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Analyze invoice from URL + analyze_invoice(client) + + +# [START ContentUnderstandingAnalyzeInvoice] +def analyze_invoice(client: ContentUnderstandingClient) -> None: + """Analyze an invoice using prebuilt-invoice analyzer.""" + + invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + print(f"Analyzing invoice with prebuilt-invoice analyzer...") + print(f" URL: {invoice_url}") + + poller = client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(url=invoice_url)], + ) + result: AnalyzeResult = poller.result() + + # Extract invoice fields + extract_invoice_fields(result) +# [END ContentUnderstandingAnalyzeInvoice] + + +# [START ContentUnderstandingExtractInvoiceFields] +def extract_invoice_fields(result: AnalyzeResult) -> None: + """Extract and display invoice fields from the analysis result.""" + + if not result.contents or len(result.contents) == 0: + print("No content found in the analysis result.") + return + + content = result.contents[0] + + # Get the document content (invoices are documents) + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + # Print document unit information + # The unit indicates the measurement system used for coordinates in the source field + print(f"\nDocument unit: {document_content.unit or 'unknown'}") + print(f"Pages: {document_content.start_page_number} to {document_content.end_page_number}") + print() + + if not document_content.fields: + print("No fields found in the analysis result.") + return + + # Extract simple string fields + customer_name_field = document_content.fields.get("CustomerName") + invoice_date_field = document_content.fields.get("InvoiceDate") + + customer_name = customer_name_field.value if customer_name_field else None + invoice_date = invoice_date_field.value if invoice_date_field else None + + print(f"Customer Name: {customer_name or '(None)'}") + if customer_name_field: + print(f" Confidence: {customer_name_field.confidence:.2f}" if customer_name_field.confidence else " Confidence: N/A") + # Source is an encoded identifier containing bounding box coordinates + # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) + print(f" Source: {customer_name_field.source or 'N/A'}") + if customer_name_field.spans and len(customer_name_field.spans) > 0: + span = customer_name_field.spans[0] + print(f" Position in markdown: offset={span.offset}, length={span.length}") + + print(f"Invoice Date: {invoice_date or '(None)'}") + if invoice_date_field: + print(f" Confidence: {invoice_date_field.confidence:.2f}" if invoice_date_field.confidence else " Confidence: N/A") + + # Extract object field (TotalAmount contains Amount and CurrencyCode) + total_amount_field = document_content.fields.get("TotalAmount") + if total_amount_field and total_amount_field.value: + total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore + amount_field = total_amount_obj.get("Amount") + currency_field = total_amount_obj.get("CurrencyCode") + + amount = amount_field.value if amount_field else None + currency = currency_field.value if currency_field else None + + print(f"\nTotal Amount: {amount} {currency}") + if total_amount_field.confidence: + print(f" Confidence: {total_amount_field.confidence:.2f}") + + # Extract array field (Items - line items) + items_field = document_content.fields.get("Items") + if items_field and items_field.value: + items_array: list = items_field.value # type: ignore + print(f"\nLine Items ({len(items_array)}):") + for i, item in enumerate(items_array, 1): + if isinstance(item, dict): + description_field = item.get("Description") + quantity_field = item.get("Quantity") + amount_field = item.get("Amount") + + description = description_field.value if description_field else "(no description)" + quantity = quantity_field.value if quantity_field else "N/A" + amount = amount_field.value if amount_field else "N/A" + + print(f" {i}. {description}") + print(f" Quantity: {quantity}, Amount: {amount}") +# [END ContentUnderstandingExtractInvoiceFields] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py new file mode 100644 index 000000000000..648f547b60b2 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py @@ -0,0 +1,122 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_return_raw_json.py + +DESCRIPTION: + This sample demonstrates how to access the raw JSON response from analysis operations + using protocol methods. This is useful for advanced scenarios where you need direct access + to the JSON structure. + + The Content Understanding SDK provides two approaches for accessing analysis results: + 1. Object model approach (recommended): Returns strongly-typed AnalyzeResult objects + 2. Protocol method approach: Returns raw BinaryData containing the JSON response + + For production use, prefer the object model approach as it provides: + - Type safety + - IntelliSense support + - Easier navigation of results + - Better error handling + + Use raw JSON only when you need: + - Custom JSON processing + - Direct access to the raw response structure + - Integration with custom JSON parsers + +USAGE: + python sample_analyze_return_raw_json.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import json +import os +from datetime import datetime +from pathlib import Path + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Analyze and return raw JSON + analyze_return_raw_json(client) + + +# [START ContentUnderstandingAnalyzeReturnRawJson] +def analyze_return_raw_json(client: ContentUnderstandingClient) -> None: + """Use the protocol method to get raw JSON response.""" + + file_path = "sample_files/sample_invoice.pdf" + + with open(file_path, "rb") as f: + file_bytes = f.read() + + print(f"Analyzing {file_path} with prebuilt-documentSearch...") + + # Use the standard method which returns an AnalyzeResult + # Then serialize to JSON for raw access + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + ) + result = poller.result() + + # Convert to dictionary and then to JSON + result_dict = result.as_dict() + parse_and_save_json(result_dict) +# [END ContentUnderstandingAnalyzeReturnRawJson] + + +# [START ContentUnderstandingParseRawJson] +def parse_and_save_json(result_dict: dict) -> None: + """Parse and format the raw JSON response.""" + + # Pretty-print the JSON + pretty_json = json.dumps(result_dict, indent=2, ensure_ascii=False, default=str) + + # Create output directory if it doesn't exist + output_dir = Path(__file__).parent / "sample_output" + output_dir.mkdir(exist_ok=True) + + # Save to file + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + output_filename = f"analyze_result_{timestamp}.json" + output_path = output_dir / output_filename + + with open(output_path, "w", encoding="utf-8") as f: + f.write(pretty_json) + + print(f"\nRaw JSON response saved to: {output_path}") + print(f"File size: {len(pretty_json):,} characters") + + # Show a preview of the JSON structure + print("\nJSON Structure Preview:") + print("=" * 50) + preview = pretty_json[:2000] + "..." if len(pretty_json) > 2000 else pretty_json + print(preview) + print("=" * 50) +# [END ContentUnderstandingParseRawJson] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py new file mode 100644 index 000000000000..71775323fbe9 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py @@ -0,0 +1,97 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_url.py + +DESCRIPTION: + This sample demonstrates how to analyze a document from a URL using the prebuilt-documentSearch + analyzer. This shows how to analyze a document from a publicly accessible URL instead of a local file. + + For understanding basic analysis concepts, authentication, and result processing, + see sample_analyze_binary.py first. + +USAGE: + python sample_analyze_url.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Analyze document from URL + analyze_document_url(client) + + +# [START ContentUnderstandingAnalyzeUrlAsync] +def analyze_document_url(client: ContentUnderstandingClient) -> None: + """Analyze a document from a URL using prebuilt-documentSearch analyzer.""" + + document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + print(f"Analyzing document from URL with prebuilt-documentSearch...") + print(f" URL: {document_url}") + + poller = client.begin_analyze( + analyzer_id="prebuilt-documentSearch", + inputs=[AnalyzeInput(url=document_url)], + ) + result: AnalyzeResult = poller.result() + + # Extract markdown content + print("\nMarkdown Content:") + print("=" * 50) + + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.markdown: + print(content.markdown) + else: + print("No markdown content available.") + else: + print("No content found in the analysis result.") + + print("=" * 50) + + # Display document properties + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f" Start page: {document_content.start_page_number}") + print(f" End page: {document_content.end_page_number}") +# [END ContentUnderstandingAnalyzeUrlAsync] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py new file mode 100644 index 000000000000..a84640564999 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py @@ -0,0 +1,114 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_configure_defaults.py + +DESCRIPTION: + This sample demonstrates how to configure and retrieve default model deployment settings + for your Microsoft Foundry resource. This is a required one-time setup before using + prebuilt analyzers. + + Content Understanding prebuilt analyzers require specific GPT model deployments to function: + - GPT-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt) + - GPT-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-audioSearch) + - text-embedding-3-large: Used for semantic search and embeddings + +USAGE: + python sample_configure_defaults.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + 3) GPT_4_1_DEPLOYMENT - your GPT-4.1 deployment name in Azure AI Foundry. + 4) GPT_4_1_MINI_DEPLOYMENT - your GPT-4.1-mini deployment name in Azure AI Foundry. + 5) TEXT_EMBEDDING_3_LARGE_DEPLOYMENT - your text-embedding-3-large deployment name in Azure AI Foundry. +""" + +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Update model deployments + update_model_deployments(client) + + # Get current defaults + get_model_deployments(client) + + +# [START ContentUnderstandingUpdateDefaults] +def update_model_deployments(client: ContentUnderstandingClient) -> None: + """Configure default model deployment mappings for the Content Understanding resource.""" + + # Get deployment names from environment variables + gpt_4_1_deployment = os.getenv("GPT_4_1_DEPLOYMENT") + gpt_4_1_mini_deployment = os.getenv("GPT_4_1_MINI_DEPLOYMENT") + text_embedding_3_large_deployment = os.getenv("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + # Check if required deployments are configured + missing_deployments = [] + if not gpt_4_1_deployment: + missing_deployments.append("GPT_4_1_DEPLOYMENT") + if not gpt_4_1_mini_deployment: + missing_deployments.append("GPT_4_1_MINI_DEPLOYMENT") + if not text_embedding_3_large_deployment: + missing_deployments.append("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + if missing_deployments: + print("⚠️ Missing required environment variables:") + for deployment in missing_deployments: + print(f" - {deployment}") + print("\nPlease set these environment variables and try again.") + return + + # Map your deployed models to the models required by prebuilt analyzers + model_deployments = { + "gpt-4.1": gpt_4_1_deployment, + "gpt-4.1-mini": gpt_4_1_mini_deployment, + "text-embedding-3-large": text_embedding_3_large_deployment, + } + + print("Configuring model deployments...") + updated_defaults = client.update_defaults(model_deployments=model_deployments) + + print("Model deployments configured successfully!") + if updated_defaults.model_deployments: + for model_name, deployment_name in updated_defaults.model_deployments.items(): + print(f" {model_name} → {deployment_name}") +# [END ContentUnderstandingUpdateDefaults] + + +# [START ContentUnderstandingGetDefaults] +def get_model_deployments(client: ContentUnderstandingClient) -> None: + """Retrieve and display default model deployment settings.""" + + print("\nRetrieving current model deployment settings...") + defaults = client.get_defaults() + + print("\nCurrent model deployment mappings:") + if defaults.model_deployments and len(defaults.model_deployments) > 0: + for model_name, deployment_name in defaults.model_deployments.items(): + print(f" {model_name} → {deployment_name}") + else: + print(" No model deployments configured yet.") +# [END ContentUnderstandingGetDefaults] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py new file mode 100644 index 000000000000..a026cba3a750 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py @@ -0,0 +1,185 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_copy_analyzer.py + +DESCRIPTION: + This sample demonstrates how to copy an analyzer from source to target within the same + resource using the copy_analyzer API. This is useful for creating copies of analyzers + for testing, staging, or production deployment. + + The copy_analyzer API allows you to copy an analyzer within the same Azure resource: + - Same-resource copy: Copies an analyzer from one ID to another within the same resource + - Exact copy: The target analyzer is an exact copy of the source analyzer + - Use cases: Testing, staging, production deployment, versioning + + Note: For cross-resource copying (copying between different Azure resources or subscriptions), + use the grant_copy_auth sample instead. + +USAGE: + python sample_copy_analyzer.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Copy analyzer from source to target + copy_analyzer_demo(client) + + +def copy_analyzer_demo(client: ContentUnderstandingClient) -> None: + """Demonstrate copying an analyzer from source to target.""" + + base_id = f"my_analyzer_{int(time.time())}" + source_analyzer_id = f"{base_id}_source" + target_analyzer_id = f"{base_id}_target" + + # Step 1: Create the source analyzer + create_source_analyzer(client, source_analyzer_id) + + # Step 2: Copy the analyzer + copy_analyzer(client, source_analyzer_id, target_analyzer_id) + + # Step 3: Update and verify the target analyzer + update_and_verify_analyzer(client, target_analyzer_id) + + # Step 4: Clean up + cleanup_analyzers(client, source_analyzer_id, target_analyzer_id) + + +def create_source_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> None: + """Create the source analyzer.""" + + print(f"Creating source analyzer '{analyzer_id}'...") + + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for copy example", + config=ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + field_schema=ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + }, + ), + models={"completion": "gpt-4.1"}, + ) + + poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + ) + poller.result() + print(f"Source analyzer '{analyzer_id}' created successfully!") + + +# [START ContentUnderstandingCopyAnalyzer] +def copy_analyzer(client: ContentUnderstandingClient, source_analyzer_id: str, target_analyzer_id: str) -> None: + """Copy an analyzer from source to target.""" + + print(f"\nCopying analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'...") + + poller = client.begin_copy_analyzer( + target_analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id, + ) + poller.result() + + print(f"Analyzer copied successfully!") +# [END ContentUnderstandingCopyAnalyzer] + + +# [START ContentUnderstandingUpdateAndVerifyAnalyzer] +def update_and_verify_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> None: + """Update the target analyzer with a production tag and verify.""" + + # Get the target analyzer first to get its BaseAnalyzerId + print(f"\nGetting target analyzer '{analyzer_id}'...") + target_analyzer = client.get_analyzer(analyzer_id=analyzer_id) + + # Update the target analyzer with a production tag + updated_analyzer = ContentAnalyzer( + base_analyzer_id=target_analyzer.base_analyzer_id, + tags={"modelType": "model_in_production"}, + ) + + print(f"Updating target analyzer with production tag...") + client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) + + # Verify the update + updated_target = client.get_analyzer(analyzer_id=analyzer_id) + print(f" Description: {updated_target.description}") + if updated_target.tags: + print(f" Tag 'modelType': {updated_target.tags.get('modelType', 'N/A')}") +# [END ContentUnderstandingUpdateAndVerifyAnalyzer] + + +# [START ContentUnderstandingDeleteCopiedAnalyzers] +def cleanup_analyzers(client: ContentUnderstandingClient, source_analyzer_id: str, target_analyzer_id: str) -> None: + """Clean up by deleting both source and target analyzers.""" + + print(f"\nCleaning up analyzers...") + + try: + client.delete_analyzer(analyzer_id=source_analyzer_id) + print(f" Source analyzer '{source_analyzer_id}' deleted successfully.") + except Exception: + pass # Ignore cleanup errors + + try: + client.delete_analyzer(analyzer_id=target_analyzer_id) + print(f" Target analyzer '{target_analyzer_id}' deleted successfully.") + except Exception: + pass # Ignore cleanup errors +# [END ContentUnderstandingDeleteCopiedAnalyzers] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py new file mode 100644 index 000000000000..51cf298f8309 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py @@ -0,0 +1,153 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_create_analyzer.py + +DESCRIPTION: + This sample demonstrates how to create a custom analyzer with a field schema to extract + structured data from documents. + + Custom analyzers allow you to: + - Define custom fields (string, number, date, object, array) + - Specify extraction methods: + - extract: Values are extracted as they appear in the content (literal text extraction) + - generate: Values are generated freely based on the content using AI models + - classify: Values are classified against a predefined set of categories + - Use prebuilt analyzers as a base (prebuilt-document, prebuilt-audio, prebuilt-video, prebuilt-image) + - Configure analysis options (OCR, layout, formulas) + - Enable source and confidence tracking for extracted field values + +USAGE: + python sample_create_analyzer.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using custom analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Create a custom analyzer + analyzer_id = create_custom_analyzer(client) + + # Clean up - delete the analyzer + if analyzer_id: + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") + + +# [START ContentUnderstandingCreateAnalyzer] +def create_custom_analyzer(client: ContentUnderstandingClient) -> str: + """Create a custom analyzer with field schema.""" + + # Generate a unique analyzer ID + analyzer_id = f"my_custom_analyzer_{int(time.time())}" + + print(f"Creating custom analyzer '{analyzer_id}'...") + + # Define field schema with custom fields + # This example demonstrates three extraction methods: + # - extract: Literal text extraction (requires estimateSourceAndConfidence) + # - generate: AI-generated values based on content interpretation + # - classify: Classification against predefined categories + field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + "document_summary": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="A brief summary of the document content", + ), + "document_type": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.CLASSIFY, + description="Type of document", + enum=["invoice", "receipt", "contract", "report", "other"], + ), + }, + ) + + # Create analyzer configuration + config = ContentAnalyzerConfig( + enable_formula=True, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ) + + # Create the analyzer with field schema + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom analyzer for extracting company information", + config=config, + field_schema=field_schema, + models={"completion": "gpt-4.1"}, # Required when using field_schema + ) + + # Create the analyzer + poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + ) + result = poller.result() + + print(f"Analyzer '{analyzer_id}' created successfully!") + print(f" Status: {result.status}") + print(f" Description: {result.description}") + + if result.field_schema and result.field_schema.fields: + print(f" Fields ({len(result.field_schema.fields)}):") + for field_name, field_def in result.field_schema.fields.items(): + method = field_def.method.value if field_def.method else "auto" + print(f" - {field_name}: {field_def.type.value if field_def.type else 'unknown'} ({method})") + + return analyzer_id +# [END ContentUnderstandingCreateAnalyzer] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py new file mode 100644 index 000000000000..b6fe1890188b --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -0,0 +1,177 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_create_classifier.py + +DESCRIPTION: + This sample demonstrates how to create a classifier analyzer to categorize documents and + use it to analyze documents with and without automatic segmentation. + + Classifiers are a type of custom analyzer that categorize documents into predefined categories. + They're useful for: + - Document routing: Automatically route documents to the right processing pipeline + - Content organization: Organize large document collections by type + - Multi-document processing: Process files containing multiple document types by segmenting them + +USAGE: + python sample_create_classifier.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using classifiers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentCategoryDefinition, + AnalyzeResult, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Create a classifier + analyzer_id = create_classifier(client) + + # Analyze with the classifier (demonstrates both with and without segmentation) + if analyzer_id: + analyze_with_classifier(client, analyzer_id) + + # Clean up - delete the classifier + print(f"\nCleaning up: deleting classifier '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Classifier '{analyzer_id}' deleted successfully.") + + +# [START ContentUnderstandingCreateClassifier] +def create_classifier(client: ContentUnderstandingClient) -> str: + """Create a classifier analyzer with content categories.""" + + # Generate a unique analyzer ID + analyzer_id = f"my_classifier_{int(time.time())}" + + print(f"Creating classifier '{analyzer_id}'...") + + # Define content categories for classification + categories = { + "Loan_Application": ContentCategoryDefinition( + description="Documents submitted by individuals or businesses to request funding, " + "typically including personal or business details, financial history, " + "loan amount, purpose, and supporting documentation." + ), + "Invoice": ContentCategoryDefinition( + description="Billing documents issued by sellers or service providers to request " + "payment for goods or services, detailing items, prices, taxes, totals, " + "and payment terms." + ), + "Bank_Statement": ContentCategoryDefinition( + description="Official statements issued by banks that summarize account activity " + "over a period, including deposits, withdrawals, fees, and balances." + ), + } + + # Create analyzer configuration + config = ContentAnalyzerConfig( + return_details=True, + enable_segment=True, # Enable automatic segmentation by category + content_categories=categories, + ) + + # Create the classifier analyzer + classifier = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom classifier for financial document categorization", + config=config, + models={"completion": "gpt-4.1"}, + ) + + # Create the classifier + poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=classifier, + ) + result = poller.result() + + print(f"Classifier '{analyzer_id}' created successfully!") + print(f" Status: {result.status}") + + return analyzer_id +# [END ContentUnderstandingCreateClassifier] + + +# [START ContentUnderstandingAnalyzeCategory] +def analyze_with_classifier(client: ContentUnderstandingClient, analyzer_id: str) -> None: + """Analyze a document with the classifier.""" + + file_path = "sample_files/sample_invoice.pdf" + + with open(file_path, "rb") as f: + file_bytes = f.read() + + print(f"\nAnalyzing document with classifier '{analyzer_id}'...") + + poller = client.begin_analyze_binary( + analyzer_id=analyzer_id, + binary_input=file_bytes, + ) + result: AnalyzeResult = poller.result() + + # Display classification results + display_classification_results(result) +# [END ContentUnderstandingAnalyzeCategory] + + +# [START ContentUnderstandingAnalyzeCategoryWithSegments] +def display_classification_results(result: AnalyzeResult) -> None: + """Display classification results including segments if available.""" + + if not result.contents or len(result.contents) == 0: + print("No content found in the analysis result.") + return + + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + print(f"Pages: {document_content.start_page_number}-{document_content.end_page_number}") + + # Display segments (classification results) + if document_content.segments and len(document_content.segments) > 0: + print(f"\nFound {len(document_content.segments)} segment(s):") + for segment in document_content.segments: + print(f" Category: {segment.category or '(unknown)'}") + print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + if segment.confidence: + print(f" Confidence: {segment.confidence:.2f}") + print() + else: + print("No segments found (document classified as a single unit).") +# [END ContentUnderstandingAnalyzeCategoryWithSegments] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py new file mode 100644 index 000000000000..266fe8a4295f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py @@ -0,0 +1,104 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_delete_analyzer.py + +DESCRIPTION: + This sample demonstrates how to delete a custom analyzer. + + The delete_analyzer method permanently removes a custom analyzer from your resource. + This operation cannot be undone. + + Important notes: + - Only custom analyzers can be deleted. Prebuilt analyzers cannot be deleted. + - Deleting an analyzer does not delete analysis results that were created using that analyzer. + - Once deleted, the analyzer ID cannot be reused immediately. + +USAGE: + python sample_delete_analyzer.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Create and delete an analyzer + create_and_delete_analyzer(client) + + +# [START ContentUnderstandingCreateSimpleAnalyzer] +def create_simple_analyzer(client: ContentUnderstandingClient) -> str: + """Create a simple analyzer for deletion demo.""" + + # Generate a unique analyzer ID + analyzer_id = f"my_analyzer_{int(time.time())}" + + print(f"Creating analyzer '{analyzer_id}'...") + + # Create a simple analyzer + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Simple analyzer for deletion example", + config=ContentAnalyzerConfig(return_details=True), + models={"completion": "gpt-4.1"}, + ) + + poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + ) + poller.result() + print(f"Analyzer '{analyzer_id}' created successfully.") + + return analyzer_id +# [END ContentUnderstandingCreateSimpleAnalyzer] + + +# [START ContentUnderstandingDeleteAnalyzer] +def delete_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> None: + """Delete a custom analyzer.""" + + print(f"Deleting analyzer '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") +# [END ContentUnderstandingDeleteAnalyzer] + + +def create_and_delete_analyzer(client: ContentUnderstandingClient) -> None: + """Create a simple analyzer and then delete it.""" + + # First create an analyzer to delete + analyzer_id = create_simple_analyzer(client) + + # Now delete the analyzer + delete_analyzer(client, analyzer_id) + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py new file mode 100644 index 000000000000..309974059a6e --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -0,0 +1,125 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_delete_result.py + +DESCRIPTION: + This sample demonstrates how to delete analysis results using the delete_result API. + This is useful for removing temporary or sensitive analysis results immediately, rather + than waiting for automatic deletion after 24 hours. + + Analysis results are stored temporarily and can be deleted using the delete_result API: + - Immediate deletion: Results are marked for deletion and permanently removed + - Automatic deletion: Results are automatically deleted after 24 hours if not manually deleted + - Operation ID required: You need the operation ID from the analysis operation to delete + + Important: Once deleted, results cannot be recovered. Make sure you have saved any data + you need before deleting. + +USAGE: + python sample_delete_result.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.core.exceptions import ResourceNotFoundError +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Analyze and delete result + analyze_and_delete_result(client) + + +# [START ContentUnderstandingAnalyzeAndDeleteResult] +def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: + """Analyze a document and then delete the result.""" + + document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + print("Document Analysis Workflow") + print("=" * 60) + print(f" Document URL: {document_url}") + print(f" Analyzer: prebuilt-invoice") + print("=" * 60) + + # Step 1: Start the analysis operation + print("\nStep 1: Starting document analysis...") + poller = client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(url=document_url)], + ) + + # Get the operation ID from the poller + operation_id = poller.operation_id + + if not operation_id: + print("Error: Could not extract operation ID from response") + return + + print(f" Operation ID: {operation_id}") + + # Wait for completion + print(" Waiting for analysis to complete...") + result: AnalyzeResult = poller.result() + print("Analysis completed successfully!") + + # Display some sample results + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.kind == MediaContentKind.DOCUMENT: + doc_content: DocumentContent = content # type: ignore + if doc_content.fields: + print(f" Total fields extracted: {len(doc_content.fields)}") + customer_name_field = doc_content.fields.get("CustomerName") + if customer_name_field: + print(f" Customer Name: {customer_name_field.value or '(not found)'}") + + # Step 2: Delete the analysis result + print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") + client.delete_result(operation_id=operation_id) + print("Analysis result deleted successfully!") + + # Verify deletion by trying to get the result (should fail) + print("\nStep 3: Verifying deletion...") + try: + # Try to get the result - this should fail after deletion + client.get_result(operation_id=operation_id) + print(" Warning: Result still accessible (may take time to propagate)") + except ResourceNotFoundError: + print(" Verified: Result is no longer accessible (404 Not Found)") + except Exception as e: + print(f" Result access check: {type(e).__name__}: {e}") +# [END ContentUnderstandingAnalyzeAndDeleteResult] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py new file mode 100644 index 000000000000..007cf54e6a8e --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py @@ -0,0 +1,160 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_get_analyzer.py + +DESCRIPTION: + This sample demonstrates how to retrieve information about analyzers, including prebuilt + analyzers and custom analyzers. + + The get_analyzer method allows you to retrieve detailed information about any analyzer: + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice + - Custom analyzers: Analyzers you've created with custom field schemas or classifiers + + This is useful for: + - Verifying analyzer configuration + - Inspecting prebuilt analyzers to learn about their capabilities + - Debugging analyzer behavior + +USAGE: + python sample_get_analyzer.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import json +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Get prebuilt analyzer information + get_prebuilt_analyzer(client) + + # Get custom analyzer information + get_custom_analyzer(client) + + +# [START ContentUnderstandingGetPrebuiltAnalyzer] +def get_prebuilt_analyzer(client: ContentUnderstandingClient) -> None: + """Retrieve information about a prebuilt analyzer.""" + + print("Retrieving prebuilt-documentSearch analyzer...") + analyzer = client.get_analyzer(analyzer_id="prebuilt-documentSearch") + + # Display full analyzer JSON + print("\n" + "=" * 80) + print("Prebuilt-documentSearch Analyzer:") + print("=" * 80) + analyzer_json = json.dumps(analyzer.as_dict(), indent=2, default=str) + print(analyzer_json) + print("=" * 80) +# [END ContentUnderstandingGetPrebuiltAnalyzer] + + +# [START ContentUnderstandingGetPrebuiltInvoice] +def get_prebuilt_invoice_analyzer(client: ContentUnderstandingClient) -> None: + """Retrieve information about the prebuilt-invoice analyzer.""" + + print("Retrieving prebuilt-invoice analyzer...") + analyzer = client.get_analyzer(analyzer_id="prebuilt-invoice") + + # Display full analyzer JSON + print("\n" + "=" * 80) + print("Prebuilt-invoice Analyzer:") + print("=" * 80) + analyzer_json = json.dumps(analyzer.as_dict(), indent=2, default=str) + print(analyzer_json) + print("=" * 80) +# [END ContentUnderstandingGetPrebuiltInvoice] + + +# [START ContentUnderstandingGetCustomAnalyzer] +def get_custom_analyzer(client: ContentUnderstandingClient) -> None: + """Create a custom analyzer, retrieve its information, and display the full JSON.""" + + # First, create a custom analyzer + analyzer_id = f"my_custom_analyzer_{int(time.time())}" + + print(f"\nCreating custom analyzer '{analyzer_id}'...") + + field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + }, + ) + + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom analyzer for extracting company information", + config=ContentAnalyzerConfig(return_details=True), + field_schema=field_schema, + models={"completion": "gpt-4.1"}, + ) + + poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + ) + poller.result() + print(f"Custom analyzer '{analyzer_id}' created successfully!") + + # Now retrieve the custom analyzer + print(f"\nRetrieving custom analyzer '{analyzer_id}'...") + retrieved_analyzer = client.get_analyzer(analyzer_id=analyzer_id) + + # Display full analyzer JSON + print("\n" + "=" * 80) + print(f"Custom Analyzer '{analyzer_id}':") + print("=" * 80) + analyzer_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) + print(analyzer_json) + print("=" * 80) + + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") +# [END ContentUnderstandingGetCustomAnalyzer] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py new file mode 100644 index 000000000000..56c609908bbd --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py @@ -0,0 +1,151 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_get_result_file.py + +DESCRIPTION: + This sample demonstrates how to retrieve result files (such as keyframe images) from a + video analysis operation using the get_result_file API. + + When analyzing video content, the Content Understanding service can generate result files: + - Keyframe images: Extracted frames from the video at specific timestamps + - Other result files: Additional files generated during analysis + + The get_result_file API allows you to retrieve these files using: + - Operation ID: Extracted from the analysis operation + - File path: The path to the specific result file (e.g., "keyframes/{frameTimeMs}") + +USAGE: + python sample_get_result_file.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import os +from pathlib import Path + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + AudioVisualContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Analyze video and get result files + analyze_video_and_get_result_files(client) + + +# [START ContentUnderstandingAnalyzeVideoForResultFiles] +def analyze_video_and_get_result_files(client: ContentUnderstandingClient) -> None: + """Analyze a video and retrieve result files (keyframe images).""" + + # Use a sample video URL + video_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/sample_video.mp4" + + print(f"Analyzing video with prebuilt-videoSearch...") + print(f" URL: {video_url}") + + # Start the analysis operation (using begin_analyze which returns a poller) + poller = client.begin_analyze( + analyzer_id="prebuilt-videoSearch", + inputs=[AnalyzeInput(url=video_url)], + ) + + # Get the operation ID from the poller + operation_id = poller.operation_id + print(f" Operation ID: {operation_id}") + + # Wait for completion + print(" Waiting for analysis to complete...") + result: AnalyzeResult = poller.result() + + # Get result files + get_result_files(client, operation_id, result) +# [END ContentUnderstandingAnalyzeVideoForResultFiles] + + +# [START ContentUnderstandingGetResultFile] +def get_result_files(client: ContentUnderstandingClient, operation_id: str, result: AnalyzeResult) -> None: + """Retrieve result files (keyframe images) using the operation ID and file path.""" + + if not result.contents or len(result.contents) == 0: + print("No content found in the analysis result.") + return + + content = result.contents[0] + + # For video analysis, keyframes would be found in AudioVisualContent.KeyFrameTimesMs + if content.kind in [MediaContentKind.VIDEO, MediaContentKind.AUDIO]: + video_content: AudioVisualContent = content # type: ignore + + if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: + total_keyframes = len(video_content.key_frame_times_ms) + first_frame_time_ms = video_content.key_frame_times_ms[0] + + print(f"\nTotal keyframes: {total_keyframes}") + print(f"First keyframe time: {first_frame_time_ms} ms") + + # Get the first keyframe as an example + frame_path = f"keyframes/{first_frame_time_ms}" + + print(f"Getting result file: {frame_path}") + + # Get the result file (keyframe image) + file_response = client.get_result_file( + operation_id=operation_id, + file_path=frame_path, + ) + + image_bytes = file_response + print(f"Retrieved keyframe image ({len(image_bytes):,} bytes)") + + # Save the keyframe image to sample_output directory + output_dir = Path(__file__).parent / "sample_output" + output_dir.mkdir(exist_ok=True) + output_filename = f"keyframe_{first_frame_time_ms}.jpg" + output_path = output_dir / output_filename + + with open(output_path, "wb") as f: + f.write(image_bytes) + + print(f"Keyframe image saved to: {output_path}") + else: + print("\nNote: This sample demonstrates GetResultFile API usage.") + print(" For video analysis with keyframes, use prebuilt-videoSearch analyzer.") + print(" Keyframes are available in AudioVisualContent.key_frame_times_ms.") + print() + print(f"Example usage with operation ID '{operation_id}':") + print(" file_response = client.get_result_file(") + print(" operation_id=operation_id,") + print(' file_path="keyframes/1000")') + else: + print("\nNote: This sample is designed for video analysis.") + print(" The analyzed content is not a video.") +# [END ContentUnderstandingGetResultFile] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py new file mode 100644 index 000000000000..ac9c758f153f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py @@ -0,0 +1,213 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_grant_copy_auth.py + +DESCRIPTION: + This sample demonstrates how to grant copy authorization and copy an analyzer from a source + resource to a target resource (cross-resource copying). This is useful for copying analyzers + between different Azure resources or subscriptions. + + The grant_copy_authorization and copy_analyzer APIs allow you to copy an analyzer between + different Azure resources: + - Cross-resource copy: Copies an analyzer from one Azure resource to another + - Authorization required: You must grant copy authorization before copying + - Use cases: Cross-subscription copying, resource migration, multi-region deployment + + Note: For same-resource copying (copying within the same Azure resource), use the + sample_copy_analyzer.py sample instead. + +USAGE: + python sample_grant_copy_auth.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the source endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + 3) AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID - Full Azure Resource Manager resource ID of source. + 4) AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION - Azure region of source resource. + 5) AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT - Target endpoint for cross-subscription copy. + 6) AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID - Full Azure Resource Manager resource ID of target. + 7) AZURE_CONTENT_UNDERSTANDING_TARGET_REGION - Azure region of target resource. + 8) AZURE_CONTENT_UNDERSTANDING_TARGET_KEY - Target API key (optional if using DefaultAzureCredential). + + Example resource ID format: + /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name} + + Note: Both source and target AI Foundry Resources require 'Cognitive Services User' role for cross-subscription copy. +""" + +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + # Check for required environment variables + required_vars = [ + "AZURE_CONTENT_UNDERSTANDING_ENDPOINT", + "AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID", + "AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION", + "AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", + "AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID", + "AZURE_CONTENT_UNDERSTANDING_TARGET_REGION", + ] + + missing_vars = [var for var in required_vars if not os.getenv(var)] + if missing_vars: + print("Missing required environment variables:") + for var in missing_vars: + print(f" - {var}") + print("\nPlease set these environment variables and try again.") + print("\nExample resource ID format:") + print(" /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name}") + return + + # Grant copy authorization and copy analyzer + grant_copy_auth_and_copy() + + +# [START ContentUnderstandingGrantCopyAuth] +def grant_copy_auth_and_copy() -> None: + """Grant copy authorization and copy an analyzer from source to target resource.""" + + # Get source configuration + source_endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + source_key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + source_credential = AzureKeyCredential(source_key) if source_key else DefaultAzureCredential() + + source_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID"] + source_region = os.environ["AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION"] + + # Get target configuration + target_endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT"] + target_key = os.getenv("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") + target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() + + target_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID"] + target_region = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_REGION"] + + # Create clients + source_client = ContentUnderstandingClient(endpoint=source_endpoint, credential=source_credential) + target_client = ContentUnderstandingClient(endpoint=target_endpoint, credential=target_credential) + + # Generate unique analyzer IDs + base_id = f"my_analyzer_{int(time.time())}" + source_analyzer_id = f"{base_id}_source" + target_analyzer_id = f"{base_id}_target" + + print("Cross-Resource Copy Workflow") + print("=" * 60) + print(f" Source Endpoint: {source_endpoint}") + print(f" Source Region: {source_region}") + print(f" Target Endpoint: {target_endpoint}") + print(f" Target Region: {target_region}") + print("=" * 60) + + try: + # Step 1: Create the source analyzer + print(f"\nStep 1: Creating source analyzer '{source_analyzer_id}'...") + + source_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for cross-resource copying", + config=ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + field_schema=ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + }, + ), + models={"completion": "gpt-4.1"}, + ) + + poller = source_client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=source_analyzer, + ) + poller.result() + print(f" Source analyzer created successfully!") + + # Step 2: Grant copy authorization from target + print(f"\nStep 2: Granting copy authorization from target resource...") + + copy_auth = target_client.grant_copy_authorization( + analyzer_id=target_analyzer_id, + source_resource_id=source_resource_id, + source_region=source_region, + ) + + print(f" Authorization granted!") + print(f" Target Analyzer ID: {copy_auth.analyzer_id}") + print(f" Expires: {copy_auth.expires_on}") + + # Step 3: Copy analyzer using authorization + print(f"\nStep 3: Copying analyzer from source to target...") + + copy_poller = source_client.begin_copy_analyzer( + target_analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id, + copy_authorization=copy_auth, + ) + copy_poller.result() + print(f" Analyzer copied successfully!") + + # Step 4: Verify the copy + print(f"\nStep 4: Verifying the copied analyzer...") + copied_analyzer = target_client.get_analyzer(analyzer_id=target_analyzer_id) + print(f" Target Analyzer ID: {copied_analyzer.analyzer_id}") + print(f" Description: {copied_analyzer.description}") + print(f" Status: {copied_analyzer.status}") + + finally: + # Clean up + print(f"\nCleaning up...") + try: + source_client.delete_analyzer(analyzer_id=source_analyzer_id) + print(f" Source analyzer '{source_analyzer_id}' deleted.") + except Exception: + pass + + try: + target_client.delete_analyzer(analyzer_id=target_analyzer_id) + print(f" Target analyzer '{target_analyzer_id}' deleted.") + except Exception: + pass +# [END ContentUnderstandingGrantCopyAuth] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py deleted file mode 100644 index 19ff5a7ec6a1..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_helper.py +++ /dev/null @@ -1,69 +0,0 @@ -# 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. -# -------------------------------------------------------------------------- -"""Helper utilities for Content Understanding samples.""" - -from __future__ import annotations -import json -import os -from datetime import datetime -from pathlib import Path -from typing import Any - - -def save_json_to_file(data: dict[str, Any], filename_prefix: str = "result") -> str: - """Save JSON data to a file with timestamp. - - :param data: Dictionary to save as JSON - :type data: dict[str, Any] - :param filename_prefix: Prefix for the output filename - :type filename_prefix: str - :return: Path to the saved file - :rtype: str - """ - # Create output directory if it doesn't exist - output_dir = Path(__file__).parent / "sample_output" - output_dir.mkdir(exist_ok=True) - - # Generate filename with timestamp - timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") - filename = f"{filename_prefix}_{timestamp}.json" - filepath = output_dir / filename - - # Save to file - with open(filepath, "w", encoding="utf-8") as f: - json.dump(data, f, indent=2, ensure_ascii=False) - - print(f"\n✓ Saved to: {filepath}") - return str(filepath) - - -def get_sample_file_path(filename: str) -> str: - """Get the absolute path to a sample file. - - :param filename: Name of the sample file - :type filename: str - :return: Absolute path to the file - :rtype: str - """ - samples_dir = Path(__file__).parent - filepath = samples_dir / "sample_files" / filename - - if not filepath.exists(): - raise FileNotFoundError(f"Sample file not found: {filepath}") - - return str(filepath) - - -def read_binary_file(filepath: str) -> bytes: - """Read a binary file and return its contents. - - :param filepath: Path to the file - :type filepath: str - :return: File contents as bytes - :rtype: bytes - """ - with open(filepath, "rb") as f: - return f.read() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py new file mode 100644 index 000000000000..7b9145167ccd --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py @@ -0,0 +1,92 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_list_analyzers.py + +DESCRIPTION: + This sample demonstrates how to list all available analyzers in your Microsoft Foundry + resource, including both prebuilt and custom analyzers. + + The list_analyzers method returns all analyzers in your resource, including: + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice + - Custom analyzers: Analyzers you've created + + This is useful for: + - Discovery: See what analyzers are available in your resource + - Management: Get an overview of all your custom analyzers + - Debugging: Verify that analyzers were created successfully + +USAGE: + python sample_list_analyzers.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # List all analyzers + list_all_analyzers(client) + + +# [START ContentUnderstandingListAnalyzers] +def list_all_analyzers(client: ContentUnderstandingClient) -> None: + """List all available analyzers.""" + + print("Listing all available analyzers...") + + # List all analyzers + analyzers = list(client.list_analyzers()) + + print(f"\nFound {len(analyzers)} analyzer(s)") + + # Display summary + prebuilt_count = sum(1 for a in analyzers if a.analyzer_id and a.analyzer_id.startswith("prebuilt-")) + custom_count = len(analyzers) - prebuilt_count + print(f" Prebuilt analyzers: {prebuilt_count}") + print(f" Custom analyzers: {custom_count}") + + # Display details for each analyzer + print("\n" + "=" * 60) + for analyzer in analyzers: + print(f"ID: {analyzer.analyzer_id}") + print(f" Description: {analyzer.description or '(none)'}") + print(f" Status: {analyzer.status}") + + if analyzer.analyzer_id and analyzer.analyzer_id.startswith("prebuilt-"): + print(" Type: Prebuilt analyzer") + else: + print(" Type: Custom analyzer") + + # Show tags if available + if analyzer.tags: + tags_str = ", ".join(f"{k}={v}" for k, v in analyzer.tags.items()) + print(f" Tags: {tags_str}") + + print() + print("=" * 60) +# [END ContentUnderstandingListAnalyzers] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py new file mode 100644 index 000000000000..2bba80a7438f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py @@ -0,0 +1,145 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_update_analyzer.py + +DESCRIPTION: + This sample demonstrates how to update an existing custom analyzer, including updating + its description and tags. + + The update_analyzer method allows you to modify certain properties of an existing analyzer: + - Description: Update the analyzer's description + - Tags: Add, update, or remove tags (set tag value to empty string to remove) + + Note: Not all analyzer properties can be updated. Field schemas, models, and configuration + typically cannot be changed after creation. To change these, you may need to delete and + recreate the analyzer. + +USAGE: + python sample_update_analyzer.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +load_dotenv() + + +def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + + # Create initial analyzer + analyzer_id = create_initial_analyzer(client) + + if analyzer_id: + # Update the analyzer + update_analyzer(client, analyzer_id) + + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") + + +def create_initial_analyzer(client: ContentUnderstandingClient) -> str: + """Create an initial analyzer to update.""" + + analyzer_id = f"my_analyzer_for_update_{int(time.time())}" + + print(f"Creating initial analyzer '{analyzer_id}'...") + + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Initial description", + config=ContentAnalyzerConfig(return_details=True), + field_schema=ContentFieldSchema( + name="demo_schema", + description="Schema for update demo", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + }, + ), + models={"completion": "gpt-4.1"}, + tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, + ) + + poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + ) + poller.result() + print(f"Analyzer '{analyzer_id}' created successfully!") + + return analyzer_id + + +# [START ContentUnderstandingUpdateAnalyzer] +def update_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> None: + """Update an analyzer's description and tags.""" + + # First, get the current analyzer to preserve base analyzer ID + current_analyzer = client.get_analyzer(analyzer_id=analyzer_id) + + # Display current analyzer information + print("\nCurrent analyzer information:") + print(f" Description: {current_analyzer.description}") + if current_analyzer.tags: + tags_str = ", ".join(f"{k}={v}" for k, v in current_analyzer.tags.items()) + print(f" Tags: {tags_str}") + + # Create an updated analyzer with new description and tags + updated_analyzer = ContentAnalyzer( + base_analyzer_id=current_analyzer.base_analyzer_id, + description="Updated description", + tags={ + "tag1": "tag1_updated_value", # Update existing tag + "tag2": "", # Remove tag2 (empty string removes the tag) + "tag3": "tag3_value", # Add new tag + }, + ) + + # Update the analyzer + print(f"\nUpdating analyzer '{analyzer_id}'...") + client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) + + # Verify the update + updated = client.get_analyzer(analyzer_id=analyzer_id) + print("\nUpdated analyzer information:") + print(f" Description: {updated.description}") + if updated.tags: + tags_str = ", ".join(f"{k}={v}" for k, v in updated.tags.items()) + print(f" Tags: {tags_str}") +# [END ContentUnderstandingUpdateAnalyzer] + + +if __name__ == "__main__": + main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py deleted file mode 100644 index 79af603087b3..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_analyzer.py +++ /dev/null @@ -1,161 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- - -import asyncio -import os - -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod, - ProcessingLocation, -) - -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -from dotenv import load_dotenv - -load_dotenv() - -""" -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python update_analyzer.py -""" - - -async def main(): - """ - Update analyzer using update API. - - High-level steps: - 1. Create an initial analyzer - 2. Get the analyzer to verify initial state - 3. Update the analyzer with new description and tags - 4. Get the analyzer again to verify changes persisted - 5. Clean up the created analyzer - """ - endpoint = os.getenv("AZURE_CONTENT_UNDERSTANDING_ENDPOINT") or "" - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - analyzer_id = f"sdk_sample_analyzer_for_update_{int(asyncio.get_event_loop().time())}" - - # Create initial analyzer using object model - print(f"Creating initial analyzer '{analyzer_id}'...") - - initial_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - config=ContentAnalyzerConfig( - enable_formula=True, - enable_layout=True, - enable_ocr=True, - estimate_field_source_and_confidence=True, - return_details=True, - ), - description=f"Initial description", - field_schema=ContentFieldSchema( - fields={ - "total_amount": ContentFieldDefinition( - description="Total amount of this document", - method=GenerationMethod.EXTRACT, - type=ContentFieldType.NUMBER, - ), - "company_name": ContentFieldDefinition( - description="Name of the company", - method=GenerationMethod.EXTRACT, - type=ContentFieldType.STRING, - ), - }, - description="Schema for update demo", - name="update_demo_schema", - ), - models={"completion": "gpt-4.1"}, # Required when using field_schema - processing_location=ProcessingLocation.GLOBAL, - tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, - ) - - # Start the analyzer creation operation - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=initial_analyzer, - ) - - # Wait for the analyzer to be created - print(f"Waiting for analyzer creation to complete...") - await poller.result() - print(f"Analyzer '{analyzer_id}' created successfully!") - - # Get the analyzer before update to verify initial state - print(f" Getting analyzer '{analyzer_id}' before update...") - analyzer_before_update = await client.get_analyzer(analyzer_id=analyzer_id) - - print(f"Initial analyzer state verified:") - print(f" Description: {analyzer_before_update.description}") - print(f" Tags: {analyzer_before_update.tags}") - - # Create updated analyzer with only allowed properties (description and tags) - print(f"Creating updated analyzer configuration...") - # Update the value for tag1, remove tag2 by setting it to an empty string, and add tag3 - updated_analyzer = ContentAnalyzer( - # Note: Service requires baseAnalyzerId and models even in PATCH update - # This is a service bug - TypeSpec says they should not be required in Update - base_analyzer_id=analyzer_before_update.base_analyzer_id, # <== SERVICE-FIX: Service will return error without this - models=analyzer_before_update.models, # <== SERVICE-FIX: Service will return error without this - description=f"Updated description", - tags={"tag1": "tag1_updated_value", "tag2": "", "tag3": "tag3_value"}, - ) - - # Update the analyzer - print(f"Updating analyzer '{analyzer_id}' with new description and tags...") - response = await client.update_analyzer( - analyzer_id=analyzer_id, - resource=updated_analyzer, - ) - - print(f"Analyzer updated successfully!") - - # Get the analyzer after update to verify the changes persisted - print(f" Getting analyzer '{analyzer_id}' after update...") - analyzer_after_update = await client.get_analyzer(analyzer_id=analyzer_id) - - print(f"Updated analyzer state verified:") - print(f" Description: {analyzer_after_update.description}") - print(f" Tags: {analyzer_after_update.tags}") - - # Clean up the created analyzer (demo cleanup) - print(f"Deleting analyzer '{analyzer_id}' (demo cleanup)...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully!") - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -# x-ms-original-file: 2025-11-01/ContentAnalyzers_Update.json -if __name__ == "__main__": - asyncio.run(main()) From 958e4d70ac14d845661bd07002b59006e940a6f5 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 26 Nov 2025 09:11:18 -0800 Subject: [PATCH 028/105] flat version --- .../samples/sample_analyze_binary.py | 73 +++--- .../samples/sample_analyze_configs.py | 210 +++++++----------- .../samples/sample_analyze_invoice.py | 30 +-- .../samples/sample_analyze_return_raw_json.py | 20 +- .../samples/sample_analyze_url.py | 11 +- .../samples/sample_configure_defaults.py | 26 +-- .../samples/sample_copy_analyzer.py | 65 ++---- .../samples/sample_create_analyzer.py | 22 +- .../samples/sample_create_classifier.py | 82 +++---- .../samples/sample_delete_analyzer.py | 31 +-- .../samples/sample_delete_result.py | 13 +- .../samples/sample_get_analyzer.py | 47 +--- .../samples/sample_get_result_file.py | 32 +-- .../samples/sample_grant_copy_auth.py | 11 +- .../samples/sample_list_analyzers.py | 11 +- .../samples/sample_update_analyzer.py | 30 +-- .../samples/update_defaults.py | 4 +- 17 files changed, 216 insertions(+), 502 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py index 7309bbccde76..41c5593dbc05 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py @@ -51,14 +51,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Analyze document from binary data - analyze_document_binary(client) - - -# [START ContentUnderstandingAnalyzeBinaryAsync] -def analyze_document_binary(client: ContentUnderstandingClient) -> None: - """Analyze a document from binary data using prebuilt-documentSearch analyzer.""" - + # [START analyze_document_from_binary] file_path = "sample_files/sample_invoice.pdf" with open(file_path, "rb") as f: @@ -70,19 +63,9 @@ def analyze_document_binary(client: ContentUnderstandingClient) -> None: binary_input=pdf_bytes, ) result: AnalyzeResult = poller.result() + # [END analyze_document_from_binary] - # Extract markdown content - extract_markdown_content(result) - - # Extract document properties - extract_document_properties(result) -# [END ContentUnderstandingAnalyzeBinaryAsync] - - -# [START ContentUnderstandingExtractMarkdown] -def extract_markdown_content(result: AnalyzeResult) -> None: - """Extract and display markdown content from the analysis result.""" - + # [START extract_markdown] print("\nMarkdown Content:") print("=" * 50) @@ -97,36 +80,30 @@ def extract_markdown_content(result: AnalyzeResult) -> None: print("No content found in the analysis result.") print("=" * 50) -# [END ContentUnderstandingExtractMarkdown] - + # [END extract_markdown] -def extract_document_properties(result: AnalyzeResult) -> None: - """Extract and display document properties from the analysis result.""" + # Extract document properties + if result.contents and len(result.contents) > 0: + content = result.contents[0] - if not result.contents or len(result.contents) == 0: - print("No content found in the analysis result.") - return - - content = result.contents[0] - - # Check if this is document content to access document-specific properties - if content.kind == MediaContentKind.DOCUMENT: - # Type assertion: we know this is DocumentContent for PDF files - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f" Start page: {document_content.start_page_number}") - print(f" End page: {document_content.end_page_number}") - - if document_content.start_page_number and document_content.end_page_number: - total_pages = document_content.end_page_number - document_content.start_page_number + 1 - print(f" Total pages: {total_pages}") - - # Check for pages - if document_content.pages: - print(f"\nPages ({len(document_content.pages)}):") - for page in document_content.pages: - unit = document_content.unit or "units" - print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + # Check if this is document content to access document-specific properties + if content.kind == MediaContentKind.DOCUMENT: + # Type assertion: we know this is DocumentContent for PDF files + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f" Start page: {document_content.start_page_number}") + print(f" End page: {document_content.end_page_number}") + + if document_content.start_page_number and document_content.end_page_number: + total_pages = document_content.end_page_number - document_content.start_page_number + 1 + print(f" Total pages: {total_pages}") + + # Check for pages + if document_content.pages: + print(f"\nPages ({len(document_content.pages)}):") + for page in document_content.pages: + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index 792ac2b19e6f..a0bf55af5f97 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -57,14 +57,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Analyze with configs - analyze_with_configs(client) - - -# [START ContentUnderstandingAnalyzeWithConfigs] -def analyze_with_configs(client: ContentUnderstandingClient) -> None: - """Analyze a document using prebuilt-documentSearch with formulas, layout, and OCR enabled.""" - + # [START analyze_with_configs] file_path = "sample_files/sample_invoice.pdf" with open(file_path, "rb") as f: @@ -79,126 +72,89 @@ def analyze_with_configs(client: ContentUnderstandingClient) -> None: binary_input=pdf_bytes, ) result: AnalyzeResult = poller.result() - - # Extract various features - extract_charts(result) - extract_hyperlinks(result) - extract_formulas(result) - extract_annotations(result) -# [END ContentUnderstandingAnalyzeWithConfigs] - - -# [START ContentUnderstandingExtractCharts] -def extract_charts(result: AnalyzeResult) -> None: - """Extract chart figures from the document.""" - - if not result.contents or len(result.contents) == 0: - print("\nNo content found in the analysis result.") - return - - content = result.contents[0] - - if content.kind != MediaContentKind.DOCUMENT: - print("\nContent is not a document.") - return - - document_content: DocumentContent = content # type: ignore - - if document_content.figures and len(document_content.figures) > 0: - # Filter for chart figures - chart_figures = [ - f for f in document_content.figures - if isinstance(f, DocumentChartFigure) or (hasattr(f, 'kind') and f.kind == DocumentFigureKind.CHART) - ] - - print(f"\nFound {len(chart_figures)} chart(s)") - for chart in chart_figures: - print(f" Chart ID: {chart.id}") - if hasattr(chart, 'description') and chart.description: - print(f" Description: {chart.description}") - if hasattr(chart, 'caption') and chart.caption and chart.caption.content: - print(f" Caption: {chart.caption.content}") - else: - print("\nNo figures found in the document.") -# [END ContentUnderstandingExtractCharts] - - -# [START ContentUnderstandingExtractHyperlinks] -def extract_hyperlinks(result: AnalyzeResult) -> None: - """Extract hyperlinks from the document.""" - - if not result.contents or len(result.contents) == 0: - return - - content = result.contents[0] - - if content.kind != MediaContentKind.DOCUMENT: - return - - document_content: DocumentContent = content # type: ignore - - if document_content.hyperlinks and len(document_content.hyperlinks) > 0: - print(f"\nFound {len(document_content.hyperlinks)} hyperlink(s)") - for hyperlink in document_content.hyperlinks: - print(f" URL: {hyperlink.url or '(not available)'}") - print(f" Content: {hyperlink.content or '(not available)'}") - else: - print("\nNo hyperlinks found in the document.") -# [END ContentUnderstandingExtractHyperlinks] - - -# [START ContentUnderstandingExtractFormulas] -def extract_formulas(result: AnalyzeResult) -> None: - """Extract mathematical formulas from document pages.""" - - if not result.contents or len(result.contents) == 0: - return - - content = result.contents[0] - - if content.kind != MediaContentKind.DOCUMENT: - return - - document_content: DocumentContent = content # type: ignore - - all_formulas = [] - if document_content.pages: - for page in document_content.pages: - if hasattr(page, 'formulas') and page.formulas: - all_formulas.extend(page.formulas) - - if len(all_formulas) > 0: - print(f"\nFound {len(all_formulas)} formula(s)") - for formula in all_formulas: - print(f" Formula: {formula.value or '(no value)'}") - if hasattr(formula, 'kind') and formula.kind: - print(f" Kind: {formula.kind}") + # [END analyze_with_configs] + + # [START extract_charts] + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + if document_content.figures and len(document_content.figures) > 0: + # Filter for chart figures + chart_figures = [ + f for f in document_content.figures + if isinstance(f, DocumentChartFigure) or (hasattr(f, 'kind') and f.kind == DocumentFigureKind.CHART) + ] + + print(f"\nFound {len(chart_figures)} chart(s)") + for chart in chart_figures: + print(f" Chart ID: {chart.id}") + if hasattr(chart, 'description') and chart.description: + print(f" Description: {chart.description}") + if hasattr(chart, 'caption') and chart.caption and chart.caption.content: + print(f" Caption: {chart.caption.content}") + else: + print("\nNo figures found in the document.") else: - print("\nNo formulas found in the document.") -# [END ContentUnderstandingExtractFormulas] - - -def extract_annotations(result: AnalyzeResult) -> None: - """Extract annotations from the document.""" - - if not result.contents or len(result.contents) == 0: - return - - content = result.contents[0] - - if content.kind != MediaContentKind.DOCUMENT: - return - - document_content: DocumentContent = content # type: ignore - - if hasattr(document_content, 'annotations') and document_content.annotations and len(document_content.annotations) > 0: - print(f"\nFound {len(document_content.annotations)} annotation(s)") - for annotation in document_content.annotations: - print(f" Kind: {annotation.kind or '(unknown)'}") - if hasattr(annotation, 'content') and annotation.content: - print(f" Content: {annotation.content}") - else: - print("\nNo annotations found in the document.") + print("\nNo content found in the analysis result.") + # [END extract_charts] + + # [START extract_hyperlinks] + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + if document_content.hyperlinks and len(document_content.hyperlinks) > 0: + print(f"\nFound {len(document_content.hyperlinks)} hyperlink(s)") + for hyperlink in document_content.hyperlinks: + print(f" URL: {hyperlink.url or '(not available)'}") + print(f" Content: {hyperlink.content or '(not available)'}") + else: + print("\nNo hyperlinks found in the document.") + # [END extract_hyperlinks] + + # [START extract_formulas] + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + all_formulas = [] + if document_content.pages: + for page in document_content.pages: + if hasattr(page, 'formulas') and page.formulas: + all_formulas.extend(page.formulas) + + if len(all_formulas) > 0: + print(f"\nFound {len(all_formulas)} formula(s)") + for formula in all_formulas: + print(f" Formula: {formula.value or '(no value)'}") + if hasattr(formula, 'kind') and formula.kind: + print(f" Kind: {formula.kind}") + else: + print("\nNo formulas found in the document.") + # [END extract_formulas] + + # Extract annotations + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + if hasattr(document_content, 'annotations') and document_content.annotations and len(document_content.annotations) > 0: + print(f"\nFound {len(document_content.annotations)} annotation(s)") + for annotation in document_content.annotations: + print(f" Kind: {annotation.kind or '(unknown)'}") + if hasattr(annotation, 'content') and annotation.content: + print(f" Content: {annotation.content}") + else: + print("\nNo annotations found in the document.") if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index e1432ea3c623..d4b947489160 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -54,14 +54,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Analyze invoice from URL - analyze_invoice(client) - - -# [START ContentUnderstandingAnalyzeInvoice] -def analyze_invoice(client: ContentUnderstandingClient) -> None: - """Analyze an invoice using prebuilt-invoice analyzer.""" - + # [START analyze_invoice] invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" print(f"Analyzing invoice with prebuilt-invoice analyzer...") @@ -72,16 +65,9 @@ def analyze_invoice(client: ContentUnderstandingClient) -> None: inputs=[AnalyzeInput(url=invoice_url)], ) result: AnalyzeResult = poller.result() + # [END analyze_invoice] - # Extract invoice fields - extract_invoice_fields(result) -# [END ContentUnderstandingAnalyzeInvoice] - - -# [START ContentUnderstandingExtractInvoiceFields] -def extract_invoice_fields(result: AnalyzeResult) -> None: - """Extract and display invoice fields from the analysis result.""" - + # [START extract_invoice_fields] if not result.contents or len(result.contents) == 0: print("No content found in the analysis result.") return @@ -129,10 +115,10 @@ def extract_invoice_fields(result: AnalyzeResult) -> None: total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore amount_field = total_amount_obj.get("Amount") currency_field = total_amount_obj.get("CurrencyCode") - + amount = amount_field.value if amount_field else None currency = currency_field.value if currency_field else None - + print(f"\nTotal Amount: {amount} {currency}") if total_amount_field.confidence: print(f" Confidence: {total_amount_field.confidence:.2f}") @@ -147,14 +133,14 @@ def extract_invoice_fields(result: AnalyzeResult) -> None: description_field = item.get("Description") quantity_field = item.get("Quantity") amount_field = item.get("Amount") - + description = description_field.value if description_field else "(no description)" quantity = quantity_field.value if quantity_field else "N/A" amount = amount_field.value if amount_field else "N/A" - + print(f" {i}. {description}") print(f" Quantity: {quantity}, Amount: {amount}") -# [END ContentUnderstandingExtractInvoiceFields] + # [END extract_invoice_fields] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py index 648f547b60b2..19f9411a9f7a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py @@ -58,14 +58,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Analyze and return raw JSON - analyze_return_raw_json(client) - - -# [START ContentUnderstandingAnalyzeReturnRawJson] -def analyze_return_raw_json(client: ContentUnderstandingClient) -> None: - """Use the protocol method to get raw JSON response.""" - + # [START analyze_return_raw_json] file_path = "sample_files/sample_invoice.pdf" with open(file_path, "rb") as f: @@ -83,14 +76,9 @@ def analyze_return_raw_json(client: ContentUnderstandingClient) -> None: # Convert to dictionary and then to JSON result_dict = result.as_dict() - parse_and_save_json(result_dict) -# [END ContentUnderstandingAnalyzeReturnRawJson] - - -# [START ContentUnderstandingParseRawJson] -def parse_and_save_json(result_dict: dict) -> None: - """Parse and format the raw JSON response.""" + # [END analyze_return_raw_json] + # [START parse_raw_json] # Pretty-print the JSON pretty_json = json.dumps(result_dict, indent=2, ensure_ascii=False, default=str) @@ -115,7 +103,7 @@ def parse_and_save_json(result_dict: dict) -> None: preview = pretty_json[:2000] + "..." if len(pretty_json) > 2000 else pretty_json print(preview) print("=" * 50) -# [END ContentUnderstandingParseRawJson] + # [END parse_raw_json] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py index 71775323fbe9..abfe36e0b031 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py @@ -48,14 +48,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Analyze document from URL - analyze_document_url(client) - - -# [START ContentUnderstandingAnalyzeUrlAsync] -def analyze_document_url(client: ContentUnderstandingClient) -> None: - """Analyze a document from a URL using prebuilt-documentSearch analyzer.""" - + # [START analyze_document_from_url] document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" print(f"Analyzing document from URL with prebuilt-documentSearch...") @@ -90,7 +83,7 @@ def analyze_document_url(client: ContentUnderstandingClient) -> None: print(f"\nDocument Information:") print(f" Start page: {document_content.start_page_number}") print(f" End page: {document_content.end_page_number}") -# [END ContentUnderstandingAnalyzeUrlAsync] + # [END analyze_document_from_url] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py index a84640564999..e6c3a396ba85 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py @@ -45,17 +45,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Update model deployments - update_model_deployments(client) - - # Get current defaults - get_model_deployments(client) - - -# [START ContentUnderstandingUpdateDefaults] -def update_model_deployments(client: ContentUnderstandingClient) -> None: - """Configure default model deployment mappings for the Content Understanding resource.""" - + # [START update_defaults] # Get deployment names from environment variables gpt_4_1_deployment = os.getenv("GPT_4_1_DEPLOYMENT") gpt_4_1_mini_deployment = os.getenv("GPT_4_1_MINI_DEPLOYMENT") @@ -90,24 +80,20 @@ def update_model_deployments(client: ContentUnderstandingClient) -> None: print("Model deployments configured successfully!") if updated_defaults.model_deployments: for model_name, deployment_name in updated_defaults.model_deployments.items(): - print(f" {model_name} → {deployment_name}") -# [END ContentUnderstandingUpdateDefaults] - - -# [START ContentUnderstandingGetDefaults] -def get_model_deployments(client: ContentUnderstandingClient) -> None: - """Retrieve and display default model deployment settings.""" + print(f" {model_name} -> {deployment_name}") + # [END update_defaults] + # [START get_defaults] print("\nRetrieving current model deployment settings...") defaults = client.get_defaults() print("\nCurrent model deployment mappings:") if defaults.model_deployments and len(defaults.model_deployments) > 0: for model_name, deployment_name in defaults.model_deployments.items(): - print(f" {model_name} → {deployment_name}") + print(f" {model_name} -> {deployment_name}") else: print(" No model deployments configured yet.") -# [END ContentUnderstandingGetDefaults] + # [END get_defaults] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py index a026cba3a750..4d2229a96ea2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py @@ -54,34 +54,12 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Copy analyzer from source to target - copy_analyzer_demo(client) - - -def copy_analyzer_demo(client: ContentUnderstandingClient) -> None: - """Demonstrate copying an analyzer from source to target.""" - base_id = f"my_analyzer_{int(time.time())}" source_analyzer_id = f"{base_id}_source" target_analyzer_id = f"{base_id}_target" # Step 1: Create the source analyzer - create_source_analyzer(client, source_analyzer_id) - - # Step 2: Copy the analyzer - copy_analyzer(client, source_analyzer_id, target_analyzer_id) - - # Step 3: Update and verify the target analyzer - update_and_verify_analyzer(client, target_analyzer_id) - - # Step 4: Clean up - cleanup_analyzers(client, source_analyzer_id, target_analyzer_id) - - -def create_source_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> None: - """Create the source analyzer.""" - - print(f"Creating source analyzer '{analyzer_id}'...") + print(f"Creating source analyzer '{source_analyzer_id}'...") analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", @@ -113,36 +91,28 @@ def create_source_analyzer(client: ContentUnderstandingClient, analyzer_id: str) ) poller = client.begin_create_analyzer( - analyzer_id=analyzer_id, + analyzer_id=source_analyzer_id, resource=analyzer, ) poller.result() - print(f"Source analyzer '{analyzer_id}' created successfully!") - - -# [START ContentUnderstandingCopyAnalyzer] -def copy_analyzer(client: ContentUnderstandingClient, source_analyzer_id: str, target_analyzer_id: str) -> None: - """Copy an analyzer from source to target.""" + print(f"Source analyzer '{source_analyzer_id}' created successfully!") + # [START copy_analyzer] print(f"\nCopying analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'...") poller = client.begin_copy_analyzer( - target_analyzer_id=target_analyzer_id, + analyzer_id=target_analyzer_id, source_analyzer_id=source_analyzer_id, ) poller.result() print(f"Analyzer copied successfully!") -# [END ContentUnderstandingCopyAnalyzer] - - -# [START ContentUnderstandingUpdateAndVerifyAnalyzer] -def update_and_verify_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> None: - """Update the target analyzer with a production tag and verify.""" + # [END copy_analyzer] + # [START update_and_verify_analyzer] # Get the target analyzer first to get its BaseAnalyzerId - print(f"\nGetting target analyzer '{analyzer_id}'...") - target_analyzer = client.get_analyzer(analyzer_id=analyzer_id) + print(f"\nGetting target analyzer '{target_analyzer_id}'...") + target_analyzer = client.get_analyzer(analyzer_id=target_analyzer_id) # Update the target analyzer with a production tag updated_analyzer = ContentAnalyzer( @@ -151,20 +121,16 @@ def update_and_verify_analyzer(client: ContentUnderstandingClient, analyzer_id: ) print(f"Updating target analyzer with production tag...") - client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) + client.update_analyzer(analyzer_id=target_analyzer_id, resource=updated_analyzer) # Verify the update - updated_target = client.get_analyzer(analyzer_id=analyzer_id) + updated_target = client.get_analyzer(analyzer_id=target_analyzer_id) print(f" Description: {updated_target.description}") if updated_target.tags: print(f" Tag 'modelType': {updated_target.tags.get('modelType', 'N/A')}") -# [END ContentUnderstandingUpdateAndVerifyAnalyzer] - - -# [START ContentUnderstandingDeleteCopiedAnalyzers] -def cleanup_analyzers(client: ContentUnderstandingClient, source_analyzer_id: str, target_analyzer_id: str) -> None: - """Clean up by deleting both source and target analyzers.""" + # [END update_and_verify_analyzer] + # [START delete_copied_analyzers] print(f"\nCleaning up analyzers...") try: @@ -178,6 +144,11 @@ def cleanup_analyzers(client: ContentUnderstandingClient, source_analyzer_id: st print(f" Target analyzer '{target_analyzer_id}' deleted successfully.") except Exception: pass # Ignore cleanup errors + # [END delete_copied_analyzers] + + +if __name__ == "__main__": + main() # [END ContentUnderstandingDeleteCopiedAnalyzers] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py index 51cf298f8309..dfe3c2935388 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py @@ -58,20 +58,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Create a custom analyzer - analyzer_id = create_custom_analyzer(client) - - # Clean up - delete the analyzer - if analyzer_id: - print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") - client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully.") - - -# [START ContentUnderstandingCreateAnalyzer] -def create_custom_analyzer(client: ContentUnderstandingClient) -> str: - """Create a custom analyzer with field schema.""" - + # [START create_analyzer] # Generate a unique analyzer ID analyzer_id = f"my_custom_analyzer_{int(time.time())}" @@ -144,9 +131,12 @@ def create_custom_analyzer(client: ContentUnderstandingClient) -> str: for field_name, field_def in result.field_schema.fields.items(): method = field_def.method.value if field_def.method else "auto" print(f" - {field_name}: {field_def.type.value if field_def.type else 'unknown'} ({method})") + # [END create_analyzer] - return analyzer_id -# [END ContentUnderstandingCreateAnalyzer] + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index b6fe1890188b..e7cee8f926fb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -54,23 +54,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Create a classifier - analyzer_id = create_classifier(client) - - # Analyze with the classifier (demonstrates both with and without segmentation) - if analyzer_id: - analyze_with_classifier(client, analyzer_id) - - # Clean up - delete the classifier - print(f"\nCleaning up: deleting classifier '{analyzer_id}'...") - client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Classifier '{analyzer_id}' deleted successfully.") - - -# [START ContentUnderstandingCreateClassifier] -def create_classifier(client: ContentUnderstandingClient) -> str: - """Create a classifier analyzer with content categories.""" - + # [START create_classifier] # Generate a unique analyzer ID analyzer_id = f"my_classifier_{int(time.time())}" @@ -118,15 +102,9 @@ def create_classifier(client: ContentUnderstandingClient) -> str: print(f"Classifier '{analyzer_id}' created successfully!") print(f" Status: {result.status}") + # [END create_classifier] - return analyzer_id -# [END ContentUnderstandingCreateClassifier] - - -# [START ContentUnderstandingAnalyzeCategory] -def analyze_with_classifier(client: ContentUnderstandingClient, analyzer_id: str) -> None: - """Analyze a document with the classifier.""" - + # [START analyze_with_classifier] file_path = "sample_files/sample_invoice.pdf" with open(file_path, "rb") as f: @@ -138,39 +116,33 @@ def analyze_with_classifier(client: ContentUnderstandingClient, analyzer_id: str analyzer_id=analyzer_id, binary_input=file_bytes, ) - result: AnalyzeResult = poller.result() + analyze_result: AnalyzeResult = poller.result() # Display classification results - display_classification_results(result) -# [END ContentUnderstandingAnalyzeCategory] - - -# [START ContentUnderstandingAnalyzeCategoryWithSegments] -def display_classification_results(result: AnalyzeResult) -> None: - """Display classification results including segments if available.""" - - if not result.contents or len(result.contents) == 0: + if analyze_result.contents and len(analyze_result.contents) > 0: + content = analyze_result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + print(f"Pages: {document_content.start_page_number}-{document_content.end_page_number}") + + # Display segments (classification results) + if document_content.segments and len(document_content.segments) > 0: + print(f"\nFound {len(document_content.segments)} segment(s):") + for segment in document_content.segments: + print(f" Category: {segment.category or '(unknown)'}") + print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + print() + else: + print("No segments found (document classified as a single unit).") + else: print("No content found in the analysis result.") - return - - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - print(f"Pages: {document_content.start_page_number}-{document_content.end_page_number}") - - # Display segments (classification results) - if document_content.segments and len(document_content.segments) > 0: - print(f"\nFound {len(document_content.segments)} segment(s):") - for segment in document_content.segments: - print(f" Category: {segment.category or '(unknown)'}") - print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") - if segment.confidence: - print(f" Confidence: {segment.confidence:.2f}") - print() - else: - print("No segments found (document classified as a single unit).") -# [END ContentUnderstandingAnalyzeCategoryWithSegments] + # [END analyze_with_classifier] + + # Clean up - delete the classifier + print(f"\nCleaning up: deleting classifier '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Classifier '{analyzer_id}' deleted successfully.") if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py index 266fe8a4295f..a6435bc90a24 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py @@ -48,14 +48,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Create and delete an analyzer - create_and_delete_analyzer(client) - - -# [START ContentUnderstandingCreateSimpleAnalyzer] -def create_simple_analyzer(client: ContentUnderstandingClient) -> str: - """Create a simple analyzer for deletion demo.""" - + # [START create_simple_analyzer] # Generate a unique analyzer ID analyzer_id = f"my_analyzer_{int(time.time())}" @@ -75,29 +68,13 @@ def create_simple_analyzer(client: ContentUnderstandingClient) -> str: ) poller.result() print(f"Analyzer '{analyzer_id}' created successfully.") + # [END create_simple_analyzer] - return analyzer_id -# [END ContentUnderstandingCreateSimpleAnalyzer] - - -# [START ContentUnderstandingDeleteAnalyzer] -def delete_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> None: - """Delete a custom analyzer.""" - + # [START delete_analyzer] print(f"Deleting analyzer '{analyzer_id}'...") client.delete_analyzer(analyzer_id=analyzer_id) print(f"Analyzer '{analyzer_id}' deleted successfully.") -# [END ContentUnderstandingDeleteAnalyzer] - - -def create_and_delete_analyzer(client: ContentUnderstandingClient) -> None: - """Create a simple analyzer and then delete it.""" - - # First create an analyzer to delete - analyzer_id = create_simple_analyzer(client) - - # Now delete the analyzer - delete_analyzer(client, analyzer_id) + # [END delete_analyzer] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index 309974059a6e..c7da7976dd1d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -55,14 +55,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Analyze and delete result - analyze_and_delete_result(client) - - -# [START ContentUnderstandingAnalyzeAndDeleteResult] -def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: - """Analyze a document and then delete the result.""" - + # [START analyze_and_delete_result] document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" print("Document Analysis Workflow") @@ -112,13 +105,13 @@ def analyze_and_delete_result(client: ContentUnderstandingClient) -> None: print("\nStep 3: Verifying deletion...") try: # Try to get the result - this should fail after deletion - client.get_result(operation_id=operation_id) + client._get_result(operation_id=operation_id) # type: ignore[attr-defined] print(" Warning: Result still accessible (may take time to propagate)") except ResourceNotFoundError: print(" Verified: Result is no longer accessible (404 Not Found)") except Exception as e: print(f" Result access check: {type(e).__name__}: {e}") -# [END ContentUnderstandingAnalyzeAndDeleteResult] + # [END analyze_and_delete_result] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py index 007cf54e6a8e..fd07aab844a7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py @@ -55,17 +55,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Get prebuilt analyzer information - get_prebuilt_analyzer(client) - - # Get custom analyzer information - get_custom_analyzer(client) - - -# [START ContentUnderstandingGetPrebuiltAnalyzer] -def get_prebuilt_analyzer(client: ContentUnderstandingClient) -> None: - """Retrieve information about a prebuilt analyzer.""" - + # [START get_prebuilt_analyzer] print("Retrieving prebuilt-documentSearch analyzer...") analyzer = client.get_analyzer(analyzer_id="prebuilt-documentSearch") @@ -76,30 +66,9 @@ def get_prebuilt_analyzer(client: ContentUnderstandingClient) -> None: analyzer_json = json.dumps(analyzer.as_dict(), indent=2, default=str) print(analyzer_json) print("=" * 80) -# [END ContentUnderstandingGetPrebuiltAnalyzer] - - -# [START ContentUnderstandingGetPrebuiltInvoice] -def get_prebuilt_invoice_analyzer(client: ContentUnderstandingClient) -> None: - """Retrieve information about the prebuilt-invoice analyzer.""" - - print("Retrieving prebuilt-invoice analyzer...") - analyzer = client.get_analyzer(analyzer_id="prebuilt-invoice") - - # Display full analyzer JSON - print("\n" + "=" * 80) - print("Prebuilt-invoice Analyzer:") - print("=" * 80) - analyzer_json = json.dumps(analyzer.as_dict(), indent=2, default=str) - print(analyzer_json) - print("=" * 80) -# [END ContentUnderstandingGetPrebuiltInvoice] - - -# [START ContentUnderstandingGetCustomAnalyzer] -def get_custom_analyzer(client: ContentUnderstandingClient) -> None: - """Create a custom analyzer, retrieve its information, and display the full JSON.""" + # [END get_prebuilt_analyzer] + # [START get_custom_analyzer] # First, create a custom analyzer analyzer_id = f"my_custom_analyzer_{int(time.time())}" @@ -122,7 +91,7 @@ def get_custom_analyzer(client: ContentUnderstandingClient) -> None: }, ) - analyzer = ContentAnalyzer( + custom_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Custom analyzer for extracting company information", config=ContentAnalyzerConfig(return_details=True), @@ -132,7 +101,7 @@ def get_custom_analyzer(client: ContentUnderstandingClient) -> None: poller = client.begin_create_analyzer( analyzer_id=analyzer_id, - resource=analyzer, + resource=custom_analyzer, ) poller.result() print(f"Custom analyzer '{analyzer_id}' created successfully!") @@ -145,15 +114,15 @@ def get_custom_analyzer(client: ContentUnderstandingClient) -> None: print("\n" + "=" * 80) print(f"Custom Analyzer '{analyzer_id}':") print("=" * 80) - analyzer_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) - print(analyzer_json) + retrieved_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) + print(retrieved_json) print("=" * 80) # Clean up - delete the analyzer print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") client.delete_analyzer(analyzer_id=analyzer_id) print(f"Analyzer '{analyzer_id}' deleted successfully.") -# [END ContentUnderstandingGetCustomAnalyzer] + # [END get_custom_analyzer] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py index 56c609908bbd..2482a314d07f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py @@ -54,16 +54,9 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # Analyze video and get result files - analyze_video_and_get_result_files(client) - - -# [START ContentUnderstandingAnalyzeVideoForResultFiles] -def analyze_video_and_get_result_files(client: ContentUnderstandingClient) -> None: - """Analyze a video and retrieve result files (keyframe images).""" - + # [START analyze_video_for_result_files] # Use a sample video URL - video_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/sample_video.mp4" + video_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/videos/sdk_samples/FlightSimulator.mp4" print(f"Analyzing video with prebuilt-videoSearch...") print(f" URL: {video_url}") @@ -81,16 +74,9 @@ def analyze_video_and_get_result_files(client: ContentUnderstandingClient) -> No # Wait for completion print(" Waiting for analysis to complete...") result: AnalyzeResult = poller.result() + # [END analyze_video_for_result_files] - # Get result files - get_result_files(client, operation_id, result) -# [END ContentUnderstandingAnalyzeVideoForResultFiles] - - -# [START ContentUnderstandingGetResultFile] -def get_result_files(client: ContentUnderstandingClient, operation_id: str, result: AnalyzeResult) -> None: - """Retrieve result files (keyframe images) using the operation ID and file path.""" - + # [START get_result_file] if not result.contents or len(result.contents) == 0: print("No content found in the analysis result.") return @@ -98,7 +84,7 @@ def get_result_files(client: ContentUnderstandingClient, operation_id: str, resu content = result.contents[0] # For video analysis, keyframes would be found in AudioVisualContent.KeyFrameTimesMs - if content.kind in [MediaContentKind.VIDEO, MediaContentKind.AUDIO]: + if content.kind == MediaContentKind.AUDIO_VISUAL: video_content: AudioVisualContent = content # type: ignore if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: @@ -116,10 +102,10 @@ def get_result_files(client: ContentUnderstandingClient, operation_id: str, resu # Get the result file (keyframe image) file_response = client.get_result_file( operation_id=operation_id, - file_path=frame_path, + path=frame_path, ) - image_bytes = file_response + image_bytes = b"".join(file_response) print(f"Retrieved keyframe image ({len(image_bytes):,} bytes)") # Save the keyframe image to sample_output directory @@ -140,11 +126,11 @@ def get_result_files(client: ContentUnderstandingClient, operation_id: str, resu print(f"Example usage with operation ID '{operation_id}':") print(" file_response = client.get_result_file(") print(" operation_id=operation_id,") - print(' file_path="keyframes/1000")') + print(' path="keyframes/1000")') else: print("\nNote: This sample is designed for video analysis.") print(" The analyzed content is not a video.") -# [END ContentUnderstandingGetResultFile] + # [END get_result_file] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py index ac9c758f153f..3c6d32006fdc 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py @@ -80,14 +80,7 @@ def main() -> None: print(" /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name}") return - # Grant copy authorization and copy analyzer - grant_copy_auth_and_copy() - - -# [START ContentUnderstandingGrantCopyAuth] -def grant_copy_auth_and_copy() -> None: - """Grant copy authorization and copy an analyzer from source to target resource.""" - + # [START grant_copy_auth] # Get source configuration source_endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] source_key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") @@ -206,7 +199,7 @@ def grant_copy_auth_and_copy() -> None: print(f" Target analyzer '{target_analyzer_id}' deleted.") except Exception: pass -# [END ContentUnderstandingGrantCopyAuth] + # [END grant_copy_auth] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py index 7b9145167ccd..92a044a761ce 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py @@ -45,14 +45,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) - # List all analyzers - list_all_analyzers(client) - - -# [START ContentUnderstandingListAnalyzers] -def list_all_analyzers(client: ContentUnderstandingClient) -> None: - """List all available analyzers.""" - + # [START list_analyzers] print("Listing all available analyzers...") # List all analyzers @@ -85,7 +78,7 @@ def list_all_analyzers(client: ContentUnderstandingClient) -> None: print() print("=" * 60) -# [END ContentUnderstandingListAnalyzers] + # [END list_analyzers] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py index 2bba80a7438f..10ccad6a18ba 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py @@ -54,21 +54,6 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # Create initial analyzer - analyzer_id = create_initial_analyzer(client) - - if analyzer_id: - # Update the analyzer - update_analyzer(client, analyzer_id) - - # Clean up - delete the analyzer - print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") - client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully.") - - -def create_initial_analyzer(client: ContentUnderstandingClient) -> str: - """Create an initial analyzer to update.""" - analyzer_id = f"my_analyzer_for_update_{int(time.time())}" print(f"Creating initial analyzer '{analyzer_id}'...") @@ -99,13 +84,7 @@ def create_initial_analyzer(client: ContentUnderstandingClient) -> str: poller.result() print(f"Analyzer '{analyzer_id}' created successfully!") - return analyzer_id - - -# [START ContentUnderstandingUpdateAnalyzer] -def update_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> None: - """Update an analyzer's description and tags.""" - + # [START update_analyzer] # First, get the current analyzer to preserve base analyzer ID current_analyzer = client.get_analyzer(analyzer_id=analyzer_id) @@ -138,7 +117,12 @@ def update_analyzer(client: ContentUnderstandingClient, analyzer_id: str) -> Non if updated.tags: tags_str = ", ".join(f"{k}={v}" for k, v in updated.tags.items()) print(f" Tags: {tags_str}") -# [END ContentUnderstandingUpdateAnalyzer] + # [END update_analyzer] + + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py index 5772b80204b2..859fa20e737b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py @@ -119,7 +119,7 @@ async def update_model_deployments(client: ContentUnderstandingClient) -> None: # Display the configured mappings if hasattr(result, "model_deployments") and result.model_deployments: for model, deployment in result.model_deployments.items(): - print(f" {model:<30} → {deployment}") + print(f" {model:<30} -> {deployment}") else: print(" No model deployments returned in response") @@ -128,7 +128,7 @@ async def update_model_deployments(client: ContentUnderstandingClient) -> None: print(" You can now use prebuilt analyzers like 'prebuilt-invoice' and 'prebuilt-receipt'.") except Exception as e: - print(f"\n❌ Failed to configure defaults: {e}") + print(f"\n[FAILED] Failed to configure defaults: {e}") print("\nThis error may occur if:") print(" - One or more deployment names don't exist in your Azure AI Foundry project") print(" - The deployments exist but use different names than specified") From b51be619bc3c39515803068b265792e87e49aefc Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 26 Nov 2025 10:28:11 -0800 Subject: [PATCH 029/105] fix samples --- .../samples/sample_analyze_configs.py | 2 +- .../samples/sample_create_classifier.py | 3 +- .../samples/sample_delete_result.py | 2 +- .../samples/update_defaults.py | 144 ------------------ 4 files changed, 4 insertions(+), 147 deletions(-) delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index a0bf55af5f97..cd9486303ac3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -58,7 +58,7 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_with_configs] - file_path = "sample_files/sample_invoice.pdf" + file_path = "sample_files/sample_document_features.pdf" with open(file_path, "rb") as f: pdf_bytes = f.read() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index e7cee8f926fb..cfac509f2491 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -105,7 +105,7 @@ def main() -> None: # [END create_classifier] # [START analyze_with_classifier] - file_path = "sample_files/sample_invoice.pdf" + file_path = "sample_files/mixed_financial_docs.pdf" with open(file_path, "rb") as f: file_bytes = f.read() @@ -114,6 +114,7 @@ def main() -> None: poller = client.begin_analyze_binary( analyzer_id=analyzer_id, + content_type="application/pdf", binary_input=file_bytes, ) analyze_result: AnalyzeResult = poller.result() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index c7da7976dd1d..4207e385da4c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -106,7 +106,7 @@ def main() -> None: try: # Try to get the result - this should fail after deletion client._get_result(operation_id=operation_id) # type: ignore[attr-defined] - print(" Warning: Result still accessible (may take time to propagate)") + print(" Warning: Result still accessible") except ResourceNotFoundError: print(" Verified: Result is no longer accessible (404 Not Found)") except Exception as e: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py deleted file mode 100644 index 859fa20e737b..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/update_defaults.py +++ /dev/null @@ -1,144 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression - -# 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. -# -------------------------------------------------------------------------- -""" -Async sample: configure default model deployments for Content Understanding resource. - -Prerequisites: - pip install azure-ai-contentunderstanding python-dotenv - az login # Used for DefaultAzureCredential(). Alternatively, set the AZURE_CONTENT_UNDERSTANDING_KEY environment variable - -Environment variables: - AZURE_CONTENT_UNDERSTANDING_ENDPOINT (required) - AZURE_CONTENT_UNDERSTANDING_KEY (optional - DefaultAzureCredential() will be used if not set) - GPT_4_1_DEPLOYMENT (required) - Your GPT-4.1 deployment name in Azure AI Foundry - GPT_4_1_MINI_DEPLOYMENT (required) - Your GPT-4.1-mini deployment name in Azure AI Foundry - TEXT_EMBEDDING_3_LARGE_DEPLOYMENT (required) - Your text-embedding-3-large deployment name in Azure AI Foundry - These variables can be set in a .env file in the samples directory for repeated use. Please see env.sample for an example. - -Run: - python update_defaults.py -""" - -from __future__ import annotations -import asyncio -import os - -from dotenv import load_dotenv -from azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from azure.core.credentials import AzureKeyCredential -from azure.identity.aio import DefaultAzureCredential - -load_dotenv() - - -# --------------------------------------------------------------------------- -# Sample: Update default model deployments for Content Understanding resource -# --------------------------------------------------------------------------- -# This sample demonstrates: -# 1. Authenticate with Azure AI Content Understanding -# 2. Configure default model deployment mappings for the resource -# 3. Verify the configuration was applied successfully -# 4. Display the updated model deployment mappings -# -# Note: This configuration step is required ONCE per Azure Content Understanding resource -# before using prebuilt analyzers. It maps model names to your specific deployments. - - -async def main() -> None: - endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] - print(f"Using endpoint: {endpoint}") - # Return AzureKeyCredential if AZURE_CONTENT_UNDERSTANDING_KEY is set, otherwise DefaultAzureCredential - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - credential = AzureKeyCredential(key) if key else DefaultAzureCredential() - - async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: - await update_model_deployments(client) - - # Manually close DefaultAzureCredential if it was used - if isinstance(credential, DefaultAzureCredential): - await credential.close() - - -async def update_model_deployments(client: ContentUnderstandingClient) -> None: - """Configure default model deployment mappings for the Content Understanding resource.""" - - # Get deployment names from environment variables - gpt_4_1_deployment = os.getenv("GPT_4_1_DEPLOYMENT") - gpt_4_1_mini_deployment = os.getenv("GPT_4_1_MINI_DEPLOYMENT") - text_embedding_3_large_deployment = os.getenv("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") - - # Check if required deployments are configured - missing_deployments = [] - if not gpt_4_1_deployment: - missing_deployments.append("GPT_4_1_DEPLOYMENT") - if not gpt_4_1_mini_deployment: - missing_deployments.append("GPT_4_1_MINI_DEPLOYMENT") - if not text_embedding_3_large_deployment: - missing_deployments.append("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") - - if missing_deployments: - print("\n⚠️ Error: Missing required model deployment configuration(s):") - for deployment in missing_deployments: - print(f" - {deployment}") - print("\nPrebuilt analyzers require these model deployments to function correctly.") - print("\nPlease complete the following steps:") - print("1. Deploy GPT-4.1, GPT-4.1-mini, and text-embedding-3-large models in Azure AI Foundry") - print("2. Add the following to your .env file in the samples directory:") - print(" GPT_4_1_DEPLOYMENT=") - print(" GPT_4_1_MINI_DEPLOYMENT=") - print(" TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=") - print("3. Run this sample again") - return - - print("\nConfiguring default model deployments...") - print(f" GPT-4.1 deployment: {gpt_4_1_deployment}") - print(f" GPT-4.1-mini deployment: {gpt_4_1_mini_deployment}") - print(f" text-embedding-3-large deployment: {text_embedding_3_large_deployment}") - - try: - # Update defaults to map model names to your deployments - # The keys are the standard model names used by Content Understanding - # The values are your deployment names in Azure AI Foundry - result = await client.update_defaults( - model_deployments={ - "gpt-4.1": gpt_4_1_deployment, - "gpt-4.1-mini": gpt_4_1_mini_deployment, - "text-embedding-3-large": text_embedding_3_large_deployment, - } - ) - - print("\nDefault model deployments configured successfully!") - print("\nModel Mappings:") - print("=" * 60) - - # Display the configured mappings - if hasattr(result, "model_deployments") and result.model_deployments: - for model, deployment in result.model_deployments.items(): - print(f" {model:<30} -> {deployment}") - else: - print(" No model deployments returned in response") - - print("=" * 60) - print("\nThese mappings are now configured for your Content Understanding resource.") - print(" You can now use prebuilt analyzers like 'prebuilt-invoice' and 'prebuilt-receipt'.") - - except Exception as e: - print(f"\n[FAILED] Failed to configure defaults: {e}") - print("\nThis error may occur if:") - print(" - One or more deployment names don't exist in your Azure AI Foundry project") - print(" - The deployments exist but use different names than specified") - print(" - You don't have permission to update defaults for this resource") - print("\nPlease verify:") - print(" 1. All three models are deployed in Azure AI Foundry") - print(" 2. The deployment names in your .env file match exactly") - print(" 3. You have the necessary permissions on the Content Understanding resource") - raise - - -if __name__ == "__main__": - asyncio.run(main()) From 123802ffe3f5fa0c1dcef21ad4ded78a6afa01a5 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 26 Nov 2025 12:36:17 -0800 Subject: [PATCH 030/105] fix samples --- .../samples/sample_analyze_configs.py | 11 ++++++++--- .../samples/sample_copy_analyzer.py | 14 ++++++++++---- 2 files changed, 18 insertions(+), 7 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index cd9486303ac3..52a42e977777 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -150,9 +150,14 @@ def main() -> None: if hasattr(document_content, 'annotations') and document_content.annotations and len(document_content.annotations) > 0: print(f"\nFound {len(document_content.annotations)} annotation(s)") for annotation in document_content.annotations: - print(f" Kind: {annotation.kind or '(unknown)'}") - if hasattr(annotation, 'content') and annotation.content: - print(f" Content: {annotation.content}") + print(f" Annotation ID: {annotation.id}") + print(f" Kind: {annotation.kind}") + if hasattr(annotation, 'author') and annotation.author: + print(f" Author: {annotation.author}") + if hasattr(annotation, 'comments') and annotation.comments and len(annotation.comments) > 0: + print(f" Comments: {len(annotation.comments)}") + for comment in annotation.comments: + print(f" - {comment.message}") else: print("\nNo annotations found in the document.") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py index 4d2229a96ea2..566dd2975a78 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py @@ -63,7 +63,7 @@ def main() -> None: analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", - description="Source analyzer for copy example", + description="Source analyzer for copying", config=ContentAnalyzerConfig( enable_formula=False, enable_layout=True, @@ -88,8 +88,8 @@ def main() -> None: }, ), models={"completion": "gpt-4.1"}, + tags={"modelType": "in_development"}, ) - poller = client.begin_create_analyzer( analyzer_id=source_analyzer_id, resource=analyzer, @@ -97,6 +97,12 @@ def main() -> None: poller.result() print(f"Source analyzer '{source_analyzer_id}' created successfully!") + # Get the source analyzer to see its description and tags before copying + source_analyzer_info = client.get_analyzer(analyzer_id=source_analyzer_id) + print(f"Source analyzer description: {source_analyzer_info.description}") + if source_analyzer_info.tags: + print(f"Source analyzer tags: {', '.join(f'{k}={v}' for k, v in source_analyzer_info.tags.items())}") + # [START copy_analyzer] print(f"\nCopying analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'...") @@ -125,9 +131,9 @@ def main() -> None: # Verify the update updated_target = client.get_analyzer(analyzer_id=target_analyzer_id) - print(f" Description: {updated_target.description}") + print(f"Updated target analyzer description: {updated_target.description}") if updated_target.tags: - print(f" Tag 'modelType': {updated_target.tags.get('modelType', 'N/A')}") + print(f"Updated target analyzer tag: {updated_target.tags.get('modelType', 'N/A')}") # [END update_and_verify_analyzer] # [START delete_copied_analyzers] From 706a644838100260527aac92c053e6d65050ec23 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 26 Nov 2025 12:37:03 -0800 Subject: [PATCH 031/105] add async samples --- .../sample_analyze_binary_async.py | 113 +++++++++ .../sample_analyze_configs_async.py | 169 ++++++++++++++ .../sample_analyze_invoice_async.py | 150 ++++++++++++ .../sample_analyze_return_raw_json_async.py | 113 +++++++++ .../async_samples/sample_analyze_url_async.py | 93 ++++++++ .../sample_configure_defaults_async.py | 103 +++++++++ .../sample_copy_analyzer_async.py | 161 +++++++++++++ .../sample_create_analyzer_async.py | 146 ++++++++++++ .../sample_create_classifier_async.py | 153 +++++++++++++ .../sample_delete_analyzer_async.py | 84 +++++++ .../sample_delete_result_async.py | 121 ++++++++++ .../sample_get_analyzer_async.py | 132 +++++++++++ .../sample_get_result_file_async.py | 140 ++++++++++++ .../sample_grant_copy_auth_async.py | 214 ++++++++++++++++++ .../sample_list_analyzers_async.py | 88 +++++++ .../sample_update_analyzer_async.py | 132 +++++++++++ 16 files changed, 2112 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_copy_analyzer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_analyzer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py new file mode 100644 index 000000000000..7be2a85ba202 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py @@ -0,0 +1,113 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_binary_async.py + +DESCRIPTION: + This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + analyzer. The prebuilt-documentSearch analyzer transforms unstructured documents into structured, + machine-readable data optimized for RAG scenarios. + + Content Understanding supports multiple content types: + - Documents: Extract text, tables, figures, layout information, and structured markdown + - Images: Analyze standalone images to generate descriptions and extract visual features + - Audio: Transcribe audio content with speaker diarization and timing information + - Video: Analyze video content with visual frame extraction and audio transcription + +USAGE: + python sample_analyze_binary_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeResult, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START analyze_document_from_binary] + file_path = "../sample_files/sample_invoice.pdf" + + with open(file_path, "rb") as f: + pdf_bytes = f.read() + + print(f"Analyzing {file_path} with prebuilt-documentSearch...") + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=pdf_bytes, + ) + result: AnalyzeResult = await poller.result() + # [END analyze_document_from_binary] + + # [START extract_markdown] + print("\nMarkdown Content:") + print("=" * 50) + + # A PDF file has only one content element even if it contains multiple pages + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.markdown: + print(content.markdown) + else: + print("No markdown content available.") + else: + print("No content found in the analysis result.") + + print("=" * 50) + # [END extract_markdown] + + # Extract document properties + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + # Check if this is document content to access document-specific properties + if content.kind == MediaContentKind.DOCUMENT: + # Type assertion: we know this is DocumentContent for PDF files + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f" Start page: {document_content.start_page_number}") + print(f" End page: {document_content.end_page_number}") + + if document_content.start_page_number and document_content.end_page_number: + total_pages = document_content.end_page_number - document_content.start_page_number + 1 + print(f" Total pages: {total_pages}") + + # Check for pages + if document_content.pages: + print(f"\nPages ({len(document_content.pages)}):") + for page in document_content.pages: + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py new file mode 100644 index 000000000000..531872312883 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -0,0 +1,169 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_configs_async.py + +DESCRIPTION: + This sample demonstrates how to extract additional features from documents such as charts, + hyperlinks, formulas, and annotations using the prebuilt-documentSearch analyzer. + + The prebuilt-documentSearch analyzer has the following configurations enabled by default: + - EnableFormula: Extracts mathematical formulas from documents + - EnableLayout: Extracts layout information (tables, figures, etc.) + - EnableOcr: Performs OCR on documents + + These configs enable extraction of: + - Charts: Chart figures with Chart.js configuration + - Hyperlinks: URLs and links found in the document + - Formulas: Mathematical formulas in LaTeX format + - Annotations: PDF annotations, comments, and markup + +USAGE: + python sample_analyze_configs_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeResult, + DocumentContent, + MediaContentKind, + DocumentChartFigure, + DocumentFigureKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START analyze_with_configs] + file_path = "../sample_files/sample_document_features.pdf" + + with open(file_path, "rb") as f: + pdf_bytes = f.read() + + print(f"Analyzing {file_path} with prebuilt-documentSearch...") + print("Note: prebuilt-documentSearch has formulas, layout, and OCR enabled by default.") + + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=pdf_bytes, + ) + result: AnalyzeResult = await poller.result() + # [END analyze_with_configs] + + # [START extract_charts] + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + if document_content.figures and len(document_content.figures) > 0: + # Filter for chart figures + chart_figures = [ + f for f in document_content.figures + if isinstance(f, DocumentChartFigure) or (hasattr(f, 'kind') and f.kind == DocumentFigureKind.CHART) + ] + + print(f"\nFound {len(chart_figures)} chart(s)") + for chart in chart_figures: + print(f" Chart ID: {chart.id}") + if hasattr(chart, 'description') and chart.description: + print(f" Description: {chart.description}") + if hasattr(chart, 'caption') and chart.caption and chart.caption.content: + print(f" Caption: {chart.caption.content}") + else: + print("\nNo figures found in the document.") + else: + print("\nNo content found in the analysis result.") + # [END extract_charts] + + # [START extract_hyperlinks] + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + if document_content.hyperlinks and len(document_content.hyperlinks) > 0: + print(f"\nFound {len(document_content.hyperlinks)} hyperlink(s)") + for hyperlink in document_content.hyperlinks: + print(f" URL: {hyperlink.url or '(not available)'}") + print(f" Content: {hyperlink.content or '(not available)'}") + else: + print("\nNo hyperlinks found in the document.") + # [END extract_hyperlinks] + + # [START extract_formulas] + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + all_formulas = [] + if document_content.pages: + for page in document_content.pages: + if hasattr(page, 'formulas') and page.formulas: + all_formulas.extend(page.formulas) + + if len(all_formulas) > 0: + print(f"\nFound {len(all_formulas)} formula(s)") + for formula in all_formulas: + print(f" Formula: {formula.value or '(no value)'}") + if hasattr(formula, 'kind') and formula.kind: + print(f" Kind: {formula.kind}") + else: + print("\nNo formulas found in the document.") + # [END extract_formulas] + + # Extract annotations + if result.contents and len(result.contents) > 0: + content = result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + if hasattr(document_content, 'annotations') and document_content.annotations and len(document_content.annotations) > 0: + print(f"\nFound {len(document_content.annotations)} annotation(s)") + for annotation in document_content.annotations: + print(f" Annotation ID: {annotation.id}") + print(f" Kind: {annotation.kind}") + if hasattr(annotation, 'author') and annotation.author: + print(f" Author: {annotation.author}") + if hasattr(annotation, 'comments') and annotation.comments and len(annotation.comments) > 0: + print(f" Comments: {len(annotation.comments)}") + for comment in annotation.comments: + print(f" - {comment.message}") + else: + print("\nNo annotations found in the document.") + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py new file mode 100644 index 000000000000..5d80dde7c632 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -0,0 +1,150 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_invoice_async.py + +DESCRIPTION: + This sample demonstrates how to analyze an invoice from a URL using the prebuilt-invoice + analyzer and extract structured fields from the result. + + Content Understanding provides 70+ production-ready prebuilt analyzers that are ready to use + without any training or configuration. The prebuilt-invoice analyzer automatically extracts: + - Customer/Vendor information: Name, address, contact details + - Invoice metadata: Invoice number, date, due date, purchase order number + - Line items: Description, quantity, unit price, total for each item + - Financial totals: Subtotal, tax amount, shipping charges, total amount + - Payment information: Payment terms, payment method, remittance address + +USAGE: + python sample_analyze_invoice_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + DocumentContent, + ContentField, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START analyze_invoice] + invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + print(f"Analyzing invoice with prebuilt-invoice analyzer...") + print(f" URL: {invoice_url}") + + poller = await client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(url=invoice_url)], + ) + result: AnalyzeResult = await poller.result() + # [END analyze_invoice] + + # [START extract_invoice_fields] + if not result.contents or len(result.contents) == 0: + print("No content found in the analysis result.") + return + + content = result.contents[0] + + # Get the document content (invoices are documents) + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + + # Print document unit information + # The unit indicates the measurement system used for coordinates in the source field + print(f"\nDocument unit: {document_content.unit or 'unknown'}") + print(f"Pages: {document_content.start_page_number} to {document_content.end_page_number}") + print() + + if not document_content.fields: + print("No fields found in the analysis result.") + return + + # Extract simple string fields + customer_name_field = document_content.fields.get("CustomerName") + invoice_date_field = document_content.fields.get("InvoiceDate") + + customer_name = customer_name_field.value if customer_name_field else None + invoice_date = invoice_date_field.value if invoice_date_field else None + + print(f"Customer Name: {customer_name or '(None)'}") + if customer_name_field: + print(f" Confidence: {customer_name_field.confidence:.2f}" if customer_name_field.confidence else " Confidence: N/A") + # Source is an encoded identifier containing bounding box coordinates + # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) + print(f" Source: {customer_name_field.source or 'N/A'}") + if customer_name_field.spans and len(customer_name_field.spans) > 0: + span = customer_name_field.spans[0] + print(f" Position in markdown: offset={span.offset}, length={span.length}") + + print(f"Invoice Date: {invoice_date or '(None)'}") + if invoice_date_field: + print(f" Confidence: {invoice_date_field.confidence:.2f}" if invoice_date_field.confidence else " Confidence: N/A") + + # Extract object field (TotalAmount contains Amount and CurrencyCode) + total_amount_field = document_content.fields.get("TotalAmount") + if total_amount_field and total_amount_field.value: + total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore + amount_field = total_amount_obj.get("Amount") + currency_field = total_amount_obj.get("CurrencyCode") + + amount = amount_field.value if amount_field else None + currency = currency_field.value if currency_field else None + + print(f"\nTotal Amount: {amount} {currency}") + if total_amount_field.confidence: + print(f" Confidence: {total_amount_field.confidence:.2f}") + + # Extract array field (Items - line items) + items_field = document_content.fields.get("Items") + if items_field and items_field.value: + items_array: list = items_field.value # type: ignore + print(f"\nLine Items ({len(items_array)}):") + for i, item in enumerate(items_array, 1): + if isinstance(item, dict): + description_field = item.get("Description") + quantity_field = item.get("Quantity") + amount_field = item.get("Amount") + + description = description_field.value if description_field else "(no description)" + quantity = quantity_field.value if quantity_field else "N/A" + amount = amount_field.value if amount_field else "N/A" + + print(f" {i}. {description}") + print(f" Quantity: {quantity}, Amount: {amount}") + # [END extract_invoice_fields] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py new file mode 100644 index 000000000000..86061c9ba4c4 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py @@ -0,0 +1,113 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_return_raw_json_async.py + +DESCRIPTION: + This sample demonstrates how to access the raw JSON response from analysis operations + using protocol methods. This is useful for advanced scenarios where you need direct access + to the JSON structure. + + The Content Understanding SDK provides two approaches for accessing analysis results: + 1. Object model approach (recommended): Returns strongly-typed AnalyzeResult objects + 2. Protocol method approach: Returns raw BinaryData containing the JSON response + + For production use, prefer the object model approach as it provides: + - Type safety + - IntelliSense support + - Easier navigation of results + - Better error handling + + Use raw JSON only when you need: + - Custom JSON processing + - Direct access to the raw response structure + - Integration with custom JSON parsers + +USAGE: + python sample_analyze_return_raw_json_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import json +import os +from datetime import datetime +from pathlib import Path + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START analyze_return_raw_json] + file_path = "../sample_files/sample_invoice.pdf" + + with open(file_path, "rb") as f: + file_bytes = f.read() + + print(f"Analyzing {file_path} with prebuilt-documentSearch...") + + # Use the standard method which returns an AnalyzeResult + # Then serialize to JSON for raw access + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + ) + result = await poller.result() + + # Convert to dictionary and then to JSON + result_dict = result.as_dict() + # [END analyze_return_raw_json] + + # [START parse_raw_json] + # Pretty-print the JSON + pretty_json = json.dumps(result_dict, indent=2, ensure_ascii=False, default=str) + + # Create output directory if it doesn't exist + output_dir = Path(__file__).parent.parent / "sample_output" + output_dir.mkdir(exist_ok=True) + + # Save to file + timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") + output_filename = f"analyze_result_{timestamp}.json" + output_path = output_dir / output_filename + + with open(output_path, "w", encoding="utf-8") as f: + f.write(pretty_json) + + print(f"\nRaw JSON response saved to: {output_path}") + print(f"File size: {len(pretty_json):,} characters") + + # Show a preview of the JSON structure + print("\nJSON Structure Preview:") + print("=" * 50) + preview = pretty_json[:2000] + "..." if len(pretty_json) > 2000 else pretty_json + print(preview) + print("=" * 50) + # [END parse_raw_json] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py new file mode 100644 index 000000000000..97b375c04231 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py @@ -0,0 +1,93 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_analyze_url_async.py + +DESCRIPTION: + This sample demonstrates how to analyze a document from a URL using the prebuilt-documentSearch + analyzer. This shows how to analyze a document from a publicly accessible URL instead of a local file. + + For understanding basic analysis concepts, authentication, and result processing, + see sample_analyze_binary_async.py first. + +USAGE: + python sample_analyze_url_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START analyze_document_from_url] + document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + print(f"Analyzing document from URL with prebuilt-documentSearch...") + print(f" URL: {document_url}") + + poller = await client.begin_analyze( + analyzer_id="prebuilt-documentSearch", + inputs=[AnalyzeInput(url=document_url)], + ) + result: AnalyzeResult = await poller.result() + + # Extract markdown content + print("\nMarkdown Content:") + print("=" * 50) + + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.markdown: + print(content.markdown) + else: + print("No markdown content available.") + else: + print("No content found in the analysis result.") + + print("=" * 50) + + # Display document properties + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f" Start page: {document_content.start_page_number}") + print(f" End page: {document_content.end_page_number}") + # [END analyze_document_from_url] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py new file mode 100644 index 000000000000..c9fbd1cf6373 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py @@ -0,0 +1,103 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_configure_defaults_async.py + +DESCRIPTION: + This sample demonstrates how to configure and retrieve default model deployment settings + for your Microsoft Foundry resource. This is a required one-time setup before using + prebuilt analyzers. + + Content Understanding prebuilt analyzers require specific GPT model deployments to function: + - GPT-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt) + - GPT-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-audioSearch) + - text-embedding-3-large: Used for semantic search and embeddings + +USAGE: + python sample_configure_defaults_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + 3) GPT_4_1_DEPLOYMENT - your GPT-4.1 deployment name in Azure AI Foundry. + 4) GPT_4_1_MINI_DEPLOYMENT - your GPT-4.1-mini deployment name in Azure AI Foundry. + 5) TEXT_EMBEDDING_3_LARGE_DEPLOYMENT - your text-embedding-3-large deployment name in Azure AI Foundry. +""" + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START update_defaults] + # Get deployment names from environment variables + gpt_4_1_deployment = os.getenv("GPT_4_1_DEPLOYMENT") + gpt_4_1_mini_deployment = os.getenv("GPT_4_1_MINI_DEPLOYMENT") + text_embedding_3_large_deployment = os.getenv("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + # Check if required deployments are configured + missing_deployments = [] + if not gpt_4_1_deployment: + missing_deployments.append("GPT_4_1_DEPLOYMENT") + if not gpt_4_1_mini_deployment: + missing_deployments.append("GPT_4_1_MINI_DEPLOYMENT") + if not text_embedding_3_large_deployment: + missing_deployments.append("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + if missing_deployments: + print("⚠️ Missing required environment variables:") + for deployment in missing_deployments: + print(f" - {deployment}") + print("\nPlease set these environment variables and try again.") + return + + # Map your deployed models to the models required by prebuilt analyzers + model_deployments = { + "gpt-4.1": gpt_4_1_deployment, + "gpt-4.1-mini": gpt_4_1_mini_deployment, + "text-embedding-3-large": text_embedding_3_large_deployment, + } + + print("Configuring model deployments...") + updated_defaults = await client.update_defaults(model_deployments=model_deployments) + + print("Model deployments configured successfully!") + if updated_defaults.model_deployments: + for model_name, deployment_name in updated_defaults.model_deployments.items(): + print(f" {model_name} -> {deployment_name}") + # [END update_defaults] + + # [START get_defaults] + print("\nRetrieving current model deployment settings...") + defaults = await client.get_defaults() + + print("\nCurrent model deployment mappings:") + if defaults.model_deployments and len(defaults.model_deployments) > 0: + for model_name, deployment_name in defaults.model_deployments.items(): + print(f" {model_name} -> {deployment_name}") + else: + print(" No model deployments configured yet.") + # [END get_defaults] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_copy_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_copy_analyzer_async.py new file mode 100644 index 000000000000..c2e85a9f4610 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_copy_analyzer_async.py @@ -0,0 +1,161 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_copy_analyzer_async.py + +DESCRIPTION: + This sample demonstrates how to copy an analyzer from source to target within the same + resource using the copy_analyzer API. This is useful for creating copies of analyzers + for testing, staging, or production deployment. + + The copy_analyzer API allows you to copy an analyzer within the same Azure resource: + - Same-resource copy: Copies an analyzer from one ID to another within the same resource + - Exact copy: The target analyzer is an exact copy of the source analyzer + - Use cases: Testing, staging, production deployment, versioning + + Note: For cross-resource copying (copying between different Azure resources or subscriptions), + use the grant_copy_auth sample instead. + +USAGE: + python sample_copy_analyzer_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import asyncio +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + base_id = f"my_analyzer_{int(time.time())}" + source_analyzer_id = f"{base_id}_source" + target_analyzer_id = f"{base_id}_target" + + # Step 1: Create the source analyzer + print(f"Creating source analyzer '{source_analyzer_id}'...") + + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for copying", + config=ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + field_schema=ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + }, + ), + models={"completion": "gpt-4.1"}, + tags={"modelType": "in_development"}, + ) + + poller = await client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=analyzer, + ) + await poller.result() + print(f"Source analyzer '{source_analyzer_id}' created successfully!") + + # Get the source analyzer to see its description and tags before copying + source_analyzer_info = await client.get_analyzer(analyzer_id=source_analyzer_id) + print(f"Source analyzer description: {source_analyzer_info.description}") + if source_analyzer_info.tags: + print(f"Source analyzer tags: {', '.join(f'{k}={v}' for k, v in source_analyzer_info.tags.items())}") + + # [START copy_analyzer] + print(f"\nCopying analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'...") + + poller = await client.begin_copy_analyzer( + analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id, + ) + await poller.result() + + print(f"Analyzer copied successfully!") + # [END copy_analyzer] + + # [START update_and_verify_analyzer] + # Get the target analyzer first to get its BaseAnalyzerId + print(f"\nGetting target analyzer '{target_analyzer_id}'...") + target_analyzer = await client.get_analyzer(analyzer_id=target_analyzer_id) + + # Update the target analyzer with a production tag + updated_analyzer = ContentAnalyzer( + base_analyzer_id=target_analyzer.base_analyzer_id, + tags={"modelType": "model_in_production"}, + ) + + print(f"Updating target analyzer with production tag...") + await client.update_analyzer(analyzer_id=target_analyzer_id, resource=updated_analyzer) + + # Verify the update + updated_target = await client.get_analyzer(analyzer_id=target_analyzer_id) + print(f"Updated target analyzer description: {updated_target.description}") + if updated_target.tags: + print(f"Updated target analyzer tag: {updated_target.tags.get('modelType', 'N/A')}") + # [END update_and_verify_analyzer] + + # [START delete_copied_analyzers] + print(f"\nCleaning up analyzers...") + + try: + await client.delete_analyzer(analyzer_id=source_analyzer_id) + print(f" Source analyzer '{source_analyzer_id}' deleted successfully.") + except Exception: + pass # Ignore cleanup errors + + try: + await client.delete_analyzer(analyzer_id=target_analyzer_id) + print(f" Target analyzer '{target_analyzer_id}' deleted successfully.") + except Exception: + pass # Ignore cleanup errors + # [END delete_copied_analyzers] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py new file mode 100644 index 000000000000..ec6652153aea --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py @@ -0,0 +1,146 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_create_analyzer_async.py + +DESCRIPTION: + This sample demonstrates how to create a custom analyzer with a field schema to extract + structured data from documents. + + Custom analyzers allow you to: + - Define custom fields (string, number, date, object, array) + - Specify extraction methods: + - extract: Values are extracted as they appear in the content (literal text extraction) + - generate: Values are generated freely based on the content using AI models + - classify: Values are classified against a predefined set of categories + - Use prebuilt analyzers as a base (prebuilt-document, prebuilt-audio, prebuilt-video, prebuilt-image) + - Configure analysis options (OCR, layout, formulas) + - Enable source and confidence tracking for extracted field values + +USAGE: + python sample_create_analyzer_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using custom analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START create_analyzer] + # Generate a unique analyzer ID + analyzer_id = f"my_custom_analyzer_{int(time.time())}" + + print(f"Creating custom analyzer '{analyzer_id}'...") + + # Define field schema with custom fields + # This example demonstrates three extraction methods: + # - extract: Literal text extraction (requires estimateSourceAndConfidence) + # - generate: AI-generated values based on content interpretation + # - classify: Classification against predefined categories + field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + "document_summary": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.GENERATE, + description="A brief summary of the document content", + ), + "document_type": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.CLASSIFY, + description="Type of document", + enum=["invoice", "receipt", "contract", "report", "other"], + ), + }, + ) + + # Create analyzer configuration + config = ContentAnalyzerConfig( + enable_formula=True, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ) + + # Create the analyzer with field schema + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom analyzer for extracting company information", + config=config, + field_schema=field_schema, + models={"completion": "gpt-4.1"}, # Required when using field_schema + ) + + # Create the analyzer + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + ) + result = await poller.result() + + print(f"Analyzer '{analyzer_id}' created successfully!") + print(f" Status: {result.status}") + print(f" Description: {result.description}") + + if result.field_schema and result.field_schema.fields: + print(f" Fields ({len(result.field_schema.fields)}):") + for field_name, field_def in result.field_schema.fields.items(): + method = field_def.method.value if field_def.method else "auto" + print(f" - {field_name}: {field_def.type.value if field_def.type else 'unknown'} ({method})") + # [END create_analyzer] + + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py new file mode 100644 index 000000000000..c357762536c8 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -0,0 +1,153 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_create_classifier_async.py + +DESCRIPTION: + This sample demonstrates how to create a classifier analyzer to categorize documents and + use it to analyze documents with and without automatic segmentation. + + Classifiers are a type of custom analyzer that categorize documents into predefined categories. + They're useful for: + - Document routing: Automatically route documents to the right processing pipeline + - Content organization: Organize large document collections by type + - Multi-document processing: Process files containing multiple document types by segmenting them + +USAGE: + python sample_create_classifier_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using classifiers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentCategoryDefinition, + AnalyzeResult, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START create_classifier] + # Generate a unique analyzer ID + analyzer_id = f"my_classifier_{int(time.time())}" + + print(f"Creating classifier '{analyzer_id}'...") + + # Define content categories for classification + categories = { + "Loan_Application": ContentCategoryDefinition( + description="Documents submitted by individuals or businesses to request funding, " + "typically including personal or business details, financial history, " + "loan amount, purpose, and supporting documentation." + ), + "Invoice": ContentCategoryDefinition( + description="Billing documents issued by sellers or service providers to request " + "payment for goods or services, detailing items, prices, taxes, totals, " + "and payment terms." + ), + "Bank_Statement": ContentCategoryDefinition( + description="Official statements issued by banks that summarize account activity " + "over a period, including deposits, withdrawals, fees, and balances." + ), + } + + # Create analyzer configuration + config = ContentAnalyzerConfig( + return_details=True, + enable_segment=True, # Enable automatic segmentation by category + content_categories=categories, + ) + + # Create the classifier analyzer + classifier = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom classifier for financial document categorization", + config=config, + models={"completion": "gpt-4.1"}, + ) + + # Create the classifier + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=classifier, + ) + result = await poller.result() + + print(f"Classifier '{analyzer_id}' created successfully!") + print(f" Status: {result.status}") + # [END create_classifier] + + # [START analyze_with_classifier] + file_path = "../sample_files/mixed_financial_docs.pdf" + + with open(file_path, "rb") as f: + file_bytes = f.read() + + print(f"\nAnalyzing document with classifier '{analyzer_id}'...") + + poller = await client.begin_analyze_binary( + analyzer_id=analyzer_id, + content_type="application/pdf", + binary_input=file_bytes, + ) + analyze_result: AnalyzeResult = await poller.result() + + # Display classification results + if analyze_result.contents and len(analyze_result.contents) > 0: + content = analyze_result.contents[0] + + if content.kind == MediaContentKind.DOCUMENT: + document_content: DocumentContent = content # type: ignore + print(f"Pages: {document_content.start_page_number}-{document_content.end_page_number}") + + # Display segments (classification results) + if document_content.segments and len(document_content.segments) > 0: + print(f"\nFound {len(document_content.segments)} segment(s):") + for segment in document_content.segments: + print(f" Category: {segment.category or '(unknown)'}") + print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + print() + else: + print("No segments found (document classified as a single unit).") + else: + print("No content found in the analysis result.") + # [END analyze_with_classifier] + + # Clean up - delete the classifier + print(f"\nCleaning up: deleting classifier '{analyzer_id}'...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Classifier '{analyzer_id}' deleted successfully.") + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_analyzer_async.py new file mode 100644 index 000000000000..a5c4b0edd864 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_analyzer_async.py @@ -0,0 +1,84 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_delete_analyzer_async.py + +DESCRIPTION: + This sample demonstrates how to delete a custom analyzer. + + The delete_analyzer method permanently removes a custom analyzer from your resource. + This operation cannot be undone. + + Important notes: + - Only custom analyzers can be deleted. Prebuilt analyzers cannot be deleted. + - Deleting an analyzer does not delete analysis results that were created using that analyzer. + - Once deleted, the analyzer ID cannot be reused immediately. + +USAGE: + python sample_delete_analyzer_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import asyncio +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START create_simple_analyzer] + # Generate a unique analyzer ID + analyzer_id = f"my_analyzer_{int(time.time())}" + + print(f"Creating analyzer '{analyzer_id}'...") + + # Create a simple analyzer + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Simple analyzer for deletion example", + config=ContentAnalyzerConfig(return_details=True), + models={"completion": "gpt-4.1"}, + ) + + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + ) + await poller.result() + print(f"Analyzer '{analyzer_id}' created successfully.") + # [END create_simple_analyzer] + + # [START delete_analyzer] + print(f"Deleting analyzer '{analyzer_id}'...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") + # [END delete_analyzer] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py new file mode 100644 index 000000000000..48142caca794 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py @@ -0,0 +1,121 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_delete_result_async.py + +DESCRIPTION: + This sample demonstrates how to delete analysis results using the delete_result API. + This is useful for removing temporary or sensitive analysis results immediately, rather + than waiting for automatic deletion after 24 hours. + + Analysis results are stored temporarily and can be deleted using the delete_result API: + - Immediate deletion: Results are marked for deletion and permanently removed + - Automatic deletion: Results are automatically deleted after 24 hours if not manually deleted + - Operation ID required: You need the operation ID from the analysis operation to delete + + Important: Once deleted, results cannot be recovered. Make sure you have saved any data + you need before deleting. + +USAGE: + python sample_delete_result_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + DocumentContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.core.exceptions import ResourceNotFoundError +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START analyze_and_delete_result] + document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + + print("Document Analysis Workflow") + print("=" * 60) + print(f" Document URL: {document_url}") + print(f" Analyzer: prebuilt-invoice") + print("=" * 60) + + # Step 1: Start the analysis operation + print("\nStep 1: Starting document analysis...") + poller = await client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(url=document_url)], + ) + + # Get the operation ID from the poller + operation_id = poller.operation_id + + if not operation_id: + print("Error: Could not extract operation ID from response") + return + + print(f" Operation ID: {operation_id}") + + # Wait for completion + print(" Waiting for analysis to complete...") + result: AnalyzeResult = await poller.result() + print("Analysis completed successfully!") + + # Display some sample results + if result.contents and len(result.contents) > 0: + content = result.contents[0] + if content.kind == MediaContentKind.DOCUMENT: + doc_content: DocumentContent = content # type: ignore + if doc_content.fields: + print(f" Total fields extracted: {len(doc_content.fields)}") + customer_name_field = doc_content.fields.get("CustomerName") + if customer_name_field: + print(f" Customer Name: {customer_name_field.value or '(not found)'}") + + # Step 2: Delete the analysis result + print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") + await client.delete_result(operation_id=operation_id) + print("Analysis result deleted successfully!") + + # Verify deletion by trying to get the result (should fail) + print("\nStep 3: Verifying deletion...") + try: + # Try to get the result - this should fail after deletion + await client._get_result(operation_id=operation_id) # type: ignore[attr-defined] + print(" Warning: Result still accessible") + except ResourceNotFoundError: + print(" Verified: Result is no longer accessible (404 Not Found)") + except Exception as e: + print(f" Result access check: {type(e).__name__}: {e}") + # [END analyze_and_delete_result] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py new file mode 100644 index 000000000000..a5e9c763b645 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py @@ -0,0 +1,132 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_get_analyzer_async.py + +DESCRIPTION: + This sample demonstrates how to retrieve information about analyzers, including prebuilt + analyzers and custom analyzers. + + The get_analyzer method allows you to retrieve detailed information about any analyzer: + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice + - Custom analyzers: Analyzers you've created with custom field schemas or classifiers + + This is useful for: + - Verifying analyzer configuration + - Inspecting prebuilt analyzers to learn about their capabilities + - Debugging analyzer behavior + +USAGE: + python sample_get_analyzer_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import asyncio +import json +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START get_prebuilt_analyzer] + print("Retrieving prebuilt-documentSearch analyzer...") + analyzer = await client.get_analyzer(analyzer_id="prebuilt-documentSearch") + + # Display full analyzer JSON + print("\n" + "=" * 80) + print("Prebuilt-documentSearch Analyzer:") + print("=" * 80) + analyzer_json = json.dumps(analyzer.as_dict(), indent=2, default=str) + print(analyzer_json) + print("=" * 80) + # [END get_prebuilt_analyzer] + + # [START get_custom_analyzer] + # First, create a custom analyzer + analyzer_id = f"my_custom_analyzer_{int(time.time())}" + + print(f"\nCreating custom analyzer '{analyzer_id}'...") + + field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + }, + ) + + custom_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom analyzer for extracting company information", + config=ContentAnalyzerConfig(return_details=True), + field_schema=field_schema, + models={"completion": "gpt-4.1"}, + ) + + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=custom_analyzer, + ) + await poller.result() + print(f"Custom analyzer '{analyzer_id}' created successfully!") + + # Now retrieve the custom analyzer + print(f"\nRetrieving custom analyzer '{analyzer_id}'...") + retrieved_analyzer = await client.get_analyzer(analyzer_id=analyzer_id) + + # Display full analyzer JSON + print("\n" + "=" * 80) + print(f"Custom Analyzer '{analyzer_id}':") + print("=" * 80) + retrieved_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) + print(retrieved_json) + print("=" * 80) + + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") + # [END get_custom_analyzer] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py new file mode 100644 index 000000000000..bcb4310d4570 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py @@ -0,0 +1,140 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_get_result_file_async.py + +DESCRIPTION: + This sample demonstrates how to retrieve result files (such as keyframe images) from a + video analysis operation using the get_result_file API. + + When analyzing video content, the Content Understanding service can generate result files: + - Keyframe images: Extracted frames from the video at specific timestamps + - Other result files: Additional files generated during analysis + + The get_result_file API allows you to retrieve these files using: + - Operation ID: Extracted from the analysis operation + - File path: The path to the specific result file (e.g., "keyframes/{frameTimeMs}") + +USAGE: + python sample_get_result_file_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + + Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry + resource. See sample_configure_defaults.py for setup instructions. +""" + +import asyncio +import os +from pathlib import Path + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + AnalyzeInput, + AnalyzeResult, + AudioVisualContent, + MediaContentKind, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START analyze_video_for_result_files] + # Use a sample video URL + video_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/videos/sdk_samples/FlightSimulator.mp4" + + print(f"Analyzing video with prebuilt-videoSearch...") + print(f" URL: {video_url}") + + # Start the analysis operation (using begin_analyze which returns a poller) + poller = await client.begin_analyze( + analyzer_id="prebuilt-videoSearch", + inputs=[AnalyzeInput(url=video_url)], + ) + + # Get the operation ID from the poller + operation_id = poller.operation_id + print(f" Operation ID: {operation_id}") + + # Wait for completion + print(" Waiting for analysis to complete...") + result: AnalyzeResult = await poller.result() + # [END analyze_video_for_result_files] + + # [START get_result_file] + if not result.contents or len(result.contents) == 0: + print("No content found in the analysis result.") + return + + content = result.contents[0] + + # For video analysis, keyframes would be found in AudioVisualContent.KeyFrameTimesMs + if content.kind == MediaContentKind.AUDIO_VISUAL: + video_content: AudioVisualContent = content # type: ignore + + if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: + total_keyframes = len(video_content.key_frame_times_ms) + first_frame_time_ms = video_content.key_frame_times_ms[0] + + print(f"\nTotal keyframes: {total_keyframes}") + print(f"First keyframe time: {first_frame_time_ms} ms") + + # Get the first keyframe as an example + frame_path = f"keyframes/{first_frame_time_ms}" + + print(f"Getting result file: {frame_path}") + + # Get the result file (keyframe image) + file_response = await client.get_result_file( + operation_id=operation_id, + path=frame_path, + ) + + image_bytes = b"".join([chunk async for chunk in file_response]) + print(f"Retrieved keyframe image ({len(image_bytes):,} bytes)") + + # Save the keyframe image to sample_output directory + output_dir = Path(__file__).parent.parent / "sample_output" + output_dir.mkdir(exist_ok=True) + output_filename = f"keyframe_{first_frame_time_ms}.jpg" + output_path = output_dir / output_filename + + with open(output_path, "wb") as f: + f.write(image_bytes) + + print(f"Keyframe image saved to: {output_path}") + else: + print("\nNote: This sample demonstrates GetResultFile API usage.") + print(" For video analysis with keyframes, use prebuilt-videoSearch analyzer.") + print(" Keyframes are available in AudioVisualContent.key_frame_times_ms.") + print() + print(f"Example usage with operation ID '{operation_id}':") + print(" file_response = await client.get_result_file(") + print(" operation_id=operation_id,") + print(' path="keyframes/1000")') + else: + print("\nNote: This sample is designed for video analysis.") + print(" The analyzed content is not a video.") + # [END get_result_file] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py new file mode 100644 index 000000000000..12e049c04922 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py @@ -0,0 +1,214 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_grant_copy_auth_async.py + +DESCRIPTION: + This sample demonstrates how to grant copy authorization and copy an analyzer from a source + resource to a target resource (cross-resource copying). This is useful for copying analyzers + between different Azure resources or subscriptions. + + The grant_copy_authorization and copy_analyzer APIs allow you to copy an analyzer between + different Azure resources: + - Cross-resource copy: Copies an analyzer from one Azure resource to another + - Authorization required: You must grant copy authorization before copying + - Use cases: Cross-subscription copying, resource migration, multi-region deployment + + Note: For same-resource copying (copying within the same Azure resource), use the + sample_copy_analyzer_async.py sample instead. + +USAGE: + python sample_grant_copy_auth_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the source endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + 3) AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID - Full Azure Resource Manager resource ID of source. + 4) AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION - Azure region of source resource. + 5) AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT - Target endpoint for cross-subscription copy. + 6) AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID - Full Azure Resource Manager resource ID of target. + 7) AZURE_CONTENT_UNDERSTANDING_TARGET_REGION - Azure region of target resource. + 8) AZURE_CONTENT_UNDERSTANDING_TARGET_KEY - Target API key (optional if using DefaultAzureCredential). + + Example resource ID format: + /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name} + + Note: Both source and target AI Foundry Resources require 'Cognitive Services User' role for cross-subscription copy. +""" + +import asyncio +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + # Check for required environment variables + required_vars = [ + "AZURE_CONTENT_UNDERSTANDING_ENDPOINT", + "AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID", + "AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION", + "AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", + "AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID", + "AZURE_CONTENT_UNDERSTANDING_TARGET_REGION", + ] + + missing_vars = [var for var in required_vars if not os.getenv(var)] + if missing_vars: + print("Missing required environment variables:") + for var in missing_vars: + print(f" - {var}") + print("\nPlease set these environment variables and try again.") + print("\nExample resource ID format:") + print(" /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name}") + return + + # [START grant_copy_auth] + # Get source configuration + source_endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + source_key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + source_credential = AzureKeyCredential(source_key) if source_key else DefaultAzureCredential() + + source_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID"] + source_region = os.environ["AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION"] + + # Get target configuration + target_endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT"] + target_key = os.getenv("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") + target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() + + target_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID"] + target_region = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_REGION"] + + # Create clients + source_client = ContentUnderstandingClient(endpoint=source_endpoint, credential=source_credential) + target_client = ContentUnderstandingClient(endpoint=target_endpoint, credential=target_credential) + + # Generate unique analyzer IDs + base_id = f"my_analyzer_{int(time.time())}" + source_analyzer_id = f"{base_id}_source" + target_analyzer_id = f"{base_id}_target" + + print("Cross-Resource Copy Workflow") + print("=" * 60) + print(f" Source Endpoint: {source_endpoint}") + print(f" Source Region: {source_region}") + print(f" Target Endpoint: {target_endpoint}") + print(f" Target Region: {target_region}") + print("=" * 60) + + try: + async with source_client, target_client: + # Step 1: Create the source analyzer + print(f"\nStep 1: Creating source analyzer '{source_analyzer_id}'...") + + source_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for cross-resource copying", + config=ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + field_schema=ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + }, + ), + models={"completion": "gpt-4.1"}, + ) + + poller = await source_client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=source_analyzer, + ) + await poller.result() + print(f" Source analyzer created successfully!") + + # Step 2: Grant copy authorization from target + print(f"\nStep 2: Granting copy authorization from target resource...") + + copy_auth = await target_client.grant_copy_authorization( + analyzer_id=target_analyzer_id, + source_resource_id=source_resource_id, + source_region=source_region, + ) + + print(f" Authorization granted!") + print(f" Target Analyzer ID: {copy_auth.analyzer_id}") + print(f" Expires: {copy_auth.expires_on}") + + # Step 3: Copy analyzer using authorization + print(f"\nStep 3: Copying analyzer from source to target...") + + copy_poller = await source_client.begin_copy_analyzer( + target_analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id, + copy_authorization=copy_auth, + ) + await copy_poller.result() + print(f" Analyzer copied successfully!") + + # Step 4: Verify the copy + print(f"\nStep 4: Verifying the copied analyzer...") + copied_analyzer = await target_client.get_analyzer(analyzer_id=target_analyzer_id) + print(f" Target Analyzer ID: {copied_analyzer.analyzer_id}") + print(f" Description: {copied_analyzer.description}") + print(f" Status: {copied_analyzer.status}") + + finally: + # Clean up + print(f"\nCleaning up...") + async with source_client, target_client: + try: + await source_client.delete_analyzer(analyzer_id=source_analyzer_id) + print(f" Source analyzer '{source_analyzer_id}' deleted.") + except Exception: + pass + + try: + await target_client.delete_analyzer(analyzer_id=target_analyzer_id) + print(f" Target analyzer '{target_analyzer_id}' deleted.") + except Exception: + pass + # [END grant_copy_auth] + + if not isinstance(source_credential, AzureKeyCredential): + await source_credential.close() + if not isinstance(target_credential, AzureKeyCredential): + await target_credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py new file mode 100644 index 000000000000..43622ff0d625 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py @@ -0,0 +1,88 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_list_analyzers_async.py + +DESCRIPTION: + This sample demonstrates how to list all available analyzers in your Microsoft Foundry + resource, including both prebuilt and custom analyzers. + + The list_analyzers method returns all analyzers in your resource, including: + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice + - Custom analyzers: Analyzers you've created + + This is useful for: + - Discovery: See what analyzers are available in your resource + - Management: Get an overview of all your custom analyzers + - Debugging: Verify that analyzers were created successfully + +USAGE: + python sample_list_analyzers_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import asyncio +import os + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # [START list_analyzers] + print("Listing all available analyzers...") + + # List all analyzers + analyzers = [analyzer async for analyzer in client.list_analyzers()] + + print(f"\nFound {len(analyzers)} analyzer(s)") + + # Display summary + prebuilt_count = sum(1 for a in analyzers if a.analyzer_id and a.analyzer_id.startswith("prebuilt-")) + custom_count = len(analyzers) - prebuilt_count + print(f" Prebuilt analyzers: {prebuilt_count}") + print(f" Custom analyzers: {custom_count}") + + # Display details for each analyzer + print("\n" + "=" * 60) + for analyzer in analyzers: + print(f"ID: {analyzer.analyzer_id}") + print(f" Description: {analyzer.description or '(none)'}") + print(f" Status: {analyzer.status}") + + if analyzer.analyzer_id and analyzer.analyzer_id.startswith("prebuilt-"): + print(" Type: Prebuilt analyzer") + else: + print(" Type: Custom analyzer") + + # Show tags if available + if analyzer.tags: + tags_str = ", ".join(f"{k}={v}" for k, v in analyzer.tags.items()) + print(f" Tags: {tags_str}") + + print() + print("=" * 60) + # [END list_analyzers] + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py new file mode 100644 index 000000000000..20b2c4d0bac6 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py @@ -0,0 +1,132 @@ +# pylint: disable=line-too-long,useless-suppression +# 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. +# -------------------------------------------------------------------------- +""" +FILE: sample_update_analyzer_async.py + +DESCRIPTION: + This sample demonstrates how to update an existing custom analyzer, including updating + its description and tags. + + The update_analyzer method allows you to modify certain properties of an existing analyzer: + - Description: Update the analyzer's description + - Tags: Add, update, or remove tags (set tag value to empty string to remove) + + Note: Not all analyzer properties can be updated. Field schemas, models, and configuration + typically cannot be changed after creation. To change these, you may need to delete and + recreate the analyzer. + +USAGE: + python sample_update_analyzer_async.py + + Set the environment variables with your own values before running the sample: + 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). +""" + +import asyncio +import os +import time + +from dotenv import load_dotenv +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod, +) +from azure.core.credentials import AzureKeyCredential +from azure.identity.aio import DefaultAzureCredential + +load_dotenv() + + +async def main() -> None: + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + # Create initial analyzer + analyzer_id = f"my_analyzer_for_update_{int(time.time())}" + + print(f"Creating initial analyzer '{analyzer_id}'...") + + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Initial description", + config=ContentAnalyzerConfig(return_details=True), + field_schema=ContentFieldSchema( + name="demo_schema", + description="Schema for update demo", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + }, + ), + models={"completion": "gpt-4.1"}, + tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, + ) + + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + ) + await poller.result() + print(f"Analyzer '{analyzer_id}' created successfully!") + + # [START update_analyzer] + # First, get the current analyzer to preserve base analyzer ID + current_analyzer = await client.get_analyzer(analyzer_id=analyzer_id) + + # Display current analyzer information + print("\nCurrent analyzer information:") + print(f" Description: {current_analyzer.description}") + if current_analyzer.tags: + tags_str = ", ".join(f"{k}={v}" for k, v in current_analyzer.tags.items()) + print(f" Tags: {tags_str}") + + # Create an updated analyzer with new description and tags + updated_analyzer = ContentAnalyzer( + base_analyzer_id=current_analyzer.base_analyzer_id, + description="Updated description", + tags={ + "tag1": "tag1_updated_value", # Update existing tag + "tag2": "", # Remove tag2 (empty string removes the tag) + "tag3": "tag3_value", # Add new tag + }, + ) + + # Update the analyzer + print(f"\nUpdating analyzer '{analyzer_id}'...") + await client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) + + # Verify the update + updated = await client.get_analyzer(analyzer_id=analyzer_id) + print("\nUpdated analyzer information:") + print(f" Description: {updated.description}") + if updated.tags: + tags_str = ", ".join(f"{k}={v}" for k, v in updated.tags.items()) + print(f" Tags: {tags_str}") + # [END update_analyzer] + + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") + + if not isinstance(credential, AzureKeyCredential): + await credential.close() + + +if __name__ == "__main__": + asyncio.run(main()) From 059b4fd0b068402fc5617c1d8ac46cb19cd914f9 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 26 Nov 2025 12:50:21 -0800 Subject: [PATCH 032/105] update Microsoft Foundry --- .../azure-ai-contentunderstanding/README.md | 22 +++++++++---------- .../azure-ai-contentunderstanding/env.sample | 4 ++-- .../sample_configure_defaults_async.py | 6 ++--- .../samples/sample_configure_defaults.py | 6 ++--- 4 files changed, 19 insertions(+), 19 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index d0a87549075a..15d567eb8a03 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -14,7 +14,7 @@ This table shows the relationship between SDK versions and supported API service - Python 3.9 or later is required to use this package. - You need an [Azure subscription][azure_sub] to use this package. -- Once you have your Azure subscription, create an [Azure AI Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) in the Azure portal. Be sure to create it in a [supported region](https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support). +- Once you have your Azure subscription, create an [Microsoft Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) in the Azure portal. Be sure to create it in a [supported region](https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support). - For more information, see: https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api?tabs=document ### Install the package @@ -23,17 +23,17 @@ This table shows the relationship between SDK versions and supported API service python -m pip install azure-ai-contentunderstanding ``` -### Configure your Azure AI Foundry resource and required model deployments +### Configure your Microsoft Foundry resource and required model deployments Before running most samples (especially those that use prebuilt analyzers) you need to: -1. Create (or reuse) an Azure AI Foundry resource +1. Create (or reuse) an Microsoft Foundry resource 2. Assign the correct role so you can configure default model deployments 3. Deploy the required foundation models (GPT and Embeddings) in that resource 4. Map those deployments to standard model names using the SDK's `update_defaults` API (one-time per resource) 5. Provide environment variables (via a `.env` file at the repository root for tests, or your shell/session for ad‑hoc runs) -#### 1. Create the Azure AI Foundry resource +#### 1. Create the Microsoft Foundry resource Follow the steps in the Azure portal (Create a resource > AI Foundry). The Content Understanding service is hosted within this resource. After creation, locate the endpoint under: Resource Management > Keys and Endpoint. It typically looks like: @@ -45,7 +45,7 @@ Set this as `AZURE_CONTENT_UNDERSTANDING_ENDPOINT`. #### 2. Grant required permissions -To configure default model deployments you (or the service principal / managed identity you use) must have the **Cognitive Services User** role on the Azure AI Foundry resource, even if you are already an Owner. In the Azure portal: +To configure default model deployments you (or the service principal / managed identity you use) must have the **Cognitive Services User** role on the Microsoft Foundry resource, even if you are already an Owner. In the Azure portal: 1. Go to your resource 2. Access Control (IAM) > Add > Add role assignment @@ -63,7 +63,7 @@ Prebuilt analyzers rely on specific model families: | `prebuilt-documentSearch`, `prebuilt-audioSearch`, `prebuilt-videoSearch` | `gpt-4.1-mini`, `text-embedding-3-large` | | `prebuilt-invoice`, `prebuilt-receipt` and similar structured document analyzers | `gpt-4.1`, `text-embedding-3-large` | -In Azure AI Foundry: Deployments > Deploy model > Deploy base model. Deploy each of: +In Microsoft Foundry: Deployments > Deploy model > Deploy base model. Deploy each of: - GPT-4.1 (suggested deployment name: `gpt-4.1`) - GPT-4.1-mini (suggested deployment name: `gpt-4.1-mini`) @@ -135,7 +135,7 @@ After a successful run you can immediately use prebuilt analyzers such as `prebu - Confirm the **Cognitive Services User** role assignment - Verify the endpoint points to the correct resource -You only need to perform this configuration again if you change deployment names or create a new Azure AI Foundry resource. +You only need to perform this configuration again if you change deployment names or create a new Microsoft Foundry resource. #### Troubleshooting quick tips - Missing model variables: ensure all three deployment environment variables are present; samples will warn politely if any are absent. @@ -272,11 +272,11 @@ asyncio.run(analyze_invoice()) ## Troubleshooting -### Azure AI Foundry Resource and Regional Support +### Microsoft Foundry Resource and Regional Support -Azure AI Content Understanding requires an [Azure AI Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) and is only available in certain [supported regions](https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support). Make sure to: +Azure AI Content Understanding requires an [Microsoft Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) and is only available in certain [supported regions](https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support). Make sure to: -- Create an Azure AI Foundry resource in the Azure portal under **AI Foundry** > **AI Foundry** +- Create an Microsoft Foundry resource in the Azure portal under **AI Foundry** > **AI Foundry** - Select a supported region when creating the resource For detailed setup instructions and current supported regions, see: **[Azure AI Content Understanding Quickstart Guide](https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api)** @@ -311,7 +311,7 @@ To run the tests for this package, you need to set up a `.env` file with your te ``` 4. Edit the `.env` file at the repo root and fill in your actual values: - - `CONTENTUNDERSTANDING_ENDPOINT`: Your Azure AI Foundry resource endpoint + - `CONTENTUNDERSTANDING_ENDPOINT`: Your Microsoft Foundry resource endpoint - `AZURE_CONTENT_UNDERSTANDING_KEY`: Your API key (optional if using DefaultAzureCredential) - `AZURE_TEST_RUN_LIVE`: Set to `true` to run tests against real Azure resources - `AZURE_SKIP_LIVE_RECORDING`: Set to `true` to skip recording when running live tests diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample index d0e113808bed..a17801877a7a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample @@ -5,7 +5,7 @@ # Required Configuration # ============================================================================ -# The endpoint URL of your Azure AI Foundry resource +# The endpoint URL of your Microsoft Foundry resource # Used by all samples AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://your-resource.services.ai.azure.com/ @@ -60,7 +60,7 @@ AZURE_SKIP_LIVE_RECORDING=false # Required for prebuilt analyzers: # - prebuilt-documentSearch, prebuilt-audioSearch, prebuilt-videoSearch require GPT-4.1-mini and text-embedding-3-large # - prebuilt-invoice, prebuilt-receipt, and others require GPT-4.1 and text-embedding-3-large -# Deploy these models in Azure AI Foundry and specify their deployment names here +# Deploy these models in Microsoft Foundry and specify their deployment names here # By convention, deployment names typically match the model name # but you can use any name you chose during deployment # Learn more: https://learn.microsoft.com/en-us/azure/ai-studio/how-to/deploy-models-openai diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py index c9fbd1cf6373..7efeb8712180 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py @@ -23,9 +23,9 @@ Set the environment variables with your own values before running the sample: 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - 3) GPT_4_1_DEPLOYMENT - your GPT-4.1 deployment name in Azure AI Foundry. - 4) GPT_4_1_MINI_DEPLOYMENT - your GPT-4.1-mini deployment name in Azure AI Foundry. - 5) TEXT_EMBEDDING_3_LARGE_DEPLOYMENT - your text-embedding-3-large deployment name in Azure AI Foundry. + 3) GPT_4_1_DEPLOYMENT - your GPT-4.1 deployment name in Microsoft Foundry. + 4) GPT_4_1_MINI_DEPLOYMENT - your GPT-4.1-mini deployment name in Microsoft Foundry. + 5) TEXT_EMBEDDING_3_LARGE_DEPLOYMENT - your text-embedding-3-large deployment name in Microsoft Foundry. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py index e6c3a396ba85..518c38e4c5e8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py @@ -23,9 +23,9 @@ Set the environment variables with your own values before running the sample: 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - 3) GPT_4_1_DEPLOYMENT - your GPT-4.1 deployment name in Azure AI Foundry. - 4) GPT_4_1_MINI_DEPLOYMENT - your GPT-4.1-mini deployment name in Azure AI Foundry. - 5) TEXT_EMBEDDING_3_LARGE_DEPLOYMENT - your text-embedding-3-large deployment name in Azure AI Foundry. + 3) GPT_4_1_DEPLOYMENT - your GPT-4.1 deployment name in Microsoft Foundry. + 4) GPT_4_1_MINI_DEPLOYMENT - your GPT-4.1-mini deployment name in Microsoft Foundry. + 5) TEXT_EMBEDDING_3_LARGE_DEPLOYMENT - your text-embedding-3-large deployment name in Microsoft Foundry. """ import os From f76ad362a30a76d37a59125e3d2a1d9caee68ef9 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 26 Nov 2025 13:53:55 -0800 Subject: [PATCH 033/105] update sample readme --- .../samples/README.md | 249 ++++++++++-------- 1 file changed, 146 insertions(+), 103 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index b3eda7e9c3bf..bc0c8bfe2b87 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -11,14 +11,14 @@ urlFragment: azure-ai-contentunderstanding-samples These code samples demonstrate common scenarios with the Azure AI Content Understanding client library. -**Note:** All samples use async operations for better performance and modern Python best practices. +**Note:** All samples in this folder use synchronous operations. For async samples, see the [`async_samples`](../async_samples) directory. ## Prerequisites * Python 3.9 or later is required to use this package -* You need an [Azure subscription][azure_sub] and an [Azure AI Foundry resource][contentunderstanding_quickstart] to use this package. -* The Azure AI Foundry resource must be created in a [supported region][contentunderstanding_regions]. -* **Required setup:** GPT-4.1, GPT-4.1-mini, and text-embedding-3-large models must be deployed in your Azure AI Foundry project and configured using `update_defaults.py` before using prebuilt analyzers. +* You need an [Azure subscription][azure_sub] and a [Microsoft Foundry resource][contentunderstanding_quickstart] to use this package. +* The Microsoft Foundry resource must be created in a [supported region][contentunderstanding_regions]. +* **Required setup:** GPT-4.1, GPT-4.1-mini, and text-embedding-3-large models must be deployed in your Microsoft Foundry project and configured using `sample_configure_defaults.py` before using prebuilt analyzers. ## Setup @@ -42,10 +42,10 @@ cp ../env.sample .env # Edit .env with your credentials # 5. Configure model deployments (required for prebuilt analyzers) -python update_defaults.py +python sample_configure_defaults.py # 6. Run a sample -python analyze_url.py +python sample_analyze_url.py ``` ### Detailed Setup Instructions @@ -97,11 +97,11 @@ cp ../env.sample .env ``` Set the following in `.env`: -* `AZURE_CONTENT_UNDERSTANDING_ENDPOINT` (required) - Your Azure AI Foundry resource endpoint +* `AZURE_CONTENT_UNDERSTANDING_ENDPOINT` (required) - Your Microsoft Foundry resource endpoint * `AZURE_CONTENT_UNDERSTANDING_KEY` (optional) - Your API key. If not set, `DefaultAzureCredential` will be used. -* `GPT_4_1_DEPLOYMENT` (required for update_defaults.py) - Your GPT-4.1 deployment name in Azure AI Foundry -* `GPT_4_1_MINI_DEPLOYMENT` (required for update_defaults.py) - Your GPT-4.1-mini deployment name in Azure AI Foundry -* `TEXT_EMBEDDING_3_LARGE_DEPLOYMENT` (required for update_defaults.py) - Your text-embedding-3-large deployment name in Azure AI Foundry +* `GPT_4_1_DEPLOYMENT` (required for sample_configure_defaults.py) - Your GPT-4.1 deployment name in Microsoft Foundry +* `GPT_4_1_MINI_DEPLOYMENT` (required for sample_configure_defaults.py) - Your GPT-4.1-mini deployment name in Microsoft Foundry +* `TEXT_EMBEDDING_3_LARGE_DEPLOYMENT` (required for sample_configure_defaults.py) - Your text-embedding-3-large deployment name in Microsoft Foundry **Example `.env` file:** ```bash @@ -128,126 +128,180 @@ az login source .venv/bin/activate # Run a sample -python samples/analyze_url.py +python samples/sample_analyze_url.py ``` ## Sample Files -### Getting Started Samples +### Sample 00: Configure Defaults -#### `analyze_url.py` ⭐ -**Start here!** Analyzes a document from a remote URL using `prebuilt-documentSearch`. Shows basic document analysis, content extraction, and object model navigation. +#### `sample_configure_defaults.py` ⭐ +**Required setup!** Configures and retrieves default model deployment settings for your Content Understanding resource. This is a one-time setup before using prebuilt analyzers. **Key concepts:** -- Using `begin_analyze` with URL input -- Extracting markdown content -- Accessing document pages and tables -- Working with the analysis result object model +- Setting up model deployment mappings (GPT-4.1, GPT-4.1-mini, text-embedding-3-large) +- Required before using prebuilt analyzers +- Retrieving current default settings + +### Sample 01: Analyze Binary -#### `analyze_binary.py` -Analyzes a PDF document from local binary data using `prebuilt-documentSearch`. Demonstrates how to read local files and analyze them. +#### `sample_analyze_binary.py` +Analyzes a PDF document from local binary data using `prebuilt-documentSearch`. Demonstrates how to read local files and extract markdown content. **Key concepts:** - Using `begin_analyze_binary` with binary input - Reading local PDF files -- Same content extraction as `analyze_url.py` +- Extracting markdown content +- Accessing document properties (pages, dimensions) -#### `analyze_url_prebuilt_invoice.py` +### Sample 02: Analyze URL + +#### `sample_analyze_url.py` ⭐ +**Start here!** Analyzes a document from a remote URL using `prebuilt-documentSearch`. Shows basic document analysis and content extraction. + +**Key concepts:** +- Using `begin_analyze` with URL input +- Extracting markdown content +- Working with the analysis result object model + +### Sample 03: Analyze Invoice + +#### `sample_analyze_invoice.py` Extracts structured fields from invoices using `prebuilt-invoice` analyzer. Shows how to work with structured field extraction. **Key concepts:** - Using specialized prebuilt analyzers - Extracting structured fields (customer name, totals, dates, line items) -- Working with field types (StringField, NumberField, ArrayField) -- Using the convenience `.value` property +- Working with field confidence scores and source locations +- Accessing object fields and array fields -### Advanced Analysis Samples +### Sample 04: Create Analyzer -#### `analyze_binary_raw_json.py` -Shows how to access the raw JSON response before deserialization for debugging or custom processing. +#### `sample_create_analyzer.py` +Creates a custom analyzer with field schema to extract structured data from documents. -#### `analyze_binary_features.py` -Demonstrates advanced features like figure analysis, chart extraction, and custom output options. +**Key concepts:** +- Defining custom field schemas (string, number, date, object, array) +- Using extraction methods: `extract`, `generate`, `classify` +- Configuring analysis options (OCR, layout, formulas) +- Enabling source and confidence tracking -#### `compare_prebuilt_analyzers.py` -Compares results from different prebuilt analyzers (`prebuilt-document` vs `prebuilt-documentSearch`) to show differences. +### Sample 05: Create Classifier -#### `analyze_category_enable_segments.py` -Creates a custom analyzer with content categories for document classification and automatic page segmentation. +#### `sample_create_classifier.py` +Creates a classifier analyzer to categorize documents and demonstrates automatic segmentation. -**Use case:** Multi-page documents with mixed content types (e.g., PDF with invoices and bank statements) +**Key concepts:** +- Creating classifiers with content categories +- Document categorization (Loan_Application, Invoice, Bank_Statement) +- Enabling segmentation for multi-document files +- Processing classification results -### Resource Configuration +### Sample 06: Get Analyzer -#### `update_defaults.py` ⭐ -**Required setup!** Configures default model deployments for your Content Understanding resource. Maps model names (GPT-4.1, GPT-4.1-mini, text-embedding-3-large) to your Azure AI Foundry deployments. +#### `sample_get_analyzer.py` +Retrieves information about analyzers, including prebuilt and custom analyzers. **Key concepts:** -- Setting up model deployment mappings -- Required before using prebuilt analyzers -- Configuring GPT-4.1, GPT-4.1-mini, and text-embedding-3-large deployments +- Getting prebuilt analyzer details +- Getting custom analyzer details +- Dumping analyzer configuration as JSON + +### Sample 07: List Analyzers -#### `get_defaults.py` -Retrieves and displays current default model deployment settings for your Content Understanding resource. Shows which models are configured and what they're used for. +#### `sample_list_analyzers.py` +Lists all available analyzers in your Microsoft Foundry resource. **Key concepts:** -- Checking current model deployment configuration -- Verifying prebuilt analyzer readiness -- Understanding model usage across different analyzers +- Listing prebuilt and custom analyzers +- Displaying analyzer summary and details +- Identifying analyzer types -### Custom Analyzer Management +### Sample 08: Update Analyzer -#### `create_analyzer.py` -Creates or replaces a custom analyzer with field schemas and analysis configuration. +#### `sample_update_analyzer.py` +Updates an existing custom analyzer's description and tags. -#### `get_analyzer.py` -Retrieves analyzer configuration and details. +**Key concepts:** +- Updating analyzer description +- Adding, updating, and removing tags +- Verifying analyzer updates -#### `list_analyzers.py` -Lists all available analyzers (prebuilt and custom). +### Sample 09: Delete Analyzer -#### `update_analyzer.py` -Updates an existing analyzer configuration. +#### `sample_delete_analyzer.py` +Deletes a custom analyzer from your resource. -#### `delete_analyzer.py` -Deletes a custom analyzer. +**Key concepts:** +- Creating a simple analyzer for deletion demo +- Deleting custom analyzers +- Understanding deletion limitations (prebuilt analyzers cannot be deleted) -#### `create_classifier.py` -Creates a custom classifier for document categorization with content categories. Demonstrates how to define classification categories and enable document segmentation for multi-document files. +### Sample 10: Analyze Configs + +#### `sample_analyze_configs.py` +Extracts additional features from documents such as charts, hyperlinks, formulas, and annotations. **Key concepts:** -- Creating classifiers with content categories -- Document categorization (Loan_Application, Invoice, Bank_Statement) -- Enabling segmentation for multi-document files -- Using GPT-4.1 for classification tasks +- Using prebuilt-documentSearch with enhanced features +- Extracting chart figures +- Extracting hyperlinks +- Extracting mathematical formulas +- Extracting PDF annotations -### Advanced Features +### Sample 11: Analyze Return Raw JSON -#### `create_analyzer_with_labels.py` -Builds a custom analyzer using training data from Azure Blob Storage. Requires additional configuration (see `env.sample`). +#### `sample_analyze_return_raw_json.py` +Accesses the raw JSON response from analysis operations for custom processing. -#### `copy_analyzer.py` -Copies an analyzer from one location/region to another. +**Key concepts:** +- Getting raw JSON response +- Saving analysis results to file +- Custom JSON processing -#### `get_result_file.py` -Downloads result files from analysis operations (e.g., extracted video keyframes). +### Sample 12: Get Result File -#### `delete_result.py` -Demonstrates the complete workflow of analyzing a document, extracting results, and then deleting the analysis result to free up storage. Shows proper result lifecycle management. +#### `sample_get_result_file.py` +Retrieves result files (such as keyframe images) from video analysis operations. + +**Key concepts:** +- Analyzing video content +- Extracting operation IDs +- Retrieving keyframe images +- Saving result files to disk + +### Sample 13: Delete Result + +#### `sample_delete_result.py` +Demonstrates analyzing a document and then deleting the analysis result. **Key concepts:** - Extracting operation IDs from analysis operations - Deleting analysis results to manage storage -- Verifying result deletion with error handling +- Verifying result deletion - Understanding result retention policies (24-hour auto-deletion) -### Utility +### Sample 14: Copy Analyzer + +#### `sample_copy_analyzer.py` +Copies an analyzer from source to target within the same resource. + +**Key concepts:** +- Creating source analyzers +- Copying analyzers within the same resource +- Updating copied analyzers with new tags +- Use cases: testing, staging, production deployment + +### Sample 15: Grant Copy Auth -#### `sample_helper.py` -Helper functions for saving results and working with sample files. +#### `sample_grant_copy_auth.py` +Grants copy authorization and copies an analyzer from a source resource to a target resource (cross-resource copying). -#### `run_all_samples.py` -Runs all samples sequentially for testing. Stops on first error. +**Key concepts:** +- Cross-resource copying between different Azure resources +- Granting copy authorization +- Resource migration and multi-region deployment +- Required environment variables for cross-resource operations ## Common Patterns @@ -263,41 +317,38 @@ credential = AzureKeyCredential(api_key) **Option 2: DefaultAzureCredential (recommended)** ```python -from azure.identity.aio import DefaultAzureCredential +from azure.identity import DefaultAzureCredential credential = DefaultAzureCredential() # Requires: az login ``` -### Async Context Managers - -All samples use async context managers for proper resource cleanup: +### Working with the Client ```python -async with ContentUnderstandingClient(endpoint, credential) as client: - # Client automatically closed when exiting context - poller = await client.begin_analyze(...) - result = await poller.result() - -# Clean up credential if using DefaultAzureCredential -if isinstance(credential, DefaultAzureCredential): - await credential.close() +from azure.ai.contentunderstanding import ContentUnderstandingClient + +client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) + +# Analyze a document +poller = client.begin_analyze(analyzer_id="prebuilt-documentSearch", inputs=[...]) +result = poller.result() ``` ### Working with Results **Access markdown content:** ```python -result: AnalyzeResult = await poller.result() -content: MediaContent = result.contents[0] +result: AnalyzeResult = poller.result() +content = result.contents[0] print(content.markdown) ``` **Access structured fields:** ```python # For prebuilt-invoice -content: MediaContent = result.contents[0] -customer_name = content.fields["CustomerName"].value # Using .value property -invoice_total = content.fields["InvoiceTotal"].value +content = result.contents[0] +customer_name = content.fields["CustomerName"].value +invoice_total = content.fields["TotalAmount"].value ``` **Access document properties:** @@ -335,21 +386,13 @@ pip install -r dev_requirements.txt **Solution:** Either set `AZURE_CONTENT_UNDERSTANDING_KEY` in `.env` or run `az login`. -### Import errors or type checking issues - -**Solution:** Reinstall the SDK in the virtual environment: -```bash -source .venv/bin/activate -pip install -e . --force-reinstall -``` - ### "Model deployments not configured" or "prebuilt analyzers not available" **Solution:** Run the setup sample to configure model deployments: ```bash source .venv/bin/activate cd samples -python update_defaults.py +python sample_configure_defaults.py ``` This configures the required GPT-4.1, GPT-4.1-mini, and text-embedding-3-large model deployments that prebuilt analyzers depend on. From 4e199230b99deaf9c91470a5b695a1aa3b8d673c Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 26 Nov 2025 13:57:38 -0800 Subject: [PATCH 034/105] update sample readme --- .../azure-ai-contentunderstanding/samples/README.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index bc0c8bfe2b87..d224fc20f25b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -135,7 +135,7 @@ python samples/sample_analyze_url.py ### Sample 00: Configure Defaults -#### `sample_configure_defaults.py` ⭐ +#### `sample_configure_defaults.py` **Required setup!** Configures and retrieves default model deployment settings for your Content Understanding resource. This is a one-time setup before using prebuilt analyzers. **Key concepts:** @@ -156,7 +156,7 @@ Analyzes a PDF document from local binary data using `prebuilt-documentSearch`. ### Sample 02: Analyze URL -#### `sample_analyze_url.py` ⭐ +#### `sample_analyze_url.py` **Start here!** Analyzes a document from a remote URL using `prebuilt-documentSearch`. Shows basic document analysis and content extraction. **Key concepts:** @@ -386,6 +386,14 @@ pip install -r dev_requirements.txt **Solution:** Either set `AZURE_CONTENT_UNDERSTANDING_KEY` in `.env` or run `az login`. +### Import errors or type checking issues + +**Solution:** Reinstall the SDK in the virtual environment: +```bash +source .venv/bin/activate +pip install -e . --force-reinstall +``` + ### "Model deployments not configured" or "prebuilt analyzers not available" **Solution:** Run the setup sample to configure model deployments: From 628ab7855ec8ec430b97dc1e2e1eb9ee3a89edfd Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 26 Nov 2025 14:12:04 -0800 Subject: [PATCH 035/105] update sample readme --- .../samples/README.md | 34 +++++++++---------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index d224fc20f25b..b58ce7b2ec57 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -11,7 +11,7 @@ urlFragment: azure-ai-contentunderstanding-samples These code samples demonstrate common scenarios with the Azure AI Content Understanding client library. -**Note:** All samples in this folder use synchronous operations. For async samples, see the [`async_samples`](../async_samples) directory. +**Note:** All samples in this folder use synchronous operations. For async samples, see the [`async_samples`](async_samples) directory. ## Prerequisites @@ -135,7 +135,7 @@ python samples/sample_analyze_url.py ### Sample 00: Configure Defaults -#### `sample_configure_defaults.py` +#### `sample_configure_defaults.py` / `sample_configure_defaults_async.py` **Required setup!** Configures and retrieves default model deployment settings for your Content Understanding resource. This is a one-time setup before using prebuilt analyzers. **Key concepts:** @@ -145,7 +145,7 @@ python samples/sample_analyze_url.py ### Sample 01: Analyze Binary -#### `sample_analyze_binary.py` +#### `sample_analyze_binary.py` / `sample_analyze_binary_async.py` Analyzes a PDF document from local binary data using `prebuilt-documentSearch`. Demonstrates how to read local files and extract markdown content. **Key concepts:** @@ -156,7 +156,7 @@ Analyzes a PDF document from local binary data using `prebuilt-documentSearch`. ### Sample 02: Analyze URL -#### `sample_analyze_url.py` +#### `sample_analyze_url.py` / `sample_analyze_url_async.py` **Start here!** Analyzes a document from a remote URL using `prebuilt-documentSearch`. Shows basic document analysis and content extraction. **Key concepts:** @@ -166,7 +166,7 @@ Analyzes a PDF document from local binary data using `prebuilt-documentSearch`. ### Sample 03: Analyze Invoice -#### `sample_analyze_invoice.py` +#### `sample_analyze_invoice.py` / `sample_analyze_invoice_async.py` Extracts structured fields from invoices using `prebuilt-invoice` analyzer. Shows how to work with structured field extraction. **Key concepts:** @@ -177,7 +177,7 @@ Extracts structured fields from invoices using `prebuilt-invoice` analyzer. Show ### Sample 04: Create Analyzer -#### `sample_create_analyzer.py` +#### `sample_create_analyzer.py` / `sample_create_analyzer_async.py` Creates a custom analyzer with field schema to extract structured data from documents. **Key concepts:** @@ -188,7 +188,7 @@ Creates a custom analyzer with field schema to extract structured data from docu ### Sample 05: Create Classifier -#### `sample_create_classifier.py` +#### `sample_create_classifier.py` / `sample_create_classifier_async.py` Creates a classifier analyzer to categorize documents and demonstrates automatic segmentation. **Key concepts:** @@ -199,7 +199,7 @@ Creates a classifier analyzer to categorize documents and demonstrates automatic ### Sample 06: Get Analyzer -#### `sample_get_analyzer.py` +#### `sample_get_analyzer.py` / `sample_get_analyzer_async.py` Retrieves information about analyzers, including prebuilt and custom analyzers. **Key concepts:** @@ -209,7 +209,7 @@ Retrieves information about analyzers, including prebuilt and custom analyzers. ### Sample 07: List Analyzers -#### `sample_list_analyzers.py` +#### `sample_list_analyzers.py` / `sample_list_analyzers_async.py` Lists all available analyzers in your Microsoft Foundry resource. **Key concepts:** @@ -219,7 +219,7 @@ Lists all available analyzers in your Microsoft Foundry resource. ### Sample 08: Update Analyzer -#### `sample_update_analyzer.py` +#### `sample_update_analyzer.py` / `sample_update_analyzer_async.py` Updates an existing custom analyzer's description and tags. **Key concepts:** @@ -229,7 +229,7 @@ Updates an existing custom analyzer's description and tags. ### Sample 09: Delete Analyzer -#### `sample_delete_analyzer.py` +#### `sample_delete_analyzer.py` / `sample_delete_analyzer_async.py` Deletes a custom analyzer from your resource. **Key concepts:** @@ -239,7 +239,7 @@ Deletes a custom analyzer from your resource. ### Sample 10: Analyze Configs -#### `sample_analyze_configs.py` +#### `sample_analyze_configs.py` / `sample_analyze_configs_async.py` Extracts additional features from documents such as charts, hyperlinks, formulas, and annotations. **Key concepts:** @@ -251,7 +251,7 @@ Extracts additional features from documents such as charts, hyperlinks, formulas ### Sample 11: Analyze Return Raw JSON -#### `sample_analyze_return_raw_json.py` +#### `sample_analyze_return_raw_json.py` / `sample_analyze_return_raw_json_async.py` Accesses the raw JSON response from analysis operations for custom processing. **Key concepts:** @@ -261,7 +261,7 @@ Accesses the raw JSON response from analysis operations for custom processing. ### Sample 12: Get Result File -#### `sample_get_result_file.py` +#### `sample_get_result_file.py` / `sample_get_result_file_async.py` Retrieves result files (such as keyframe images) from video analysis operations. **Key concepts:** @@ -272,7 +272,7 @@ Retrieves result files (such as keyframe images) from video analysis operations. ### Sample 13: Delete Result -#### `sample_delete_result.py` +#### `sample_delete_result.py` / `sample_delete_result_async.py` Demonstrates analyzing a document and then deleting the analysis result. **Key concepts:** @@ -283,7 +283,7 @@ Demonstrates analyzing a document and then deleting the analysis result. ### Sample 14: Copy Analyzer -#### `sample_copy_analyzer.py` +#### `sample_copy_analyzer.py` / `sample_copy_analyzer_async.py` Copies an analyzer from source to target within the same resource. **Key concepts:** @@ -294,7 +294,7 @@ Copies an analyzer from source to target within the same resource. ### Sample 15: Grant Copy Auth -#### `sample_grant_copy_auth.py` +#### `sample_grant_copy_auth.py` / `sample_grant_copy_auth_async.py` Grants copy authorization and copies an analyzer from a source resource to a target resource (cross-resource copying). **Key concepts:** From e432b5f4084652f7b76409925615d8ad1e6456ee Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Sun, 30 Nov 2025 03:33:10 +0000 Subject: [PATCH 036/105] CHNAGELOG: Update the formats --- .../azure-ai-contentunderstanding/CHANGELOG.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md index b957b2575b48..83f897aac77e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md @@ -1,7 +1,13 @@ # Release History -## 1.0.0b1 (1970-01-01) +## 1.0.0-beta.1 (Unreleased) -### Other Changes +### Features Added +- Initial release of Azure AI Content Understanding client library for .NET +- Added `ContentUnderstandingClient` for analyzing documents, audio, and video content - - Initial version \ No newline at end of file +### Breaking Changes + +### Bugs Fixed + +### Other Changes \ No newline at end of file From 732cc1f5d9bfffb0aba08a99821234764645c125 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Sun, 30 Nov 2025 19:09:38 +0000 Subject: [PATCH 037/105] README: Update README.md for Azure AI Content Understanding samples: modified product list and installation instructions to reflect new package name and URL fragment. --- .../azure-ai-contentunderstanding/samples/README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index b58ce7b2ec57..58b8bbc10bad 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -4,7 +4,9 @@ languages: - python products: - azure -urlFragment: azure-ai-contentunderstanding-samples + - azure-cognitive-services + - azure-content-understanding +urlFragment: contentunderstanding-samples --- # Azure AI Content Understanding client library for Python Samples @@ -33,7 +35,7 @@ source .venv/bin/activate # On Linux/macOS # .venv\Scripts\activate # On Windows # 3. Install SDK and all dependencies -pip install -e . +pip install azure-ai-contentunderstanding pip install -r dev_requirements.txt # Includes aiohttp, pytest, python-dotenv, azure-identity # 4. Set up environment variables From c401b2ad4928a6d9cd6d1f181b25ce71588d0c19 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Sun, 30 Nov 2025 20:16:10 +0000 Subject: [PATCH 038/105] SAMPLE: - Fix Grant Copy sample issue - Update async sample file path, and updated README for correct instruction --- .../azure-ai-contentunderstanding/.gitignore | 1 + .../samples/README.md | 70 ++++++++++++++++++- .../sample_analyze_binary_async.py | 2 +- .../sample_analyze_configs_async.py | 2 +- .../sample_analyze_return_raw_json_async.py | 2 +- .../sample_create_classifier_async.py | 2 +- .../sample_grant_copy_auth_async.py | 58 ++++++++------- .../samples/sample_grant_copy_auth.py | 26 ++++--- 8 files changed, 122 insertions(+), 41 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore b/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore index d2e11e7d02e6..cbb17c6c9faf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore @@ -24,3 +24,4 @@ htmlcov/ # Environment variables .env +.local_only/ \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index 58b8bbc10bad..baf99de54728 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -46,8 +46,11 @@ cp ../env.sample .env # 5. Configure model deployments (required for prebuilt analyzers) python sample_configure_defaults.py -# 6. Run a sample +# 6. Run a sync sample python sample_analyze_url.py + +# Or run an async sample +python ../async_samples/sample_analyze_url_async.py ``` ### Detailed Setup Instructions @@ -125,14 +128,62 @@ az login **Important:** Always run samples from the activated virtual environment! +### Running Sync Samples + +Sync samples are in the `samples/` directory. Run them from the package directory: + ```bash # Make sure virtual environment is activated source .venv/bin/activate -# Run a sample +# From the package directory, run sync samples python samples/sample_analyze_url.py +python samples/sample_analyze_binary.py ``` +Or navigate to the samples directory first: + +```bash +# Make sure virtual environment is activated +source .venv/bin/activate + +# Navigate to samples directory +cd samples + +# Run sync samples +python sample_analyze_url.py +python sample_analyze_binary.py +``` + +### Running Async Samples + +Async samples are in the `samples/async_samples/` directory. Run them from the package directory: + +```bash +# Make sure virtual environment is activated +source .venv/bin/activate + +# From the package directory, run async samples +python samples/async_samples/sample_analyze_url_async.py +python samples/async_samples/sample_analyze_binary_async.py +``` + +Or navigate to the async_samples directory: + +```bash +# Make sure virtual environment is activated +source .venv/bin/activate + +# Navigate to async_samples directory +cd samples/async_samples + +# Run async samples +python sample_analyze_url_async.py +python sample_analyze_binary_async.py +``` + +**Note:** When running samples that use local files (like `sample_analyze_binary.py`), make sure you run them from the `samples/` directory (or use the full path) so that relative paths like `sample_files/sample_invoice.pdf` resolve correctly. + ## Sample Files ### Sample 00: Configure Defaults @@ -407,6 +458,21 @@ python sample_configure_defaults.py This configures the required GPT-4.1, GPT-4.1-mini, and text-embedding-3-large model deployments that prebuilt analyzers depend on. +### "FileNotFoundError" when running samples with local files + +**Solution:** Make sure you run samples that use local files from the `samples/` directory: +```bash +source .venv/bin/activate +cd samples +python sample_analyze_binary.py # This will find sample_files/sample_invoice.pdf +``` + +If running from the package directory, use the full path: +```bash +source .venv/bin/activate +python samples/sample_analyze_binary.py # Make sure you're in the package directory +``` + ## Next Steps * Review the [Azure AI Content Understanding documentation][contentunderstanding_docs] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py index 7be2a85ba202..8f1c35c05848 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py @@ -52,7 +52,7 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_document_from_binary] - file_path = "../sample_files/sample_invoice.pdf" + file_path = "sample_files/sample_invoice.pdf" with open(file_path, "rb") as f: pdf_bytes = f.read() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index 531872312883..805976412c81 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -58,7 +58,7 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_with_configs] - file_path = "../sample_files/sample_document_features.pdf" + file_path = "sample_files/sample_document_features.pdf" with open(file_path, "rb") as f: pdf_bytes = f.read() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py index 86061c9ba4c4..3b9d7371dfe4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py @@ -59,7 +59,7 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_return_raw_json] - file_path = "../sample_files/sample_invoice.pdf" + file_path = "sample_files/sample_invoice.pdf" with open(file_path, "rb") as f: file_bytes = f.read() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index c357762536c8..e2dba8e5a565 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -105,7 +105,7 @@ async def main() -> None: # [END create_classifier] # [START analyze_with_classifier] - file_path = "../sample_files/mixed_financial_docs.pdf" + file_path = "sample_files/mixed_financial_docs.pdf" with open(file_path, "rb") as f: file_bytes = f.read() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py index 12e049c04922..f1c2229bc35f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py @@ -156,26 +156,30 @@ async def main() -> None: await poller.result() print(f" Source analyzer created successfully!") - # Step 2: Grant copy authorization from target - print(f"\nStep 2: Granting copy authorization from target resource...") + # Step 2: Grant copy authorization from source + # Grant authorization on the source client for copying to the target resource + print(f"\nStep 2: Granting copy authorization from source resource...") - copy_auth = await target_client.grant_copy_authorization( - analyzer_id=target_analyzer_id, - source_resource_id=source_resource_id, - source_region=source_region, + copy_auth = await source_client.grant_copy_authorization( + analyzer_id=source_analyzer_id, + target_azure_resource_id=target_resource_id, + target_region=target_region, ) print(f" Authorization granted!") - print(f" Target Analyzer ID: {copy_auth.analyzer_id}") - print(f" Expires: {copy_auth.expires_on}") + print(f" Target Azure Resource ID: {copy_auth.target_azure_resource_id}") + print(f" Target Region: {target_region}") + print(f" Expires at: {copy_auth.expires_at}") # Step 3: Copy analyzer using authorization + # Copy is performed on the target client, copying from source to target print(f"\nStep 3: Copying analyzer from source to target...") - copy_poller = await source_client.begin_copy_analyzer( - target_analyzer_id=target_analyzer_id, + copy_poller = await target_client.begin_copy_analyzer( + analyzer_id=target_analyzer_id, source_analyzer_id=source_analyzer_id, - copy_authorization=copy_auth, + source_azure_resource_id=source_resource_id, + source_region=source_region, ) await copy_poller.result() print(f" Analyzer copied successfully!") @@ -188,20 +192,26 @@ async def main() -> None: print(f" Status: {copied_analyzer.status}") finally: - # Clean up + # Clean up - create new client instances for cleanup since the original ones are closed print(f"\nCleaning up...") - async with source_client, target_client: - try: - await source_client.delete_analyzer(analyzer_id=source_analyzer_id) - print(f" Source analyzer '{source_analyzer_id}' deleted.") - except Exception: - pass - - try: - await target_client.delete_analyzer(analyzer_id=target_analyzer_id) - print(f" Target analyzer '{target_analyzer_id}' deleted.") - except Exception: - pass + cleanup_source_client = ContentUnderstandingClient(endpoint=source_endpoint, credential=source_credential) + cleanup_target_client = ContentUnderstandingClient(endpoint=target_endpoint, credential=target_credential) + + try: + async with cleanup_source_client, cleanup_target_client: + try: + await cleanup_source_client.delete_analyzer(analyzer_id=source_analyzer_id) + print(f" Source analyzer '{source_analyzer_id}' deleted.") + except Exception: + pass + + try: + await cleanup_target_client.delete_analyzer(analyzer_id=target_analyzer_id) + print(f" Target analyzer '{target_analyzer_id}' deleted.") + except Exception: + pass + except Exception: + pass # [END grant_copy_auth] if not isinstance(source_credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py index 3c6d32006fdc..188e62927ae6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py @@ -154,26 +154,30 @@ def main() -> None: poller.result() print(f" Source analyzer created successfully!") - # Step 2: Grant copy authorization from target - print(f"\nStep 2: Granting copy authorization from target resource...") + # Step 2: Grant copy authorization from source + # Grant authorization on the source client for copying to the target resource + print(f"\nStep 2: Granting copy authorization from source resource...") - copy_auth = target_client.grant_copy_authorization( - analyzer_id=target_analyzer_id, - source_resource_id=source_resource_id, - source_region=source_region, + copy_auth = source_client.grant_copy_authorization( + analyzer_id=source_analyzer_id, + target_azure_resource_id=target_resource_id, + target_region=target_region, ) print(f" Authorization granted!") - print(f" Target Analyzer ID: {copy_auth.analyzer_id}") - print(f" Expires: {copy_auth.expires_on}") + print(f" Target Azure Resource ID: {copy_auth.target_azure_resource_id}") + print(f" Target Region: {target_region}") + print(f" Expires at: {copy_auth.expires_at}") # Step 3: Copy analyzer using authorization + # Copy is performed on the target client, copying from source to target print(f"\nStep 3: Copying analyzer from source to target...") - copy_poller = source_client.begin_copy_analyzer( - target_analyzer_id=target_analyzer_id, + copy_poller = target_client.begin_copy_analyzer( + analyzer_id=target_analyzer_id, source_analyzer_id=source_analyzer_id, - copy_authorization=copy_auth, + source_azure_resource_id=source_resource_id, + source_region=source_region, ) copy_poller.result() print(f" Analyzer copied successfully!") From a30c2380eaa82d2a679fc5f685ec00cab6da749e Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 06:08:04 +0000 Subject: [PATCH 039/105] SDK-GEN: Update with the latest main and also TypeSpec commit --- .../_metadata.json | 6 +- .../apiview-properties.json | 3 +- .../_operations/_operations.py | 82 +----------------- .../azure/ai/contentunderstanding/_patch.py | 1 + .../aio/_operations/_operations.py | 80 +----------------- .../ai/contentunderstanding/aio/_patch.py | 5 +- .../aio/models/__init__.py | 1 - .../contentunderstanding/aio/models/_patch.py | 4 +- .../contentunderstanding/models/__init__.py | 50 +---------- .../ai/contentunderstanding/models/_models.py | 83 +++---------------- .../ai/contentunderstanding/models/_patch.py | 20 +++-- .../sample_analyze_configs_async.py | 24 ++++-- .../sample_analyze_invoice_async.py | 12 ++- .../sample_grant_copy_auth_async.py | 6 +- .../samples/sample_analyze_configs.py | 23 +++-- .../samples/sample_analyze_invoice.py | 16 +++- .../samples/sample_analyze_url.py | 4 +- .../samples/sample_delete_result.py | 4 +- .../samples/sample_grant_copy_auth.py | 4 +- .../tsp-location.yaml | 2 +- 20 files changed, 107 insertions(+), 323 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json index afaae3701e35..3fe24b0cef0d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/_metadata.json @@ -1,7 +1,3 @@ { - "apiVersion": "2025-11-01", - "commit": "88218cd4248be9482eea5100e72814adf5be248b", - "repository_url": "https://github.com/Azure/azure-rest-api-specs", - "typespec_src": "specification/ai/ContentUnderstanding", - "emitterVersion": "0.53.2" + "apiVersion": "2025-11-01" } \ No newline at end of file diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json index adbea869e890..77bb9601d363 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json @@ -13,14 +13,13 @@ "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.ContentCategory": "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.DetectedPerson": "ContentUnderstanding.DetectedPerson", "azure.ai.contentunderstanding.models.DocumentAnnotation": "ContentUnderstanding.DocumentAnnotation", "azure.ai.contentunderstanding.models.DocumentAnnotationComment": "ContentUnderstanding.DocumentAnnotationComment", "azure.ai.contentunderstanding.models.DocumentBarcode": "ContentUnderstanding.DocumentBarcode", diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py index 695524e71c5e..b332a661f32e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py @@ -36,7 +36,6 @@ from .._utils.model_base import SdkJSONEncoder, _deserialize from .._utils.serialization import Serializer from .._utils.utils import ClientMixinABC -from .._validation import api_version_validation JSON = MutableMapping[str, Any] _Unset: Any = object() @@ -134,7 +133,7 @@ def build_content_understanding_copy_analyzer_request( # pylint: disable=name-t accept = _headers.pop("Accept", "application/json") # Construct URL - _url = "/analyzers/{analyzerId}:copy" + _url = "/analyzers/{analyzerId}:copyAnalyzer" path_format_arguments = { "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), } @@ -739,22 +738,6 @@ def get_long_running_output(pipeline_response): self._client, raw_result, get_long_running_output, polling_method # type: ignore ) - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={ - "2025-11-01": [ - "api_version", - "analyzer_id", - "string_encoding", - "processing_location", - "content_type", - "input_range", - "client_request_id", - "accept", - ] - }, - api_versions_list=["2025-11-01"], - ) def _analyze_binary_initial( self, analyzer_id: str, @@ -826,22 +809,6 @@ def _analyze_binary_initial( return deserialized # type: ignore @distributed_trace - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={ - "2025-11-01": [ - "api_version", - "analyzer_id", - "string_encoding", - "processing_location", - "content_type", - "input_range", - "client_request_id", - "accept", - ] - }, - api_versions_list=["2025-11-01"], - ) def begin_analyze_binary( self, analyzer_id: str, @@ -936,13 +903,6 @@ def get_long_running_output(pipeline_response): self._client, raw_result, get_long_running_output, polling_method # type: ignore ) - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={ - "2025-11-01": ["api_version", "analyzer_id", "allow_replace", "client_request_id", "content_type", "accept"] - }, - api_versions_list=["2025-11-01"], - ) def _copy_analyzer_initial( self, analyzer_id: str, @@ -1005,10 +965,7 @@ def _copy_analyzer_initial( response = pipeline_response.http_response - # Accept both 201 (Created) and 202 (Accepted) for copy analyzer operation - # Service currently returns 201 but may return 202 in the future - # This ensures compatibility with both current and future service behavior - if response.status_code not in [201, 202]: + if response.status_code not in [202]: try: response.read() # Load the body in memory and close the socket except (StreamConsumedError, StreamClosedError): @@ -1122,13 +1079,6 @@ def begin_copy_analyzer( """ @distributed_trace - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={ - "2025-11-01": ["api_version", "analyzer_id", "allow_replace", "client_request_id", "content_type", "accept"] - }, - api_versions_list=["2025-11-01"], - ) def begin_copy_analyzer( self, analyzer_id: str, @@ -1225,10 +1175,6 @@ def get_long_running_output(pipeline_response): self._client, raw_result, get_long_running_output, polling_method # type: ignore ) - @api_version_validation( - params_added_on={"2025-11-01": ["allow_replace"]}, - api_versions_list=["2025-05-01-preview", "2025-11-01"], - ) def _create_analyzer_initial( self, analyzer_id: str, @@ -1385,10 +1331,6 @@ def begin_create_analyzer( """ @distributed_trace - @api_version_validation( - params_added_on={"2025-11-01": ["allow_replace"]}, - api_versions_list=["2025-05-01-preview", "2025-11-01"], - ) def begin_create_analyzer( self, analyzer_id: str, @@ -1528,11 +1470,6 @@ def delete_analyzer( # pylint: disable=inconsistent-return-statements return cls(pipeline_response, None, response_headers) # type: ignore @distributed_trace - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={"2025-11-01": ["api_version", "operation_id"]}, - api_versions_list=["2025-11-01"], - ) def delete_result(self, operation_id: str, **kwargs: Any) -> None: # pylint: disable=inconsistent-return-statements """Mark the result of an analysis operation for deletion. @@ -1646,11 +1583,6 @@ def get_analyzer(self, analyzer_id: str, **kwargs: Any) -> _models.ContentAnalyz return deserialized # type: ignore @distributed_trace - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={"2025-11-01": ["api_version", "accept"]}, - api_versions_list=["2025-11-01"], - ) def get_defaults(self, **kwargs: Any) -> _models.ContentUnderstandingDefaults: """Return default settings for this Content Understanding resource. @@ -1962,11 +1894,6 @@ def grant_copy_authorization( """ @distributed_trace - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={"2025-11-01": ["api_version", "analyzer_id", "client_request_id", "content_type", "accept"]}, - api_versions_list=["2025-11-01"], - ) def grant_copy_authorization( self, analyzer_id: str, @@ -2345,11 +2272,6 @@ def update_defaults( """ @distributed_trace - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={"2025-11-01": ["api_version", "content_type", "accept"]}, - api_versions_list=["2025-11-01"], - ) def update_defaults( self, body: Union[JSON, IO[bytes]] = _Unset, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py index 233d6d4e60c8..efb768887c0c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py index 2c295861b551..d740c7601d06 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py @@ -52,7 +52,6 @@ ) from ..._utils.model_base import SdkJSONEncoder, _deserialize from ..._utils.utils import ClientMixinABC -from ..._validation import api_version_validation from .._configuration import ContentUnderstandingClientConfiguration JSON = MutableMapping[str, Any] @@ -349,22 +348,6 @@ def get_long_running_output(pipeline_response): self._client, raw_result, get_long_running_output, polling_method # type: ignore ) - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={ - "2025-11-01": [ - "api_version", - "analyzer_id", - "string_encoding", - "processing_location", - "content_type", - "input_range", - "client_request_id", - "accept", - ] - }, - api_versions_list=["2025-11-01"], - ) async def _analyze_binary_initial( self, analyzer_id: str, @@ -436,22 +419,6 @@ async def _analyze_binary_initial( return deserialized # type: ignore @distributed_trace_async - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={ - "2025-11-01": [ - "api_version", - "analyzer_id", - "string_encoding", - "processing_location", - "content_type", - "input_range", - "client_request_id", - "accept", - ] - }, - api_versions_list=["2025-11-01"], - ) async def begin_analyze_binary( self, analyzer_id: str, @@ -547,13 +514,6 @@ def get_long_running_output(pipeline_response): self._client, raw_result, get_long_running_output, polling_method # type: ignore ) - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={ - "2025-11-01": ["api_version", "analyzer_id", "allow_replace", "client_request_id", "content_type", "accept"] - }, - api_versions_list=["2025-11-01"], - ) async def _copy_analyzer_initial( self, analyzer_id: str, @@ -616,10 +576,7 @@ async def _copy_analyzer_initial( response = pipeline_response.http_response - # Accept both 201 (Created) and 202 (Accepted) for copy analyzer operation - # Service currently returns 201 but may return 202 in the future - # This ensures compatibility with both current and future service behavior - if response.status_code not in [201, 202]: + if response.status_code not in [202]: try: await response.read() # Load the body in memory and close the socket except (StreamConsumedError, StreamClosedError): @@ -736,13 +693,6 @@ async def begin_copy_analyzer( """ @distributed_trace_async - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={ - "2025-11-01": ["api_version", "analyzer_id", "allow_replace", "client_request_id", "content_type", "accept"] - }, - api_versions_list=["2025-11-01"], - ) async def begin_copy_analyzer( self, analyzer_id: str, @@ -841,10 +791,6 @@ def get_long_running_output(pipeline_response): self._client, raw_result, get_long_running_output, polling_method # type: ignore ) - @api_version_validation( - params_added_on={"2025-11-01": ["allow_replace"]}, - api_versions_list=["2025-05-01-preview", "2025-11-01"], - ) async def _create_analyzer_initial( self, analyzer_id: str, @@ -1004,10 +950,6 @@ async def begin_create_analyzer( """ @distributed_trace_async - @api_version_validation( - params_added_on={"2025-11-01": ["allow_replace"]}, - api_versions_list=["2025-05-01-preview", "2025-11-01"], - ) async def begin_create_analyzer( self, analyzer_id: str, @@ -1147,11 +1089,6 @@ async def delete_analyzer(self, analyzer_id: str, **kwargs: Any) -> None: return cls(pipeline_response, None, response_headers) # type: ignore @distributed_trace_async - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={"2025-11-01": ["api_version", "operation_id"]}, - api_versions_list=["2025-11-01"], - ) async def delete_result(self, operation_id: str, **kwargs: Any) -> None: """Mark the result of an analysis operation for deletion. @@ -1265,11 +1202,6 @@ async def get_analyzer(self, analyzer_id: str, **kwargs: Any) -> _models.Content return deserialized # type: ignore @distributed_trace_async - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={"2025-11-01": ["api_version", "accept"]}, - api_versions_list=["2025-11-01"], - ) async def get_defaults(self, **kwargs: Any) -> _models.ContentUnderstandingDefaults: """Return default settings for this Content Understanding resource. @@ -1581,11 +1513,6 @@ async def grant_copy_authorization( """ @distributed_trace_async - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={"2025-11-01": ["api_version", "analyzer_id", "client_request_id", "content_type", "accept"]}, - api_versions_list=["2025-11-01"], - ) async def grant_copy_authorization( self, analyzer_id: str, @@ -1965,11 +1892,6 @@ async def update_defaults( """ @distributed_trace_async - @api_version_validation( - method_added_on="2025-11-01", - params_added_on={"2025-11-01": ["api_version", "content_type", "accept"]}, - api_versions_list=["2025-11-01"], - ) async def update_defaults( self, body: Union[JSON, IO[bytes]] = _Unset, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py index e2f5dea5539f..06dd013b7818 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. @@ -279,9 +280,7 @@ async def begin_analyze_binary( poller._polling_method, # pylint: disable=protected-access ) - async def send_request( - self, request: HttpRequest, *, stream: bool = False, **kwargs: Any - ) -> AsyncHttpResponse: + async def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> AsyncHttpResponse: """Runs the network request through the client's chained policies. >>> from azure.core.rest import HttpRequest diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/__init__.py index a9093967c884..8eef93e0a170 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/__init__.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/__init__.py @@ -8,4 +8,3 @@ from ._patch import AnalyzeAsyncLROPoller __all__ = ["AnalyzeAsyncLROPoller"] - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py index e58438817384..27d014d5c2a2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. @@ -44,7 +45,7 @@ class AnalyzeAsyncLROPoller(AsyncLROPoller[PollingReturnType_co]): @property def operation_id(self) -> str: """Returns the operation ID for this long-running operation. - + The operation ID can be used with get_result_file() to retrieve intermediate or final result files from the service. @@ -94,4 +95,3 @@ def patch_sdk(): :return: None :rtype: None """ - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py index cc6c3d11c00c..c1fe5cd4fbf0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py @@ -7,52 +7,10 @@ # -------------------------------------------------------------------------- # pylint: disable=wrong-import-position -from typing import TYPE_CHECKING, Optional, Any, List, Dict, Union +from typing import TYPE_CHECKING if TYPE_CHECKING: from ._patch import * # pylint: disable=unused-wildcard-import - - # Type stubs for .value property on field classes - # These override the imported classes during type checking to add .value property signatures - class ContentField(ContentField): # type: ignore[no-redef] - @property - def value(self) -> Union[Optional[str], Optional[int], Optional[float], Optional[bool], Optional[List[Any]], Optional[Dict[str, Any]], Optional[Any]]: ... - - class StringField(StringField): # type: ignore[no-redef] - @property - def value(self) -> Optional[str]: ... - - class IntegerField(IntegerField): # type: ignore[no-redef] - @property - def value(self) -> Optional[int]: ... - - class NumberField(NumberField): # type: ignore[no-redef] - @property - def value(self) -> Optional[float]: ... - - class BooleanField(BooleanField): # type: ignore[no-redef] - @property - def value(self) -> Optional[bool]: ... - - class DateField(DateField): # type: ignore[no-redef] - @property - def value(self) -> Optional[str]: ... - - class TimeField(TimeField): # type: ignore[no-redef] - @property - def value(self) -> Optional[str]: ... - - class ArrayField(ArrayField): # type: ignore[no-redef] - @property - def value(self) -> Optional[List[ContentField]]: ... - - class ObjectField(ObjectField): # type: ignore[no-redef] - @property - def value(self) -> Optional[Dict[str, ContentField]]: ... - - class JsonField(JsonField): # type: ignore[no-redef] - @property - def value(self) -> Optional[Any]: ... from ._models import ( # type: ignore @@ -66,7 +24,7 @@ def value(self) -> Optional[Any]: ... ContentAnalyzerAnalyzeOperationStatus, ContentAnalyzerConfig, ContentAnalyzerOperationStatus, - ContentCategoryDefinition, + ContentCategory, ContentField, ContentFieldDefinition, ContentFieldSchema, @@ -74,7 +32,6 @@ def value(self) -> Optional[Any]: ... ContentUnderstandingDefaults, CopyAuthorization, DateField, - DetectedPerson, DocumentAnnotation, DocumentAnnotationComment, DocumentBarcode, @@ -143,7 +100,7 @@ def value(self) -> Optional[Any]: ... "ContentAnalyzerAnalyzeOperationStatus", "ContentAnalyzerConfig", "ContentAnalyzerOperationStatus", - "ContentCategoryDefinition", + "ContentCategory", "ContentField", "ContentFieldDefinition", "ContentFieldSchema", @@ -151,7 +108,6 @@ def value(self) -> Optional[Any]: ... "ContentUnderstandingDefaults", "CopyAuthorization", "DateField", - "DetectedPerson", "DocumentAnnotation", "DocumentAnnotationComment", "DocumentBarcode", diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py index c745388db82d..4a49c6fbad9a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py @@ -402,14 +402,6 @@ def __init__(self, mapping: Mapping[str, Any]) -> None: """ def __init__(self, *args: Any, **kwargs: Any) -> None: - # Workaround for service bug: keyFrameTimesMs is returned as KeyFrameTimesMs - # Fix the incorrect casing before calling parent __init__ - if args and isinstance(args[0], Mapping): - mapping = dict(args[0]) - if "KeyFrameTimesMs" in mapping and "keyFrameTimesMs" not in mapping: - mapping["keyFrameTimesMs"] = mapping.pop("KeyFrameTimesMs") - args = (mapping,) + args[1:] - super().__init__(*args, **kwargs) self.kind = MediaContentKind.AUDIO_VISUAL # type: ignore @@ -701,8 +693,7 @@ class ContentAnalyzerConfig(_Model): :ivar estimate_field_source_and_confidence: Return field grounding source and confidence. :vartype estimate_field_source_and_confidence: bool :ivar content_categories: Map of categories to classify the input content(s) against. - :vartype content_categories: dict[str, - ~azure.ai.contentunderstanding.models.ContentCategoryDefinition] + :vartype content_categories: dict[str, ~azure.ai.contentunderstanding.models.ContentCategory] :ivar enable_segment: Enable segmentation of the input by contentCategories. :vartype enable_segment: bool :ivar segment_per_page: Force segmentation of document content by page. @@ -761,7 +752,7 @@ class ContentAnalyzerConfig(_Model): name="estimateFieldSourceAndConfidence", visibility=["read", "create", "update", "delete", "query"] ) """Return field grounding source and confidence.""" - content_categories: Optional[dict[str, "_models.ContentCategoryDefinition"]] = rest_field( + content_categories: Optional[dict[str, "_models.ContentCategory"]] = rest_field( name="contentCategories", visibility=["read", "create", "update", "delete", "query"] ) """Map of categories to classify the input content(s) against.""" @@ -795,7 +786,7 @@ def __init__( annotation_format: Optional[Union[str, "_models.AnnotationFormat"]] = None, disable_face_blurring: Optional[bool] = None, estimate_field_source_and_confidence: Optional[bool] = None, - content_categories: Optional[dict[str, "_models.ContentCategoryDefinition"]] = None, + content_categories: Optional[dict[str, "_models.ContentCategory"]] = None, enable_segment: Optional[bool] = None, segment_per_page: Optional[bool] = None, omit_content: Optional[bool] = None, @@ -864,7 +855,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None: super().__init__(*args, **kwargs) -class ContentCategoryDefinition(_Model): +class ContentCategory(_Model): """Content category definition. :ivar description: The description of the category. @@ -1198,46 +1189,6 @@ def __init__(self, *args: Any, **kwargs: Any) -> None: self.field_type = ContentFieldType.DATE # type: ignore -class DetectedPerson(_Model): - """Detected person. - - :ivar person_id: Person identifier in the optional person directory if found. Otherwise, each - unknown person is assigned a unique ``Person-{Number}``. - :vartype person_id: str - :ivar confidence: Confidence of the person identification, if a person directory is provided. - :vartype confidence: float - :ivar source: Encoded source that identifies the position of the person in the input content. - :vartype source: str - """ - - person_id: Optional[str] = rest_field(name="personId", visibility=["read", "create", "update", "delete", "query"]) - """Person identifier in the optional person directory if found. Otherwise, each unknown person is - assigned a unique ``Person-{Number}``.""" - confidence: Optional[float] = rest_field(visibility=["read", "create", "update", "delete", "query"]) - """Confidence of the person identification, if a person directory is provided.""" - source: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) - """Encoded source that identifies the position of the person in the input content.""" - - @overload - def __init__( - self, - *, - person_id: Optional[str] = None, - confidence: Optional[float] = None, - source: Optional[str] = None, - ) -> None: ... - - @overload - def __init__(self, mapping: Mapping[str, Any]) -> None: - """ - :param mapping: raw JSON to initialize the model. - :type mapping: Mapping[str, Any] - """ - - def __init__(self, *args: Any, **kwargs: Any) -> None: - super().__init__(*args, **kwargs) - - class DocumentAnnotation(_Model): """Annotation in a document, such as a strikethrough or a comment. @@ -1572,13 +1523,13 @@ class DocumentChartFigure(DocumentFigure, discriminator="chart"): :vartype kind: str or ~azure.ai.contentunderstanding.models.CHART :ivar content: Chart content represented using `Chart.js config `_. Required. - :vartype content: any + :vartype content: dict[str, any] """ kind: Literal[DocumentFigureKind.CHART] = rest_discriminator(name="kind", visibility=["read", "create", "update", "delete", "query"]) # type: ignore """Figure kind. Required. Figure containing a chart, such as a bar chart, line chart, or pie chart.""" - content: Any = rest_field(visibility=["read", "create", "update", "delete", "query"]) + content: dict[str, Any] = rest_field(visibility=["read", "create", "update", "delete", "query"]) """Chart content represented using `Chart.js config `_. Required.""" @@ -1587,7 +1538,7 @@ def __init__( self, *, id: str, # pylint: disable=redefined-builtin - content: Any, + content: dict[str, Any], source: Optional[str] = None, span: Optional["_models.ContentSpan"] = None, elements: Optional[list[str]] = None, @@ -1648,9 +1599,6 @@ class DocumentContent(MediaContent, discriminator="document"): :ivar figures: List of figures in the document. Only if enableLayout and returnDetails are true. :vartype figures: list[~azure.ai.contentunderstanding.models.DocumentFigure] - :ivar persons: List of detected persons in the document. Only if enableFace and returnDetails - are true. - :vartype persons: list[~azure.ai.contentunderstanding.models.DetectedPerson] :ivar annotations: List of annotations in the document. Only if enableAnnotations and returnDetails are true. :vartype annotations: list[~azure.ai.contentunderstanding.models.DocumentAnnotation] @@ -1694,10 +1642,6 @@ class DocumentContent(MediaContent, discriminator="document"): visibility=["read", "create", "update", "delete", "query"] ) """List of figures in the document. Only if enableLayout and returnDetails are true.""" - persons: Optional[list["_models.DetectedPerson"]] = rest_field( - visibility=["read", "create", "update", "delete", "query"] - ) - """List of detected persons in the document. Only if enableFace and returnDetails are true.""" annotations: Optional[list["_models.DocumentAnnotation"]] = rest_field( visibility=["read", "create", "update", "delete", "query"] ) @@ -1729,7 +1673,6 @@ def __init__( sections: Optional[list["_models.DocumentSection"]] = None, tables: Optional[list["_models.DocumentTable"]] = None, figures: Optional[list["_models.DocumentFigure"]] = None, - persons: Optional[list["_models.DetectedPerson"]] = None, annotations: Optional[list["_models.DocumentAnnotation"]] = None, hyperlinks: Optional[list["_models.DocumentHyperlink"]] = None, segments: Optional[list["_models.DocumentContentSegment"]] = None, @@ -2726,22 +2669,22 @@ class SupportedModels(_Model): """Chat completion and embedding models supported by the analyzer. :ivar completion: Chat completion models supported by the analyzer. Required. - :vartype completion: dict[str, str] + :vartype completion: list[str] :ivar embedding: Embedding models supported by the analyzer. Required. - :vartype embedding: dict[str, str] + :vartype embedding: list[str] """ - completion: dict[str, str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + completion: list[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) """Chat completion models supported by the analyzer. Required.""" - embedding: dict[str, str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + embedding: list[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) """Embedding models supported by the analyzer. Required.""" @overload def __init__( self, *, - completion: dict[str, str], - embedding: dict[str, str], + completion: list[str], + embedding: list[str], ) -> None: ... @overload diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index 0688f9193388..aa2a50d5dc1a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. @@ -72,7 +73,7 @@ class AnalyzeLROPoller(LROPoller[PollingReturnType_co]): @property def operation_id(self) -> str: """Returns the operation ID for this long-running operation. - + The operation ID can be used with get_result_file() to retrieve intermediate or final result files from the service. @@ -138,15 +139,24 @@ def patch_sdk(): _add_value_property_to_field(ArrayField, "value_array") _add_value_property_to_field(ObjectField, "value_object") _add_value_property_to_field(JsonField, "value_json") - + # Add dynamic .value to ContentField base class # This checks which value_* attribute exists and returns it def _content_field_value_getter(self) -> Any: """Get the value of this field regardless of its specific type.""" - for attr in ['value_string', 'value_integer', 'value_number', 'value_boolean', - 'value_date', 'value_time', 'value_array', 'value_object', 'value_json']: + for attr in [ + "value_string", + "value_integer", + "value_number", + "value_boolean", + "value_date", + "value_time", + "value_array", + "value_object", + "value_json", + ]: if hasattr(self, attr): return getattr(self, attr) return None - + setattr(ContentField, "value", property(_content_field_value_getter)) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index 805976412c81..72717104ff22 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -84,16 +84,18 @@ async def main() -> None: if document_content.figures and len(document_content.figures) > 0: # Filter for chart figures chart_figures = [ - f for f in document_content.figures - if isinstance(f, DocumentChartFigure) or (hasattr(f, 'kind') and f.kind == DocumentFigureKind.CHART) + f + for f in document_content.figures + if isinstance(f, DocumentChartFigure) + or (hasattr(f, "kind") and f.kind == DocumentFigureKind.CHART) ] print(f"\nFound {len(chart_figures)} chart(s)") for chart in chart_figures: print(f" Chart ID: {chart.id}") - if hasattr(chart, 'description') and chart.description: + if hasattr(chart, "description") and chart.description: print(f" Description: {chart.description}") - if hasattr(chart, 'caption') and chart.caption and chart.caption.content: + if hasattr(chart, "caption") and chart.caption and chart.caption.content: print(f" Caption: {chart.caption.content}") else: print("\nNo figures found in the document.") @@ -127,14 +129,14 @@ async def main() -> None: all_formulas = [] if document_content.pages: for page in document_content.pages: - if hasattr(page, 'formulas') and page.formulas: + if hasattr(page, "formulas") and page.formulas: all_formulas.extend(page.formulas) if len(all_formulas) > 0: print(f"\nFound {len(all_formulas)} formula(s)") for formula in all_formulas: print(f" Formula: {formula.value or '(no value)'}") - if hasattr(formula, 'kind') and formula.kind: + if hasattr(formula, "kind") and formula.kind: print(f" Kind: {formula.kind}") else: print("\nNo formulas found in the document.") @@ -147,14 +149,18 @@ async def main() -> None: if content.kind == MediaContentKind.DOCUMENT: document_content: DocumentContent = content # type: ignore - if hasattr(document_content, 'annotations') and document_content.annotations and len(document_content.annotations) > 0: + if ( + hasattr(document_content, "annotations") + and document_content.annotations + and len(document_content.annotations) > 0 + ): print(f"\nFound {len(document_content.annotations)} annotation(s)") for annotation in document_content.annotations: print(f" Annotation ID: {annotation.id}") print(f" Kind: {annotation.kind}") - if hasattr(annotation, 'author') and annotation.author: + if hasattr(annotation, "author") and annotation.author: print(f" Author: {annotation.author}") - if hasattr(annotation, 'comments') and annotation.comments and len(annotation.comments) > 0: + if hasattr(annotation, "comments") and annotation.comments and len(annotation.comments) > 0: print(f" Comments: {len(annotation.comments)}") for comment in annotation.comments: print(f" - {comment.message}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index 5d80dde7c632..db74e32701b8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -97,7 +97,11 @@ async def main() -> None: print(f"Customer Name: {customer_name or '(None)'}") if customer_name_field: - print(f" Confidence: {customer_name_field.confidence:.2f}" if customer_name_field.confidence else " Confidence: N/A") + print( + f" Confidence: {customer_name_field.confidence:.2f}" + if customer_name_field.confidence + else " Confidence: N/A" + ) # Source is an encoded identifier containing bounding box coordinates # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) print(f" Source: {customer_name_field.source or 'N/A'}") @@ -107,7 +111,11 @@ async def main() -> None: print(f"Invoice Date: {invoice_date or '(None)'}") if invoice_date_field: - print(f" Confidence: {invoice_date_field.confidence:.2f}" if invoice_date_field.confidence else " Confidence: N/A") + print( + f" Confidence: {invoice_date_field.confidence:.2f}" + if invoice_date_field.confidence + else " Confidence: N/A" + ) # Extract object field (TotalAmount contains Amount and CurrencyCode) total_amount_field = document_content.fields.get("TotalAmount") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py index f1c2229bc35f..aabffab9f2a4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py @@ -78,7 +78,9 @@ async def main() -> None: print(f" - {var}") print("\nPlease set these environment variables and try again.") print("\nExample resource ID format:") - print(" /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name}") + print( + " /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name}" + ) return # [START grant_copy_auth] @@ -196,7 +198,7 @@ async def main() -> None: print(f"\nCleaning up...") cleanup_source_client = ContentUnderstandingClient(endpoint=source_endpoint, credential=source_credential) cleanup_target_client = ContentUnderstandingClient(endpoint=target_endpoint, credential=target_credential) - + try: async with cleanup_source_client, cleanup_target_client: try: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index 52a42e977777..faf0204c8f2d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -84,16 +84,17 @@ def main() -> None: if document_content.figures and len(document_content.figures) > 0: # Filter for chart figures chart_figures = [ - f for f in document_content.figures - if isinstance(f, DocumentChartFigure) or (hasattr(f, 'kind') and f.kind == DocumentFigureKind.CHART) + f + for f in document_content.figures + if isinstance(f, DocumentChartFigure) or (hasattr(f, "kind") and f.kind == DocumentFigureKind.CHART) ] print(f"\nFound {len(chart_figures)} chart(s)") for chart in chart_figures: print(f" Chart ID: {chart.id}") - if hasattr(chart, 'description') and chart.description: + if hasattr(chart, "description") and chart.description: print(f" Description: {chart.description}") - if hasattr(chart, 'caption') and chart.caption and chart.caption.content: + if hasattr(chart, "caption") and chart.caption and chart.caption.content: print(f" Caption: {chart.caption.content}") else: print("\nNo figures found in the document.") @@ -127,14 +128,14 @@ def main() -> None: all_formulas = [] if document_content.pages: for page in document_content.pages: - if hasattr(page, 'formulas') and page.formulas: + if hasattr(page, "formulas") and page.formulas: all_formulas.extend(page.formulas) if len(all_formulas) > 0: print(f"\nFound {len(all_formulas)} formula(s)") for formula in all_formulas: print(f" Formula: {formula.value or '(no value)'}") - if hasattr(formula, 'kind') and formula.kind: + if hasattr(formula, "kind") and formula.kind: print(f" Kind: {formula.kind}") else: print("\nNo formulas found in the document.") @@ -147,14 +148,18 @@ def main() -> None: if content.kind == MediaContentKind.DOCUMENT: document_content: DocumentContent = content # type: ignore - if hasattr(document_content, 'annotations') and document_content.annotations and len(document_content.annotations) > 0: + if ( + hasattr(document_content, "annotations") + and document_content.annotations + and len(document_content.annotations) > 0 + ): print(f"\nFound {len(document_content.annotations)} annotation(s)") for annotation in document_content.annotations: print(f" Annotation ID: {annotation.id}") print(f" Kind: {annotation.kind}") - if hasattr(annotation, 'author') and annotation.author: + if hasattr(annotation, "author") and annotation.author: print(f" Author: {annotation.author}") - if hasattr(annotation, 'comments') and annotation.comments and len(annotation.comments) > 0: + if hasattr(annotation, "comments") and annotation.comments and len(annotation.comments) > 0: print(f" Comments: {len(annotation.comments)}") for comment in annotation.comments: print(f" - {comment.message}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index d4b947489160..96eba0cd11b5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -55,7 +55,9 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_invoice] - invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + invoice_url = ( + "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + ) print(f"Analyzing invoice with prebuilt-invoice analyzer...") print(f" URL: {invoice_url}") @@ -97,7 +99,11 @@ def main() -> None: print(f"Customer Name: {customer_name or '(None)'}") if customer_name_field: - print(f" Confidence: {customer_name_field.confidence:.2f}" if customer_name_field.confidence else " Confidence: N/A") + print( + f" Confidence: {customer_name_field.confidence:.2f}" + if customer_name_field.confidence + else " Confidence: N/A" + ) # Source is an encoded identifier containing bounding box coordinates # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) print(f" Source: {customer_name_field.source or 'N/A'}") @@ -107,7 +113,11 @@ def main() -> None: print(f"Invoice Date: {invoice_date or '(None)'}") if invoice_date_field: - print(f" Confidence: {invoice_date_field.confidence:.2f}" if invoice_date_field.confidence else " Confidence: N/A") + print( + f" Confidence: {invoice_date_field.confidence:.2f}" + if invoice_date_field.confidence + else " Confidence: N/A" + ) # Extract object field (TotalAmount contains Amount and CurrencyCode) total_amount_field = document_content.fields.get("TotalAmount") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py index abfe36e0b031..28a46db9cccd 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py @@ -49,7 +49,9 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_document_from_url] - document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + document_url = ( + "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + ) print(f"Analyzing document from URL with prebuilt-documentSearch...") print(f" URL: {document_url}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index 4207e385da4c..e7d18df54d96 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -56,7 +56,9 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_and_delete_result] - document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + document_url = ( + "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + ) print("Document Analysis Workflow") print("=" * 60) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py index 188e62927ae6..78b71abd1c8b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py @@ -77,7 +77,9 @@ def main() -> None: print(f" - {var}") print("\nPlease set these environment variables and try again.") print("\nExample resource ID format:") - print(" /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name}") + print( + " /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name}" + ) return # [START grant_copy_auth] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml index ebb0da02b4dd..b45f7d5ee721 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml @@ -1,4 +1,4 @@ directory: specification/ai/ContentUnderstanding -commit: 88218cd4248be9482eea5100e72814adf5be248b +commit: e14eec8796b4d481a942a41e103881589ec648d8 repo: Azure/azure-rest-api-specs additionalDirectories: From 6007490f90ac5896be556fd2931e36521588a5c9 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 06:09:16 +0000 Subject: [PATCH 040/105] SDK-FIX: Fix copyAnalyzer path issue, and work around service issue that returns 201 for copy --- .../_operations/_patch.py | 142 ++++++++++++++++-- .../aio/_operations/_patch.py | 131 ++++++++++++++-- .../sample_create_classifier_async.py | 8 +- .../samples/sample_copy_analyzer.py | 5 - .../samples/sample_create_classifier.py | 8 +- 5 files changed, 263 insertions(+), 31 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index cc86db4005cf..63cf3c01da8f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -6,19 +6,143 @@ # -------------------------------------------------------------------------- """Customize generated code here. -Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +SDK-FIX: Fix copy analyzer endpoint path and status code handling. +- URL path: Change from ":copyAnalyzer" to ":copy" (emitter generates wrong endpoint path) +- Status codes: Accept both 201 and 202 (service inconsistently returns both status codes) """ -__all__: list[str] = [] # Add all objects you want publicly available to users at this package level +from typing import Any, Optional, Union, IO, Iterator +from azure.core.rest import HttpRequest +from azure.core.exceptions import ( + ClientAuthenticationError, + HttpResponseError, + ResourceExistsError, + ResourceNotFoundError, + ResourceNotModifiedError, + StreamClosedError, + StreamConsumedError, + map_error, +) +from azure.core.pipeline import PipelineResponse +from azure.core.utils import case_insensitive_dict +from collections.abc import MutableMapping +from io import IOBase +import json + +__all__: list[str] = [] def patch_sdk(): - """Do not remove from this file. + """Patch the SDK to fix copy analyzer operations. + + This function: + 1. Replaces build_content_understanding_copy_analyzer_request to fix URL path + 2. Wraps _copy_analyzer_initial method to accept both 201 and 202 status codes + """ + from . import _operations + + # 1. SDK-FIX: Fix URL path from ":copyAnalyzer" to ":copy" + _original_build_request = _operations.build_content_understanding_copy_analyzer_request + + def _patched_build_content_understanding_copy_analyzer_request( + analyzer_id: str, *, allow_replace: Optional[bool] = None, **kwargs: Any + ) -> HttpRequest: + """Patched version that uses correct endpoint path :copy instead of :copyAnalyzer.""" + request = _original_build_request(analyzer_id, allow_replace=allow_replace, **kwargs) + # Fix the URL path + if ":copyAnalyzer" in request.url: + request.url = request.url.replace(":copyAnalyzer", ":copy") + return request + + _operations.build_content_understanding_copy_analyzer_request = _patched_build_content_understanding_copy_analyzer_request + + # 2. SDK-FIX: Wrap _copy_analyzer_initial to accept both 201 and 202 status codes + _original_copy_initial = _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial + + def _patched_copy_analyzer_initial( + self, + analyzer_id: str, + body: Union[_operations.JSON, IO[bytes]] = _operations._Unset, + *, + source_analyzer_id: str = _operations._Unset, + allow_replace: Optional[bool] = None, + source_azure_resource_id: Optional[str] = None, + source_region: Optional[str] = None, + **kwargs: Any + ) -> Iterator[bytes]: + """Patched version that accepts both 201 and 202 status codes.""" + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) - `patch_sdk` is a last resort escape hatch that allows you to do customizations - you can't accomplish using the techniques described in - https://aka.ms/azsdk/python/dpcodegen/python/customize + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} - :return: None - :rtype: None - """ + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: _operations.ClsType[Iterator[bytes]] = kwargs.pop("cls", None) + + if body is _operations._Unset: + if source_analyzer_id is _operations._Unset: + raise TypeError("missing required argument: source_analyzer_id") + body = { + "sourceAnalyzerId": source_analyzer_id, + "sourceAzureResourceId": source_azure_resource_id, + "sourceRegion": source_region, + } + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + from .._utils.model_base import SdkJSONEncoder + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = _operations.build_content_understanding_copy_analyzer_request( + analyzer_id=analyzer_id, + allow_replace=allow_replace, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + # SDK-FIX: Accept both 201 and 202 (service inconsistently returns both status codes) + if response.status_code not in [201, 202]: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = _patched_copy_analyzer_initial diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index cc86db4005cf..e39a73f85661 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -6,19 +6,132 @@ # -------------------------------------------------------------------------- """Customize generated code here. -Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize +SDK-FIX: Fix copy analyzer endpoint path and status code handling for async operations. +- URL path: Change from ":copyAnalyzer" to ":copy" (emitter generates wrong endpoint path) +- Status codes: Accept both 201 and 202 (service inconsistently returns both status codes) """ -__all__: list[str] = [] # Add all objects you want publicly available to users at this package level +from typing import Any, Optional, Union, IO, AsyncIterator +from azure.core.rest import HttpRequest +from azure.core.exceptions import ( + ClientAuthenticationError, + HttpResponseError, + ResourceExistsError, + ResourceNotFoundError, + ResourceNotModifiedError, + StreamClosedError, + StreamConsumedError, + map_error, +) +from azure.core.pipeline import PipelineResponse +from azure.core.utils import case_insensitive_dict +from collections.abc import MutableMapping +from io import IOBase +import json + +__all__: list[str] = [] def patch_sdk(): - """Do not remove from this file. + """Patch the SDK to fix async copy analyzer operations. + + This function: + 1. Uses the patched build_content_understanding_copy_analyzer_request (from sync operations) + 2. Wraps _copy_analyzer_initial method to accept both 201 and 202 status codes + """ + from ..._operations import _operations as sync_operations + from . import _operations + + # Note: The request builder is shared between sync and async, so it's already patched + # by the sync _patch.py. We just need to patch the async _copy_analyzer_initial method. + + # SDK-FIX: Wrap _copy_analyzer_initial to accept both 201 and 202 status codes + _original_copy_initial = _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial + + async def _patched_copy_analyzer_initial( + self, + analyzer_id: str, + body: Union[_operations.JSON, IO[bytes]] = _operations._Unset, + *, + source_analyzer_id: str = _operations._Unset, + allow_replace: Optional[bool] = None, + source_azure_resource_id: Optional[str] = None, + source_region: Optional[str] = None, + **kwargs: Any + ) -> AsyncIterator[bytes]: + """Patched version that accepts both 201 and 202 status codes.""" + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) - `patch_sdk` is a last resort escape hatch that allows you to do customizations - you can't accomplish using the techniques described in - https://aka.ms/azsdk/python/dpcodegen/python/customize + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = kwargs.pop("params", {}) or {} - :return: None - :rtype: None - """ + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: _operations.ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) + + if body is _operations._Unset: + if source_analyzer_id is _operations._Unset: + raise TypeError("missing required argument: source_analyzer_id") + body = { + "sourceAnalyzerId": source_analyzer_id, + "sourceAzureResourceId": source_azure_resource_id, + "sourceRegion": source_region, + } + body = {k: v for k, v in body.items() if v is not None} + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + from ..._utils.model_base import SdkJSONEncoder + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = sync_operations.build_content_understanding_copy_analyzer_request( + analyzer_id=analyzer_id, + allow_replace=allow_replace, + content_type=content_type, + api_version=self._config.api_version, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = True + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + # SDK-FIX: Accept both 201 and 202 (service inconsistently returns both status codes) + if response.status_code not in [201, 202]: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + raise HttpResponseError(response=response) + + response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) + + deserialized = response.iter_bytes() + + if cls: + return cls(pipeline_response, deserialized, response_headers) # type: ignore + + return deserialized # type: ignore + + _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = _patched_copy_analyzer_initial diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index e2dba8e5a565..b193e53f1b60 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -37,7 +37,7 @@ from azure.ai.contentunderstanding.models import ( ContentAnalyzer, ContentAnalyzerConfig, - ContentCategoryDefinition, + ContentCategory, AnalyzeResult, DocumentContent, MediaContentKind, @@ -62,17 +62,17 @@ async def main() -> None: # Define content categories for classification categories = { - "Loan_Application": ContentCategoryDefinition( + "Loan_Application": ContentCategory( description="Documents submitted by individuals or businesses to request funding, " "typically including personal or business details, financial history, " "loan amount, purpose, and supporting documentation." ), - "Invoice": ContentCategoryDefinition( + "Invoice": ContentCategory( description="Billing documents issued by sellers or service providers to request " "payment for goods or services, detailing items, prices, taxes, totals, " "and payment terms." ), - "Bank_Statement": ContentCategoryDefinition( + "Bank_Statement": ContentCategory( description="Official statements issued by banks that summarize account activity " "over a period, including deposits, withdrawals, fees, and balances." ), diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py index 566dd2975a78..8875f5b3a566 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py @@ -153,10 +153,5 @@ def main() -> None: # [END delete_copied_analyzers] -if __name__ == "__main__": - main() -# [END ContentUnderstandingDeleteCopiedAnalyzers] - - if __name__ == "__main__": main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index cfac509f2491..2d4b2b7be9b8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -36,7 +36,7 @@ from azure.ai.contentunderstanding.models import ( ContentAnalyzer, ContentAnalyzerConfig, - ContentCategoryDefinition, + ContentCategory, AnalyzeResult, DocumentContent, MediaContentKind, @@ -62,17 +62,17 @@ def main() -> None: # Define content categories for classification categories = { - "Loan_Application": ContentCategoryDefinition( + "Loan_Application": ContentCategory( description="Documents submitted by individuals or businesses to request funding, " "typically including personal or business details, financial history, " "loan amount, purpose, and supporting documentation." ), - "Invoice": ContentCategoryDefinition( + "Invoice": ContentCategory( description="Billing documents issued by sellers or service providers to request " "payment for goods or services, detailing items, prices, taxes, totals, " "and payment terms." ), - "Bank_Statement": ContentCategoryDefinition( + "Bank_Statement": ContentCategory( description="Official statements issued by banks that summarize account activity " "over a period, including deposits, withdrawals, fees, and balances." ), From 34b648e921bb04fb9e777e80cafced65e6ea9a0d Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 07:00:57 +0000 Subject: [PATCH 041/105] SERVICE-FIX: Work around service bug of returning "KeyFrameTimesMs" --- .../ai/contentunderstanding/models/_patch.py | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index aa2a50d5dc1a..8369e23d2162 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -160,3 +160,28 @@ def _content_field_value_getter(self) -> Any: return None setattr(ContentField, "value", property(_content_field_value_getter)) + + # SDK-FIX: Patch AudioVisualContent.__init__ to handle KeyFrameTimesMs casing inconsistency + # The service returns "KeyFrameTimesMs" (capital K) but TypeSpec defines "keyFrameTimesMs" (lowercase k) + # This fix is forward compatible: if the service fixes the issue and returns "keyFrameTimesMs" correctly, + # the patch will be a no-op and the correct value will pass through unchanged. + _original_audio_visual_content_init = _models.AudioVisualContent.__init__ + + def _patched_audio_visual_content_init(self, *args: Any, **kwargs: Any) -> None: + """Patched __init__ that normalizes casing for KeyFrameTimesMs before calling parent. + + This patch is forward compatible: it only normalizes when the service returns incorrect casing. + If the service returns the correct "keyFrameTimesMs" casing, the patch does nothing. + """ + # If first arg is a dict (mapping), normalize the casing + if args and isinstance(args[0], dict): + mapping = dict(args[0]) # Make a copy + # SDK-FIX: Handle both "keyFrameTimesMs" (TypeSpec) and "KeyFrameTimesMs" (service response) + # Forward compatible: only normalizes if incorrect casing exists and correct casing doesn't + if "KeyFrameTimesMs" in mapping and "keyFrameTimesMs" not in mapping: + mapping["keyFrameTimesMs"] = mapping["KeyFrameTimesMs"] + # Call original with normalized mapping + args = (mapping,) + args[1:] + _original_audio_visual_content_init(self, *args, **kwargs) + + _models.AudioVisualContent.__init__ = _patched_audio_visual_content_init # type: ignore[assignment] From 43c25c3849f37afe9141962687cbf51049b2ef57 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 07:05:02 +0000 Subject: [PATCH 042/105] TEST: Removed bogus generated tests --- .../generated_tests/conftest.py | 45 --- .../test_content_understanding.py | 301 ----------------- .../test_content_understanding_async.py | 310 ------------------ .../generated_tests/testpreparer.py | 28 -- .../generated_tests/testpreparer_async.py | 20 -- 5 files changed, 704 deletions(-) delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/conftest.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer.py delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/conftest.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/conftest.py deleted file mode 100644 index ebb1cc0e636a..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/conftest.py +++ /dev/null @@ -1,45 +0,0 @@ -# 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. -# -------------------------------------------------------------------------- -import os -import pytest -from dotenv import load_dotenv -from devtools_testutils import ( - test_proxy, - add_general_regex_sanitizer, - add_body_key_sanitizer, - add_header_regex_sanitizer, -) - -load_dotenv() - - -# For security, please avoid record sensitive identity information in recordings -@pytest.fixture(scope="session", autouse=True) -def add_sanitizers(test_proxy): - contentunderstanding_subscription_id = os.environ.get( - "CONTENTUNDERSTANDING_SUBSCRIPTION_ID", "00000000-0000-0000-0000-000000000000" - ) - contentunderstanding_tenant_id = os.environ.get( - "CONTENTUNDERSTANDING_TENANT_ID", "00000000-0000-0000-0000-000000000000" - ) - contentunderstanding_client_id = os.environ.get( - "CONTENTUNDERSTANDING_CLIENT_ID", "00000000-0000-0000-0000-000000000000" - ) - contentunderstanding_client_secret = os.environ.get( - "CONTENTUNDERSTANDING_CLIENT_SECRET", "00000000-0000-0000-0000-000000000000" - ) - add_general_regex_sanitizer( - regex=contentunderstanding_subscription_id, value="00000000-0000-0000-0000-000000000000" - ) - add_general_regex_sanitizer(regex=contentunderstanding_tenant_id, value="00000000-0000-0000-0000-000000000000") - add_general_regex_sanitizer(regex=contentunderstanding_client_id, value="00000000-0000-0000-0000-000000000000") - add_general_regex_sanitizer(regex=contentunderstanding_client_secret, value="00000000-0000-0000-0000-000000000000") - - add_header_regex_sanitizer(key="Set-Cookie", value="[set-cookie;]") - add_header_regex_sanitizer(key="Cookie", value="cookie;") - add_body_key_sanitizer(json_path="$..access_token", value="access_token") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py deleted file mode 100644 index d570db867e1f..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding.py +++ /dev/null @@ -1,301 +0,0 @@ -# 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. -# -------------------------------------------------------------------------- -import pytest -from devtools_testutils import recorded_by_proxy -from testpreparer import ContentUnderstandingClientTestBase, ContentUnderstandingPreparer - - -@pytest.mark.skip("you may need to update the auto-generated test case before run it") -class TestContentUnderstanding(ContentUnderstandingClientTestBase): - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_begin_analyze(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.begin_analyze( - analyzer_id="str", - body={ - "inputs": [ - { - "data": bytes("bytes", encoding="utf-8"), - "mimeType": "str", - "name": "str", - "range": "str", - "url": "str", - } - ], - "modelDeployments": {"str": "str"}, - }, - ).result() # call '.result()' to poll until service return final result - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_begin_analyze_binary(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.begin_analyze_binary( - analyzer_id="str", - binary_input=bytes("bytes", encoding="utf-8"), - content_type="str", - ).result() # call '.result()' to poll until service return final result - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_begin_copy_analyzer(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.begin_copy_analyzer( - analyzer_id="str", - body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, - source_analyzer_id="str", - ).result() # call '.result()' to poll until service return final result - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_begin_create_analyzer(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.begin_create_analyzer( - analyzer_id="str", - resource={ - "analyzerId": "str", - "createdAt": "2020-02-20 00:00:00", - "lastModifiedAt": "2020-02-20 00:00:00", - "status": "str", - "baseAnalyzerId": "str", - "config": { - "annotationFormat": "str", - "chartFormat": "str", - "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, - "disableFaceBlurring": bool, - "enableFigureAnalysis": bool, - "enableFigureDescription": bool, - "enableFormula": bool, - "enableLayout": bool, - "enableOcr": bool, - "enableSegment": bool, - "estimateFieldSourceAndConfidence": bool, - "locales": ["str"], - "omitContent": bool, - "returnDetails": bool, - "segmentPerPage": bool, - "tableFormat": "str", - }, - "description": "str", - "dynamicFieldSchema": bool, - "fieldSchema": { - "fields": { - "str": { - "$ref": "str", - "description": "str", - "enum": ["str"], - "enumDescriptions": {"str": "str"}, - "estimateSourceAndConfidence": bool, - "examples": ["str"], - "items": ..., - "method": "str", - "properties": {"str": ...}, - "type": "str", - } - }, - "definitions": { - "str": { - "$ref": "str", - "description": "str", - "enum": ["str"], - "enumDescriptions": {"str": "str"}, - "estimateSourceAndConfidence": bool, - "examples": ["str"], - "items": ..., - "method": "str", - "properties": {"str": ...}, - "type": "str", - } - }, - "description": "str", - "name": "str", - }, - "knowledgeSources": ["knowledge_source"], - "models": {"str": "str"}, - "processingLocation": "str", - "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, - "tags": {"str": "str"}, - "warnings": [~azure.core.ODataV4Format], - }, - ).result() # call '.result()' to poll until service return final result - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_delete_analyzer(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.delete_analyzer( - analyzer_id="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_delete_result(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.delete_result( - operation_id="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_get_analyzer(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.get_analyzer( - analyzer_id="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_get_defaults(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.get_defaults() - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_get_result_file(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.get_result_file( - operation_id="str", - path="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_grant_copy_authorization(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.grant_copy_authorization( - analyzer_id="str", - body={"targetAzureResourceId": "str", "targetRegion": "str"}, - target_azure_resource_id="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_list_analyzers(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.list_analyzers() - result = [r for r in response] - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_update_analyzer(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.update_analyzer( - analyzer_id="str", - resource={ - "analyzerId": "str", - "createdAt": "2020-02-20 00:00:00", - "lastModifiedAt": "2020-02-20 00:00:00", - "status": "str", - "baseAnalyzerId": "str", - "config": { - "annotationFormat": "str", - "chartFormat": "str", - "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, - "disableFaceBlurring": bool, - "enableFigureAnalysis": bool, - "enableFigureDescription": bool, - "enableFormula": bool, - "enableLayout": bool, - "enableOcr": bool, - "enableSegment": bool, - "estimateFieldSourceAndConfidence": bool, - "locales": ["str"], - "omitContent": bool, - "returnDetails": bool, - "segmentPerPage": bool, - "tableFormat": "str", - }, - "description": "str", - "dynamicFieldSchema": bool, - "fieldSchema": { - "fields": { - "str": { - "$ref": "str", - "description": "str", - "enum": ["str"], - "enumDescriptions": {"str": "str"}, - "estimateSourceAndConfidence": bool, - "examples": ["str"], - "items": ..., - "method": "str", - "properties": {"str": ...}, - "type": "str", - } - }, - "definitions": { - "str": { - "$ref": "str", - "description": "str", - "enum": ["str"], - "enumDescriptions": {"str": "str"}, - "estimateSourceAndConfidence": bool, - "examples": ["str"], - "items": ..., - "method": "str", - "properties": {"str": ...}, - "type": "str", - } - }, - "description": "str", - "name": "str", - }, - "knowledgeSources": ["knowledge_source"], - "models": {"str": "str"}, - "processingLocation": "str", - "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, - "tags": {"str": "str"}, - "warnings": [~azure.core.ODataV4Format], - }, - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_update_defaults(self, contentunderstanding_endpoint): - client = self.create_client(endpoint=contentunderstanding_endpoint) - response = client.update_defaults( - body={"modelDeployments": {}}, - ) - - # please add some check logic here by yourself - # ... diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py deleted file mode 100644 index a587c1be2188..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/test_content_understanding_async.py +++ /dev/null @@ -1,310 +0,0 @@ -# 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. -# -------------------------------------------------------------------------- -import pytest -from devtools_testutils.aio import recorded_by_proxy_async -from testpreparer import ContentUnderstandingPreparer -from testpreparer_async import ContentUnderstandingClientTestBaseAsync - - -@pytest.mark.skip("you may need to update the auto-generated test case before run it") -class TestContentUnderstandingAsync(ContentUnderstandingClientTestBaseAsync): - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_begin_analyze(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await ( - await client.begin_analyze( - analyzer_id="str", - body={ - "inputs": [ - { - "data": bytes("bytes", encoding="utf-8"), - "mimeType": "str", - "name": "str", - "range": "str", - "url": "str", - } - ], - "modelDeployments": {"str": "str"}, - }, - ) - ).result() # call '.result()' to poll until service return final result - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_begin_analyze_binary(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await ( - await client.begin_analyze_binary( - analyzer_id="str", - binary_input=bytes("bytes", encoding="utf-8"), - content_type="str", - ) - ).result() # call '.result()' to poll until service return final result - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_begin_copy_analyzer(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await ( - await client.begin_copy_analyzer( - analyzer_id="str", - body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, - source_analyzer_id="str", - ) - ).result() # call '.result()' to poll until service return final result - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_begin_create_analyzer(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await ( - await client.begin_create_analyzer( - analyzer_id="str", - resource={ - "analyzerId": "str", - "createdAt": "2020-02-20 00:00:00", - "lastModifiedAt": "2020-02-20 00:00:00", - "status": "str", - "baseAnalyzerId": "str", - "config": { - "annotationFormat": "str", - "chartFormat": "str", - "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, - "disableFaceBlurring": bool, - "enableFigureAnalysis": bool, - "enableFigureDescription": bool, - "enableFormula": bool, - "enableLayout": bool, - "enableOcr": bool, - "enableSegment": bool, - "estimateFieldSourceAndConfidence": bool, - "locales": ["str"], - "omitContent": bool, - "returnDetails": bool, - "segmentPerPage": bool, - "tableFormat": "str", - }, - "description": "str", - "dynamicFieldSchema": bool, - "fieldSchema": { - "fields": { - "str": { - "$ref": "str", - "description": "str", - "enum": ["str"], - "enumDescriptions": {"str": "str"}, - "estimateSourceAndConfidence": bool, - "examples": ["str"], - "items": ..., - "method": "str", - "properties": {"str": ...}, - "type": "str", - } - }, - "definitions": { - "str": { - "$ref": "str", - "description": "str", - "enum": ["str"], - "enumDescriptions": {"str": "str"}, - "estimateSourceAndConfidence": bool, - "examples": ["str"], - "items": ..., - "method": "str", - "properties": {"str": ...}, - "type": "str", - } - }, - "description": "str", - "name": "str", - }, - "knowledgeSources": ["knowledge_source"], - "models": {"str": "str"}, - "processingLocation": "str", - "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, - "tags": {"str": "str"}, - "warnings": [~azure.core.ODataV4Format], - }, - ) - ).result() # call '.result()' to poll until service return final result - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_delete_analyzer(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.delete_analyzer( - analyzer_id="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_delete_result(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.delete_result( - operation_id="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_get_analyzer(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.get_analyzer( - analyzer_id="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_get_defaults(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.get_defaults() - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_get_result_file(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.get_result_file( - operation_id="str", - path="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_grant_copy_authorization(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.grant_copy_authorization( - analyzer_id="str", - body={"targetAzureResourceId": "str", "targetRegion": "str"}, - target_azure_resource_id="str", - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_list_analyzers(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = client.list_analyzers() - result = [r async for r in response] - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_update_analyzer(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.update_analyzer( - analyzer_id="str", - resource={ - "analyzerId": "str", - "createdAt": "2020-02-20 00:00:00", - "lastModifiedAt": "2020-02-20 00:00:00", - "status": "str", - "baseAnalyzerId": "str", - "config": { - "annotationFormat": "str", - "chartFormat": "str", - "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, - "disableFaceBlurring": bool, - "enableFigureAnalysis": bool, - "enableFigureDescription": bool, - "enableFormula": bool, - "enableLayout": bool, - "enableOcr": bool, - "enableSegment": bool, - "estimateFieldSourceAndConfidence": bool, - "locales": ["str"], - "omitContent": bool, - "returnDetails": bool, - "segmentPerPage": bool, - "tableFormat": "str", - }, - "description": "str", - "dynamicFieldSchema": bool, - "fieldSchema": { - "fields": { - "str": { - "$ref": "str", - "description": "str", - "enum": ["str"], - "enumDescriptions": {"str": "str"}, - "estimateSourceAndConfidence": bool, - "examples": ["str"], - "items": ..., - "method": "str", - "properties": {"str": ...}, - "type": "str", - } - }, - "definitions": { - "str": { - "$ref": "str", - "description": "str", - "enum": ["str"], - "enumDescriptions": {"str": "str"}, - "estimateSourceAndConfidence": bool, - "examples": ["str"], - "items": ..., - "method": "str", - "properties": {"str": ...}, - "type": "str", - } - }, - "description": "str", - "name": "str", - }, - "knowledgeSources": ["knowledge_source"], - "models": {"str": "str"}, - "processingLocation": "str", - "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, - "tags": {"str": "str"}, - "warnings": [~azure.core.ODataV4Format], - }, - ) - - # please add some check logic here by yourself - # ... - - @ContentUnderstandingPreparer() - @recorded_by_proxy_async - async def test_update_defaults(self, contentunderstanding_endpoint): - client = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.update_defaults( - body={"modelDeployments": {}}, - ) - - # please add some check logic here by yourself - # ... diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer.py deleted file mode 100644 index 59d6d08b3a68..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer.py +++ /dev/null @@ -1,28 +0,0 @@ -# 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 azure.ai.contentunderstanding import ContentUnderstandingClient -from devtools_testutils import AzureRecordedTestCase, PowerShellPreparer -import functools - - -class ContentUnderstandingClientTestBase(AzureRecordedTestCase): - - def create_client(self, endpoint): - credential = self.get_credential(ContentUnderstandingClient) - return self.create_client_from_credential( - ContentUnderstandingClient, - credential=credential, - endpoint=endpoint, - ) - - -ContentUnderstandingPreparer = functools.partial( - PowerShellPreparer, - "contentunderstanding", - contentunderstanding_endpoint="https://fake_contentunderstanding_endpoint.com", -) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer_async.py deleted file mode 100644 index 1ca8d36c5713..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/generated_tests/testpreparer_async.py +++ /dev/null @@ -1,20 +0,0 @@ -# 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 azure.ai.contentunderstanding.aio import ContentUnderstandingClient -from devtools_testutils import AzureRecordedTestCase - - -class ContentUnderstandingClientTestBaseAsync(AzureRecordedTestCase): - - def create_async_client(self, endpoint): - credential = self.get_credential(ContentUnderstandingClient, is_async=True) - return self.create_client_from_credential( - ContentUnderstandingClient, - credential=credential, - endpoint=endpoint, - ) From d482ab4a584b3da6ef920c8c9d6c738994ccd695 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 07:15:49 +0000 Subject: [PATCH 043/105] SAMPLE: Update invoice analysis samples to correctly extract line items as ArrayField and ObjectField, enhancing price information display with UnitPrice and Amount options. --- .../sample_analyze_invoice_async.py | 41 ++++++++++++++----- .../samples/sample_analyze_invoice.py | 41 ++++++++++++++----- 2 files changed, 60 insertions(+), 22 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index db74e32701b8..3a5358447940 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -41,6 +41,8 @@ DocumentContent, ContentField, MediaContentKind, + ArrayField, + ObjectField, ) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential @@ -131,23 +133,40 @@ async def main() -> None: if total_amount_field.confidence: print(f" Confidence: {total_amount_field.confidence:.2f}") - # Extract array field (Items - line items) - items_field = document_content.fields.get("Items") - if items_field and items_field.value: - items_array: list = items_field.value # type: ignore + # Extract array field (LineItems - line items) + # Note: The field name is "LineItems" (not "Items") to match the service response + line_items_field = document_content.fields.get("LineItems") + if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: + items_array: list = line_items_field.value # type: ignore print(f"\nLine Items ({len(items_array)}):") for i, item in enumerate(items_array, 1): - if isinstance(item, dict): - description_field = item.get("Description") - quantity_field = item.get("Quantity") - amount_field = item.get("Amount") + # Each item in the array is a ContentField (ObjectField for line items) + if isinstance(item, ObjectField) and item.value: + item_dict: dict[str, ContentField] = item.value # type: ignore + description_field = item_dict.get("Description") + quantity_field = item_dict.get("Quantity") + # Try UnitPrice first, then Amount (matching .NET sample pattern) + unit_price_field = item_dict.get("UnitPrice") + amount_field = item_dict.get("Amount") description = description_field.value if description_field else "(no description)" quantity = quantity_field.value if quantity_field else "N/A" - amount = amount_field.value if amount_field else "N/A" - + + # Display price information - prefer UnitPrice if available, otherwise Amount + # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) + price_info = "" + if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: + unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore + unit_price_amount_field = unit_price_obj.get("Amount") + unit_price_currency_field = unit_price_obj.get("CurrencyCode") + if unit_price_amount_field and unit_price_amount_field.value is not None: + currency = unit_price_currency_field.value if unit_price_currency_field else "" + price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() + elif amount_field and amount_field.value is not None: + price_info = f"Amount: {amount_field.value}" + print(f" {i}. {description}") - print(f" Quantity: {quantity}, Amount: {amount}") + print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) # [END extract_invoice_fields] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index 96eba0cd11b5..c58696f965f3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -40,6 +40,8 @@ DocumentContent, ContentField, MediaContentKind, + ArrayField, + ObjectField, ) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential @@ -133,23 +135,40 @@ def main() -> None: if total_amount_field.confidence: print(f" Confidence: {total_amount_field.confidence:.2f}") - # Extract array field (Items - line items) - items_field = document_content.fields.get("Items") - if items_field and items_field.value: - items_array: list = items_field.value # type: ignore + # Extract array field (LineItems - line items) + # Note: The field name is "LineItems" (not "Items") to match the service response + line_items_field = document_content.fields.get("LineItems") + if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: + items_array: list = line_items_field.value # type: ignore print(f"\nLine Items ({len(items_array)}):") for i, item in enumerate(items_array, 1): - if isinstance(item, dict): - description_field = item.get("Description") - quantity_field = item.get("Quantity") - amount_field = item.get("Amount") + # Each item in the array is a ContentField (ObjectField for line items) + if isinstance(item, ObjectField) and item.value: + item_dict: dict[str, ContentField] = item.value # type: ignore + description_field = item_dict.get("Description") + quantity_field = item_dict.get("Quantity") + # Try UnitPrice first, then Amount (matching .NET sample pattern) + unit_price_field = item_dict.get("UnitPrice") + amount_field = item_dict.get("Amount") description = description_field.value if description_field else "(no description)" quantity = quantity_field.value if quantity_field else "N/A" - amount = amount_field.value if amount_field else "N/A" - + + # Display price information - prefer UnitPrice if available, otherwise Amount + # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) + price_info = "" + if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: + unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore + unit_price_amount_field = unit_price_obj.get("Amount") + unit_price_currency_field = unit_price_obj.get("CurrencyCode") + if unit_price_amount_field and unit_price_amount_field.value is not None: + currency = unit_price_currency_field.value if unit_price_currency_field else "" + price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() + elif amount_field and amount_field.value is not None: + price_info = f"Amount: {amount_field.value}" + print(f" {i}. {description}") - print(f" Quantity: {quantity}, Amount: {amount}") + print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) # [END extract_invoice_fields] From d91908cd0c14b4c79ffda3ec7ee401e27dc4f88d Mon Sep 17 00:00:00 2001 From: Changjian Wang Date: Mon, 1 Dec 2025 16:24:48 +0800 Subject: [PATCH 044/105] FEATURE: Enhance invoice analysis with comprehensive field extraction and validation tests - Added new helper functions for validating document properties and invoice fields. - Implemented tests for document properties validation and invoice field extraction. - Created a new invoice analyzer object with a detailed field schema for extracting common invoice fields. - Updated existing test helpers to include assertions for document properties and invoice fields. --- .../azure-ai-contentunderstanding/.gitignore | 1 + ...ding_content_analyzers_operations_async.py | 633 +++++++++--------- .../tests/test_helpers.py | 259 +++++++ 3 files changed, 591 insertions(+), 302 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore b/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore index cbb17c6c9faf..485d2e026cc3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/.gitignore @@ -20,6 +20,7 @@ __pycache__/ .pytest_cache/ .coverage htmlcov/ +tests/recordings/ # Environment variables .env diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py index 4e7737911a18..173a454b01c2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py @@ -18,9 +18,12 @@ from test_helpers import ( generate_analyzer_id, new_simple_content_analyzer_object, + new_invoice_analyzer_object, new_marketing_video_analyzer_object, assert_poller_properties, assert_simple_content_analyzer_result, + assert_invoice_fields, + assert_document_properties, save_analysis_result_to_file, save_keyframe_image_to_file, ) @@ -46,7 +49,7 @@ async def create_analyzer_and_assert_async( print(f"\nCreating analyzer {analyzer_id}") # Start the analyzer creation operation - poller = await client.begin_create_or_replace( + poller = await client.begin_create_analyzer( analyzer_id=analyzer_id, resource=resource, ) @@ -83,7 +86,7 @@ async def delete_analyzer_and_assert( if created_analyzer: print(f"Cleaning up analyzer {analyzer_id}") try: - await client.delete(analyzer_id=analyzer_id) + await client.delete_analyzer(analyzer_id=analyzer_id) except Exception as e: # If deletion fails, the test should fail raise AssertionError(f"Failed to delete analyzer {analyzer_id}: {e}") from e @@ -215,14 +218,121 @@ class TestContentUnderstandingContentAnalyzersOperationsAsync(ContentUnderstandi @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_begin_create_with_content_analyzer( + async def test_update_defaults_async(self, contentunderstanding_endpoint: str) -> None: + """ + Tests updating default model deployments for the Content Understanding service. + Verifies that model deployments (gpt-4.1, gpt-4.1-mini, text-embedding-3-large) can be updated and are correctly persisted. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + + # Check if model deployments are configured in test environment + gpt41_deployment = os.getenv("CONTENTUNDERSTANDING_GPT41_DEPLOYMENT") + gpt41_mini_deployment = os.getenv("CONTENTUNDERSTANDING_GPT41_MINI_DEPLOYMENT") + text_embedding_deployment = os.getenv("CONTENTUNDERSTANDING_TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + if not gpt41_deployment or not gpt41_mini_deployment or not text_embedding_deployment: + pytest.skip("Model deployments are not configured in test environment. Skipping test_update_defaults_async.") + return + + # Update defaults with configured deployments + model_deployments = { + "gpt-4.1": gpt41_deployment, + "gpt-4.1-mini": gpt41_mini_deployment, + "text-embedding-3-large": text_embedding_deployment, + } + + response = await client.update_defaults(model_deployments=model_deployments) + + assert response is not None, "Update response should not be null" + assert hasattr(response, "model_deployments"), "Updated defaults should have model_deployments attribute" + + # Verify the updated defaults + updated_defaults = response + assert updated_defaults.model_deployments is not None, "Updated model deployments should not be null" + assert len(updated_defaults.model_deployments) >= 3, "Should have at least 3 model deployments" + + # Verify each deployment was set correctly + assert "gpt-4.1" in updated_defaults.model_deployments, "Should contain gpt-4.1 deployment" + assert updated_defaults.model_deployments["gpt-4.1"] == gpt41_deployment, "gpt-4.1 deployment should match" + + assert "gpt-4.1-mini" in updated_defaults.model_deployments, "Should contain gpt-4.1-mini deployment" + assert ( + updated_defaults.model_deployments["gpt-4.1-mini"] == gpt41_mini_deployment + ), "gpt-4.1-mini deployment should match" + + assert ( + "text-embedding-3-large" in updated_defaults.model_deployments + ), "Should contain text-embedding-3-large deployment" + assert ( + updated_defaults.model_deployments["text-embedding-3-large"] == text_embedding_deployment + ), "text-embedding-3-large deployment should match" + + print(f"Successfully updated defaults with {len(updated_defaults.model_deployments)} model deployments") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_get_defaults_async(self, contentunderstanding_endpoint: str) -> None: + """ + Tests retrieving default model deployments from the Content Understanding service. + Verifies that the returned defaults contain the expected model deployment configurations. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + + # Load expected model values from test environment + gpt41_deployment = os.getenv("CONTENTUNDERSTANDING_GPT41_DEPLOYMENT") + gpt41_mini_deployment = os.getenv("CONTENTUNDERSTANDING_GPT41_MINI_DEPLOYMENT") + text_embedding_deployment = os.getenv("CONTENTUNDERSTANDING_TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + response = await client.get_defaults() + + assert response is not None, "Response should not be null" + + # Verify defaults structure + defaults = response + assert defaults is not None, "Defaults should not be null" + + # ModelDeployments may be null or empty if not configured + if defaults.model_deployments is not None and len(defaults.model_deployments) > 0: + assert len(defaults.model_deployments) > 0, "Model deployments dictionary should not be empty if not null" + + # Verify expected keys exist if deployments are configured + for key, value in defaults.model_deployments.items(): + assert key is not None and len(key) > 0, "Model deployment key should not be null or empty" + assert value is not None and len(value) > 0, "Model deployment value should not be null or empty" + + # Verify specific model values if they are configured in test environment + if gpt41_deployment: + assert "gpt-4.1" in defaults.model_deployments, "Should contain gpt-4.1 deployment" + assert ( + defaults.model_deployments["gpt-4.1"] == gpt41_deployment + ), "gpt-4.1 deployment should match test environment value" + + if gpt41_mini_deployment: + assert "gpt-4.1-mini" in defaults.model_deployments, "Should contain gpt-4.1-mini deployment" + assert ( + defaults.model_deployments["gpt-4.1-mini"] == gpt41_mini_deployment + ), "gpt-4.1-mini deployment should match test environment value" + + if text_embedding_deployment: + assert ( + "text-embedding-3-large" in defaults.model_deployments + ), "Should contain text-embedding-3-large deployment" + assert ( + defaults.model_deployments["text-embedding-3-large"] == text_embedding_deployment + ), "text-embedding-3-large deployment should match test environment value" + + print(f"Successfully retrieved defaults with {len(defaults.model_deployments)} model deployments") + else: + print("Model deployments not configured or empty") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_create_analyzer_async( self, contentunderstanding_endpoint: str ) -> None: """ - Test Summary: - - Create analyzer using ContentAnalyzer object - - Verify analyzer creation and poller properties - - Clean up created analyzer + Tests creating a custom analyzer using ContentAnalyzer object. + Verifies analyzer creation, poller properties, and proper cleanup. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) analyzer_id = generate_analyzer_id(client, "create_content_analyzer", is_async=True) @@ -243,12 +353,10 @@ async def test_content_analyzers_begin_create_with_content_analyzer( @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_begin_create_with_json(self, contentunderstanding_endpoint: str) -> None: + async def test_create_analyzer_with_json_async(self, contentunderstanding_endpoint: str) -> None: """ - Test Summary: - - Create analyzer using JSON dictionary - - Verify analyzer creation and poller properties - - Clean up created analyzer + Tests creating a custom analyzer using JSON dictionary representation. + Verifies analyzer creation, poller properties, and proper cleanup. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) analyzer_id = generate_analyzer_id(client, "create_json", is_async=True) @@ -298,14 +406,10 @@ async def test_content_analyzers_begin_create_with_json(self, contentunderstandi @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_update(self, contentunderstanding_endpoint: str) -> None: + async def test_update_analyzer_async(self, contentunderstanding_endpoint: str) -> None: """ - Test Summary: - - Create initial analyzer - - Get analyzer before update to verify initial state - - Update analyzer with new description and tags - - Get analyzer after update to verify changes persisted - - Clean up created analyzer + Tests updating an analyzer's properties (description and tags). + Verifies that updates are correctly applied and persisted. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) analyzer_id = generate_analyzer_id(client, "update", is_async=True) @@ -325,7 +429,7 @@ async def test_content_analyzers_update(self, contentunderstanding_endpoint: str # Get the analyzer before update to verify initial state print(f"Getting analyzer {analyzer_id} before update") - analyzer_before_update = await client.get(analyzer_id=analyzer_id) + analyzer_before_update = await client.get_analyzer(analyzer_id=analyzer_id) assert analyzer_before_update is not None assert analyzer_before_update.analyzer_id == analyzer_id assert analyzer_before_update.description == f"Initial analyzer for update test: {analyzer_id}" @@ -347,7 +451,7 @@ async def test_content_analyzers_update(self, contentunderstanding_endpoint: str print(f"Updating analyzer {analyzer_id} with new tag and description") # Update the analyzer - response = await client.update( + response = await client.update_analyzer( analyzer_id=analyzer_id, resource=updated_analyzer, ) @@ -367,7 +471,7 @@ async def test_content_analyzers_update(self, contentunderstanding_endpoint: str # Get the analyzer after update to verify the changes persisted print(f"Getting analyzer {analyzer_id} after update") - analyzer_after_update = await client.get(analyzer_id=analyzer_id) + analyzer_after_update = await client.get_analyzer(analyzer_id=analyzer_id) assert analyzer_after_update is not None assert analyzer_after_update.analyzer_id == analyzer_id assert analyzer_after_update.description == f"Updated analyzer for update test: {analyzer_id}" @@ -382,14 +486,13 @@ async def test_content_analyzers_update(self, contentunderstanding_endpoint: str @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_get(self, contentunderstanding_endpoint: str) -> None: + async def test_get_analyzer_async(self, contentunderstanding_endpoint: str) -> None: """ - Test Summary: - - Get existing prebuilt analyzer - - Verify analyzer properties and status + Tests retrieving an analyzer by ID. + Verifies that the prebuilt-documentSearch analyzer can be retrieved with all properties. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = await client.get( + response = await client.get_analyzer( analyzer_id="prebuilt-documentSearch", ) assert response is not None @@ -403,12 +506,12 @@ async def test_content_analyzers_get(self, contentunderstanding_endpoint: str) - @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_delete(self, contentunderstanding_endpoint: str) -> None: + async def test_delete_analyzer_async( + self, contentunderstanding_endpoint: str + ) -> None: """ - Test Summary: - - Create analyzer for deletion test - - Delete analyzer - - Clean up if deletion failed + Tests deleting an analyzer. + Verifies that an analyzer can be successfully deleted. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) analyzer_id = generate_analyzer_id(client, "delete", is_async=True) @@ -428,7 +531,7 @@ async def test_content_analyzers_delete(self, contentunderstanding_endpoint: str # Delete the analyzer print(f"Deleting analyzer {analyzer_id}") - response = await client.delete(analyzer_id=analyzer_id) + response = await client.delete_analyzer(analyzer_id=analyzer_id) # Verify the delete response assert response is None @@ -439,7 +542,7 @@ async def test_content_analyzers_delete(self, contentunderstanding_endpoint: str if created_analyzer: print(f"Cleaning up analyzer {analyzer_id} that was not properly deleted") try: - await client.delete(analyzer_id=analyzer_id) + await client.delete_analyzer(analyzer_id=analyzer_id) # Verify deletion (NOTE: check disabled - list too long to execute) # client, analyzer_id # ), f"Failed to delete analyzer {analyzer_id} during cleanup" @@ -453,15 +556,15 @@ async def test_content_analyzers_delete(self, contentunderstanding_endpoint: str @pytest.mark.skip(reason="TEMPORARILY SKIPPED: List operation is too long - too many analyzers") @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_list(self, contentunderstanding_endpoint: str) -> None: + async def test_list_analyzers_async( + self, contentunderstanding_endpoint: str + ) -> None: """ - Test Summary: - - List all available analyzers - - Verify list response contains expected prebuilt analyzers - - Verify each analyzer has required properties + Tests listing all available analyzers. + Verifies that prebuilt analyzers are included and have required properties. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) - response = client.list() + response = client.list_analyzers() result = [r async for r in response] assert len(result) > 0, "Should have at least one analyzer in the list" print(f"Found {len(result)} analyzers") @@ -482,16 +585,10 @@ async def test_content_analyzers_list(self, contentunderstanding_endpoint: str) @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_begin_analyze_url(self, contentunderstanding_endpoint: str) -> None: + async def test_analyze_url_async(self, contentunderstanding_endpoint: str) -> None: """ - Test Summary: - - Create simple analyzer for URL analysis - - Begin analysis operation with URL input - - Wait for analysis completion - - Save analysis result to output file - - Verify fields node exists in first result - - Verify total_amount field exists and equals 110 - - Clean up created analyzer + Tests analyzing a document from a URL. + Verifies that analysis completes successfully and returns expected field results. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) analyzer_id = generate_analyzer_id(client, "analyze_url", is_async=True) @@ -540,17 +637,10 @@ async def test_content_analyzers_begin_analyze_url(self, contentunderstanding_en @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_begin_analyze_binary(self, contentunderstanding_endpoint: str) -> None: + async def test_analyze_binary_basic_async(self, contentunderstanding_endpoint: str) -> None: """ - Test Summary: - - Create simple analyzer for binary analysis - - Read sample invoice PDF file - - Begin binary analysis operation with analyzer - - Wait for analysis completion - - Save analysis result to output file - - Verify fields node exists in first result - - Verify total_amount field exists and equals 110 - - Clean up created analyzer + Tests analyzing a document from binary data (PDF file). + Verifies that binary analysis completes successfully and returns expected field results. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) analyzer_id = generate_analyzer_id(client, "analyze_binary", is_async=True) @@ -577,7 +667,9 @@ async def test_content_analyzers_begin_analyze_binary(self, contentunderstanding print(f"Starting binary analysis with analyzer {analyzer_id}") # Begin binary analysis operation - analysis_poller = await client.begin_analyze_binary(analyzer_id=analyzer_id, binary_input=pdf_content) + analysis_poller = await client.begin_analyze_binary( + analyzer_id=analyzer_id, binary_input=pdf_content, content_type="application/pdf" + ) assert_poller_properties(analysis_poller, "Analysis poller") # Wait for analysis completion @@ -598,16 +690,10 @@ async def test_content_analyzers_begin_analyze_binary(self, contentunderstanding @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: str) -> None: + async def test_get_result_file_async(self, contentunderstanding_endpoint: str) -> None: """ - Test Summary: - - Create marketing video analyzer based on the marketing video template - - Read FlightSimulator.mp4 file - - Begin video analysis operation with analyzer - - Wait for analysis completion - - Use get_result_file to retrieve image files generated from video analysis - - Verify image file content is returned and save to test_output - - Clean up created analyzer + Tests retrieving result files from a video analysis operation. + Verifies that image files generated from video analysis can be retrieved and saved. """ if not is_live_and_not_recording(): pytest.skip( @@ -654,14 +740,12 @@ async def test_content_analyzers_get_result_file(self, contentunderstanding_endp analysis_result, "test_content_analyzers_get_result_file", test_file_dir, analyzer_id ) - # Extract operation ID for get_result_file test using custom poller's details property - from azure.ai.contentunderstanding.aio.operations._patch import AnalyzeAsyncLROPoller + # Extract operation ID for get_result_file test using custom poller's operation_id property + from azure.ai.contentunderstanding.aio.models import AnalyzeAsyncLROPoller assert isinstance(analysis_poller, AnalyzeAsyncLROPoller), "Should return custom AnalyzeAsyncLROPoller" - details = analysis_poller.details - assert "operation_id" in details, "Details should contain operation_id" - analysis_operation_id = details["operation_id"] + analysis_operation_id = analysis_poller.operation_id assert analysis_operation_id is not None, "Operation ID should not be None" assert len(analysis_operation_id) > 0, "Operation ID should not be empty" print(f"Analysis operation ID: {analysis_operation_id}") @@ -678,231 +762,176 @@ async def test_content_analyzers_get_result_file(self, contentunderstanding_endp # Always clean up the created analyzer, even if the test fails await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) - # @ContentUnderstandingPreparer() - # @recorded_by_proxy_async - # @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# async def test_content_analyzers_begin_analyze(self, contentunderstanding_endpoint): -# client = self.create_async_client(endpoint=contentunderstanding_endpoint) -# response = await ( -# await client.begin_analyze( -# analyzer_id="str", -# body={ -# "inputs": [ -# { -# "data": bytes("bytes", encoding="utf-8"), -# "mimeType": "str", -# "name": "str", -# "range": "str", -# "url": "str", -# } -# ], -# "modelDeployments": {"str": "str"}, -# }, -# ) -# ).result() # call '.result()' to poll until service return final result - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# async def test_content_analyzers_begin_copy(self, contentunderstanding_endpoint): -# client = self.create_async_client(endpoint=contentunderstanding_endpoint) -# response = await ( -# await client.begin_copy( -# analyzer_id="str", -# body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, -# source_analyzer_id="str", -# ) -# ).result() # call '.result()' to poll until service return final result - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# async def test_content_analyzers_begin_create_or_replace(self, contentunderstanding_endpoint): -# client = self.create_async_client(endpoint=contentunderstanding_endpoint) -# response = await ( -# await client.begin_create_or_replace( -# analyzer_id="str", -# resource={ -# "analyzerId": "str", -# "createdAt": "2020-02-20 00:00:00", -# "lastModifiedAt": "2020-02-20 00:00:00", -# "status": "str", -# "baseAnalyzerId": "str", -# "config": { -# "annotationFormat": "str", -# "chartFormat": "str", -# "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, -# "disableFaceBlurring": bool, -# "enableAnnotation": bool, -# "enableFigureAnalysis": bool, -# "enableFigureDescription": bool, -# "enableFormula": bool, -# "enableLayout": bool, -# "enableOcr": bool, -# "enableSegment": bool, -# "estimateFieldSourceAndConfidence": bool, -# "locales": ["str"], -# "omitContent": bool, -# "returnDetails": bool, -# "segmentPerPage": bool, -# "tableFormat": "str", -# }, -# "description": "str", -# "dynamicFieldSchema": bool, -# "fieldSchema": { -# "fields": { -# "str": { -# "$ref": "str", -# "description": "str", -# "enum": ["str"], -# "enumDescriptions": {"str": "str"}, -# "estimateSourceAndConfidence": bool, -# "examples": ["str"], -# "items": ..., -# "method": "str", -# "properties": {"str": ...}, -# "type": "str", -# } -# }, -# "definitions": { -# "str": { -# "$ref": "str", -# "description": "str", -# "enum": ["str"], -# "enumDescriptions": {"str": "str"}, -# "estimateSourceAndConfidence": bool, -# "examples": ["str"], -# "items": ..., -# "method": "str", -# "properties": {"str": ...}, -# "type": "str", -# } -# }, -# "description": "str", -# "name": "str", -# }, -# "knowledgeSources": ["knowledge_source"], -# "models": {"str": "str"}, -# "processingLocation": "str", -# "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, -# "tags": {"str": "str"}, -# "warnings": [...], -# }, -# ) -# ).result() # call '.result()' to poll until service return final result - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# async def test_content_analyzers_delete_result(self, contentunderstanding_endpoint): -# client = self.create_async_client(endpoint=contentunderstanding_endpoint) -# response = await client.delete_result( -# operation_id="str", -# ) - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# async def test_content_analyzers_get_defaults(self, contentunderstanding_endpoint): -# client = self.create_async_client(endpoint=contentunderstanding_endpoint) -# response = await client.get_defaults() - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# async def test_content_analyzers_get_operation_status(self, contentunderstanding_endpoint): -# client = self.create_async_client(endpoint=contentunderstanding_endpoint) -# response = await client.get_operation_status( -# analyzer_id="str", -# operation_id="str", -# ) - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# async def test_content_analyzers_grant_copy_authorization(self, contentunderstanding_endpoint): -# client = self.create_async_client(endpoint=contentunderstanding_endpoint) -# response = await client.grant_copy_authorization( -# analyzer_id="str", -# body={"targetAzureResourceId": "str", "targetRegion": "str"}, -# target_azure_resource_id="str", -# ) - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy_async -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# async def test_content_analyzers_update_defaults(self, contentunderstanding_endpoint): -# client = self.create_async_client(endpoint=contentunderstanding_endpoint) -# response = await client.update_defaults( -# body={"modelDeployments": {}}, -# ) -# please add some check logic here by yourself -# + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_validate_document_properties_async(self, contentunderstanding_endpoint: str) -> None: + """ + Tests document property validation from analysis results. + Verifies that analyzed documents contain expected properties like page count, content structure, and layout information. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "validate_props", is_async=True) + created_analyzer = False + + # Create a simple analyzer with OCR and layout enabled to get rich document properties + content_analyzer = new_simple_content_analyzer_object( + analyzer_id=analyzer_id, + description=f"test analyzer for document properties validation: {analyzer_id}", + tags={"test_type": "document_properties"}, + ) + + try: + # Create analyzer + poller = await create_analyzer_and_assert_async(client, analyzer_id, content_analyzer) + created_analyzer = True + + # Read the sample invoice PDF file + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + pdf_path = os.path.join(test_file_dir, "test_data", "sample_invoice.pdf") + with open(pdf_path, "rb") as pdf_file: + pdf_content = pdf_file.read() + + print(f"Starting analysis for document properties validation") + + # Begin binary analysis + analysis_poller = await client.begin_analyze_binary( + analyzer_id=analyzer_id, binary_input=pdf_content, content_type="application/pdf" + ) + assert_poller_properties(analysis_poller, "Document properties analysis poller") + + # Wait for completion + print(f"Waiting for analysis completion") + analysis_result = await analysis_poller.result() + print(f"Analysis completed") + + # Save result to file + output_filename = save_analysis_result_to_file( + analysis_result, "test_validate_document_properties", test_file_dir, analyzer_id + ) + + # Validate document properties using the new helper function + # Sample invoice PDF is a single-page document + assert_document_properties(analysis_result, expected_min_pages=1) + + # Additional specific validations + assert analysis_result.contents is not None, "Should have contents" + first_content = analysis_result.contents[0] + + # Verify markdown output exists (basic OCR result) + assert hasattr(first_content, 'markdown'), "Content should have markdown attribute" + if first_content.markdown: + assert len(first_content.markdown) > 100, "Markdown content should contain substantial text from the document" + print(f"✓ Markdown content length: {len(first_content.markdown)} characters") + + # Verify fields were extracted if field schema was defined + if hasattr(first_content, 'fields') and first_content.fields: + assert 'total_amount' in first_content.fields, "Should extract total_amount field" + total_amount = first_content.fields['total_amount'] + assert total_amount is not None, "total_amount field should have a value" + print(f"✓ Extracted total_amount: {total_amount}") + + print(f"✓ Document properties validation test completed successfully") + + finally: + # Always clean up the created analyzer + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_analyze_invoice_with_fields_async(self, contentunderstanding_endpoint: str) -> None: + """ + Tests invoice analysis with comprehensive field extraction. + Verifies that invoice-specific fields (invoice_number, dates, amounts, vendor/customer info) are correctly extracted. + This test demonstrates structured data extraction from invoices using field schema. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + analyzer_id = generate_analyzer_id(client, "invoice_fields", is_async=True) + created_analyzer = False + + # Create an invoice analyzer with comprehensive field schema + invoice_analyzer = new_invoice_analyzer_object( + analyzer_id=analyzer_id, + description=f"test analyzer for invoice field extraction: {analyzer_id}", + tags={"test_type": "invoice_fields"}, + ) + + try: + # Create analyzer + print(f"\nCreating invoice analyzer with field schema") + poller = await create_analyzer_and_assert_async(client, analyzer_id, invoice_analyzer) + created_analyzer = True + + # Read the sample invoice PDF file + test_file_dir = os.path.dirname(os.path.abspath(__file__)) + pdf_path = os.path.join(test_file_dir, "test_data", "sample_invoice.pdf") + with open(pdf_path, "rb") as pdf_file: + pdf_content = pdf_file.read() + + print(f"Starting invoice analysis with field extraction") + + # Begin binary analysis + analysis_poller = await client.begin_analyze_binary( + analyzer_id=analyzer_id, binary_input=pdf_content, content_type="application/pdf" + ) + assert_poller_properties(analysis_poller, "Invoice analysis poller") + + # Wait for completion + print(f"Waiting for invoice analysis completion") + analysis_result = await analysis_poller.result() + print(f"Invoice analysis completed") + + # Save result to file for inspection + output_filename = save_analysis_result_to_file( + analysis_result, "test_analyze_invoice_with_fields", test_file_dir, analyzer_id + ) + print(f"Analysis result saved to: {output_filename}") + + # Validate invoice fields using the specialized assertion function + assert_invoice_fields(analysis_result, "Invoice analysis result") + + # Additional validation - verify at least total_amount is extracted (most critical field) + first_content = analysis_result.contents[0] + assert hasattr(first_content, 'fields'), "Content should have fields" + assert first_content.fields is not None, "Fields should not be None" + + fields = first_content.fields + assert 'total_amount' in fields, "Should extract total_amount field (most critical invoice field)" + + total_field = fields['total_amount'] + print(f"\n✓ Critical field verification:") + print(f" - total_amount extracted successfully") + + if isinstance(total_field, dict) and 'valueNumber' in total_field: + total_value = total_field['valueNumber'] + print(f" - Total amount value: {total_value}") + assert total_value > 0, "Total amount should be positive" + + # Verify confidence if available + if 'confidence' in total_field: + confidence = total_field['confidence'] + print(f" - Confidence: {confidence:.2%}") + # Note: We don't enforce a minimum confidence as it depends on document quality + + # Verify source information if available + if 'spans' in total_field: + spans = total_field['spans'] + print(f" - Source locations: {len(spans)} span(s)") + assert len(spans) > 0, "Should have source location for extracted field" + + if 'source' in total_field: + source = total_field['source'] + print(f" - Source: {source[:50]}..." if len(source) > 50 else f" - Source: {source}") + + # Count how many invoice fields were successfully extracted + invoice_field_names = [ + 'invoice_number', 'invoice_date', 'due_date', + 'vendor_name', 'vendor_address', 'customer_name', 'customer_address', + 'subtotal', 'tax_amount', 'total_amount' + ] + extracted_count = sum(1 for field in invoice_field_names if field in fields) + print(f"\n✓ Successfully extracted {extracted_count}/{len(invoice_field_names)} invoice fields") + print(f"✓ Invoice field extraction test completed successfully") + + finally: + # Always clean up the created analyzer + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py index f56685e9511a..d73f72d15229 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py @@ -304,3 +304,262 @@ def get_test_data_path(relative_path: str) -> str: """ test_file_dir = os.path.dirname(os.path.abspath(__file__)) return os.path.join(test_file_dir, "test_data", relative_path) + + +def assert_document_properties(analysis_result: Any, expected_min_pages: int = 1) -> None: + """Assert document-level properties from analysis result. + + Validates that the analysis result contains expected document properties such as: + - Page count + - Content structure (pages, paragraphs, etc.) + - OCR results if enabled + - Layout information + + Args: + analysis_result: The analysis result object to validate + expected_min_pages: Minimum expected number of pages (default: 1) + + Raises: + AssertionError: If any document property assertion fails + """ + print(f"Validating document properties") + + assert analysis_result is not None, "Analysis result should not be None" + assert analysis_result.contents is not None, "Analysis result should have contents" + assert len(analysis_result.contents) > 0, "Analysis result should have at least one content item" + + # Verify the first content has expected structure + first_content = analysis_result.contents[0] + assert first_content is not None, "First content should not be None" + + # Check if markdown content is present (most common output format) + if hasattr(first_content, 'markdown') and first_content.markdown: + markdown_content = first_content.markdown + assert isinstance(markdown_content, str), "Markdown content should be a string" + assert len(markdown_content) > 0, "Markdown content should not be empty" + print(f"✓ Markdown content found: {len(markdown_content)} characters") + + # Check pages information if available + if hasattr(first_content, 'pages') and first_content.pages: + pages = first_content.pages + assert len(pages) >= expected_min_pages, f"Expected at least {expected_min_pages} page(s), got {len(pages)}" + print(f"✓ Document has {len(pages)} page(s)") + + # Validate first page properties + first_page = pages[0] + if hasattr(first_page, 'page_number'): + assert first_page.page_number >= 1, "Page number should be >= 1" + print(f"✓ First page number: {first_page.page_number}") + + # Check if fields were extracted (if using field schema) + if hasattr(first_content, 'fields') and first_content.fields: + fields = first_content.fields + assert isinstance(fields, dict), "Fields should be a dictionary" + print(f"✓ Extracted {len(fields)} field(s): {list(fields.keys())}") + + # Validate each field has value + for field_name, field_value in fields.items(): + assert field_value is not None, f"Field '{field_name}' should have a value" + + print(f"✓ Document properties validation completed successfully") + + +def new_invoice_analyzer_object( + analyzer_id: str, description: Optional[str] = None, tags: Optional[Dict[str, str]] = None +) -> ContentAnalyzer: + """Create an invoice ContentAnalyzer object with comprehensive field extraction schema. + + This analyzer is configured to extract common invoice fields including: + - invoice_number: The invoice number or ID + - invoice_date: The date the invoice was issued + - due_date: The payment due date + - vendor_name: The name of the vendor/seller + - vendor_address: The vendor's address + - customer_name: The name of the customer/buyer + - customer_address: The customer's address + - subtotal: The subtotal amount before tax + - tax_amount: The tax amount + - total_amount: The total amount due + + Args: + analyzer_id: The analyzer ID + description: Optional description for the analyzer + tags: Optional tags for the analyzer + + Returns: + ContentAnalyzer: A configured ContentAnalyzer object for invoice analysis + """ + if description is None: + description = f"invoice analyzer: {analyzer_id}" + if tags is None: + tags = {"test_type": "invoice_analysis"} + + return ContentAnalyzer( + base_analyzer_id="prebuilt-document", + config=ContentAnalyzerConfig( + enable_formula=True, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ), + description=description, + field_schema=ContentFieldSchema( + fields={ + "invoice_number": ContentFieldDefinition( + description="The invoice number or ID", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.STRING, + ), + "invoice_date": ContentFieldDefinition( + description="The date the invoice was issued", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.STRING, + ), + "due_date": ContentFieldDefinition( + description="The payment due date", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.STRING, + ), + "vendor_name": ContentFieldDefinition( + description="The name of the vendor or seller", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.STRING, + ), + "vendor_address": ContentFieldDefinition( + description="The address of the vendor", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.STRING, + ), + "customer_name": ContentFieldDefinition( + description="The name of the customer or buyer", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.STRING, + ), + "customer_address": ContentFieldDefinition( + description="The address of the customer", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.STRING, + ), + "subtotal": ContentFieldDefinition( + description="The subtotal amount before tax", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.NUMBER, + ), + "tax_amount": ContentFieldDefinition( + description="The tax amount", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.NUMBER, + ), + "total_amount": ContentFieldDefinition( + description="The total amount due", + method=GenerationMethod.EXTRACT, + type=ContentFieldType.NUMBER, + ), + }, + description="Invoice field extraction schema", + name="invoice_schema", + ), + processing_location=ProcessingLocation.GLOBAL, + models={"completion": "gpt-4o"}, # Required when using field_schema + tags=tags, + ) + + +def assert_invoice_fields(analysis_result: Any, result_name: str = "Invoice analysis result") -> None: + """Assert invoice-specific field extraction from analysis result. + + Validates that the analysis result contains expected invoice fields and their properties: + - Fields are present and have values + - Numeric fields (total_amount, subtotal, tax_amount) have correct types + - String fields (invoice_number, dates, names) are non-empty + - Confidence scores are present + - Source/span information is available + + Args: + analysis_result: The analysis result object to validate + result_name: Optional name for the result in log messages + + Raises: + AssertionError: If any invoice field assertion fails + """ + print(f"Validating {result_name} invoice fields") + + assert analysis_result is not None, f"{result_name} should not be None" + assert analysis_result.contents is not None, f"{result_name} should have contents" + assert len(analysis_result.contents) > 0, f"{result_name} should have at least one content item" + + first_content = analysis_result.contents[0] + assert first_content is not None, "First content should not be None" + + # Verify fields were extracted + assert hasattr(first_content, 'fields'), "Content should have fields attribute" + assert first_content.fields is not None, "Fields should not be None" + fields = first_content.fields + assert isinstance(fields, dict), "Fields should be a dictionary" + assert len(fields) > 0, "Should have extracted at least one field" + + print(f"✓ Extracted {len(fields)} invoice field(s): {list(fields.keys())}") + + # Define expected invoice fields (at least some should be present) + expected_fields = [ + 'invoice_number', 'invoice_date', 'due_date', + 'vendor_name', 'vendor_address', + 'customer_name', 'customer_address', + 'subtotal', 'tax_amount', 'total_amount' + ] + + found_fields = [f for f in expected_fields if f in fields] + print(f"✓ Found {len(found_fields)} expected invoice fields: {found_fields}") + + # Validate numeric fields if present + numeric_fields = ['total_amount', 'subtotal', 'tax_amount'] + for field_name in numeric_fields: + if field_name in fields: + field_value = fields[field_name] + assert field_value is not None, f"Field '{field_name}' should have a value" + + # Check if it's a dict with 'valueNumber' (common response format) + if isinstance(field_value, dict): + assert 'type' in field_value, f"Field '{field_name}' should have a type" + assert field_value['type'] == 'number', f"Field '{field_name}' should have type 'number'" + + if 'valueNumber' in field_value: + value = field_value['valueNumber'] + assert isinstance(value, (int, float)), f"Field '{field_name}' valueNumber should be numeric" + assert value >= 0, f"Field '{field_name}' value should be non-negative" + print(f"✓ {field_name}: {value}") + + # Check confidence if available + if 'confidence' in field_value: + confidence = field_value['confidence'] + assert isinstance(confidence, (int, float)), f"Confidence should be numeric" + assert 0 <= confidence <= 1, f"Confidence should be between 0 and 1" + print(f" - Confidence: {confidence:.2%}") + + # Check spans/source if available + if 'spans' in field_value: + spans = field_value['spans'] + assert isinstance(spans, list), "Spans should be a list" + assert len(spans) > 0, "Should have at least one span" + print(f" - Source spans: {len(spans)} location(s)") + + # Validate string fields if present + string_fields = ['invoice_number', 'vendor_name', 'customer_name'] + for field_name in string_fields: + if field_name in fields: + field_value = fields[field_name] + assert field_value is not None, f"Field '{field_name}' should have a value" + + # Check if it's a dict with 'valueString' (common response format) + if isinstance(field_value, dict): + assert 'type' in field_value, f"Field '{field_name}' should have a type" + assert field_value['type'] == 'string', f"Field '{field_name}' should have type 'string'" + + if 'valueString' in field_value: + value = field_value['valueString'] + assert isinstance(value, str), f"Field '{field_name}' valueString should be string" + assert len(value) > 0, f"Field '{field_name}' value should not be empty" + print(f"✓ {field_name}: {value}") + + print(f"✓ Invoice fields validation completed successfully") From c002c18986d6165131850c07fdd58e166403a61a Mon Sep 17 00:00:00 2001 From: Changjian Wang Date: Mon, 1 Dec 2025 17:31:09 +0800 Subject: [PATCH 045/105] FEATURE: Add tests for extracting markdown from binary documents and creating classifiers with content categories --- ...ding_content_analyzers_operations_async.py | 310 ++++++++++++++++++ 1 file changed, 310 insertions(+) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py index 173a454b01c2..f1e2d63f7b5e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py @@ -935,3 +935,313 @@ async def test_analyze_invoice_with_fields_async(self, contentunderstanding_endp finally: # Always clean up the created analyzer await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_analyze_binary_extract_markdown_async(self, contentunderstanding_endpoint: str) -> None: + """Test extracting markdown content from analyzed binary documents. + + This test corresponds to .NET AnalyzeBinaryAsync_ExtractMarkdown. + Verifies that markdown is successfully extracted and is non-empty. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + + print("\n=== Test: Extract Markdown from Binary Document ===") + + # Get test file path + current_dir = os.path.dirname(os.path.abspath(__file__)) + file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") + assert os.path.exists(file_path), f"Sample file should exist at {file_path}" + print(f"Test file: {file_path}") + + # Read file content + with open(file_path, "rb") as f: + file_bytes = f.read() + assert len(file_bytes) > 0, "File should not be empty" + print(f"File size: {len(file_bytes)} bytes") + + # Analyze the document + print("\nAnalyzing document with prebuilt-documentSearch...") + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf", + ) + + # Wait for completion + result = await poller.result() + assert_poller_properties(poller) + + # Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should contain at least one content element" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + print(f"✓ Analysis completed with {len(result.contents)} content element(s)") + + # Extract markdown from first content + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Verify markdown content + assert hasattr(content, "markdown"), "Content should have markdown attribute" + assert content.markdown is not None, "Markdown content should not be null" + assert isinstance(content.markdown, str), "Markdown should be a string" + assert len(content.markdown) > 0, "Markdown content should not be empty" + assert content.markdown.strip(), "Markdown content should not be just whitespace" + + print(f"\n✓ Markdown extraction successful:") + print(f" - Markdown length: {len(content.markdown)} characters") + print(f" - First 100 chars: {content.markdown[:100]}...") + print(f"✓ Markdown extraction test completed successfully") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_create_classifier_async(self, contentunderstanding_endpoint: str) -> None: + """Test creating a classifier with content categories and document segmentation. + + This test corresponds to .NET CreateClassifierAsync. + Verifies that the classifier is created successfully with the specified categories + and configuration, and can segment documents into different categories. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + created_analyzer = False + analyzer_id = generate_analyzer_id(client, "test_classifier", is_async=True) + + print(f"\n=== Test: Create Classifier with Segmentation ===") + print(f"Analyzer ID: {analyzer_id}") + + try: + # Define content categories for classification + content_categories = { + "Loan_Application": { + "description": "Documents submitted by individuals or businesses to request funding" + }, + "Invoice": { + "description": "Billing documents issued by sellers or service providers to request payment" + }, + "Bank_Statement": { + "description": "Official statements issued by banks that summarize account activity" + } + } + + # Create analyzer configuration with categories and segmentation enabled + config = { + "returnDetails": True, + "enableSegment": True, + "contentCategories": content_categories + } + + # Create the classifier analyzer + classifier = { + "baseAnalyzerId": "prebuilt-document", + "description": "Custom classifier for financial document categorization", + "config": config, + "models": { + "completion": "gpt-4.1" + } + } + + print(f"\nCreating classifier with {len(content_categories)} categories...") + print(f"Categories: {', '.join(content_categories.keys())}") + + # Create the classifier + poller = await create_analyzer_and_assert_async(client, analyzer_id, classifier) + created_analyzer = True + + # Get the created classifier to verify full details + get_response = await client.get_analyzer(analyzer_id=analyzer_id) + assert get_response is not None, "Get analyzer response should not be null" + + result = get_response + assert result is not None, "Classifier result should not be null" + + # Verify config + if hasattr(result, "config") and result.config is not None: + config_dict = result.config if isinstance(result.config, dict) else result.config.as_dict() + if "contentCategories" in config_dict or "content_categories" in config_dict: + categories_key = "contentCategories" if "contentCategories" in config_dict else "content_categories" + categories = config_dict[categories_key] + assert len(categories) >= 3, "Should have at least 3 content categories" + print(f"✓ Classifier created successfully with {len(categories)} categories") + else: + print(" (Config exists but contentCategories not verified - may be service behavior)") + else: + print(" (Config verification skipped - result.config is None)") + + print(f"✓ Classifier test completed successfully") + + finally: + # Always clean up the created analyzer + await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_analyze_configs_async(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing a document with specific configurations enabled. + + This test corresponds to .NET AnalyzeConfigsAsync. + Verifies that document features can be extracted with formulas, layout, and OCR enabled. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + + print("\n=== Test: Analyze with Specific Configurations ===") + + # Get test file path + current_dir = os.path.dirname(os.path.abspath(__file__)) + file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") + + assert os.path.exists(file_path), f"Test file should exist at {file_path}" + print(f"Test file: {file_path}") + + # Read file content + with open(file_path, "rb") as f: + file_bytes = f.read() + assert len(file_bytes) > 0, "File should not be empty" + print(f"File size: {len(file_bytes)} bytes") + + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled + print("\nAnalyzing document with prebuilt-documentSearch (formulas, layout, OCR enabled)...") + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf", + ) + + # Wait for completion + result = await poller.result() + assert_poller_properties(poller) + + # Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result should contain contents" + assert len(result.contents) > 0, "Result should have at least one content" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + print(f"✓ Analysis completed with {len(result.contents)} content element(s)") + + # Verify document content + document_content = result.contents[0] + assert document_content is not None, "Content should not be null" + assert hasattr(document_content, "start_page_number"), "Should have start_page_number" + start_page = getattr(document_content, "start_page_number", None) + assert start_page is not None and start_page >= 1, "Start page should be >= 1" + + if hasattr(document_content, "end_page_number"): + end_page = getattr(document_content, "end_page_number", None) + assert end_page is not None and end_page >= start_page, \ + "End page should be >= start page" + print(f"✓ Document page range: {start_page}-{end_page}") + + # Verify markdown was extracted (OCR/layout result) + if hasattr(document_content, "markdown") and document_content.markdown: + print(f"✓ Markdown extracted ({len(document_content.markdown)} characters)") + + print(f"✓ Configuration test completed successfully") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_analyze_return_raw_json_async(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing a document and returning raw JSON response. + + This test corresponds to .NET AnalyzeReturnRawJsonAsync. + Verifies that the raw JSON response can be retrieved and parsed. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + + print("\n=== Test: Analyze and Return Raw JSON ===") + + # Get test file path + current_dir = os.path.dirname(os.path.abspath(__file__)) + file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") + assert os.path.exists(file_path), f"Sample file should exist at {file_path}" + print(f"Test file: {file_path}") + + # Read file content + with open(file_path, "rb") as f: + file_bytes = f.read() + assert len(file_bytes) > 0, "File should not be empty" + print(f"File size: {len(file_bytes)} bytes") + + # Analyze the document + print("\nAnalyzing document with prebuilt-documentSearch...") + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf", + ) + + # Wait for completion + result = await poller.result() + assert_poller_properties(poller) + + # Verify operation completed successfully + assert result is not None, "Analysis result should not be null" + + # Verify response can be serialized to JSON + import json + result_dict = result.as_dict() if hasattr(result, 'as_dict') else dict(result) + json_str = json.dumps(result_dict, indent=2) + assert len(json_str) > 0, "JSON string should not be empty" + + # Verify JSON can be parsed back + parsed = json.loads(json_str) + assert parsed is not None, "Parsed JSON should not be null" + assert isinstance(parsed, dict), "Parsed JSON should be a dictionary" + + print(f"✓ JSON serialization successful:") + print(f" - JSON length: {len(json_str)} characters") + print(f" - Top-level keys: {', '.join(list(parsed.keys())[:5])}...") + print(f"✓ Raw JSON test completed successfully") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_delete_result_async(self, contentunderstanding_endpoint: str) -> None: + """Test deleting an analysis result. + + This test corresponds to .NET DeleteResultAsync. + Verifies that an analysis result can be deleted using its operation ID. + """ + client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + + print("\n=== Test: Delete Analysis Result ===") + + # Get test file URI + document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + print(f"Document URL: {document_url}") + + # Start the analysis operation + print("\nStarting analysis operation...") + poller = await client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(url=document_url)], + polling_interval=1, + ) + + # Get the operation ID from the poller + operation_id = poller._polling_method._operation.get_polling_url().split('/')[-1] # type: ignore[attr-defined] + if '?' in operation_id: + operation_id = operation_id.split('?')[0] + assert operation_id is not None, "Operation ID should not be null" + assert len(operation_id) > 0, "Operation ID should not be empty" + print(f"Operation ID: {operation_id}") + + # Wait for completion + print("Waiting for analysis to complete...") + result = await poller.result() + + # Verify analysis completed successfully + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents" + assert result.contents is not None, "Result should contain contents" + assert len(result.contents) > 0, "Result should have at least one content" + print(f"✓ Analysis completed successfully") + + # Delete the analysis result + print(f"\nDeleting analysis result (operation ID: {operation_id})...") + await client.delete_result(operation_id=operation_id) + + print(f"✓ Delete result completed successfully") + print("Note: Deletion success verified by no exception thrown") + print(f"✓ Delete result test completed successfully") From 6368da725c96fc167c3adc1097be557ebd8840ce Mon Sep 17 00:00:00 2001 From: Changjian Wang Date: Mon, 1 Dec 2025 17:38:35 +0800 Subject: [PATCH 046/105] FEATURE: Update content analyzer methods and add tests for binary document analysis and classifier creation --- ...erstanding_content_analyzers_operations.py | 346 +++++++++++++++++- 1 file changed, 329 insertions(+), 17 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py index 66d3c55bf09f..192a59078a6d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py @@ -48,7 +48,7 @@ def create_analyzer_and_assert_sync( print(f"\nCreating analyzer {analyzer_id}") # Start the analyzer creation operation - poller = client.begin_create_or_replace( + poller = client.begin_create_analyzer( analyzer_id=analyzer_id, resource=resource, ) @@ -86,7 +86,7 @@ def delete_analyzer_and_assert_sync( if created_analyzer: print(f"Cleaning up analyzer {analyzer_id}") try: - client.delete(analyzer_id=analyzer_id) + client.delete_analyzer(analyzer_id=analyzer_id) # Verify deletion print(f"Analyzer {analyzer_id} is deleted successfully") except Exception as e: @@ -321,7 +321,7 @@ def test_content_analyzers_update(self, contentunderstanding_endpoint: str) -> N # Get the analyzer before update to verify initial state print(f"Getting analyzer {analyzer_id} before update") - analyzer_before_update = client.get(analyzer_id=analyzer_id) + analyzer_before_update = client.get_analyzer(analyzer_id=analyzer_id) assert analyzer_before_update is not None assert analyzer_before_update.analyzer_id == analyzer_id assert analyzer_before_update.description == f"Initial analyzer for update test: {analyzer_id}" @@ -331,23 +331,23 @@ def test_content_analyzers_update(self, contentunderstanding_endpoint: str) -> N ) # Create updated analyzer with only allowed properties (description and tags) - updated_analyzer = ContentAnalyzer( - base_analyzer_id=analyzer_before_update.base_analyzer_id, - models=analyzer_before_update.models, - analyzer_id=analyzer_id, - description=f"Updated analyzer description: {analyzer_id}", - tags={"updated_tag": "updated_value"}, - ) + updated_analyzer = { + "analyzerId": analyzer_id, + "baseAnalyzerId": analyzer_before_update.base_analyzer_id, + "models": analyzer_before_update.models, + "description": f"Updated analyzer description: {analyzer_id}", + "tags": {"updated_tag": "updated_value"}, + } # Update the analyzer print(f"Updating analyzer {analyzer_id}") - response = client.update(analyzer_id=analyzer_id, resource=updated_analyzer) + response = client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) assert response is not None assert response.analyzer_id == analyzer_id # Get the analyzer after update to verify changes persisted print(f"Getting analyzer {analyzer_id} after update") - analyzer_after_update = client.get(analyzer_id=analyzer_id) + analyzer_after_update = client.get_analyzer(analyzer_id=analyzer_id) assert analyzer_after_update is not None assert analyzer_after_update.analyzer_id == analyzer_id assert analyzer_after_update.description == f"Updated analyzer description: {analyzer_id}" @@ -387,7 +387,7 @@ def test_content_analyzers_delete(self, contentunderstanding_endpoint: str) -> N # Delete the analyzer print(f"Deleting analyzer {analyzer_id}") - response = client.delete(analyzer_id=analyzer_id) + response = client.delete_analyzer(analyzer_id=analyzer_id) # Verify the delete response assert response is None @@ -556,10 +556,12 @@ def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: print(f"Waiting for video analysis to complete") analysis_result = analysis_poller.result() - # Get the operation ID from the poller details - details = analysis_poller.details - assert "operation_id" in details, "Details should contain operation_id" - analysis_operation_id = details["operation_id"] + # Get the operation ID from the poller using custom poller's operation_id property + from azure.ai.contentunderstanding.models import AnalyzeLROPoller + + assert isinstance(analysis_poller, AnalyzeLROPoller), "Should return custom AnalyzeLROPoller" + + analysis_operation_id = analysis_poller.operation_id assert analysis_operation_id is not None, "Operation ID should not be None" assert len(analysis_operation_id) > 0, "Operation ID should not be empty" print(f"Analysis operation ID: {analysis_operation_id}") @@ -576,6 +578,316 @@ def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: # Always clean up the created analyzer, even if the test fails delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_analyze_binary_extract_markdown(self, contentunderstanding_endpoint: str) -> None: + """Test extracting markdown content from analyzed binary documents. + + This test corresponds to .NET AnalyzeBinary_ExtractMarkdown. + Verifies that markdown is successfully extracted and is non-empty. + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + + print("\n=== Test: Extract Markdown from Binary Document ===") + + # Get test file path + current_dir = os.path.dirname(os.path.abspath(__file__)) + file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") + assert os.path.exists(file_path), f"Sample file should exist at {file_path}" + print(f"Test file: {file_path}") + + # Read file content + with open(file_path, "rb") as f: + file_bytes = f.read() + assert len(file_bytes) > 0, "File should not be empty" + print(f"File size: {len(file_bytes)} bytes") + + # Analyze the document + print("\nAnalyzing document with prebuilt-documentSearch...") + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf", + ) + + # Wait for completion + result = poller.result() + assert_poller_properties(poller) + + # Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should contain at least one content element" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + print(f"✓ Analysis completed with {len(result.contents)} content element(s)") + + # Extract markdown from first content + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Verify markdown content + assert hasattr(content, "markdown"), "Content should have markdown attribute" + assert content.markdown is not None, "Markdown content should not be null" + assert isinstance(content.markdown, str), "Markdown should be a string" + assert len(content.markdown) > 0, "Markdown content should not be empty" + assert content.markdown.strip(), "Markdown content should not be just whitespace" + + print(f"\n✓ Markdown extraction successful:") + print(f" - Markdown length: {len(content.markdown)} characters") + print(f" - First 100 chars: {content.markdown[:100]}...") + print(f"✓ Markdown extraction test completed successfully") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_create_classifier(self, contentunderstanding_endpoint: str) -> None: + """Test creating a classifier with content categories and document segmentation. + + This test corresponds to .NET CreateClassifier. + Verifies that the classifier is created successfully with the specified categories + and configuration, and can segment documents into different categories. + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + created_analyzer = False + analyzer_id = generate_analyzer_id(client, "test_classifier", is_async=False) + + print(f"\n=== Test: Create Classifier with Segmentation ===") + print(f"Analyzer ID: {analyzer_id}") + + try: + # Define content categories for classification + content_categories = { + "Loan_Application": { + "description": "Documents submitted by individuals or businesses to request funding" + }, + "Invoice": { + "description": "Billing documents issued by sellers or service providers to request payment" + }, + "Bank_Statement": { + "description": "Official statements issued by banks that summarize account activity" + } + } + + # Create analyzer configuration with categories and segmentation enabled + config = { + "returnDetails": True, + "enableSegment": True, + "contentCategories": content_categories + } + + # Create the classifier analyzer + classifier = { + "baseAnalyzerId": "prebuilt-document", + "description": "Custom classifier for financial document categorization", + "config": config, + "models": { + "completion": "gpt-4.1" + } + } + + print(f"\nCreating classifier with {len(content_categories)} categories...") + print(f"Categories: {', '.join(content_categories.keys())}") + + # Create the classifier + poller = create_analyzer_and_assert_sync(client, analyzer_id, classifier) + created_analyzer = True + + # Get the created classifier to verify full details + get_response = client.get_analyzer(analyzer_id=analyzer_id) + assert get_response is not None, "Get analyzer response should not be null" + + result = get_response + assert result is not None, "Classifier result should not be null" + + # Verify config + if hasattr(result, "config") and result.config is not None: + config_dict = result.config if isinstance(result.config, dict) else result.config.as_dict() + if "contentCategories" in config_dict or "content_categories" in config_dict: + categories_key = "contentCategories" if "contentCategories" in config_dict else "content_categories" + categories = config_dict[categories_key] + assert len(categories) >= 3, "Should have at least 3 content categories" + print(f"✓ Classifier created successfully with {len(categories)} categories") + else: + print(" (Config exists but contentCategories not verified - may be service behavior)") + else: + print(" (Config verification skipped - result.config is None)") + + print(f"✓ Classifier test completed successfully") + + finally: + # Always clean up the created analyzer + delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_analyze_configs(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing a document with specific configurations enabled. + + This test corresponds to .NET AnalyzeConfigs. + Verifies that document features can be extracted with formulas, layout, and OCR enabled. + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + + print("\n=== Test: Analyze with Specific Configurations ===") + + # Get test file path + current_dir = os.path.dirname(os.path.abspath(__file__)) + file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") + + assert os.path.exists(file_path), f"Test file should exist at {file_path}" + print(f"Test file: {file_path}") + + # Read file content + with open(file_path, "rb") as f: + file_bytes = f.read() + assert len(file_bytes) > 0, "File should not be empty" + print(f"File size: {len(file_bytes)} bytes") + + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled + print("\nAnalyzing document with prebuilt-documentSearch (formulas, layout, OCR enabled)...") + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf", + ) + + # Wait for completion + result = poller.result() + assert_poller_properties(poller) + + # Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result should contain contents" + assert len(result.contents) > 0, "Result should have at least one content" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + print(f"✓ Analysis completed with {len(result.contents)} content element(s)") + + # Verify document content + document_content = result.contents[0] + assert document_content is not None, "Content should not be null" + assert hasattr(document_content, "start_page_number"), "Should have start_page_number" + start_page = getattr(document_content, "start_page_number", None) + assert start_page is not None and start_page >= 1, "Start page should be >= 1" + + if hasattr(document_content, "end_page_number"): + end_page = getattr(document_content, "end_page_number", None) + assert end_page is not None and end_page >= start_page, \ + "End page should be >= start page" + print(f"✓ Document page range: {start_page}-{end_page}") + + # Verify markdown was extracted (OCR/layout result) + if hasattr(document_content, "markdown") and document_content.markdown: + print(f"✓ Markdown extracted ({len(document_content.markdown)} characters)") + + print(f"✓ Configuration test completed successfully") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_analyze_return_raw_json(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing a document and returning raw JSON response. + + This test corresponds to .NET AnalyzeReturnRawJson. + Verifies that the raw JSON response can be retrieved and parsed. + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + + print("\n=== Test: Analyze and Return Raw JSON ===") + + # Get test file path + current_dir = os.path.dirname(os.path.abspath(__file__)) + file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") + assert os.path.exists(file_path), f"Sample file should exist at {file_path}" + print(f"Test file: {file_path}") + + # Read file content + with open(file_path, "rb") as f: + file_bytes = f.read() + assert len(file_bytes) > 0, "File should not be empty" + print(f"File size: {len(file_bytes)} bytes") + + # Analyze the document + print("\nAnalyzing document with prebuilt-documentSearch...") + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf", + ) + + # Wait for completion + result = poller.result() + assert_poller_properties(poller) + + # Verify operation completed successfully + assert result is not None, "Analysis result should not be null" + + # Verify response can be serialized to JSON + import json + result_dict = result.as_dict() if hasattr(result, 'as_dict') else dict(result) + json_str = json.dumps(result_dict, indent=2) + assert len(json_str) > 0, "JSON string should not be empty" + + # Verify JSON can be parsed back + parsed = json.loads(json_str) + assert parsed is not None, "Parsed JSON should not be null" + assert isinstance(parsed, dict), "Parsed JSON should be a dictionary" + + print(f"✓ JSON serialization successful:") + print(f" - JSON length: {len(json_str)} characters") + print(f" - Top-level keys: {', '.join(list(parsed.keys())[:5])}...") + print(f"✓ Raw JSON test completed successfully") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_content_analyzers_delete_result(self, contentunderstanding_endpoint: str) -> None: + """Test deleting an analysis result. + + This test corresponds to .NET DeleteResult. + Verifies that an analysis result can be deleted using its operation ID. + """ + client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + + print("\n=== Test: Delete Analysis Result ===") + + # Get test file URI + document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + print(f"Document URL: {document_url}") + + # Start the analysis operation + print("\nStarting analysis operation...") + poller = client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(url=document_url)], + polling_interval=1, + ) + + # Get the operation ID from the poller + operation_id = poller._polling_method._operation.get_polling_url().split('/')[-1] # type: ignore[attr-defined] + if '?' in operation_id: + operation_id = operation_id.split('?')[0] + assert operation_id is not None, "Operation ID should not be null" + assert len(operation_id) > 0, "Operation ID should not be empty" + print(f"Operation ID: {operation_id}") + + # Wait for completion + print("Waiting for analysis to complete...") + result = poller.result() + + # Verify analysis completed successfully + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents" + assert result.contents is not None, "Result should contain contents" + assert len(result.contents) > 0, "Result should have at least one content" + print(f"✓ Analysis completed successfully") + + # Delete the analysis result + print(f"\nDeleting analysis result (operation ID: {operation_id})...") + client.delete_result(operation_id=operation_id) + + print(f"✓ Delete result completed successfully") + print("Note: Deletion success verified by no exception thrown") + print(f"✓ Delete result test completed successfully") + # def test_content_analyzers_begin_analyze(self, contentunderstanding_endpoint): # client = self.create_client(endpoint=contentunderstanding_endpoint) From 2b76b13e83ec5b59ade6c2087ac602090370447e Mon Sep 17 00:00:00 2001 From: Changjian Wang Date: Mon, 1 Dec 2025 20:33:53 +0800 Subject: [PATCH 047/105] Add sample tests for content understanding SDK - Implement test_sample_10_analyze_configs.py to validate document analysis with specific configurations. - Create test_sample_11_analyze_return_raw_json.py to test raw JSON response from document analysis. - Add test_sample_12_get_result_file.py to demonstrate retrieving result files from analysis. - Implement test_sample_13_delete_result.py to validate deletion of analysis results. - Create test_sample_14_copy_analyzer.py to test copying analyzers within the same resource. - Add test_sample_15_grant_copy_auth.py to validate granting copy authorization for cross-resource analyzer copying. --- .../test_sample_00_configure_defaults.py | 139 +++++++++ .../samples/test_sample_01_analyze_binary.py | 263 ++++++++++++++++++ .../samples/test_sample_02_analyze_url.py | 230 +++++++++++++++ .../samples/test_sample_03_analyze_invoice.py | 210 ++++++++++++++ .../samples/test_sample_04_create_analyzer.py | 170 +++++++++++ .../test_sample_05_create_classifier.py | 138 +++++++++ .../samples/test_sample_06_get_analyzer.py | 119 ++++++++ .../samples/test_sample_07_list_analyzers.py | 118 ++++++++ .../samples/test_sample_08_update_analyzer.py | 164 +++++++++++ .../samples/test_sample_09_delete_analyzer.py | 176 ++++++++++++ .../samples/test_sample_10_analyze_configs.py | 161 +++++++++++ .../test_sample_11_analyze_return_raw_json.py | 135 +++++++++ .../samples/test_sample_12_get_result_file.py | 149 ++++++++++ .../samples/test_sample_13_delete_result.py | 112 ++++++++ .../samples/test_sample_14_copy_analyzer.py | 205 ++++++++++++++ .../samples/test_sample_15_grant_copy_auth.py | 207 ++++++++++++++ 16 files changed, 2696 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_00_configure_defaults.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_01_analyze_binary.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_02_analyze_url.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_03_analyze_invoice.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_04_create_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_05_create_classifier.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_06_get_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_07_list_analyzers.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_08_update_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_09_delete_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_10_analyze_configs.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_11_analyze_return_raw_json.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_12_get_result_file.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_13_delete_result.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_14_copy_analyzer.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_15_grant_copy_auth.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_00_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_00_configure_defaults.py new file mode 100644 index 000000000000..54b5a4b60e54 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_00_configure_defaults.py @@ -0,0 +1,139 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_00_configure_defaults.py + +DESCRIPTION: + These tests validate the sample_00_configure_defaults.py sample code. + Tests correspond to .NET Sample00_ConfigureDefaults.cs + +USAGE: + pytest test_sample_00_configure_defaults.py +""" + +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase + + +class TestSample00ConfigureDefaults(ContentUnderstandingClientTestBase): + """Tests for sample_00_configure_defaults.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_00_configure_defaults(self, contentunderstanding_endpoint: str) -> None: + """Test configuring and getting model deployment defaults. + + This test validates: + 1. Optional model deployment configuration (UpdateDefaults) + 2. Getting current defaults (GetDefaults) + 3. Model deployment mappings structure + + Corresponds to .NET Sample00_ConfigureDefaults.ConfigureDefaultsAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Test UpdateDefaults - only if deployment names are provided + self._test_update_defaults(client) + + # Test GetDefaults - always run + self._test_get_defaults(client) + + print("\n[SUCCESS] All test_sample_00_configure_defaults assertions passed") + + def _test_update_defaults(self, client): + """Test updating model deployment defaults. + + Corresponds to .NET Snippet:ContentUnderstandingUpdateDefaults + """ + # Check if deployment names are configured in environment + # In Python tests, these would come from environment variables or test configuration + # For now, we'll check if the deployments are configured + + try: + # Get current defaults to check structure + response = client.get_defaults() + current_defaults = response + + # Verify the response structure exists + assert current_defaults is not None, "GetDefaults response should not be null" + + # Check if model_deployments attribute exists + model_deployments = getattr(current_defaults, "model_deployments", None) + + if model_deployments and len(model_deployments) > 0: + print(f"[PASS] UpdateDefaults: Model deployments already configured ({len(model_deployments)} models)") + + # Validate structure of existing deployments + assert isinstance(model_deployments, dict), "Model deployments should be a dictionary" + + for key, value in model_deployments.items(): + assert isinstance(key, str) and key.strip(), f"Model key should be non-empty string, got {key}" + assert isinstance(value, str) and value.strip(), f"Deployment value should be non-empty string for key {key}" + print(f" {key} → {value}") + else: + print("[WARN] UpdateDefaults: No model deployments configured (this is optional)") + + except Exception as e: + # If update_defaults is not available or fails, that's okay + print(f"[WARN] UpdateDefaults: Skipping - {str(e)}") + + def _test_get_defaults(self, client): + """Test getting current model deployment defaults. + + Corresponds to .NET Snippet:ContentUnderstandingGetDefaults and assertions + """ + # Get current defaults + get_response = client.get_defaults() + + # Assertion: Verify response is not null + assert get_response is not None, "GetDefaults response should not be null" + print("[PASS] GetDefaults: Successfully retrieved defaults") + + # Get the defaults object + defaults = get_response + + # Assertion: Verify defaults object + assert defaults is not None, "Defaults object should not be null" + + # Check model deployments attribute + model_deployments = getattr(defaults, "model_deployments", None) + + if model_deployments: + # Assertion: Verify model_deployments structure + assert isinstance(model_deployments, dict), \ + "model_deployments should be a dictionary" + + if len(model_deployments) > 0: + print(f"[PASS] Current model deployment mappings ({len(model_deployments)} models):") + + # Assertion: Validate each deployment mapping + for key, value in model_deployments.items(): + assert isinstance(key, str), f"Model key should be string, got {type(key)}" + assert key.strip(), "Model key should not be empty or whitespace" + assert isinstance(value, str), f"Deployment value should be string for key {key}, got {type(value)}" + assert value.strip(), f"Deployment value should not be empty for key {key}" + print(f" {key} → {value}") + + # Assertion: Check for expected model keys (if any configured) + # Common models: gpt-4.1, gpt-4.1-mini, text-embedding-3-large + expected_keys = {"gpt-4.1", "gpt-4.1-mini", "text-embedding-3-large"} + found_keys = set(model_deployments.keys()) + + if found_keys & expected_keys: # If any expected keys are present + common_keys = found_keys & expected_keys + print(f"[PASS] Found expected model keys: {', '.join(sorted(common_keys))}") + else: + print(" No model deployments configured yet (this is valid)") + else: + # No model deployments is a valid state + print(" No model deployments configured yet (model_deployments attribute not present)") + + print("[PASS] GetDefaults: All assertions passed") + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_01_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_01_analyze_binary.py new file mode 100644 index 000000000000..3ddb3fd4c2ca --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_01_analyze_binary.py @@ -0,0 +1,263 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_01_analyze_binary.py + +DESCRIPTION: + These tests validate the sample_01_analyze_binary.py sample code. + Tests correspond to .NET Sample01_AnalyzeBinary.cs + +USAGE: + pytest test_sample_01_analyze_binary.py +""" + +import os +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase + + +class TestSample01AnalyzeBinary(ContentUnderstandingClientTestBase): + """Tests for sample_01_analyze_binary.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_01_analyze_binary(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing a document from binary data. + + This test validates: + 1. File loading and binary data creation + 2. Document analysis using begin_analyze_binary + 3. Markdown content extraction + 4. Document properties (MIME type, pages, tables) + + Corresponds to .NET Sample01_AnalyzeBinary.AnalyzeBinaryAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Read the sample file + # Use test_data directory from parent tests folder + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + # Assertion: Verify file exists + assert os.path.exists(file_path), f"Sample file not found at {file_path}" + print(f"[PASS] Sample file exists: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + # Assertion: Verify file is not empty + assert len(file_bytes) > 0, "File should not be empty" + print(f"[PASS] File loaded: {len(file_bytes)} bytes") + + # Assertion: Verify binary data (equivalent to .NET BinaryData) + assert file_bytes is not None, "Binary data should not be null" + print("[PASS] Binary data created successfully") + + # Analyze the document + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf" + ) + + result = poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + + # Verify raw response (equivalent to .NET GetRawResponse()) + # In Python SDK, we can check if the poller has result and get HTTP response info + # type: ignore is used here because we're accessing internal implementation details + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_initial_response'): + raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if raw_response: + # PipelineResponse has http_response attribute + if hasattr(raw_response, 'http_response'): + status = raw_response.http_response.status_code + elif hasattr(raw_response, 'status_code'): + status = raw_response.status_code + else: + status = None + + if status: + assert status >= 200 and status < 300, \ + f"Response status should be successful (200-299), but was {status}" + print(f"[PASS] Raw response verified (status: {status})") + + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Test markdown extraction + self._test_markdown_extraction(result) + + # Test document properties access + self._test_document_properties(result) + + print("\n[SUCCESS] All test_sample_01_analyze_binary assertions passed") + + def _test_markdown_extraction(self, result): + """Test markdown content extraction. + + Corresponds to .NET Assertion:ContentUnderstandingExtractMarkdown + """ + # Assertion: Verify contents structure + assert result.contents is not None, "Result should contain contents" + assert len(result.contents) > 0, "Result should have at least one content" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Assertion: Verify markdown content + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + assert markdown.strip(), "Markdown content should not be just whitespace" + print(f"[PASS] Markdown content extracted successfully ({len(markdown)} characters)") + else: + print("[WARN] No markdown content available") + + def _test_document_properties(self, result): + """Test document property access. + + Corresponds to .NET Assertion:ContentUnderstandingAccessDocumentProperties + """ + content = result.contents[0] + assert content is not None, "Content should not be null for document properties validation" + + # Check if this is DocumentContent (equivalent to .NET's DocumentContent type check) + content_type = type(content).__name__ + print(f"[INFO] Content type: {content_type}") + + # Validate this is document content (should have document-specific properties) + is_document_content = hasattr(content, 'mime_type') and hasattr(content, 'start_page_number') + if not is_document_content: + print(f"[WARN] Expected DocumentContent but got {content_type}, skipping document-specific validations") + return + + # Validate MIME type + mime_type = getattr(content, "mime_type", None) + if mime_type: + assert isinstance(mime_type, str), "MIME type should be a string" + assert mime_type.strip(), "MIME type should not be empty" + assert mime_type == "application/pdf", f"MIME type should be application/pdf, but was {mime_type}" + print(f"[PASS] MIME type verified: {mime_type}") + + # Validate page numbers + start_page = getattr(content, "start_page_number", None) + if start_page is not None: + assert start_page >= 1, f"Start page should be >= 1, but was {start_page}" + + end_page = getattr(content, "end_page_number", None) + if end_page is not None: + assert end_page >= start_page, f"End page {end_page} should be >= start page {start_page}" + total_pages = end_page - start_page + 1 + assert total_pages > 0, f"Total pages should be positive, but was {total_pages}" + print(f"[PASS] Page range verified: {start_page} to {end_page} ({total_pages} pages)") + + # Validate pages collection + pages = getattr(content, "pages", None) + if pages and len(pages) > 0: + assert len(pages) > 0, "Pages collection should not be empty when not null" + assert len(pages) == total_pages, \ + f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" + print(f"[PASS] Pages collection verified: {len(pages)} pages") + + # Validate individual pages + self._validate_pages(pages, start_page, end_page, content) + else: + print("[WARN] No pages collection available in document content") + + # Validate tables collection + tables = getattr(content, "tables", None) + if tables and len(tables) > 0: + self._validate_tables(tables) + else: + print("No tables found in document content") + + # Final validation message (matching .NET) + print("[PASS] All document properties validated successfully") + + def _validate_pages(self, pages, start_page, end_page, content=None): + """Validate pages collection details.""" + page_numbers = set() + unit = getattr(content, 'unit', None) if content else None + unit_str = str(unit) if unit else "units" + + for page in pages: + assert page is not None, "Page object should not be null" + assert hasattr(page, "page_number"), "Page should have page_number attribute" + assert page.page_number >= 1, f"Page number should be >= 1, but was {page.page_number}" + assert start_page <= page.page_number <= end_page, \ + f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" + + assert hasattr(page, "width") and page.width > 0, \ + f"Page {page.page_number} width should be > 0, but was {page.width}" + assert hasattr(page, "height") and page.height > 0, \ + f"Page {page.page_number} height should be > 0, but was {page.height}" + + # Ensure page numbers are unique + assert page.page_number not in page_numbers, \ + f"Page number {page.page_number} appears multiple times" + page_numbers.add(page.page_number) + + # Print page details with unit (matching .NET output) + print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") + + print(f"[PASS] All {len(pages)} pages validated successfully") + + def _validate_tables(self, tables): + """Validate tables collection details.""" + assert len(tables) > 0, "Tables collection should not be empty when not null" + print(f"[PASS] Tables collection verified: {len(tables)} tables") + + for i, table in enumerate(tables, 1): + assert table is not None, f"Table {i} should not be null" + assert hasattr(table, "row_count"), f"Table {i} should have row_count attribute" + assert hasattr(table, "column_count"), f"Table {i} should have column_count attribute" + assert table.row_count > 0, \ + f"Table {i} should have at least 1 row, but had {table.row_count}" + assert table.column_count > 0, \ + f"Table {i} should have at least 1 column, but had {table.column_count}" + + # Validate table cells if available + if hasattr(table, "cells") and table.cells: + assert len(table.cells) > 0, \ + f"Table {i} cells collection should not be empty when not null" + + for cell in table.cells: + assert cell is not None, "Table cell should not be null" + assert hasattr(cell, "row_index"), "Cell should have row_index" + assert hasattr(cell, "column_index"), "Cell should have column_index" + assert 0 <= cell.row_index < table.row_count, \ + f"Cell row index {cell.row_index} should be within table row count {table.row_count}" + assert 0 <= cell.column_index < table.column_count, \ + f"Cell column index {cell.column_index} should be within table column count {table.column_count}" + + if hasattr(cell, "row_span"): + assert cell.row_span >= 1, f"Cell row span should be >= 1, but was {cell.row_span}" + if hasattr(cell, "column_span"): + assert cell.column_span >= 1, f"Cell column span should be >= 1, but was {cell.column_span}" + + print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)") + else: + print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_02_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_02_analyze_url.py new file mode 100644 index 000000000000..14aec0545477 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_02_analyze_url.py @@ -0,0 +1,230 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_02_analyze_url.py + +DESCRIPTION: + These tests validate the sample_02_analyze_url.py sample code. + Tests correspond to .NET Sample02_AnalyzeUrl.cs + +USAGE: + pytest test_sample_02_analyze_url.py +""" + +import os +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import AnalyzeInput + + +class TestSample02AnalyzeUrl(ContentUnderstandingClientTestBase): + """Tests for sample_02_analyze_url.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_02_analyze_url(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing a document from URL. + + This test validates: + 1. URL validation + 2. Document analysis using begin_analyze with URL input + 3. Markdown content extraction + 4. Document properties (MIME type, pages, tables) + + Corresponds to .NET Sample02_AnalyzeUrl.AnalyzeUrlAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Use a publicly accessible URL for testing + # In production, this would be a real URL to a document + # For testing, we'll use binary data instead since file:// URLs are not supported + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + # Read file as binary data (since test proxy doesn't support file:// URLs) + with open(file_path, "rb") as f: + file_data = f.read() + + print(f"[PASS] Document loaded from: {file_path}") + + # Analyze the document + poller = client.begin_analyze( + analyzer_id="prebuilt-documentSearch", + inputs=[AnalyzeInput(data=file_data)] + ) + + result = poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + + # Verify raw response + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_initial_response'): + raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if raw_response: + if hasattr(raw_response, 'http_response'): + status = raw_response.http_response.status_code + elif hasattr(raw_response, 'status_code'): + status = raw_response.status_code + else: + status = None + + if status: + assert status >= 200 and status < 300, \ + f"Response status should be successful (200-299), but was {status}" + print(f"[PASS] Raw response verified (status: {status})") + + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Test markdown extraction + self._test_markdown_extraction(result) + + # Test document properties access + self._test_document_properties(result) + + print("\n[SUCCESS] All test_sample_02_analyze_url assertions passed") + + def _test_markdown_extraction(self, result): + """Test markdown content extraction.""" + assert result.contents is not None, "Result should contain contents" + assert len(result.contents) > 0, "Result should have at least one content" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + + content = result.contents[0] + assert content is not None, "Content should not be null" + + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + assert markdown.strip(), "Markdown content should not be just whitespace" + print(f"[PASS] Markdown content extracted successfully ({len(markdown)} characters)") + else: + print("[WARN] No markdown content available") + + def _test_document_properties(self, result): + """Test document property access.""" + content = result.contents[0] + assert content is not None, "Content should not be null for document properties validation" + + content_type = type(content).__name__ + print(f"[INFO] Content type: {content_type}") + + is_document_content = hasattr(content, 'mime_type') and hasattr(content, 'start_page_number') + if not is_document_content: + print(f"[WARN] Expected DocumentContent but got {content_type}, skipping document-specific validations") + return + + # Validate MIME type + mime_type = getattr(content, "mime_type", None) + if mime_type: + assert isinstance(mime_type, str), "MIME type should be a string" + assert mime_type.strip(), "MIME type should not be empty" + assert mime_type == "application/pdf", f"MIME type should be application/pdf, but was {mime_type}" + print(f"[PASS] MIME type verified: {mime_type}") + + # Validate page numbers + start_page = getattr(content, "start_page_number", None) + if start_page is not None: + assert start_page >= 1, f"Start page should be >= 1, but was {start_page}" + + end_page = getattr(content, "end_page_number", None) + if end_page is not None: + assert end_page >= start_page, f"End page {end_page} should be >= start page {start_page}" + total_pages = end_page - start_page + 1 + assert total_pages > 0, f"Total pages should be positive, but was {total_pages}" + print(f"[PASS] Page range verified: {start_page} to {end_page} ({total_pages} pages)") + + pages = getattr(content, "pages", None) + if pages and len(pages) > 0: + assert len(pages) > 0, "Pages collection should not be empty when not null" + assert len(pages) == total_pages, \ + f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" + print(f"[PASS] Pages collection verified: {len(pages)} pages") + self._validate_pages(pages, start_page, end_page, content) + else: + print("[WARN] No pages collection available in document content") + + tables = getattr(content, "tables", None) + if tables and len(tables) > 0: + self._validate_tables(tables) + else: + print("No tables found in document content") + + print("[PASS] All document properties validated successfully") + + def _validate_pages(self, pages, start_page, end_page, content=None): + """Validate pages collection details.""" + page_numbers = set() + unit = getattr(content, 'unit', None) if content else None + unit_str = str(unit) if unit else "units" + + for page in pages: + assert page is not None, "Page object should not be null" + assert hasattr(page, "page_number"), "Page should have page_number attribute" + assert page.page_number >= 1, f"Page number should be >= 1, but was {page.page_number}" + assert start_page <= page.page_number <= end_page, \ + f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" + + assert hasattr(page, "width") and page.width > 0, \ + f"Page {page.page_number} width should be > 0, but was {page.width}" + assert hasattr(page, "height") and page.height > 0, \ + f"Page {page.page_number} height should be > 0, but was {page.height}" + + assert page.page_number not in page_numbers, \ + f"Page number {page.page_number} appears multiple times" + page_numbers.add(page.page_number) + + print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") + + print(f"[PASS] All {len(pages)} pages validated successfully") + + def _validate_tables(self, tables): + """Validate tables collection details.""" + assert len(tables) > 0, "Tables collection should not be empty when not null" + print(f"[PASS] Tables collection verified: {len(tables)} tables") + + for i, table in enumerate(tables, 1): + assert table is not None, f"Table {i} should not be null" + assert hasattr(table, "row_count"), f"Table {i} should have row_count attribute" + assert hasattr(table, "column_count"), f"Table {i} should have column_count attribute" + assert table.row_count > 0, f"Table {i} should have at least 1 row, but had {table.row_count}" + assert table.column_count > 0, f"Table {i} should have at least 1 column, but had {table.column_count}" + + if hasattr(table, "cells") and table.cells: + assert len(table.cells) > 0, f"Table {i} cells collection should not be empty when not null" + + for cell in table.cells: + assert cell is not None, "Table cell should not be null" + assert hasattr(cell, "row_index"), "Cell should have row_index" + assert hasattr(cell, "column_index"), "Cell should have column_index" + assert 0 <= cell.row_index < table.row_count, \ + f"Cell row index {cell.row_index} should be within table row count {table.row_count}" + assert 0 <= cell.column_index < table.column_count, \ + f"Cell column index {cell.column_index} should be within table column count {table.column_count}" + + if hasattr(cell, "row_span"): + assert cell.row_span >= 1, f"Cell row span should be >= 1, but was {cell.row_span}" + if hasattr(cell, "column_span"): + assert cell.column_span >= 1, f"Cell column span should be >= 1, but was {cell.column_span}" + + print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)") + else: + print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_03_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_03_analyze_invoice.py new file mode 100644 index 000000000000..8f7b02c6fe35 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_03_analyze_invoice.py @@ -0,0 +1,210 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_03_analyze_invoice.py + +DESCRIPTION: + These tests validate the sample_03_analyze_invoice.py sample code. + Tests correspond to .NET Sample03_AnalyzeInvoice.cs + +USAGE: + pytest test_sample_03_analyze_invoice.py +""" + +import os +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import AnalyzeInput, DocumentContent + + +class TestSample03AnalyzeInvoice(ContentUnderstandingClientTestBase): + """Tests for sample_03_analyze_invoice.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_03_analyze_invoice(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing an invoice document with prebuilt-invoice analyzer. + + This test validates: + 1. Analyzing an invoice using prebuilt-invoice analyzer + 2. Extracting invoice-specific fields (CustomerName, InvoiceDate, TotalAmount, LineItems) + 3. Field confidence scores and source locations + + Corresponds to .NET Sample03_AnalyzeInvoice.AnalyzeInvoiceAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Get the invoice file path (use sample_invoice.pdf from test_data) + current_dir = os.path.dirname(os.path.abspath(__file__)) + test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") + invoice_path = os.path.join(test_data_dir, "sample_invoice.pdf") + + # Read the invoice file as binary data + with open(invoice_path, "rb") as f: + invoice_data = f.read() + + # Analyze the invoice + poller = client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(data=invoice_data)] + ) + + # Wait for analysis to complete + result = poller.result() + + # Assertions for operation + assert poller is not None, "Analysis operation should not be null" + print("[PASS] Analysis operation created successfully") + + # Verify raw response using getattr with type: ignore + raw_response = getattr(poller, '_polling_method', None) + if raw_response: + initial_response = getattr(raw_response, '_initial_response', None) # type: ignore + if initial_response: + status = getattr(initial_response, 'status_code', None) + if status: + assert 200 <= status < 300, f"Response status should be successful, but was {status}" + print(f"[PASS] Response status: {status}") + + # Assertions for result + assert result is not None, "Analysis result should not be null" + print("[PASS] Analysis result received") + + assert hasattr(result, 'contents'), "Result should contain contents" + contents = getattr(result, 'contents', None) + assert contents is not None, "Result contents should not be null" + assert len(contents) > 0, "Result should have at least one content" + assert len(contents) == 1, "Invoice should have exactly one content element" + print(f"[PASS] Analysis result contains {len(contents)} content(s)") + + # Get the document content + content = contents[0] + assert content is not None, "Content should not be null" + assert isinstance(content, DocumentContent), "Content should be of type DocumentContent" + print("[PASS] Content is of type DocumentContent") + + # Verify basic document properties + document_content = content + start_page = getattr(document_content, 'start_page_number', 1) + end_page = getattr(document_content, 'end_page_number', 1) + + assert start_page >= 1, "Start page should be >= 1" + assert end_page >= start_page, "End page should be >= start page" + total_pages = end_page - start_page + 1 + assert total_pages > 0, "Total pages should be positive" + print(f"[PASS] Document has {total_pages} page(s) from {start_page} to {end_page}") + + # Print document unit information + unit = getattr(document_content, 'unit', None) + if unit: + print(f"[INFO] Document unit: {unit}") + else: + print("[INFO] Document unit: unknown") + + # Extract and verify fields + fields = getattr(document_content, 'fields', {}) + + # Extract CustomerName field + customer_name_field = fields.get('CustomerName') + if customer_name_field: + print("[PASS] CustomerName field found") + + value = getattr(customer_name_field, 'value', None) + if value: + assert len(str(value)) > 0, "CustomerName value should not be empty when present" + print(f"[INFO] Customer Name: {value}") + + confidence = getattr(customer_name_field, 'confidence', None) + if confidence is not None: + assert 0 <= confidence <= 1, f"CustomerName confidence should be between 0 and 1, but was {confidence}" + print(f"[INFO] CustomerName confidence: {confidence:.2f}") + + source = getattr(customer_name_field, 'source', None) + if source: + print(f"[INFO] CustomerName source: {source}") + + spans = getattr(customer_name_field, 'spans', None) + if spans and len(spans) > 0: + span = spans[0] + offset = getattr(span, 'offset', None) + length = getattr(span, 'length', None) + if offset is not None and length is not None: + print(f"[INFO] CustomerName position in markdown: offset={offset}, length={length}") + else: + print("[INFO] CustomerName field not found in this document") + + # Extract InvoiceDate field + invoice_date_field = fields.get('InvoiceDate') + if invoice_date_field: + print("[PASS] InvoiceDate field found") + + value = getattr(invoice_date_field, 'value', None) + if value: + print(f"[INFO] Invoice Date: {value}") + + confidence = getattr(invoice_date_field, 'confidence', None) + if confidence is not None: + assert 0 <= confidence <= 1, f"InvoiceDate confidence should be between 0 and 1" + print(f"[INFO] InvoiceDate confidence: {confidence:.2f}") + + source = getattr(invoice_date_field, 'source', None) + if source: + print(f"[INFO] InvoiceDate source: {source}") + else: + print("[INFO] InvoiceDate field not found in this document") + + # Extract TotalAmount field (object field with nested Amount and CurrencyCode) + total_amount_field = fields.get('TotalAmount') + if total_amount_field: + print("[PASS] TotalAmount field found") + + # Try to extract nested fields if it's an object + if hasattr(total_amount_field, 'value') and isinstance(total_amount_field.value, dict): + amount_obj = total_amount_field.value + amount = amount_obj.get('Amount') + currency = amount_obj.get('CurrencyCode', '$') + + if amount: + print(f"[INFO] Total: {currency}{amount:.2f}" if isinstance(amount, (int, float)) else f"[INFO] Total: {currency}{amount}") + else: + value = getattr(total_amount_field, 'value', None) + if value: + print(f"[INFO] Total Amount: {value}") + + confidence = getattr(total_amount_field, 'confidence', None) + if confidence is not None: + print(f"[INFO] TotalAmount confidence: {confidence:.2f}") + else: + print("[INFO] TotalAmount field not found in this document") + + # Extract LineItems field (array field) + line_items_field = fields.get('LineItems') + if line_items_field: + print("[PASS] LineItems field found") + + # Try to extract array items + if hasattr(line_items_field, 'value') and isinstance(line_items_field.value, list): + items = line_items_field.value + print(f"[INFO] Line Items ({len(items)}):") + + for i, item in enumerate(items[:5]): # Show first 5 items + if isinstance(item, dict): + description = item.get('Description', 'N/A') + quantity = item.get('Quantity', 'N/A') + print(f"[INFO] Item {i + 1}: {description} (Qty: {quantity})") + + if len(items) > 5: + print(f"[INFO] ... and {len(items) - 5} more items") + else: + print("[INFO] LineItems format not as expected") + else: + print("[INFO] LineItems field not found in this document") + + print("\n[SUCCESS] All test_sample_03_analyze_invoice assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_04_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_04_create_analyzer.py new file mode 100644 index 000000000000..559075887301 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_04_create_analyzer.py @@ -0,0 +1,170 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_04_create_analyzer.py + +DESCRIPTION: + These tests validate the sample_04_create_analyzer.py sample code. + Tests correspond to .NET Sample04_CreateAnalyzer.cs + +USAGE: + pytest test_sample_04_create_analyzer.py +""" + +import pytest +import uuid +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldDefinition, + ContentFieldSchema, +) + + +class TestSample04CreateAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_04_create_analyzer.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_04_create_analyzer(self, contentunderstanding_endpoint: str) -> None: + """Test creating a custom analyzer with field schema. + + This test validates: + 1. Analyzer ID generation + 2. Field schema definition with multiple field types + 3. Analyzer configuration + 4. Model mappings + 5. Analyzer creation operation + + Corresponds to .NET Sample04_CreateAnalyzer.CreateAnalyzerAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Generate a unique analyzer ID + analyzer_id = f"test_custom_analyzer_{uuid.uuid4().hex[:16]}" + assert analyzer_id and analyzer_id.strip(), "Analyzer ID should not be empty" + print(f"[PASS] Analyzer ID generated: {analyzer_id}") + + # Define field schema with custom fields + # This example demonstrates three extraction methods: + # - extract: Literal text extraction + # - generate: AI-generated values based on content interpretation + # - classify: Classification against predefined categories + field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type="string", + method="extract", + description="Name of the company" + ), + "total_amount": ContentFieldDefinition( + type="number", + method="extract", + description="Total amount on the document" + ), + "document_summary": ContentFieldDefinition( + type="string", + method="generate", + description="A brief summary of the document content" + ), + "document_type": ContentFieldDefinition( + type="string", + method="classify", + description="Type of document", + enum=["invoice", "receipt", "contract", "report", "other"] + ) + } + ) + + # Validate field schema + assert field_schema and field_schema.fields, "Field schema should have fields" + assert len(field_schema.fields) == 4, "Field schema should have 4 fields" + assert field_schema.name == "company_schema", "Field schema name should match" + print(f"[PASS] Field schema defined with {len(field_schema.fields)} fields") + + # Validate each field definition + for field_name, field_def in field_schema.fields.items(): + assert field_def.type and field_def.method and field_def.description, \ + f"Field {field_name} should have type, method, and description" + assert field_def.method in ["extract", "generate", "classify"], \ + f"Field {field_name} method should be valid" + + # Verify enum for classify field + document_type_field = field_schema.fields["document_type"] + assert document_type_field.enum and len(document_type_field.enum) == 5, \ + "Document type should have 5 enum values" + print("[PASS] Field definitions validated") + + # Create analyzer configuration + config = ContentAnalyzerConfig( + enable_formula=True, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True + ) + + assert config.enable_formula and config.enable_layout and config.enable_ocr, \ + "Core features should be enabled" + print("[PASS] Analyzer configuration created") + + # Create custom analyzer definition + custom_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom analyzer for extracting company information", + config=config, + field_schema=field_schema, + models={ + "completion": "gpt-4.1", + "embedding": "text-embedding-3-large" + } + ) + + assert custom_analyzer.base_analyzer_id == "prebuilt-document", \ + "Base analyzer should be prebuilt-document" + assert custom_analyzer.models and len(custom_analyzer.models) >= 2, \ + "Should have at least 2 model mappings" + print("[PASS] Custom analyzer definition validated") + + # Create the analyzer + try: + poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=custom_analyzer + ) + result = poller.result() + + # Verify operation completed + assert poller.done(), "Operation should be completed" + print(f"[PASS] Analyzer '{analyzer_id}' created successfully") + + # Verify result properties if available + if result: + result_id = getattr(result, "analyzer_id", None) or getattr(result, "id", None) + if result_id: + assert result_id == analyzer_id, "Result analyzer ID should match" + print(f"[PASS] Result analyzer ID verified: {result_id}") + + except Exception as e: + error_msg = str(e) + print(f"\n[ERROR] Analyzer creation failed: {error_msg}") + pytest.skip(f"Analyzer creation not available: {error_msg[:100]}") + finally: + # Cleanup: Delete the analyzer + try: + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"[PASS] Cleanup: Analyzer '{analyzer_id}' deleted") + except Exception as e: + print(f"[WARN] Cleanup failed: {str(e)}") + + print("\n[SUCCESS] All test_sample_04_create_analyzer assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_05_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_05_create_classifier.py new file mode 100644 index 000000000000..f04d125e084f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_05_create_classifier.py @@ -0,0 +1,138 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_05_create_classifier.py + +DESCRIPTION: + These tests validate the sample_05_create_classifier.py sample code. + Tests correspond to .NET Sample05_CreateClassifier.cs + +USAGE: + pytest test_sample_05_create_classifier.py +""" + +import pytest +import uuid +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentCategory, +) + + +class TestSample05CreateClassifier(ContentUnderstandingClientTestBase): + """Tests for sample_05_create_classifier.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_05_create_classifier(self, contentunderstanding_endpoint: str) -> None: + """Test creating a custom classifier with content categories. + + This test validates: + 1. Content categories definition + 2. Analyzer configuration with segmentation + 3. Classifier creation + + Corresponds to .NET Sample05_CreateClassifier.CreateClassifierAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Generate a unique analyzer ID + analyzer_id = f"test_classifier_{uuid.uuid4().hex[:16]}" + + print(f"[PASS] Classifier ID generated: {analyzer_id}") + + # Define content categories for classification using ContentCategory objects + categories = { + "Loan_Application": ContentCategory( + description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." + ), + "Invoice": ContentCategory( + description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." + ), + "Bank_Statement": ContentCategory( + description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." + ) + } + + # Assertions for categories + assert categories is not None, "Categories should not be null" + assert len(categories) == 3, "Should have 3 categories" + print(f"[PASS] Content categories defined: {len(categories)} categories") + + # Validate each category has description + for cat_name, cat_def in categories.items(): + assert cat_def.description is not None, f"Category {cat_name} should have description" + assert cat_def.description.strip(), f"Category {cat_name} description should not be empty" + + print("[PASS] All category definitions validated") + + # Create analyzer configuration using ContentAnalyzerConfig model + config = ContentAnalyzerConfig( + return_details=True, + enable_segment=True, # Enable automatic segmentation by category + content_categories=categories + ) + + # Assertions for config + assert config is not None, "Config should not be null" + assert config.enable_segment is True, "Segmentation should be enabled" + assert config.content_categories is not None, "Config should have content categories" + assert len(config.content_categories) == 3, "Config should have 3 content categories" + print("[PASS] Classifier configuration created") + + # Create the classifier analyzer using ContentAnalyzer model + classifier = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom classifier for financial document categorization", + config=config, + models={ + "completion": "gpt-4.1" + } + ) + + # Assertions for classifier + assert classifier is not None, "Classifier should not be null" + assert classifier.base_analyzer_id == "prebuilt-document", \ + "Base analyzer should be prebuilt-document" + assert classifier.models is not None, "Classifier should have models" + assert "completion" in classifier.models, "Classifier should have completion model" + print("[PASS] Classifier definition validated") + + # Create the classifier + try: + poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=classifier + ) + + result = poller.result() + + # Assertions + assert poller is not None, "Create classifier operation should not be null" + assert poller.done(), "Operation should be completed" + print(f"[PASS] Classifier '{analyzer_id}' created successfully") + + assert result is not None, "Create classifier result should not be null" + print("[PASS] Create classifier result validated") + + # Cleanup + try: + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"[PASS] Cleanup: Classifier '{analyzer_id}' deleted") + except Exception as e: + print(f"[WARN] Cleanup failed: {str(e)}") + except Exception as e: + error_msg = str(e) + print(f"\n[ERROR] Full error message:\n{error_msg}") + pytest.skip(f"Classifier creation not available or failed: {error_msg[:100]}") + + print("\n[SUCCESS] All test_sample_05_create_classifier assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_06_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_06_get_analyzer.py new file mode 100644 index 000000000000..5c7e3982077c --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_06_get_analyzer.py @@ -0,0 +1,119 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_06_get_analyzer.py + +DESCRIPTION: + These tests validate the sample_06_get_analyzer.py sample code. + Tests correspond to .NET Sample06_GetAnalyzer.cs + +USAGE: + pytest test_sample_06_get_analyzer.py +""" + +import json +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase + + +class TestSample06GetAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_06_get_analyzer.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_06_get_analyzer(self, contentunderstanding_endpoint: str) -> None: + """Test getting information about a prebuilt analyzer. + + This test validates: + 1. Getting analyzer information using get_analyzer + 2. Analyzer response structure + 3. Analyzer JSON serialization + + Corresponds to .NET Sample06_GetAnalyzer.GetPrebuiltAnalyzerAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Get information about a prebuilt analyzer + response = client.get_analyzer(analyzer_id="prebuilt-documentSearch") + + # Assertions + assert response is not None, "Response should not be null" + print("[PASS] Get analyzer response received") + + analyzer = response + assert analyzer is not None, "Analyzer should not be null" + print("[PASS] Analyzer object is not null") + + # Verify basic analyzer properties for prebuilt-documentSearch + if hasattr(analyzer, 'base_analyzer_id'): + base_id = getattr(analyzer, 'base_analyzer_id', None) + if base_id: + print(f"[INFO] Base analyzer ID: {base_id}") + + if hasattr(analyzer, 'description'): + description = getattr(analyzer, 'description', None) + if description: + print(f"[INFO] Description: {description[:100]}{'...' if len(description) > 100 else ''}") + + # Verify config if present + if hasattr(analyzer, 'config'): + config = getattr(analyzer, 'config', None) + if config: + print("[INFO] Analyzer has configuration") + if hasattr(config, 'enable_ocr'): + enable_ocr = getattr(config, 'enable_ocr', None) + if enable_ocr is not None: + print(f"[INFO] EnableOcr: {enable_ocr}") + if hasattr(config, 'enable_layout'): + enable_layout = getattr(config, 'enable_layout', None) + if enable_layout is not None: + print(f"[INFO] EnableLayout: {enable_layout}") + + # Verify models if present + if hasattr(analyzer, 'models'): + models = getattr(analyzer, 'models', None) + if models and len(models) > 0: + print(f"[INFO] Analyzer has {len(models)} model mapping(s)") + for key, value in list(models.items())[:5]: # Show first 5 + print(f"[INFO] {key}: {value}") + + # Verify analyzer can be serialized to JSON + try: + # Convert analyzer to dict and then to JSON + if hasattr(analyzer, '__dict__'): + analyzer_dict = analyzer.__dict__ + elif hasattr(analyzer, 'as_dict'): + analyzer_dict = analyzer.as_dict() # type: ignore + else: + analyzer_dict = {"analyzer": str(analyzer)} + + analyzer_json = json.dumps(analyzer_dict, indent=2, default=str) + + assert analyzer_json is not None, "Analyzer JSON should not be null" + assert len(analyzer_json) > 0, "Analyzer JSON should not be empty" + print(f"[PASS] Analyzer JSON serialized successfully ({len(analyzer_json)} characters)") + + # Verify JSON contains analyzer identifier + assert "documentSearch" in analyzer_json.lower() or "prebuilt" in analyzer_json.lower(), \ + "Analyzer JSON should contain analyzer identifier" + print("[PASS] Analyzer JSON contains expected identifiers") + print(f"[PASS] Analyzer JSON length: {len(analyzer_json)} characters") + + # Display formatted JSON (first 500 chars for brevity) + print("\n[INFO] Prebuilt-documentSearch Analyzer (preview):") + print(analyzer_json[:500] + "..." if len(analyzer_json) > 500 else analyzer_json) + + except Exception as e: + print(f"[WARN] Could not fully serialize analyzer to JSON: {str(e)[:100]}") + # Still verify basic properties + assert analyzer is not None, "Analyzer should not be null" + + print("\n[PASS] All prebuilt analyzer properties validated successfully") + print("\n[SUCCESS] All test_sample_06_get_analyzer assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_07_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_07_list_analyzers.py new file mode 100644 index 000000000000..f1400404b317 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_07_list_analyzers.py @@ -0,0 +1,118 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_07_list_analyzers.py + +DESCRIPTION: + These tests validate the sample_07_list_analyzers.py sample code. + Tests correspond to .NET Sample07_ListAnalyzers.cs + +USAGE: + pytest test_sample_07_list_analyzers.py +""" + +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase + + +class TestSample07ListAnalyzers(ContentUnderstandingClientTestBase): + """Tests for sample_07_list_analyzers.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_07_list_analyzers(self, contentunderstanding_endpoint: str) -> None: + """Test listing all available analyzers. + + This test validates: + 1. Listing all analyzers using list_analyzers + 2. Counting prebuilt vs custom analyzers + 3. Displaying analyzer details + + Corresponds to .NET Sample07_ListAnalyzers.ListAnalyzersAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # List all analyzers + analyzers = [] + for analyzer in client.list_analyzers(): + analyzers.append(analyzer) + + # Assertions + assert analyzers is not None, "Analyzers list should not be null" + assert len(analyzers) > 0, "Should have at least one analyzer" + print(f"[PASS] Found {len(analyzers)} analyzer(s)") + + # Count prebuilt vs custom analyzers + prebuilt_count = sum(1 for a in analyzers + if hasattr(a, 'analyzer_id') and + getattr(a, 'analyzer_id', '').startswith('prebuilt-')) + custom_count = sum(1 for a in analyzers + if hasattr(a, 'analyzer_id') and + not getattr(a, 'analyzer_id', '').startswith('prebuilt-')) + + print(f"[INFO] Prebuilt analyzers: {prebuilt_count}") + print(f"[INFO] Custom analyzers: {custom_count}") + + # Verify counts + assert prebuilt_count >= 0, "Prebuilt count should be >= 0" + assert custom_count >= 0, "Custom count should be >= 0" + assert len(analyzers) == prebuilt_count + custom_count, "Total count should equal prebuilt + custom count" + print(f"[PASS] Count breakdown: {prebuilt_count} prebuilt, {custom_count} custom") + + # Verify we have some prebuilt analyzers + assert prebuilt_count > 0, "Should have at least one prebuilt analyzer" + print(f"[PASS] Prebuilt analyzers found: {prebuilt_count}") + + # Display details for first 10 analyzers (for test output brevity) + print("\n[INFO] Analyzer details (first 10):") + for i, analyzer in enumerate(analyzers[:10]): + analyzer_id = getattr(analyzer, 'analyzer_id', 'unknown') + description = getattr(analyzer, 'description', '(none)') + status = getattr(analyzer, 'status', 'unknown') + + print(f"\n [{i+1}] ID: {analyzer_id}") + if description and description != '(none)': + print(f" Description: {description[:80]}{'...' if len(description) > 80 else ''}") + else: + print(f" Description: (none)") + print(f" Status: {status}") + + if analyzer_id.startswith('prebuilt-'): + print(" Type: Prebuilt analyzer") + else: + print(" Type: Custom analyzer") + + if len(analyzers) > 10: + print(f"\n[INFO] ... and {len(analyzers) - 10} more analyzer(s)") + + # Verify each analyzer has required properties + valid_analyzers = 0 + analyzers_with_description = 0 + + for analyzer in analyzers: + assert hasattr(analyzer, 'analyzer_id'), "Analyzer should have analyzer_id property" + analyzer_id = getattr(analyzer, 'analyzer_id', None) + assert analyzer_id is not None, "Analyzer ID should not be null" + assert len(analyzer_id) > 0, "Analyzer ID should not be empty" + + # Verify analyzer ID format (should not contain spaces) + assert ' ' not in analyzer_id, f"Analyzer ID should not contain spaces: {analyzer_id}" + + valid_analyzers += 1 + + # Track optional properties + description = getattr(analyzer, 'description', None) + if description and len(str(description).strip()) > 0: + analyzers_with_description += 1 + + assert len(analyzers) == valid_analyzers, "All analyzers should have valid IDs" + print(f"\n[PASS] All {valid_analyzers} analyzers have valid IDs") + print(f"[INFO] Analyzers with description: {analyzers_with_description}") + print("\n[SUCCESS] All test_sample_07_list_analyzers assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_08_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_08_update_analyzer.py new file mode 100644 index 000000000000..aaf347041e9e --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_08_update_analyzer.py @@ -0,0 +1,164 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_08_update_analyzer.py + +DESCRIPTION: + These tests validate the sample_08_update_analyzer.py sample code. + Tests correspond to .NET Sample08_UpdateAnalyzer.cs + +USAGE: + pytest test_sample_08_update_analyzer.py +""" + +import uuid +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import ContentAnalyzer, ContentAnalyzerConfig + + +class TestSample08UpdateAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_08_update_analyzer.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_08_update_analyzer(self, contentunderstanding_endpoint: str) -> None: + """Test updating an analyzer's properties. + + This test validates: + 1. Creating an initial analyzer + 2. Getting current analyzer state + 3. Updating analyzer description and tags + 4. Verifying updates were applied correctly + + Corresponds to .NET Sample08_UpdateAnalyzer.UpdateAnalyzerAsync() + """ + # Skip this test if API is not available + try: + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Generate unique analyzer ID for this test + analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" + print(f"[INFO] Creating test analyzer: {analyzer_id}") + + # Create initial analyzer + initial_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Initial description", + config=ContentAnalyzerConfig( + return_details=True + ), + models={ + "completion": "gpt-4.1" + }, + tags={ + "tag1": "tag1_initial_value", + "tag2": "tag2_initial_value" + } + ) + + # Create the analyzer + create_poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=initial_analyzer, + allow_replace=True + ) + create_result = create_poller.result() + assert create_result is not None, "Created analyzer should not be null" + print("[PASS] Initial analyzer created successfully") + + # Get the current analyzer to preserve base analyzer ID + current_analyzer = client.get_analyzer(analyzer_id=analyzer_id) + + # Assertions for initial retrieval + assert current_analyzer is not None, "Current analyzer response should not be null" + print("[PASS] Current analyzer retrieved successfully") + + # Display current analyzer information + print("\n[INFO] Current analyzer information:") + current_description = getattr(current_analyzer, 'description', None) + current_tags = getattr(current_analyzer, 'tags', {}) + print(f" Description: {current_description}") + print(f" Tags: {', '.join(f'{k}={v}' for k, v in current_tags.items())}") + + # Verify initial state + assert current_description == "Initial description", "Initial description should match" + assert "tag1" in current_tags, "tag1 should exist" + assert current_tags.get("tag1") == "tag1_initial_value", "tag1 value should match" + assert "tag2" in current_tags, "tag2 should exist" + assert current_tags.get("tag2") == "tag2_initial_value", "tag2 value should match" + print("[PASS] Initial analyzer state verified") + + # Create an updated analyzer with new description and tags + base_id = getattr(current_analyzer, 'base_analyzer_id', 'prebuilt-document') + updated_analyzer = ContentAnalyzer( + base_analyzer_id=base_id, + description="Updated description", + tags={ + "tag1": "tag1_updated_value", + "tag2": "", # Remove tag2 (empty string) + "tag3": "tag3_value" # Add tag3 + } + ) + + # Update the analyzer + client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) + print("[PASS] Analyzer updated successfully") + + # Verify the update + updated = client.get_analyzer(analyzer_id=analyzer_id) + + # Assertions for updated analyzer + assert updated is not None, "Updated analyzer response should not be null" + print("[PASS] Updated analyzer retrieved successfully") + + # Display updated analyzer information + print("\n[INFO] Updated analyzer information:") + updated_description = getattr(updated, 'description', None) + updated_tags = getattr(updated, 'tags', {}) + print(f" Description: {updated_description}") + print(f" Tags: {', '.join(f'{k}={v}' for k, v in updated_tags.items())}") + + # Verify description was updated + assert updated_description == "Updated description", "Description should be updated" + print("[PASS] Description updated correctly") + + # Verify tags were updated + assert "tag1" in updated_tags, "tag1 should still exist" + assert updated_tags.get("tag1") == "tag1_updated_value", "tag1 value should be updated" + print("[PASS] tag1 updated correctly") + + # Verify tag2 was removed (or has empty value) + if "tag2" in updated_tags: + assert updated_tags.get("tag2") == "", "tag2 should have empty value" + print("[PASS] tag2 set to empty value") + else: + print("[PASS] tag2 removed successfully") + + # Verify tag3 was added + assert "tag3" in updated_tags, "tag3 should be added" + assert updated_tags.get("tag3") == "tag3_value", "tag3 value should match" + print("[PASS] tag3 added correctly") + + print("\n[SUCCESS] All test_sample_08_update_analyzer assertions passed") + + except Exception as e: + error_msg = str(e).lower() + if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: + pytest.skip(f"API not available: {str(e)[:100]}") + raise + finally: + # Clean up: delete the test analyzer + try: + if 'analyzer_id' in locals() and 'client' in locals(): + client.delete_analyzer(analyzer_id=analyzer_id) # type: ignore + print(f"\n[INFO] Test analyzer deleted: {analyzer_id}") # type: ignore + except Exception as cleanup_error: + print(f"\n[WARN] Could not delete test analyzer: {str(cleanup_error)[:100]}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_09_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_09_delete_analyzer.py new file mode 100644 index 000000000000..01499599e4c6 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_09_delete_analyzer.py @@ -0,0 +1,176 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_09_delete_analyzer.py + +DESCRIPTION: + These tests validate the sample_09_delete_analyzer.py sample code. + Tests correspond to .NET Sample09_DeleteAnalyzer.cs + +USAGE: + pytest test_sample_09_delete_analyzer.py +""" + +import uuid +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import ContentAnalyzer, ContentAnalyzerConfig +from azure.core.exceptions import ResourceNotFoundError + + +class TestSample09DeleteAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_09_delete_analyzer.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_09_delete_analyzer(self, contentunderstanding_endpoint: str) -> None: + """Test deleting an analyzer. + + This test validates: + 1. Creating a simple analyzer + 2. Verifying the analyzer exists + 3. Deleting the analyzer + 4. Verifying deletion was successful + + Corresponds to .NET Sample09_DeleteAnalyzer.DeleteAnalyzerAsync() + """ + # Skip this test if API is not available + try: + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Generate unique analyzer ID for this test + analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" + print(f"[INFO] Analyzer ID generated: {analyzer_id}") + + # Create a simple analyzer + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Simple analyzer for deletion example", + config=ContentAnalyzerConfig( + return_details=True + ), + models={ + "completion": "gpt-4.1" + } + ) + + # Assertions for analyzer object + assert analyzer is not None, "Analyzer object should not be null" + assert analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" + assert analyzer.description == "Simple analyzer for deletion example", "Description should match" + assert analyzer.config is not None, "Config should not be null" + assert analyzer.config.return_details is True, "ReturnDetails should be true" + assert analyzer.models is not None, "Models should not be null" + assert "completion" in analyzer.models, "Should have completion model" + assert analyzer.models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" + print("[PASS] Analyzer object configured correctly") + + # Create the analyzer + create_poller = client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + allow_replace=True + ) + create_result = create_poller.result() + print(f"[PASS] Analyzer '{analyzer_id}' created successfully") + + # Verify the analyzer was created successfully + get_response = client.get_analyzer(analyzer_id=analyzer_id) + + # Assertions for get response + assert get_response is not None, "Get analyzer response should not be null" + print("[PASS] Analyzer retrieved successfully after creation") + + # Verify analyzer properties + created_base_id = getattr(get_response, 'base_analyzer_id', None) + assert created_base_id is not None, "Base analyzer ID should not be null" + assert created_base_id == "prebuilt-document", "Base analyzer ID should match" + print(f"[PASS] Base analyzer ID verified: {created_base_id}") + + created_description = getattr(get_response, 'description', None) + assert created_description is not None, "Description should not be null" + assert created_description == "Simple analyzer for deletion example", "Description should match" + print(f"[PASS] Description verified: '{created_description}'") + + # Verify config + created_config = getattr(get_response, 'config', None) + if created_config is not None: + print("[INFO] Config exists") + return_details = getattr(created_config, 'return_details', None) + if return_details is not None: + assert return_details is True, "ReturnDetails should be true" + print(f"[PASS] ReturnDetails: {return_details}") + + # Verify models + created_models = getattr(get_response, 'models', None) + if created_models is not None: + assert len(created_models) >= 1, "Should have at least 1 model" + print(f"[PASS] Models verified: {len(created_models)} model(s)") + + if "completion" in created_models: + assert created_models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" + print(f"[PASS] completion: {created_models['completion']}") + + print(f"[PASS] Verified analyzer '{analyzer_id}' exists and is correctly configured before deletion") + + # Delete the analyzer + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"[PASS] Analyzer '{analyzer_id}' deleted successfully") + + # Verify the analyzer was deleted by trying to get it + print(f"[INFO] Attempting to verify deletion of analyzer '{analyzer_id}'...") + + deletion_verified = False + status_code = None + error_message = None + + try: + deleted_response = client.get_analyzer(analyzer_id=analyzer_id) + + # If we reach here, the call succeeded which is unexpected + print("[WARN] Unexpected: Get analyzer call succeeded after deletion") + raw_response = getattr(deleted_response, '_response', None) + if raw_response: + status_code = getattr(raw_response, 'status_code', None) + print(f"[WARN] Response status: {status_code}") + + if deleted_response is not None: + analyzer_id_attr = getattr(deleted_response, 'analyzer_id', None) + description_attr = getattr(deleted_response, 'description', None) + print(f"[WARN] Analyzer ID: {analyzer_id_attr or '(null)'}") + print(f"[WARN] Description: {description_attr or '(null)'}") + + except ResourceNotFoundError as e: + # Expected: analyzer should not be found + deletion_verified = True + status_code = getattr(e, 'status_code', 404) + error_message = str(e) + print(f"[PASS] Expected error received: Analyzer not found") + print(f"[PASS] Status code: {status_code}") + print(f"[PASS] Error message: {error_message[:100]}{'...' if len(error_message) > 100 else ''}") + + except Exception as e: + # Some other error occurred + print(f"[WARN] Unexpected error during verification: {str(e)[:100]}") + # Still consider it verified if we got an error trying to get it + deletion_verified = True + error_message = str(e) + + # Final assertions + assert deletion_verified, "Deletion should be verified (analyzer not found after deletion)" + print(f"[PASS] Deletion verified: Analyzer '{analyzer_id}' is no longer accessible") + + print("\n[SUCCESS] All test_sample_09_delete_analyzer assertions passed") + + except Exception as e: + error_msg = str(e).lower() + if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: + pytest.skip(f"API not available: {str(e)[:100]}") + raise diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_10_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_10_analyze_configs.py new file mode 100644 index 000000000000..3dea96c949c0 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_10_analyze_configs.py @@ -0,0 +1,161 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_10_analyze_configs.py + +DESCRIPTION: + These tests validate the sample_10_analyze_configs.py sample code. + Tests correspond to .NET Sample10_AnalyzeConfigs.cs + +USAGE: + pytest test_sample_10_analyze_configs.py +""" + +import os +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase + + +class TestSample10AnalyzeConfigs(ContentUnderstandingClientTestBase): + """Tests for sample_10_analyze_configs.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_10_analyze_configs(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing a document with specific configuration options. + + This test validates: + 1. Document analysis with prebuilt-documentSearch analyzer + 2. Configuration options (formulas, layout, OCR enabled) + 3. Document features extraction (charts, annotations, hyperlinks, formulas) + + Corresponds to .NET Sample10_AnalyzeConfigs.AnalyzeConfigsAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Read the sample file (using sample_invoice.pdf as it contains various features) + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + # Assertion: Verify file exists + assert os.path.exists(file_path), f"Sample file not found at {file_path}" + print(f"[PASS] Sample file exists: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + # Assertion: Verify file is not empty + assert len(file_bytes) > 0, "File should not be empty" + print(f"[PASS] File loaded: {len(file_bytes)} bytes") + + # Assertion: Verify binary data + assert file_bytes is not None, "Binary data should not be null" + print("[PASS] Binary data created successfully") + + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf" + ) + + result = poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + + # Verify raw response + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_initial_response'): + raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if raw_response: + if hasattr(raw_response, 'http_response'): + status = raw_response.http_response.status_code + elif hasattr(raw_response, 'status_code'): + status = raw_response.status_code + else: + status = None + + if status: + assert status >= 200 and status < 300, \ + f"Response status should be successful (200-299), but was {status}" + print(f"[PASS] Raw response verified (status: {status})") + + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should have at least one content" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Verify document content type + first_content = result.contents[0] + assert first_content is not None, "Content should not be null" + + # Check if this is document content + content_type = type(first_content).__name__ + print(f"[INFO] Content type: {content_type}") + + is_document_content = hasattr(first_content, 'mime_type') and hasattr(first_content, 'start_page_number') + if is_document_content: + start_page = getattr(first_content, "start_page_number", None) + end_page = getattr(first_content, "end_page_number", None) + + if start_page and end_page: + assert start_page >= 1, "Start page should be >= 1" + assert end_page >= start_page, "End page should be >= start page" + total_pages = end_page - start_page + 1 + print(f"[PASS] Document has {total_pages} page(s) from {start_page} to {end_page}") + + print("[PASS] Document features analysis with configs completed successfully") + + # Test document feature extraction + self._test_document_features(first_content) + + print("\n[SUCCESS] All test_sample_10_analyze_configs assertions passed") + + def _test_document_features(self, content): + """Test extraction of document features like charts, annotations, hyperlinks.""" + # Check for charts + charts = getattr(content, "charts", None) + if charts and len(charts) > 0: + print(f"[PASS] Found {len(charts)} chart(s) in document") + for i, chart in enumerate(charts, 1): + assert chart is not None, f"Chart {i} should not be null" + print(f" Chart {i} detected") + else: + print("[INFO] No charts found in document") + + # Check for annotations + annotations = getattr(content, "annotations", None) + if annotations and len(annotations) > 0: + print(f"[PASS] Found {len(annotations)} annotation(s) in document") + else: + print("[INFO] No annotations found in document") + + # Check for hyperlinks + hyperlinks = getattr(content, "hyperlinks", None) + if hyperlinks and len(hyperlinks) > 0: + print(f"[PASS] Found {len(hyperlinks)} hyperlink(s) in document") + else: + print("[INFO] No hyperlinks found in document") + + # Check for formulas + formulas = getattr(content, "formulas", None) + if formulas and len(formulas) > 0: + print(f"[PASS] Found {len(formulas)} formula(s) in document") + else: + print("[INFO] No formulas found in document") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_11_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_11_analyze_return_raw_json.py new file mode 100644 index 000000000000..20bc8e741901 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_11_analyze_return_raw_json.py @@ -0,0 +1,135 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_11_analyze_return_raw_json.py + +DESCRIPTION: + These tests validate the sample_11_analyze_return_raw_json.py sample code. + Tests correspond to .NET Sample11_AnalyzeReturnRawJson.cs + +USAGE: + pytest test_sample_11_analyze_return_raw_json.py +""" + +import os +import json +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase + + +class TestSample11AnalyzeReturnRawJson(ContentUnderstandingClientTestBase): + """Tests for sample_11_analyze_return_raw_json.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_11_analyze_return_raw_json(self, contentunderstanding_endpoint: str) -> None: + """Test analyzing a document and getting raw JSON response. + + This test validates: + 1. Document analysis using protocol method + 2. Raw JSON response format + 3. JSON structure validation + + Corresponds to .NET Sample11_AnalyzeReturnRawJson.AnalyzeReturnRawJsonAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Read the sample file + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + # Assertion: Verify file exists + assert os.path.exists(file_path), f"Sample file not found at {file_path}" + print(f"[PASS] Sample file exists: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + # Assertion: Verify file is not empty + assert len(file_bytes) > 0, "File should not be empty" + print(f"[PASS] File loaded: {len(file_bytes)} bytes") + + # Analyze the document and get raw response + # Note: The Python SDK returns structured objects by default + # We can access the raw response through the result + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf" + ) + + result = poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + + # Verify raw response status + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_initial_response'): + raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if raw_response: + if hasattr(raw_response, 'http_response'): + status = raw_response.http_response.status_code + elif hasattr(raw_response, 'status_code'): + status = raw_response.status_code + else: + status = None + + if status: + assert status >= 200 and status < 300, \ + f"Response status should be successful (200-299), but was {status}" + print(f"[PASS] Raw response status verified: {status}") + + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + print("[PASS] Response data is not null") + + # Convert result to JSON string to verify raw format capability + # In Python SDK, we can serialize the result to JSON + try: + # Try to access the raw response data + if hasattr(result, '__dict__'): + result_dict = result.__dict__ + json_str = json.dumps(result_dict, default=str) + assert json_str is not None, "Response string should not be null" + assert len(json_str) > 0, "Response string should not be empty" + print(f"[PASS] Response converted to JSON string: {len(json_str)} characters") + + # Verify it's valid JSON + parsed_json = json.loads(json_str) + assert parsed_json is not None, "Response should be valid JSON" + print("[PASS] Response is valid JSON format") + else: + print("[INFO] Result does not have __dict__ attribute, using alternative method") + + # Alternative: Check if result has contents (which confirms it's a valid response) + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + print("[PASS] Response data structure verified") + + except json.JSONDecodeError as e: + pytest.fail(f"Response should be valid JSON format: {str(e)}") + except Exception as e: + print(f"[WARN] Could not serialize to JSON: {str(e)}") + # Still verify basic structure + assert result is not None, "Result should not be null" + print("[PASS] Response data verified (structured format)") + + # Verify the response contains expected data + assert hasattr(result, "contents"), "Result should have contents" + if result.contents and len(result.contents) > 0: + print(f"[PASS] Response contains {len(result.contents)} content(s)") + + print("\n[SUCCESS] All test_sample_11_analyze_return_raw_json assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_12_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_12_get_result_file.py new file mode 100644 index 000000000000..3cd33eadba5f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_12_get_result_file.py @@ -0,0 +1,149 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_12_get_result_file.py + +DESCRIPTION: + These tests validate the sample_12_get_result_file.py sample code. + Tests correspond to .NET Sample12_GetResultFile.cs + +USAGE: + pytest test_sample_12_get_result_file.py +""" + +import os +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import AnalyzeInput + + +class TestSample12GetResultFile(ContentUnderstandingClientTestBase): + """Tests for sample_12_get_result_file.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_12_get_result_file(self, contentunderstanding_endpoint: str) -> None: + """Test getting result files (like keyframe images) from analysis results. + + This test validates: + 1. Starting video analysis operation + 2. Getting operation ID immediately after start + 3. Waiting for operation completion + 4. Retrieving keyframe images using get_result_file + + Corresponds to .NET Sample12_GetResultFile.GetResultFileAsync() + + Note: This test uses document analysis as video analysis may not be available. + The API pattern is the same for both document and video analysis. + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Use document analysis for testing as video analysis may not be available + # The get_result_file API pattern is the same for both document and video + current_dir = os.path.dirname(os.path.abspath(__file__)) + test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") + document_path = os.path.join(test_data_dir, "sample_invoice.pdf") + + # Read the document file as binary data + with open(document_path, "rb") as f: + document_data = f.read() + + # Start the analysis operation (WaitUntil.Started equivalent) + poller = client.begin_analyze( + analyzer_id="prebuilt-document", + inputs=[AnalyzeInput(data=document_data)] + ) + + # Get the operation ID from the poller (available after Started) + # Extract operation ID from the polling URL + polling_url = poller._polling_method._operation.get_polling_url() # type: ignore + operation_id = polling_url.split('/')[-1].split('?')[0] + + assert operation_id is not None, "Operation ID should not be null" + assert len(operation_id) > 0, "Operation ID should not be empty" + print(f"[PASS] Operation ID obtained: {operation_id}") + + # Verify operation ID format + assert ' ' not in operation_id, "Operation ID should not contain spaces" + print(f"[PASS] Operation ID length: {len(operation_id)} characters") + + print(f"[INFO] Operation started (ID: {operation_id})") + + # Wait for completion + result = poller.result() + + # Verify operation completed + assert poller is not None, "Operation should not be null after waiting" + print("[PASS] Operation completed successfully") + + # Verify raw response + raw_response = getattr(poller, '_polling_method', None) + if raw_response: + initial_response = getattr(raw_response, '_initial_response', None) # type: ignore + if initial_response: + status = getattr(initial_response, 'status_code', None) + if status: + assert 200 <= status < 300, f"Response status should be successful, but was {status}" + print(f"[PASS] Response status: {status}") + + # Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, 'contents'), "Result should contain contents" + contents = getattr(result, 'contents', None) + assert contents is not None and len(contents) > 0, "Result should have at least one content" + print(f"[PASS] Analysis result contains {len(contents)} content(s)") + + print(f"\n[INFO] Operation verification completed:") + print(f" Operation ID: {operation_id}") + print(f" Status: Completed") + print(f" Contents: {len(contents)}") + + # Demonstrate get_result_file API usage + # Note: For video analysis, this would retrieve keyframe images + # For document analysis, result files may not be available + print("\n[INFO] Demonstrating get_result_file API pattern:") + print(f" Operation ID: {operation_id}") + print(" For video analysis with keyframes:") + print(" - Keyframes are found in AudioVisualContent.key_frame_times_ms") + print(" - Path format: 'keyframes/{frameTimeMs}'") + print(" - Example: client.get_result_file(operation_id, 'keyframes/1000')") + + # Try to get a result file (this may not be available for document analysis) + try: + # Example path (would be actual keyframe path for video) + # For document analysis, this is just demonstrating the API + test_path = "keyframes/0" + + file_response = client.get_result_file( + operation_id=operation_id, + path=test_path + ) + + if file_response: + # get_result_file returns Iterator[bytes], need to collect the data + file_data = b''.join(file_response) + print(f"[PASS] Result file retrieved ({len(file_data)} bytes)") + + # For video keyframes, you would save the image: + # with open(f"keyframe_{frame_time}.jpg", "wb") as f: + # f.write(file_data) + else: + print("[INFO] No result file available at test path (expected for document analysis)") + + except Exception as e: + error_msg = str(e).lower() + if "not found" in error_msg or "not available" in error_msg: + print("[INFO] Result files not available for this analysis type (expected)") + print(f"[INFO] This is normal for document analysis without video keyframes") + else: + print(f"[INFO] get_result_file returned: {str(e)[:100]}") + + print("\n[SUCCESS] All test_sample_12_get_result_file assertions passed") + print("[INFO] get_result_file API pattern demonstrated successfully") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_13_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_13_delete_result.py new file mode 100644 index 000000000000..2554117b7ed6 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_13_delete_result.py @@ -0,0 +1,112 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_13_delete_result.py + +DESCRIPTION: + These tests validate the sample_13_delete_result.py sample code. + Tests correspond to .NET Sample13_DeleteResult.cs + +USAGE: + pytest test_sample_13_delete_result.py +""" + +import os +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase + + +class TestSample13DeleteResult(ContentUnderstandingClientTestBase): + """Tests for sample_13_delete_result.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_13_delete_result(self, contentunderstanding_endpoint: str) -> None: + """Test deleting an analysis result. + + This test validates: + 1. Document analysis to create a result + 2. Extracting result ID + 3. Deleting the result + + Corresponds to .NET Sample13_DeleteResult.DeleteResultAsync() + """ + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # First, analyze a document to create a result + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + assert os.path.exists(file_path), f"Sample file not found at {file_path}" + print(f"[PASS] Sample file exists: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + assert len(file_bytes) > 0, "File should not be empty" + print(f"[PASS] File loaded: {len(file_bytes)} bytes") + + # Analyze to get a result ID + poller = client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf" + ) + + result = poller.result() + + # Assertions for analysis + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + assert result is not None, "Analysis result should not be null" + print("[PASS] Analysis completed successfully") + + # Extract operation ID from the poller + # The operation ID is needed to delete the result + operation_id = None + try: + # Extract operation ID from polling URL + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_operation'): + operation = getattr(polling_method, '_operation', None) # type: ignore + if operation and hasattr(operation, 'get_polling_url'): + polling_url = operation.get_polling_url() # type: ignore + # Extract operation ID from URL (last segment before query string) + operation_id = polling_url.split('/')[-1] + if '?' in operation_id: + operation_id = operation_id.split('?')[0] + except Exception as e: + print(f"[WARN] Could not extract operation ID: {str(e)[:100]}") + + # Assertion: Verify we have an operation ID + if operation_id: + assert operation_id is not None, "Operation ID should not be null" + assert isinstance(operation_id, str), "Operation ID should be a string" + assert operation_id.strip(), "Operation ID should not be empty" + print(f"[PASS] Operation ID extracted: {operation_id[:50]}...") + + # Delete the result + try: + client.delete_result(operation_id=operation_id) + print(f"[PASS] Result deleted successfully (operation ID: {operation_id[:50]}...)") + print("[INFO] Deletion success verified by no exception thrown") + except Exception as e: + error_msg = str(e) + # Some implementations might not support result deletion or result might auto-expire + if "not found" in error_msg.lower() or "404" in error_msg: + print(f"[INFO] Result already deleted or not found: {error_msg[:100]}") + else: + print(f"[WARN] Delete result failed: {error_msg[:100]}") + else: + print("[INFO] Operation ID not available in response") + print("[INFO] Delete result operation skipped - operation ID extraction not supported") + + print("\n[SUCCESS] All test_sample_13_delete_result assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_14_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_14_copy_analyzer.py new file mode 100644 index 000000000000..67df6bdc2466 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_14_copy_analyzer.py @@ -0,0 +1,205 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_14_copy_analyzer.py + +DESCRIPTION: + These tests validate the sample_14_copy_analyzer.py sample code. + Tests correspond to .NET Sample14_CopyAnalyzer.cs + +USAGE: + pytest test_sample_14_copy_analyzer.py +""" + +import uuid +import pytest +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod +) + + +class TestSample14CopyAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_14_copy_analyzer.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_14_copy_analyzer(self, contentunderstanding_endpoint: str) -> None: + """Test copying an analyzer (within same resource or across resources). + + This test validates: + 1. Creating a source analyzer with complex configuration + 2. Initiating a copy operation + 3. Verifying the copy completed successfully + 4. Validating the target analyzer has the same configuration + + Corresponds to .NET Sample14_CopyAnalyzer.CopyAnalyzerAsync() + + Note: This test requires copy API support. If not available, test will be skipped. + """ + # Skip this test if API is not available + try: + client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Generate unique analyzer IDs for this test + source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex}" + target_analyzer_id = f"test_analyzer_target_{uuid.uuid4().hex}" + + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") + print(f"[INFO] Target analyzer ID: {target_analyzer_id}") + + assert source_analyzer_id is not None, "Source analyzer ID should not be null" + assert len(source_analyzer_id) > 0, "Source analyzer ID should not be empty" + assert target_analyzer_id is not None, "Target analyzer ID should not be null" + assert len(target_analyzer_id) > 0, "Target analyzer ID should not be empty" + assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" + print("[PASS] Analyzer IDs verified") + + # Step 1: Create the source analyzer with complex configuration + source_config = ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True + ) + + # Verify source config + assert source_config is not None, "Source config should not be null" + assert source_config.enable_formula is False, "EnableFormula should be false" + assert source_config.enable_layout is True, "EnableLayout should be true" + assert source_config.enable_ocr is True, "EnableOcr should be true" + assert source_config.estimate_field_source_and_confidence is True, "EstimateFieldSourceAndConfidence should be true" + assert source_config.return_details is True, "ReturnDetails should be true" + print("[PASS] Source config verified") + + # Create field schema + source_field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company" + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document" + ) + } + ) + + # Verify field schema + assert source_field_schema is not None, "Source field schema should not be null" + assert source_field_schema.name == "company_schema", "Field schema name should match" + assert source_field_schema.description == "Schema for extracting company information", "Field schema description should match" + assert len(source_field_schema.fields) == 2, "Should have 2 fields" + print(f"[PASS] Source field schema verified: {source_field_schema.name}") + + # Verify individual fields + assert "company_name" in source_field_schema.fields, "Should contain company_name field" + company_name_field = source_field_schema.fields["company_name"] + assert company_name_field.type == ContentFieldType.STRING, "company_name should be String type" + assert company_name_field.method == GenerationMethod.EXTRACT, "company_name should use Extract method" + print("[PASS] company_name field verified") + + assert "total_amount" in source_field_schema.fields, "Should contain total_amount field" + total_amount_field = source_field_schema.fields["total_amount"] + assert total_amount_field.type == ContentFieldType.NUMBER, "total_amount should be Number type" + assert total_amount_field.method == GenerationMethod.EXTRACT, "total_amount should use Extract method" + print("[PASS] total_amount field verified") + + # Create source analyzer + source_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for copying", + config=source_config, + field_schema=source_field_schema, + models={ + "completion": "gpt-4.1" + }, + tags={ + "modelType": "in_development" + } + ) + + # Create the source analyzer + create_poller = client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=source_analyzer, + allow_replace=True + ) + source_result = create_poller.result() + print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") + + # Step 2: Copy the analyzer + # Note: Copy API may require authorization token for cross-resource copying + # For same-resource copying, no authorization is needed + print(f"\n[INFO] Attempting to copy analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'") + + # Check if copy_analyzer API exists + if not hasattr(client, 'begin_copy_analyzer') and not hasattr(client, 'copy_analyzer'): + pytest.skip("Copy analyzer API not available") + + # Try to copy (this may not be implemented yet) + try: + if hasattr(client, 'begin_copy_analyzer'): + # begin_copy_analyzer requires: + # - analyzer_id: target analyzer ID + # - source_analyzer_id: source analyzer ID (as keyword arg) + copy_poller = client.begin_copy_analyzer( # type: ignore + analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id + ) + copy_result = copy_poller.result() # type: ignore + print(f"[PASS] Analyzer copied successfully to '{target_analyzer_id}'") + else: + print("[INFO] Copy analyzer API not yet implemented in Python SDK") + pytest.skip("Copy analyzer API not yet implemented") + + except Exception as copy_error: + error_msg = str(copy_error).lower() + if "not found" in error_msg or "not implemented" in error_msg or "not supported" in error_msg: + print(f"[INFO] Copy API not available: {str(copy_error)[:100]}") + pytest.skip(f"Copy analyzer API not available: {str(copy_error)[:100]}") + raise + + print("\n[SUCCESS] All test_sample_14_copy_analyzer assertions passed") + print("[INFO] Copy analyzer functionality demonstrated") + + except Exception as e: + error_msg = str(e).lower() + if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: + pytest.skip(f"API not available: {str(e)[:100]}") + raise + finally: + # Clean up: delete test analyzers + try: + if 'source_analyzer_id' in locals() and 'client' in locals(): + client.delete_analyzer(analyzer_id=source_analyzer_id) # type: ignore + print(f"\n[INFO] Source analyzer deleted: {source_analyzer_id}") # type: ignore + except Exception as cleanup_error: + print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") + + try: + if 'target_analyzer_id' in locals() and 'client' in locals(): + # Only try to delete if copy succeeded + if 'copy_result' in locals(): + client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore + print(f"[INFO] Target analyzer deleted: {target_analyzer_id}") # type: ignore + except Exception as cleanup_error: + print(f"[WARN] Could not delete target analyzer: {str(cleanup_error)[:100]}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_15_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_15_grant_copy_auth.py new file mode 100644 index 000000000000..5ad5c489294f --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_15_grant_copy_auth.py @@ -0,0 +1,207 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_15_grant_copy_auth.py + +DESCRIPTION: + These tests validate the sample_15_grant_copy_auth.py sample code. + Tests correspond to .NET Sample15_GrantCopyAuth.cs + +USAGE: + pytest test_sample_15_grant_copy_auth.py +""" + +import os +import uuid +import pytest +from typing import Optional +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod +) + + +class TestSample15GrantCopyAuth(ContentUnderstandingClientTestBase): + """Tests for sample_15_grant_copy_auth.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_15_grant_copy_auth(self, contentunderstanding_endpoint: str) -> None: + """Test granting copy authorization for cross-resource analyzer copying. + + This test validates: + 1. Creating a source analyzer + 2. Granting copy authorization from target resource + 3. Using authorization to copy analyzer across resources + 4. Verifying the copied analyzer + + Corresponds to .NET Sample15_GrantCopyAuth.GrantCopyAuthAsync() + + Note: This test requires copy authorization API support and multiple resources. + If not available, test will be skipped. + """ + # Skip this test if API is not available + # Initialize variables for cleanup + source_analyzer_id: str = "" + target_analyzer_id: str = "" + source_client: Optional[object] = None + target_client: Optional[object] = None + + try: + # For this test, we use the same endpoint for both source and target + # In production, these would be different resources in different regions + source_client = self.create_client(endpoint=contentunderstanding_endpoint) + target_client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Generate unique analyzer IDs for this test + source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex}" + target_analyzer_id = f"test_analyzer_target_{uuid.uuid4().hex}" + + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") + print(f"[INFO] Target analyzer ID: {target_analyzer_id}") + + # Verify IDs + assert source_analyzer_id is not None, "Source analyzer ID should not be null" + assert target_analyzer_id is not None, "Target analyzer ID should not be null" + assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" + print("[PASS] Analyzer IDs verified") + + # Step 1: Create the source analyzer + source_config = ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True + ) + + source_field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company" + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document" + ) + } + ) + + source_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for cross-resource copying", + config=source_config, + field_schema=source_field_schema, + models={ + "completion": "gpt-4.1" + }, + tags={ + "modelType": "in_development" + } + ) + + # Create the source analyzer + create_poller = source_client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=source_analyzer, + allow_replace=True + ) + source_result = create_poller.result() + print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") + + # Step 2: Grant copy authorization from target resource + print(f"\n[INFO] Granting copy authorization from target resource") + + # Check if grant_copy_authorization API exists + if not hasattr(target_client, 'grant_copy_authorization'): + pytest.skip("Grant copy authorization API not available") + + try: + # Grant authorization for copying + # This returns an authorization token that can be used by the source to copy + auth_response = target_client.grant_copy_authorization( + analyzer_id=target_analyzer_id, + target_azure_resource_id=os.environ.get("AZURE_CONTENT_UNDERSTANDING_AZURE_RESOURCE_ID", "") + ) + + print(f"[PASS] Copy authorization granted") + + # The authorization response typically contains: + # - Authorization token + # - Target resource ID + # - Target region + # - Expiration time + + if hasattr(auth_response, 'authorization_token'): + auth_token = getattr(auth_response, 'authorization_token', None) + if auth_token: + print(f"[INFO] Authorization token received (length: {len(auth_token)})") + + # Step 3: Use authorization to copy analyzer + print(f"\n[INFO] Copying analyzer using authorization") + + if hasattr(source_client, 'begin_copy_analyzer_with_authorization'): + copy_poller = source_client.begin_copy_analyzer_with_authorization( # type: ignore + source_analyzer_id=source_analyzer_id, + authorization=auth_response + ) + copy_result = copy_poller.result() # type: ignore + print(f"[PASS] Analyzer copied successfully to '{target_analyzer_id}'") + + # Step 4: Verify the copied analyzer + copied_analyzer = target_client.get_analyzer(analyzer_id=target_analyzer_id) + + assert copied_analyzer is not None, "Copied analyzer should not be null" + print("[PASS] Copied analyzer retrieved successfully") + + # Verify basic properties match + copied_description = getattr(copied_analyzer, 'description', None) + assert copied_description == "Source analyzer for cross-resource copying", "Description should match" + print("[PASS] Copied analyzer properties verified") + else: + print("[INFO] Copy with authorization API not yet implemented in Python SDK") + pytest.skip("Copy with authorization API not yet implemented") + + except Exception as auth_error: + error_msg = str(auth_error).lower() + if "not found" in error_msg or "not implemented" in error_msg or "not supported" in error_msg: + print(f"[INFO] Copy authorization API not available: {str(auth_error)[:100]}") + pytest.skip(f"Copy authorization API not available: {str(auth_error)[:100]}") + raise + + print("\n[SUCCESS] All test_sample_15_grant_copy_auth assertions passed") + print("[INFO] Grant copy authorization functionality demonstrated") + finally: + # Clean up: delete test analyzers + try: + if source_analyzer_id and source_client: + source_client.delete_analyzer(analyzer_id=source_analyzer_id) # type: ignore[attr-defined] + print(f"\n[INFO] Source analyzer deleted: {source_analyzer_id}") + except Exception as cleanup_error: + print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") + + try: + if target_analyzer_id and target_client: + # Only try to delete if copy succeeded + if 'copy_result' in locals(): + target_client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore[attr-defined] + print(f"[INFO] Target analyzer deleted: {target_analyzer_id}") + except Exception as cleanup_error: + print(f"[WARN] Could not delete target analyzer: {str(cleanup_error)[:100]}") From 161c55a97e3e5deb1eefeaacf320abded226bdbd Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 14:41:21 +0000 Subject: [PATCH 048/105] SAMPLE: Minor clean-up --- .../async_samples/sample_create_analyzer_async.py | 9 ++++++--- .../async_samples/sample_create_classifier_async.py | 8 ++++++-- .../async_samples/sample_delete_result_async.py | 10 ---------- .../samples/sample_create_analyzer.py | 9 ++++++--- .../samples/sample_create_classifier.py | 8 ++++++-- .../samples/sample_delete_result.py | 10 ---------- 6 files changed, 24 insertions(+), 30 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py index ec6652153aea..55345a34e179 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py @@ -120,11 +120,14 @@ async def main() -> None: analyzer_id=analyzer_id, resource=analyzer, ) - result = await poller.result() + result = await poller.result() # Wait for creation to complete + + # Get the full analyzer details after creation + result = await client.get_analyzer(analyzer_id=analyzer_id) print(f"Analyzer '{analyzer_id}' created successfully!") - print(f" Status: {result.status}") - print(f" Description: {result.description}") + if result.description: + print(f" Description: {result.description}") if result.field_schema and result.field_schema.fields: print(f" Fields ({len(result.field_schema.fields)}):") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index b193e53f1b60..a38125410cea 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -98,10 +98,14 @@ async def main() -> None: analyzer_id=analyzer_id, resource=classifier, ) - result = await poller.result() + result = await poller.result() # Wait for creation to complete + + # Get the full analyzer details after creation + result = await client.get_analyzer(analyzer_id=analyzer_id) print(f"Classifier '{analyzer_id}' created successfully!") - print(f" Status: {result.status}") + if result.description: + print(f" Description: {result.description}") # [END create_classifier] # [START analyze_with_classifier] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py index 48142caca794..1083fdc0a58e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py @@ -101,16 +101,6 @@ async def main() -> None: await client.delete_result(operation_id=operation_id) print("Analysis result deleted successfully!") - # Verify deletion by trying to get the result (should fail) - print("\nStep 3: Verifying deletion...") - try: - # Try to get the result - this should fail after deletion - await client._get_result(operation_id=operation_id) # type: ignore[attr-defined] - print(" Warning: Result still accessible") - except ResourceNotFoundError: - print(" Verified: Result is no longer accessible (404 Not Found)") - except Exception as e: - print(f" Result access check: {type(e).__name__}: {e}") # [END analyze_and_delete_result] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py index dfe3c2935388..89503d5d30d3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py @@ -120,11 +120,14 @@ def main() -> None: analyzer_id=analyzer_id, resource=analyzer, ) - result = poller.result() + result = poller.result() # Wait for creation to complete + + # Get the full analyzer details after creation + result = client.get_analyzer(analyzer_id=analyzer_id) print(f"Analyzer '{analyzer_id}' created successfully!") - print(f" Status: {result.status}") - print(f" Description: {result.description}") + if result.description: + print(f" Description: {result.description}") if result.field_schema and result.field_schema.fields: print(f" Fields ({len(result.field_schema.fields)}):") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index 2d4b2b7be9b8..e690cb662cca 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -98,10 +98,14 @@ def main() -> None: analyzer_id=analyzer_id, resource=classifier, ) - result = poller.result() + result = poller.result() # Wait for creation to complete + + # Get the full analyzer details after creation + result = client.get_analyzer(analyzer_id=analyzer_id) print(f"Classifier '{analyzer_id}' created successfully!") - print(f" Status: {result.status}") + if result.description: + print(f" Description: {result.description}") # [END create_classifier] # [START analyze_with_classifier] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index e7d18df54d96..b5e0f1a79cea 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -103,16 +103,6 @@ def main() -> None: client.delete_result(operation_id=operation_id) print("Analysis result deleted successfully!") - # Verify deletion by trying to get the result (should fail) - print("\nStep 3: Verifying deletion...") - try: - # Try to get the result - this should fail after deletion - client._get_result(operation_id=operation_id) # type: ignore[attr-defined] - print(" Warning: Result still accessible") - except ResourceNotFoundError: - print(" Verified: Result is no longer accessible (404 Not Found)") - except Exception as e: - print(f" Result access check: {type(e).__name__}: {e}") # [END analyze_and_delete_result] From e08ab762bea900b392fd1c50c9ae1b275dc0a755 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 15:31:25 +0000 Subject: [PATCH 049/105] TEST: Update sample tests --- .../samples/test_sample_15_grant_copy_auth.py | 207 ----------- ...inary.py => test_sample_analyze_binary.py} | 28 +- ...figs.py => test_sample_analyze_configs.py} | 17 +- ...oice.py => test_sample_analyze_invoice.py} | 17 +- ...=> test_sample_analyze_return_raw_json.py} | 17 +- ...lyze_url.py => test_sample_analyze_url.py} | 17 +- ...s.py => test_sample_configure_defaults.py} | 21 +- ...alyzer.py => test_sample_copy_analyzer.py} | 17 +- ...yzer.py => test_sample_create_analyzer.py} | 17 +- ...er.py => test_sample_create_classifier.py} | 17 +- ...yzer.py => test_sample_delete_analyzer.py} | 17 +- ...result.py => test_sample_delete_result.py} | 17 +- ...nalyzer.py => test_sample_get_analyzer.py} | 17 +- ...file.py => test_sample_get_result_file.py} | 17 +- .../samples/test_sample_grant_copy_auth.py | 329 ++++++++++++++++++ ...yzers.py => test_sample_list_analyzers.py} | 17 +- ...yzer.py => test_sample_update_analyzer.py} | 17 +- .../tests/test_analyzer_operation_id.py | 2 +- 18 files changed, 456 insertions(+), 352 deletions(-) delete mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_15_grant_copy_auth.py rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_01_analyze_binary.py => test_sample_analyze_binary.py} (91%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_10_analyze_configs.py => test_sample_analyze_configs.py} (92%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_03_analyze_invoice.py => test_sample_analyze_invoice.py} (93%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_11_analyze_return_raw_json.py => test_sample_analyze_return_raw_json.py} (89%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_02_analyze_url.py => test_sample_analyze_url.py} (95%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_00_configure_defaults.py => test_sample_configure_defaults.py} (88%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_14_copy_analyzer.py => test_sample_copy_analyzer.py} (94%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_04_create_analyzer.py => test_sample_create_analyzer.py} (91%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_05_create_classifier.py => test_sample_create_classifier.py} (90%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_09_delete_analyzer.py => test_sample_delete_analyzer.py} (93%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_13_delete_result.py => test_sample_delete_result.py} (88%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_06_get_analyzer.py => test_sample_get_analyzer.py} (89%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_12_get_result_file.py => test_sample_get_result_file.py} (91%) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_07_list_analyzers.py => test_sample_list_analyzers.py} (89%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_08_update_analyzer.py => test_sample_update_analyzer.py} (92%) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_15_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_15_grant_copy_auth.py deleted file mode 100644 index 5ad5c489294f..000000000000 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_15_grant_copy_auth.py +++ /dev/null @@ -1,207 +0,0 @@ -# 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. -# -------------------------------------------------------------------------- - -""" -TEST FILE: test_sample_15_grant_copy_auth.py - -DESCRIPTION: - These tests validate the sample_15_grant_copy_auth.py sample code. - Tests correspond to .NET Sample15_GrantCopyAuth.cs - -USAGE: - pytest test_sample_15_grant_copy_auth.py -""" - -import os -import uuid -import pytest -from typing import Optional -from devtools_testutils import recorded_by_proxy -from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -from azure.ai.contentunderstanding.models import ( - ContentAnalyzer, - ContentAnalyzerConfig, - ContentFieldSchema, - ContentFieldDefinition, - ContentFieldType, - GenerationMethod -) - - -class TestSample15GrantCopyAuth(ContentUnderstandingClientTestBase): - """Tests for sample_15_grant_copy_auth.py""" - - @ContentUnderstandingPreparer() - @recorded_by_proxy - def test_sample_15_grant_copy_auth(self, contentunderstanding_endpoint: str) -> None: - """Test granting copy authorization for cross-resource analyzer copying. - - This test validates: - 1. Creating a source analyzer - 2. Granting copy authorization from target resource - 3. Using authorization to copy analyzer across resources - 4. Verifying the copied analyzer - - Corresponds to .NET Sample15_GrantCopyAuth.GrantCopyAuthAsync() - - Note: This test requires copy authorization API support and multiple resources. - If not available, test will be skipped. - """ - # Skip this test if API is not available - # Initialize variables for cleanup - source_analyzer_id: str = "" - target_analyzer_id: str = "" - source_client: Optional[object] = None - target_client: Optional[object] = None - - try: - # For this test, we use the same endpoint for both source and target - # In production, these would be different resources in different regions - source_client = self.create_client(endpoint=contentunderstanding_endpoint) - target_client = self.create_client(endpoint=contentunderstanding_endpoint) - - # Generate unique analyzer IDs for this test - source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex}" - target_analyzer_id = f"test_analyzer_target_{uuid.uuid4().hex}" - - print(f"[INFO] Source analyzer ID: {source_analyzer_id}") - print(f"[INFO] Target analyzer ID: {target_analyzer_id}") - - # Verify IDs - assert source_analyzer_id is not None, "Source analyzer ID should not be null" - assert target_analyzer_id is not None, "Target analyzer ID should not be null" - assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" - print("[PASS] Analyzer IDs verified") - - # Step 1: Create the source analyzer - source_config = ContentAnalyzerConfig( - enable_formula=False, - enable_layout=True, - enable_ocr=True, - estimate_field_source_and_confidence=True, - return_details=True - ) - - source_field_schema = ContentFieldSchema( - name="company_schema", - description="Schema for extracting company information", - fields={ - "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company" - ), - "total_amount": ContentFieldDefinition( - type=ContentFieldType.NUMBER, - method=GenerationMethod.EXTRACT, - description="Total amount on the document" - ) - } - ) - - source_analyzer = ContentAnalyzer( - base_analyzer_id="prebuilt-document", - description="Source analyzer for cross-resource copying", - config=source_config, - field_schema=source_field_schema, - models={ - "completion": "gpt-4.1" - }, - tags={ - "modelType": "in_development" - } - ) - - # Create the source analyzer - create_poller = source_client.begin_create_analyzer( - analyzer_id=source_analyzer_id, - resource=source_analyzer, - allow_replace=True - ) - source_result = create_poller.result() - print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") - - # Step 2: Grant copy authorization from target resource - print(f"\n[INFO] Granting copy authorization from target resource") - - # Check if grant_copy_authorization API exists - if not hasattr(target_client, 'grant_copy_authorization'): - pytest.skip("Grant copy authorization API not available") - - try: - # Grant authorization for copying - # This returns an authorization token that can be used by the source to copy - auth_response = target_client.grant_copy_authorization( - analyzer_id=target_analyzer_id, - target_azure_resource_id=os.environ.get("AZURE_CONTENT_UNDERSTANDING_AZURE_RESOURCE_ID", "") - ) - - print(f"[PASS] Copy authorization granted") - - # The authorization response typically contains: - # - Authorization token - # - Target resource ID - # - Target region - # - Expiration time - - if hasattr(auth_response, 'authorization_token'): - auth_token = getattr(auth_response, 'authorization_token', None) - if auth_token: - print(f"[INFO] Authorization token received (length: {len(auth_token)})") - - # Step 3: Use authorization to copy analyzer - print(f"\n[INFO] Copying analyzer using authorization") - - if hasattr(source_client, 'begin_copy_analyzer_with_authorization'): - copy_poller = source_client.begin_copy_analyzer_with_authorization( # type: ignore - source_analyzer_id=source_analyzer_id, - authorization=auth_response - ) - copy_result = copy_poller.result() # type: ignore - print(f"[PASS] Analyzer copied successfully to '{target_analyzer_id}'") - - # Step 4: Verify the copied analyzer - copied_analyzer = target_client.get_analyzer(analyzer_id=target_analyzer_id) - - assert copied_analyzer is not None, "Copied analyzer should not be null" - print("[PASS] Copied analyzer retrieved successfully") - - # Verify basic properties match - copied_description = getattr(copied_analyzer, 'description', None) - assert copied_description == "Source analyzer for cross-resource copying", "Description should match" - print("[PASS] Copied analyzer properties verified") - else: - print("[INFO] Copy with authorization API not yet implemented in Python SDK") - pytest.skip("Copy with authorization API not yet implemented") - - except Exception as auth_error: - error_msg = str(auth_error).lower() - if "not found" in error_msg or "not implemented" in error_msg or "not supported" in error_msg: - print(f"[INFO] Copy authorization API not available: {str(auth_error)[:100]}") - pytest.skip(f"Copy authorization API not available: {str(auth_error)[:100]}") - raise - - print("\n[SUCCESS] All test_sample_15_grant_copy_auth assertions passed") - print("[INFO] Grant copy authorization functionality demonstrated") - finally: - # Clean up: delete test analyzers - try: - if source_analyzer_id and source_client: - source_client.delete_analyzer(analyzer_id=source_analyzer_id) # type: ignore[attr-defined] - print(f"\n[INFO] Source analyzer deleted: {source_analyzer_id}") - except Exception as cleanup_error: - print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") - - try: - if target_analyzer_id and target_client: - # Only try to delete if copy succeeded - if 'copy_result' in locals(): - target_client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore[attr-defined] - print(f"[INFO] Target analyzer deleted: {target_analyzer_id}") - except Exception as cleanup_error: - print(f"[WARN] Could not delete target analyzer: {str(cleanup_error)[:100]}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_01_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py similarity index 91% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_01_analyze_binary.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py index 3ddb3fd4c2ca..d68819c525b6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_01_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_01_analyze_binary.py +TEST FILE: test_sample_analyze_binary.py DESCRIPTION: - These tests validate the sample_01_analyze_binary.py sample code. - Tests correspond to .NET Sample01_AnalyzeBinary.cs + These tests validate the sample_analyze_binary.py sample code. USAGE: - pytest test_sample_01_analyze_binary.py + pytest test_sample_analyze_binary.py """ import os @@ -23,12 +22,12 @@ from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -class TestSample01AnalyzeBinary(ContentUnderstandingClientTestBase): - """Tests for sample_01_analyze_binary.py""" +class TestSampleAnalyzeBinary(ContentUnderstandingClientTestBase): + """Tests for sample_analyze_binary.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_01_analyze_binary(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_binary(self, contentunderstanding_endpoint: str) -> None: """Test analyzing a document from binary data. This test validates: @@ -37,7 +36,6 @@ def test_sample_01_analyze_binary(self, contentunderstanding_endpoint: str) -> N 3. Markdown content extraction 4. Document properties (MIME type, pages, tables) - Corresponds to .NET Sample01_AnalyzeBinary.AnalyzeBinaryAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -57,7 +55,7 @@ def test_sample_01_analyze_binary(self, contentunderstanding_endpoint: str) -> N assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - # Assertion: Verify binary data (equivalent to .NET BinaryData) + # Assertion: Verify binary data assert file_bytes is not None, "Binary data should not be null" print("[PASS] Binary data created successfully") @@ -74,7 +72,7 @@ def test_sample_01_analyze_binary(self, contentunderstanding_endpoint: str) -> N assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - # Verify raw response (equivalent to .NET GetRawResponse()) + # Verify raw response # In Python SDK, we can check if the poller has result and get HTTP response info # type: ignore is used here because we're accessing internal implementation details if hasattr(poller, '_polling_method'): @@ -110,12 +108,11 @@ def test_sample_01_analyze_binary(self, contentunderstanding_endpoint: str) -> N # Test document properties access self._test_document_properties(result) - print("\n[SUCCESS] All test_sample_01_analyze_binary assertions passed") + print("\n[SUCCESS] All test_sample_analyze_binary assertions passed") def _test_markdown_extraction(self, result): """Test markdown content extraction. - Corresponds to .NET Assertion:ContentUnderstandingExtractMarkdown """ # Assertion: Verify contents structure assert result.contents is not None, "Result should contain contents" @@ -138,12 +135,11 @@ def _test_markdown_extraction(self, result): def _test_document_properties(self, result): """Test document property access. - Corresponds to .NET Assertion:ContentUnderstandingAccessDocumentProperties """ content = result.contents[0] assert content is not None, "Content should not be null for document properties validation" - # Check if this is DocumentContent (equivalent to .NET's DocumentContent type check) + # Check if this is DocumentContent content_type = type(content).__name__ print(f"[INFO] Content type: {content_type}") @@ -193,7 +189,7 @@ def _test_document_properties(self, result): else: print("No tables found in document content") - # Final validation message (matching .NET) + # Final validation message print("[PASS] All document properties validated successfully") def _validate_pages(self, pages, start_page, end_page, content=None): @@ -219,7 +215,7 @@ def _validate_pages(self, pages, start_page, end_page, content=None): f"Page number {page.page_number} appears multiple times" page_numbers.add(page.page_number) - # Print page details with unit (matching .NET output) + # Print page details with unit print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") print(f"[PASS] All {len(pages)} pages validated successfully") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_10_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py similarity index 92% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_10_analyze_configs.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py index 3dea96c949c0..b96f73d0afc8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_10_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_10_analyze_configs.py +TEST FILE: test_sample_analyze_configs.py DESCRIPTION: - These tests validate the sample_10_analyze_configs.py sample code. - Tests correspond to .NET Sample10_AnalyzeConfigs.cs + These tests validate the sample_analyze_configs.py sample code. USAGE: - pytest test_sample_10_analyze_configs.py + pytest test_sample_analyze_configs.py """ import os @@ -23,12 +22,12 @@ from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -class TestSample10AnalyzeConfigs(ContentUnderstandingClientTestBase): - """Tests for sample_10_analyze_configs.py""" +class TestSampleAnalyzeConfigs(ContentUnderstandingClientTestBase): + """Tests for sample_analyze_configs.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_10_analyze_configs(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_configs(self, contentunderstanding_endpoint: str) -> None: """Test analyzing a document with specific configuration options. This test validates: @@ -36,7 +35,7 @@ def test_sample_10_analyze_configs(self, contentunderstanding_endpoint: str) -> 2. Configuration options (formulas, layout, OCR enabled) 3. Document features extraction (charts, annotations, hyperlinks, formulas) - Corresponds to .NET Sample10_AnalyzeConfigs.AnalyzeConfigsAsync() + 10_AnalyzeConfigs.AnalyzeConfigsAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -125,7 +124,7 @@ def test_sample_10_analyze_configs(self, contentunderstanding_endpoint: str) -> # Test document feature extraction self._test_document_features(first_content) - print("\n[SUCCESS] All test_sample_10_analyze_configs assertions passed") + print("\n[SUCCESS] All test_sample_analyze_configs assertions passed") def _test_document_features(self, content): """Test extraction of document features like charts, annotations, hyperlinks.""" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_03_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py similarity index 93% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_03_analyze_invoice.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py index 8f7b02c6fe35..17ab6270d338 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_03_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_03_analyze_invoice.py +TEST FILE: test_sample_analyze_invoice.py DESCRIPTION: - These tests validate the sample_03_analyze_invoice.py sample code. - Tests correspond to .NET Sample03_AnalyzeInvoice.cs + These tests validate the sample_analyze_invoice.py sample code. USAGE: - pytest test_sample_03_analyze_invoice.py + pytest test_sample_analyze_invoice.py """ import os @@ -24,12 +23,12 @@ from azure.ai.contentunderstanding.models import AnalyzeInput, DocumentContent -class TestSample03AnalyzeInvoice(ContentUnderstandingClientTestBase): - """Tests for sample_03_analyze_invoice.py""" +class TestSampleAnalyzeInvoice(ContentUnderstandingClientTestBase): + """Tests for sample_analyze_invoice.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_03_analyze_invoice(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_invoice(self, contentunderstanding_endpoint: str) -> None: """Test analyzing an invoice document with prebuilt-invoice analyzer. This test validates: @@ -37,7 +36,7 @@ def test_sample_03_analyze_invoice(self, contentunderstanding_endpoint: str) -> 2. Extracting invoice-specific fields (CustomerName, InvoiceDate, TotalAmount, LineItems) 3. Field confidence scores and source locations - Corresponds to .NET Sample03_AnalyzeInvoice.AnalyzeInvoiceAsync() + 03_AnalyzeInvoice.AnalyzeInvoiceAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -207,4 +206,4 @@ def test_sample_03_analyze_invoice(self, contentunderstanding_endpoint: str) -> else: print("[INFO] LineItems field not found in this document") - print("\n[SUCCESS] All test_sample_03_analyze_invoice assertions passed") + print("\n[SUCCESS] All test_sample_analyze_invoice assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_11_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py similarity index 89% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_11_analyze_return_raw_json.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py index 20bc8e741901..998ca0a351e0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_11_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_11_analyze_return_raw_json.py +TEST FILE: test_sample_analyze_return_raw_json.py DESCRIPTION: - These tests validate the sample_11_analyze_return_raw_json.py sample code. - Tests correspond to .NET Sample11_AnalyzeReturnRawJson.cs + These tests validate the sample_analyze_return_raw_json.py sample code. USAGE: - pytest test_sample_11_analyze_return_raw_json.py + pytest test_sample_analyze_return_raw_json.py """ import os @@ -24,12 +23,12 @@ from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -class TestSample11AnalyzeReturnRawJson(ContentUnderstandingClientTestBase): - """Tests for sample_11_analyze_return_raw_json.py""" +class TestSampleAnalyzeReturnRawJson(ContentUnderstandingClientTestBase): + """Tests for sample_analyze_return_raw_json.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_11_analyze_return_raw_json(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_return_raw_json(self, contentunderstanding_endpoint: str) -> None: """Test analyzing a document and getting raw JSON response. This test validates: @@ -37,7 +36,7 @@ def test_sample_11_analyze_return_raw_json(self, contentunderstanding_endpoint: 2. Raw JSON response format 3. JSON structure validation - Corresponds to .NET Sample11_AnalyzeReturnRawJson.AnalyzeReturnRawJsonAsync() + 11_AnalyzeReturnRawJson.AnalyzeReturnRawJsonAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -132,4 +131,4 @@ def test_sample_11_analyze_return_raw_json(self, contentunderstanding_endpoint: if result.contents and len(result.contents) > 0: print(f"[PASS] Response contains {len(result.contents)} content(s)") - print("\n[SUCCESS] All test_sample_11_analyze_return_raw_json assertions passed") + print("\n[SUCCESS] All test_sample_analyze_return_raw_json assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_02_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py similarity index 95% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_02_analyze_url.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py index 14aec0545477..67121cffc359 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_02_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_02_analyze_url.py +TEST FILE: test_sample_analyze_url.py DESCRIPTION: - These tests validate the sample_02_analyze_url.py sample code. - Tests correspond to .NET Sample02_AnalyzeUrl.cs + These tests validate the sample_analyze_url.py sample code. USAGE: - pytest test_sample_02_analyze_url.py + pytest test_sample_analyze_url.py """ import os @@ -24,12 +23,12 @@ from azure.ai.contentunderstanding.models import AnalyzeInput -class TestSample02AnalyzeUrl(ContentUnderstandingClientTestBase): - """Tests for sample_02_analyze_url.py""" +class TestSampleAnalyzeUrl(ContentUnderstandingClientTestBase): + """Tests for sample_analyze_url.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_02_analyze_url(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_url(self, contentunderstanding_endpoint: str) -> None: """Test analyzing a document from URL. This test validates: @@ -38,7 +37,7 @@ def test_sample_02_analyze_url(self, contentunderstanding_endpoint: str) -> None 3. Markdown content extraction 4. Document properties (MIME type, pages, tables) - Corresponds to .NET Sample02_AnalyzeUrl.AnalyzeUrlAsync() + 02_AnalyzeUrl.AnalyzeUrlAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -99,7 +98,7 @@ def test_sample_02_analyze_url(self, contentunderstanding_endpoint: str) -> None # Test document properties access self._test_document_properties(result) - print("\n[SUCCESS] All test_sample_02_analyze_url assertions passed") + print("\n[SUCCESS] All test_sample_analyze_url assertions passed") def _test_markdown_extraction(self, result): """Test markdown content extraction.""" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_00_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py similarity index 88% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_00_configure_defaults.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py index 54b5a4b60e54..3499fc3469fe 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_00_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_00_configure_defaults.py +TEST FILE: test_sample_configure_defaults.py DESCRIPTION: - These tests validate the sample_00_configure_defaults.py sample code. - Tests correspond to .NET Sample00_ConfigureDefaults.cs + These tests validate the sample_configure_defaults.py sample code. USAGE: - pytest test_sample_00_configure_defaults.py + pytest test_sample_configure_defaults.py """ import pytest @@ -22,12 +21,12 @@ from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -class TestSample00ConfigureDefaults(ContentUnderstandingClientTestBase): - """Tests for sample_00_configure_defaults.py""" +class TestSampleConfigureDefaults(ContentUnderstandingClientTestBase): + """Tests for sample_configure_defaults.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_00_configure_defaults(self, contentunderstanding_endpoint: str) -> None: + def test_sample_configure_defaults(self, contentunderstanding_endpoint: str) -> None: """Test configuring and getting model deployment defaults. This test validates: @@ -35,7 +34,7 @@ def test_sample_00_configure_defaults(self, contentunderstanding_endpoint: str) 2. Getting current defaults (GetDefaults) 3. Model deployment mappings structure - Corresponds to .NET Sample00_ConfigureDefaults.ConfigureDefaultsAsync() + 00_ConfigureDefaults.ConfigureDefaultsAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -45,12 +44,12 @@ def test_sample_00_configure_defaults(self, contentunderstanding_endpoint: str) # Test GetDefaults - always run self._test_get_defaults(client) - print("\n[SUCCESS] All test_sample_00_configure_defaults assertions passed") + print("\n[SUCCESS] All test_sample_configure_defaults assertions passed") def _test_update_defaults(self, client): """Test updating model deployment defaults. - Corresponds to .NET Snippet:ContentUnderstandingUpdateDefaults + """ # Check if deployment names are configured in environment # In Python tests, these would come from environment variables or test configuration @@ -87,7 +86,7 @@ def _test_update_defaults(self, client): def _test_get_defaults(self, client): """Test getting current model deployment defaults. - Corresponds to .NET Snippet:ContentUnderstandingGetDefaults and assertions + and assertions """ # Get current defaults get_response = client.get_defaults() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_14_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py similarity index 94% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_14_copy_analyzer.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py index 67df6bdc2466..1ecd09015a3b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_14_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_14_copy_analyzer.py +TEST FILE: test_sample_copy_analyzer.py DESCRIPTION: - These tests validate the sample_14_copy_analyzer.py sample code. - Tests correspond to .NET Sample14_CopyAnalyzer.cs + These tests validate the sample_copy_analyzer.py sample code. USAGE: - pytest test_sample_14_copy_analyzer.py + pytest test_sample_copy_analyzer.py """ import uuid @@ -31,12 +30,12 @@ ) -class TestSample14CopyAnalyzer(ContentUnderstandingClientTestBase): - """Tests for sample_14_copy_analyzer.py""" +class TestSampleCopyAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_copy_analyzer.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_14_copy_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_copy_analyzer(self, contentunderstanding_endpoint: str) -> None: """Test copying an analyzer (within same resource or across resources). This test validates: @@ -45,7 +44,7 @@ def test_sample_14_copy_analyzer(self, contentunderstanding_endpoint: str) -> No 3. Verifying the copy completed successfully 4. Validating the target analyzer has the same configuration - Corresponds to .NET Sample14_CopyAnalyzer.CopyAnalyzerAsync() + 14_CopyAnalyzer.CopyAnalyzerAsync() Note: This test requires copy API support. If not available, test will be skipped. """ @@ -178,7 +177,7 @@ def test_sample_14_copy_analyzer(self, contentunderstanding_endpoint: str) -> No pytest.skip(f"Copy analyzer API not available: {str(copy_error)[:100]}") raise - print("\n[SUCCESS] All test_sample_14_copy_analyzer assertions passed") + print("\n[SUCCESS] All test_sample_copy_analyzer assertions passed") print("[INFO] Copy analyzer functionality demonstrated") except Exception as e: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_04_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py similarity index 91% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_04_create_analyzer.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py index 559075887301..59b52e995700 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_04_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_04_create_analyzer.py +TEST FILE: test_sample_create_analyzer.py DESCRIPTION: - These tests validate the sample_04_create_analyzer.py sample code. - Tests correspond to .NET Sample04_CreateAnalyzer.cs + These tests validate the sample_create_analyzer.py sample code. USAGE: - pytest test_sample_04_create_analyzer.py + pytest test_sample_create_analyzer.py """ import pytest @@ -29,12 +28,12 @@ ) -class TestSample04CreateAnalyzer(ContentUnderstandingClientTestBase): - """Tests for sample_04_create_analyzer.py""" +class TestSampleCreateAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_create_analyzer.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_04_create_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_create_analyzer(self, contentunderstanding_endpoint: str) -> None: """Test creating a custom analyzer with field schema. This test validates: @@ -44,7 +43,7 @@ def test_sample_04_create_analyzer(self, contentunderstanding_endpoint: str) -> 4. Model mappings 5. Analyzer creation operation - Corresponds to .NET Sample04_CreateAnalyzer.CreateAnalyzerAsync() + 04_CreateAnalyzer.CreateAnalyzerAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -167,4 +166,4 @@ def test_sample_04_create_analyzer(self, contentunderstanding_endpoint: str) -> except Exception as e: print(f"[WARN] Cleanup failed: {str(e)}") - print("\n[SUCCESS] All test_sample_04_create_analyzer assertions passed") + print("\n[SUCCESS] All test_sample_create_analyzer assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_05_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py similarity index 90% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_05_create_classifier.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py index f04d125e084f..ebad787209e9 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_05_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_05_create_classifier.py +TEST FILE: test_sample_create_classifier.py DESCRIPTION: - These tests validate the sample_05_create_classifier.py sample code. - Tests correspond to .NET Sample05_CreateClassifier.cs + These tests validate the sample_create_classifier.py sample code. USAGE: - pytest test_sample_05_create_classifier.py + pytest test_sample_create_classifier.py """ import pytest @@ -28,12 +27,12 @@ ) -class TestSample05CreateClassifier(ContentUnderstandingClientTestBase): - """Tests for sample_05_create_classifier.py""" +class TestSampleCreateClassifier(ContentUnderstandingClientTestBase): + """Tests for sample_create_classifier.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_05_create_classifier(self, contentunderstanding_endpoint: str) -> None: + def test_sample_create_classifier(self, contentunderstanding_endpoint: str) -> None: """Test creating a custom classifier with content categories. This test validates: @@ -41,7 +40,7 @@ def test_sample_05_create_classifier(self, contentunderstanding_endpoint: str) - 2. Analyzer configuration with segmentation 3. Classifier creation - Corresponds to .NET Sample05_CreateClassifier.CreateClassifierAsync() + 05_CreateClassifier.CreateClassifierAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -135,4 +134,4 @@ def test_sample_05_create_classifier(self, contentunderstanding_endpoint: str) - print(f"\n[ERROR] Full error message:\n{error_msg}") pytest.skip(f"Classifier creation not available or failed: {error_msg[:100]}") - print("\n[SUCCESS] All test_sample_05_create_classifier assertions passed") + print("\n[SUCCESS] All test_sample_create_classifier assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_09_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py similarity index 93% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_09_delete_analyzer.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py index 01499599e4c6..bad0fc82b268 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_09_delete_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_09_delete_analyzer.py +TEST FILE: test_sample_delete_analyzer.py DESCRIPTION: - These tests validate the sample_09_delete_analyzer.py sample code. - Tests correspond to .NET Sample09_DeleteAnalyzer.cs + These tests validate the sample_delete_analyzer.py sample code. USAGE: - pytest test_sample_09_delete_analyzer.py + pytest test_sample_delete_analyzer.py """ import uuid @@ -25,12 +24,12 @@ from azure.core.exceptions import ResourceNotFoundError -class TestSample09DeleteAnalyzer(ContentUnderstandingClientTestBase): - """Tests for sample_09_delete_analyzer.py""" +class TestSampleDeleteAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_delete_analyzer.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_09_delete_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_delete_analyzer(self, contentunderstanding_endpoint: str) -> None: """Test deleting an analyzer. This test validates: @@ -39,7 +38,7 @@ def test_sample_09_delete_analyzer(self, contentunderstanding_endpoint: str) -> 3. Deleting the analyzer 4. Verifying deletion was successful - Corresponds to .NET Sample09_DeleteAnalyzer.DeleteAnalyzerAsync() + 09_DeleteAnalyzer.DeleteAnalyzerAsync() """ # Skip this test if API is not available try: @@ -167,7 +166,7 @@ def test_sample_09_delete_analyzer(self, contentunderstanding_endpoint: str) -> assert deletion_verified, "Deletion should be verified (analyzer not found after deletion)" print(f"[PASS] Deletion verified: Analyzer '{analyzer_id}' is no longer accessible") - print("\n[SUCCESS] All test_sample_09_delete_analyzer assertions passed") + print("\n[SUCCESS] All test_sample_delete_analyzer assertions passed") except Exception as e: error_msg = str(e).lower() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_13_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py similarity index 88% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_13_delete_result.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py index 2554117b7ed6..e3cfde23cb35 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_13_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_13_delete_result.py +TEST FILE: test_sample_delete_result.py DESCRIPTION: - These tests validate the sample_13_delete_result.py sample code. - Tests correspond to .NET Sample13_DeleteResult.cs + These tests validate the sample_delete_result.py sample code. USAGE: - pytest test_sample_13_delete_result.py + pytest test_sample_delete_result.py """ import os @@ -23,12 +22,12 @@ from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -class TestSample13DeleteResult(ContentUnderstandingClientTestBase): - """Tests for sample_13_delete_result.py""" +class TestSampleDeleteResult(ContentUnderstandingClientTestBase): + """Tests for sample_delete_result.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_13_delete_result(self, contentunderstanding_endpoint: str) -> None: + def test_sample_delete_result(self, contentunderstanding_endpoint: str) -> None: """Test deleting an analysis result. This test validates: @@ -36,7 +35,7 @@ def test_sample_13_delete_result(self, contentunderstanding_endpoint: str) -> No 2. Extracting result ID 3. Deleting the result - Corresponds to .NET Sample13_DeleteResult.DeleteResultAsync() + 13_DeleteResult.DeleteResultAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -109,4 +108,4 @@ def test_sample_13_delete_result(self, contentunderstanding_endpoint: str) -> No print("[INFO] Operation ID not available in response") print("[INFO] Delete result operation skipped - operation ID extraction not supported") - print("\n[SUCCESS] All test_sample_13_delete_result assertions passed") + print("\n[SUCCESS] All test_sample_delete_result assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_06_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py similarity index 89% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_06_get_analyzer.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py index 5c7e3982077c..451ac4545b75 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_06_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_06_get_analyzer.py +TEST FILE: test_sample_get_analyzer.py DESCRIPTION: - These tests validate the sample_06_get_analyzer.py sample code. - Tests correspond to .NET Sample06_GetAnalyzer.cs + These tests validate the sample_get_analyzer.py sample code. USAGE: - pytest test_sample_06_get_analyzer.py + pytest test_sample_get_analyzer.py """ import json @@ -23,12 +22,12 @@ from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -class TestSample06GetAnalyzer(ContentUnderstandingClientTestBase): - """Tests for sample_06_get_analyzer.py""" +class TestSampleGetAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_get_analyzer.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_06_get_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_get_analyzer(self, contentunderstanding_endpoint: str) -> None: """Test getting information about a prebuilt analyzer. This test validates: @@ -36,7 +35,7 @@ def test_sample_06_get_analyzer(self, contentunderstanding_endpoint: str) -> Non 2. Analyzer response structure 3. Analyzer JSON serialization - Corresponds to .NET Sample06_GetAnalyzer.GetPrebuiltAnalyzerAsync() + 06_GetAnalyzer.GetPrebuiltAnalyzerAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -116,4 +115,4 @@ def test_sample_06_get_analyzer(self, contentunderstanding_endpoint: str) -> Non assert analyzer is not None, "Analyzer should not be null" print("\n[PASS] All prebuilt analyzer properties validated successfully") - print("\n[SUCCESS] All test_sample_06_get_analyzer assertions passed") + print("\n[SUCCESS] All test_sample_get_analyzer assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_12_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py similarity index 91% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_12_get_result_file.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py index 3cd33eadba5f..880d6c8a0bab 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_12_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_12_get_result_file.py +TEST FILE: test_sample_get_result_file.py DESCRIPTION: - These tests validate the sample_12_get_result_file.py sample code. - Tests correspond to .NET Sample12_GetResultFile.cs + These tests validate the sample_get_result_file.py sample code. USAGE: - pytest test_sample_12_get_result_file.py + pytest test_sample_get_result_file.py """ import os @@ -24,12 +23,12 @@ from azure.ai.contentunderstanding.models import AnalyzeInput -class TestSample12GetResultFile(ContentUnderstandingClientTestBase): - """Tests for sample_12_get_result_file.py""" +class TestSampleGetResultFile(ContentUnderstandingClientTestBase): + """Tests for sample_get_result_file.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_12_get_result_file(self, contentunderstanding_endpoint: str) -> None: + def test_sample_get_result_file(self, contentunderstanding_endpoint: str) -> None: """Test getting result files (like keyframe images) from analysis results. This test validates: @@ -38,7 +37,7 @@ def test_sample_12_get_result_file(self, contentunderstanding_endpoint: str) -> 3. Waiting for operation completion 4. Retrieving keyframe images using get_result_file - Corresponds to .NET Sample12_GetResultFile.GetResultFileAsync() + 12_GetResultFile.GetResultFileAsync() Note: This test uses document analysis as video analysis may not be available. The API pattern is the same for both document and video analysis. @@ -145,5 +144,5 @@ def test_sample_12_get_result_file(self, contentunderstanding_endpoint: str) -> else: print(f"[INFO] get_result_file returned: {str(e)[:100]}") - print("\n[SUCCESS] All test_sample_12_get_result_file assertions passed") + print("\n[SUCCESS] All test_sample_get_result_file assertions passed") print("[INFO] get_result_file API pattern demonstrated successfully") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py new file mode 100644 index 000000000000..dc4510861aa5 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py @@ -0,0 +1,329 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_grant_copy_auth.py + +DESCRIPTION: + These tests validate the sample_grant_copy_auth.py sample code. + +USAGE: + pytest test_sample_grant_copy_auth.py +""" + +import os +import uuid +from datetime import datetime, timezone +from typing import Optional, cast +from devtools_testutils import recorded_by_proxy +from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod +) + + +class TestSampleGrantCopyAuth(ContentUnderstandingClientTestBase): + """Tests for sample_grant_copy_auth.py""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str) -> None: + """Test granting copy authorization for cross-resource analyzer copying. + + This test validates: + 1. Creating a source analyzer + 2. Granting copy authorization from source resource + 3. Using authorization to copy analyzer across resources + 4. Verifying the copied analyzer + """ + # Initialize variables for cleanup + source_analyzer_id: str = "" + target_analyzer_id: str = "" + source_client: Optional[ContentUnderstandingClient] = None + target_client: Optional[ContentUnderstandingClient] = None + + try: + # Get source and target resource information from environment + # For testing, we may use the same endpoint for both source and target + # In production, these would be different resources + source_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID") + source_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION") + target_endpoint = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", contentunderstanding_endpoint) + target_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID") + target_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION") + target_key = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") + + # Require environment variables + if not source_resource_id: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID is required") + if not source_region: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION is required") + if not target_resource_id: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID is required") + if not target_region: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION is required") + + # Create clients + source_client = self.create_client(endpoint=contentunderstanding_endpoint) + + # Create target client (may use different endpoint and credential) + from azure.core.credentials import AzureKeyCredential + from azure.identity import DefaultAzureCredential + + if target_endpoint != contentunderstanding_endpoint or target_key: + # Create target client with different endpoint/credential + target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() + target_client = cast( + ContentUnderstandingClient, + self.create_client_from_credential( + ContentUnderstandingClient, + credential=target_credential, + endpoint=target_endpoint, + ), + ) + else: + # Use same endpoint and credential as source + target_client = self.create_client(endpoint=target_endpoint) + + # Generate unique analyzer IDs for this test + source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex[:16]}" + target_analyzer_id = f"test_analyzer_target_{uuid.uuid4().hex[:16]}" + + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") + print(f"[INFO] Target analyzer ID: {target_analyzer_id}") + + # Verify IDs + assert source_analyzer_id is not None, "Source analyzer ID should not be null" + assert source_analyzer_id.strip(), "Source analyzer ID should not be empty" + assert target_analyzer_id is not None, "Target analyzer ID should not be null" + assert target_analyzer_id.strip(), "Target analyzer ID should not be empty" + assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" + print("[PASS] Analyzer IDs verified") + + # Verify resource information + assert source_resource_id is not None, "Source resource ID should not be null" + assert source_resource_id.strip(), "Source resource ID should not be empty" + assert source_region is not None, "Source region should not be null" + assert source_region.strip(), "Source region should not be empty" + assert target_resource_id is not None, "Target resource ID should not be null" + assert target_resource_id.strip(), "Target resource ID should not be empty" + assert target_region is not None, "Target region should not be null" + assert target_region.strip(), "Target region should not be empty" + assert target_endpoint is not None, "Target endpoint should not be null" + assert target_endpoint.strip(), "Target endpoint should not be empty" + + print(f"[INFO] Source resource: {source_resource_id}") + print(f"[INFO] Source region: {source_region}") + print(f"[INFO] Target resource: {target_resource_id}") + print(f"[INFO] Target region: {target_region}") + print(f"[INFO] Target endpoint: {target_endpoint}") + + # Verify clients + assert source_client is not None, "Source client should not be null" + assert target_client is not None, "Target client should not be null" + print("[PASS] Source and target clients created") + + # Step 1: Create the source analyzer + source_config = ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True + ) + + # Verify source config + assert source_config is not None, "Source config should not be null" + assert source_config.enable_formula is False, "EnableFormula should be false" + assert source_config.enable_layout is True, "EnableLayout should be true" + assert source_config.enable_ocr is True, "EnableOcr should be true" + assert source_config.estimate_field_source_and_confidence is True, "EstimateFieldSourceAndConfidence should be true" + assert source_config.return_details is True, "ReturnDetails should be true" + print("[PASS] Source config verified") + + source_field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company" + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document" + ) + } + ) + + # Verify source field schema + assert source_field_schema is not None, "Source field schema should not be null" + assert source_field_schema.name == "company_schema", "Field schema name should match" + assert source_field_schema.description == "Schema for extracting company information", "Field schema description should match" + assert len(source_field_schema.fields) == 2, "Should have 2 fields" + assert "company_name" in source_field_schema.fields, "Should contain company_name field" + assert "total_amount" in source_field_schema.fields, "Should contain total_amount field" + print(f"[PASS] Source field schema verified: {source_field_schema.name} ({len(source_field_schema.fields)} fields)") + + source_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for cross-resource copying", + config=source_config, + field_schema=source_field_schema, + models={ + "completion": "gpt-4.1" + } + ) + + + # Verify source analyzer object + assert source_analyzer is not None, "Source analyzer object should not be null" + assert source_analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" + assert source_analyzer.description == "Source analyzer for cross-resource copying", "Description should match" + assert source_analyzer.models is not None, "Models should not be null" + assert "completion" in source_analyzer.models, "Should have completion model" + assert source_analyzer.models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" + print("[PASS] Source analyzer object verified") + + # Create the source analyzer + create_poller = source_client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=source_analyzer, + allow_replace=True + ) + create_poller.result() # Wait for creation to complete + print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") + + # Get the full analyzer details after creation (LRO result doesn't contain full details) + source_result = source_client.get_analyzer(analyzer_id=source_analyzer_id) + + # Verify create operation + assert source_result is not None, "Source analyzer result should not be null" + assert source_result.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" + assert source_result.description == "Source analyzer for cross-resource copying", "Description should match" + assert source_result.config is not None, "Config should not be null" + assert source_result.field_schema is not None, "Field schema should not be null" + assert len(source_result.field_schema.fields) == 2, "Should have 2 fields" + assert source_result.models is not None, "Models should not be null" + assert "completion" in source_result.models, "Should have completion model" + print(f"[PASS] Source analyzer created: '{source_analyzer_id}'") + print(f"[INFO] Base: {source_result.base_analyzer_id}") + print(f"[INFO] Fields: {len(source_result.field_schema.fields)}") + print(f"[INFO] Models: {len(source_result.models)}") + print("[INFO] Ready for cross-resource copy") + + # Step 2: Grant copy authorization from source resource + # Grant authorization on the source client for copying to the target resource + print(f"\n[INFO] Granting copy authorization from source resource") + + copy_auth = source_client.grant_copy_authorization( + analyzer_id=source_analyzer_id, + target_azure_resource_id=target_resource_id, + target_region=target_region, + ) + + print("[PASS] Copy authorization granted successfully!") + + # Verify copy authorization response + assert copy_auth is not None, "Copy authorization response should not be null" + assert hasattr(copy_auth, 'target_azure_resource_id'), "Copy authorization should have target_azure_resource_id" + assert copy_auth.target_azure_resource_id is not None, "Target Azure resource ID should not be null" + assert copy_auth.target_azure_resource_id.strip(), "Target Azure resource ID should not be empty" + assert copy_auth.target_azure_resource_id == target_resource_id, \ + f"Target resource ID should match, but got '{copy_auth.target_azure_resource_id}' instead of '{target_resource_id}'" + print(f"[PASS] Target Azure Resource ID verified: {copy_auth.target_azure_resource_id}") + print(f"[INFO] Target region (tracked): {target_region}") + + # Verify expiration time + assert hasattr(copy_auth, 'expires_at'), "Copy authorization should have expires_at" + expires_at = copy_auth.expires_at + now = datetime.now(timezone.utc) + + assert expires_at > now, \ + f"Expiration time should be in the future, but expires at {expires_at} (now: {now})" + + # Calculate time until expiration + time_until_expiration = expires_at - now + assert time_until_expiration.total_seconds() > 0, "Should have positive time until expiration" + + print(f"[PASS] Expiration time verified: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") + print(f"[INFO] Time until expiration: {time_until_expiration.total_seconds() / 60:.2f} minutes") + + if time_until_expiration.total_seconds() / 3600 < 24: + print("[WARN] Note: Authorization expires in less than 24 hours") + + print(f"[INFO] Copy authorization granted successfully:") + print(f"[INFO] Source analyzer: {source_analyzer_id}") + print(f"[INFO] Target resource: {copy_auth.target_azure_resource_id}") + print(f"[INFO] Target region: {target_region}") + print(f"[INFO] Expires: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") + print("[INFO] Authorization ready for cross-resource copy") + + # Step 3: Copy analyzer using authorization + # Copy is performed on the target client, copying from source to target + print(f"\n[INFO] Copying analyzer from source to target") + + copy_poller = target_client.begin_copy_analyzer( + analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id, + source_azure_resource_id=source_resource_id, + source_region=source_region, + ) + copy_result = copy_poller.result() + print(f"[PASS] Target analyzer '{target_analyzer_id}' copied successfully to target resource!") + + # Verify copy result + assert copy_result is not None, "Copy result should not be null" + if hasattr(copy_result, 'description'): + print(f"[INFO] Target analyzer description: {copy_result.description}") + + # Step 4: Verify the copied analyzer + copied_analyzer = target_client.get_analyzer(analyzer_id=target_analyzer_id) + + assert copied_analyzer is not None, "Copied analyzer should not be null" + print("[PASS] Copied analyzer retrieved successfully") + + # Verify basic properties match + if hasattr(copied_analyzer, 'analyzer_id'): + assert copied_analyzer.analyzer_id == target_analyzer_id, "Analyzer ID should match" + print(f"[INFO] Target Analyzer ID: {copied_analyzer.analyzer_id}") + + copied_description = getattr(copied_analyzer, 'description', None) + assert copied_description == "Source analyzer for cross-resource copying", "Description should match" + print(f"[INFO] Description: {copied_description}") + + if hasattr(copied_analyzer, 'status'): + print(f"[INFO] Status: {copied_analyzer.status}") + + print("[PASS] Copied analyzer properties verified") + + print("\n[SUCCESS] All test_sample_grant_copy_auth assertions passed") + print("[INFO] Grant copy authorization functionality demonstrated") + finally: + # Clean up: delete test analyzers + try: + if source_analyzer_id and source_client: + source_client.delete_analyzer(analyzer_id=source_analyzer_id) # type: ignore[attr-defined] + print(f"\n[INFO] Source analyzer '{source_analyzer_id}' deleted successfully.") + except Exception as cleanup_error: + print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") + + try: + if target_analyzer_id and target_client: + target_client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore[attr-defined] + print(f"[INFO] Target analyzer '{target_analyzer_id}' deleted successfully.") + except Exception as cleanup_error: + print(f"[WARN] Could not delete target analyzer: {str(cleanup_error)[:100]}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_07_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py similarity index 89% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_07_list_analyzers.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py index f1400404b317..79f89989ebe6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_07_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_07_list_analyzers.py +TEST FILE: test_sample_list_analyzers.py DESCRIPTION: - These tests validate the sample_07_list_analyzers.py sample code. - Tests correspond to .NET Sample07_ListAnalyzers.cs + These tests validate the sample_list_analyzers.py sample code. USAGE: - pytest test_sample_07_list_analyzers.py + pytest test_sample_list_analyzers.py """ import pytest @@ -22,12 +21,12 @@ from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -class TestSample07ListAnalyzers(ContentUnderstandingClientTestBase): - """Tests for sample_07_list_analyzers.py""" +class TestSampleListAnalyzers(ContentUnderstandingClientTestBase): + """Tests for sample_list_analyzers.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_07_list_analyzers(self, contentunderstanding_endpoint: str) -> None: + def test_sample_list_analyzers(self, contentunderstanding_endpoint: str) -> None: """Test listing all available analyzers. This test validates: @@ -35,7 +34,7 @@ def test_sample_07_list_analyzers(self, contentunderstanding_endpoint: str) -> N 2. Counting prebuilt vs custom analyzers 3. Displaying analyzer details - Corresponds to .NET Sample07_ListAnalyzers.ListAnalyzersAsync() + 07_ListAnalyzers.ListAnalyzersAsync() """ client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -115,4 +114,4 @@ def test_sample_07_list_analyzers(self, contentunderstanding_endpoint: str) -> N assert len(analyzers) == valid_analyzers, "All analyzers should have valid IDs" print(f"\n[PASS] All {valid_analyzers} analyzers have valid IDs") print(f"[INFO] Analyzers with description: {analyzers_with_description}") - print("\n[SUCCESS] All test_sample_07_list_analyzers assertions passed") + print("\n[SUCCESS] All test_sample_list_analyzers assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_08_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py similarity index 92% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_08_update_analyzer.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py index aaf347041e9e..5f2b4c0d0b61 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_08_update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py @@ -7,14 +7,13 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_08_update_analyzer.py +TEST FILE: test_sample_update_analyzer.py DESCRIPTION: - These tests validate the sample_08_update_analyzer.py sample code. - Tests correspond to .NET Sample08_UpdateAnalyzer.cs + These tests validate the sample_update_analyzer.py sample code. USAGE: - pytest test_sample_08_update_analyzer.py + pytest test_sample_update_analyzer.py """ import uuid @@ -24,12 +23,12 @@ from azure.ai.contentunderstanding.models import ContentAnalyzer, ContentAnalyzerConfig -class TestSample08UpdateAnalyzer(ContentUnderstandingClientTestBase): - """Tests for sample_08_update_analyzer.py""" +class TestSampleUpdateAnalyzer(ContentUnderstandingClientTestBase): + """Tests for sample_update_analyzer.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_08_update_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_update_analyzer(self, contentunderstanding_endpoint: str) -> None: """Test updating an analyzer's properties. This test validates: @@ -38,7 +37,7 @@ def test_sample_08_update_analyzer(self, contentunderstanding_endpoint: str) -> 3. Updating analyzer description and tags 4. Verifying updates were applied correctly - Corresponds to .NET Sample08_UpdateAnalyzer.UpdateAnalyzerAsync() + 08_UpdateAnalyzer.UpdateAnalyzerAsync() """ # Skip this test if API is not available try: @@ -147,7 +146,7 @@ def test_sample_08_update_analyzer(self, contentunderstanding_endpoint: str) -> assert updated_tags.get("tag3") == "tag3_value", "tag3 value should match" print("[PASS] tag3 added correctly") - print("\n[SUCCESS] All test_sample_08_update_analyzer assertions passed") + print("\n[SUCCESS] All test_sample_update_analyzer assertions passed") except Exception as e: error_msg = str(e).lower() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py index 62a541a9abce..25b75b490861 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py @@ -12,7 +12,7 @@ import pytest from unittest.mock import Mock, patch from azure.core.polling import LROPoller, PollingMethod -from azure.ai.contentunderstanding.operations._patch import ( +from azure.ai.contentunderstanding.models._patch import ( AnalyzeLROPoller, _parse_operation_id, ) From 4778361840e800dfdf720722a65d1f44c903f5b6 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 16:21:47 +0000 Subject: [PATCH 050/105] CI: Fix README.md issue --- .../azure-ai-contentunderstanding/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index 15d567eb8a03..17965bd15748 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -85,7 +85,7 @@ cp sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample .env Then edit `.env` and set at minimum: -```env +``` AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://.services.ai.azure.com/ # Optionally provide a key; if omitted DefaultAzureCredential is used. AZURE_CONTENT_UNDERSTANDING_KEY= @@ -318,7 +318,7 @@ To run the tests for this package, you need to set up a `.env` file with your te ### Running tests -**Important:** Make sure you have activated the virtual environment before running tests (see [Virtual Environment Setup](#virtual-environment-setup) above). +**Important:** Make sure you have activated the virtual environment before running tests. Install the development dependencies (if not already installed): ```bash From 5b644741f91c3ae466f9ea30528b4a09ff0a0cde Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 17:12:51 +0000 Subject: [PATCH 051/105] TEST: Update sample tests --- .../samples/README.md | 8 +- .../tests/README.md | 2 +- .../tests/conftest.py | 19 ++ .../samples/test_sample_grant_copy_auth.py | 15 +- .../tests/test_analyzer_operation_id.py | 60 +++-- ...erstanding_content_analyzers_operations.py | 221 +----------------- ...ding_content_analyzers_operations_async.py | 4 +- .../tests/test_helpers.py | 10 +- .../tests/testpreparer.py | 9 +- .../tests/testpreparer_async.py | 9 +- 10 files changed, 89 insertions(+), 268 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index baf99de54728..8684483af168 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -110,11 +110,11 @@ Set the following in `.env`: **Example `.env` file:** ```bash -AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://your-resource.services.ai.azure.com/ +AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://mmi-sample-foundry.services.ai.azure.com/ AZURE_CONTENT_UNDERSTANDING_KEY=your-api-key-here # Optional -GPT_4_1_DEPLOYMENT=your-gpt-4.1-deployment-name -GPT_4_1_MINI_DEPLOYMENT=your-gpt-4.1-mini-deployment-name -TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=your-text-embedding-3-large-deployment-name +GPT_4_1_DEPLOYMENT=gpt-4.1 +GPT_4_1_MINI_DEPLOYMENT=gpt-4.1-mini +TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=text-embedding-3-large ``` #### 4. Authenticate (if using DefaultAzureCredential) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md index 43aca8938be9..2a3320ce1c20 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md @@ -142,7 +142,7 @@ MaxRetryError: HTTPConnectionPool(host='localhost', port=5000) **Symptoms:** Tests fail with connection errors, proxy doesn't start. **Solution:** -1. Check `.env` file at repository root (`/home/yslin/repos/azure-sdk-for-python-pr/.env`) +1. Check `.env` file at repository root 2. Remove any `PROXY_MANUAL_START=false` line 3. The framework will use the default `False` (boolean) for automatic startup diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py index 8bea3f29c0d6..cbe5f3548ae9 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py @@ -13,6 +13,8 @@ add_general_string_sanitizer, add_body_key_sanitizer, add_header_regex_sanitizer, + add_uri_regex_sanitizer, + add_general_regex_sanitizer, ) load_dotenv() @@ -73,3 +75,20 @@ def add_sanitizers(test_proxy): add_header_regex_sanitizer(key="Set-Cookie", value="[set-cookie;]") add_header_regex_sanitizer(key="Cookie", value="cookie;") add_body_key_sanitizer(json_path="$..access_token", value="access_token") + + # Sanitize dynamic analyzer IDs in URLs only + # Note: We don't sanitize analyzer IDs in response bodies because tests using variables + # (like test_sample_grant_copy_auth) need the actual IDs to match the variables. + # URI sanitization is still needed for consistent URL matching in recordings. + add_uri_regex_sanitizer( + regex=r"/analyzers/test_analyzer_source_[a-f0-9]+", + value="/analyzers/test_analyzer_source_0000000000000000", + ) + add_uri_regex_sanitizer( + regex=r"/analyzers/test_analyzer_target_[a-f0-9]+", + value="/analyzers/test_analyzer_target_0000000000000000", + ) + add_uri_regex_sanitizer( + regex=r"/analyzers/test_analyzer_[a-f0-9]+", + value="/analyzers/test_analyzer_0000000000000000", + ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py index dc4510861aa5..59fef1297b4c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py @@ -38,7 +38,7 @@ class TestSampleGrantCopyAuth(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str) -> None: + def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str, **kwargs) -> None: """Test granting copy authorization for cross-resource analyzer copying. This test validates: @@ -96,9 +96,15 @@ def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str) -> Non # Use same endpoint and credential as source target_client = self.create_client(endpoint=target_endpoint) + # Get variables from test proxy (for playback mode) or use defaults (for record mode) + variables = kwargs.pop("variables", {}) + # Generate unique analyzer IDs for this test - source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex[:16]}" - target_analyzer_id = f"test_analyzer_target_{uuid.uuid4().hex[:16]}" + # Use variables from recording if available (playback mode), otherwise generate new ones (record mode) + default_source_id = f"test_analyzer_source_{uuid.uuid4().hex[:16]}" + default_target_id = f"test_analyzer_target_{uuid.uuid4().hex[:16]}" + source_analyzer_id = variables.setdefault("grantCopySourceAnalyzerId", default_source_id) + target_analyzer_id = variables.setdefault("grantCopyTargetAnalyzerId", default_target_id) print(f"[INFO] Source analyzer ID: {source_analyzer_id}") print(f"[INFO] Target analyzer ID: {target_analyzer_id}") @@ -312,6 +318,9 @@ def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str) -> Non print("\n[SUCCESS] All test_sample_grant_copy_auth assertions passed") print("[INFO] Grant copy authorization functionality demonstrated") + + # Return variables to be recorded for playback mode + return variables finally: # Clean up: delete test analyzers try: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py index 25b75b490861..0c020723c1f0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py @@ -54,8 +54,8 @@ def test_parse_operation_id_no_match(self): class TestAnalyzeLROPoller: """Test the AnalyzeLROPoller class.""" - def test_details_property_success(self): - """Test the details property when operation ID can be extracted.""" + def test_operation_id_property_success(self): + """Test the operation_id property when operation ID can be extracted.""" # Mock the polling method and initial response mock_polling_method = Mock() mock_initial_response = Mock() @@ -72,13 +72,12 @@ def test_details_property_success(self): client=Mock(), initial_response=Mock(), deserialization_callback=Mock(), polling_method=mock_polling_method ) - # Test details property - details = poller.details - assert details["operation_id"] == "test-op-id" - assert details["operation_type"] == "analyze" + # Test operation_id property + operation_id = poller.operation_id + assert operation_id == "test-op-id" - def test_details_property_missing_header(self): - """Test the details property when Operation-Location header is missing.""" + def test_operation_id_property_missing_header(self): + """Test the operation_id property when Operation-Location header is missing.""" # Mock the polling method and initial response mock_polling_method = Mock() mock_initial_response = Mock() @@ -93,14 +92,12 @@ def test_details_property_missing_header(self): client=Mock(), initial_response=Mock(), deserialization_callback=Mock(), polling_method=mock_polling_method ) - # Test details property - details = poller.details - assert details["operation_id"] is None - assert details["operation_type"] == "analyze" - assert "error" in details + # Test operation_id property raises ValueError when header is missing + with pytest.raises(ValueError, match="Could not extract operation ID"): + _ = poller.operation_id - def test_details_property_invalid_url(self): - """Test the details property when URL format is invalid.""" + def test_operation_id_property_invalid_url(self): + """Test the operation_id property when URL format is invalid.""" # Mock the polling method and initial response mock_polling_method = Mock() mock_initial_response = Mock() @@ -117,11 +114,9 @@ def test_details_property_invalid_url(self): client=Mock(), initial_response=Mock(), deserialization_callback=Mock(), polling_method=mock_polling_method ) - # Test details property - details = poller.details - assert details["operation_id"] is None - assert details["operation_type"] == "analyze" - assert "error" in details + # Test operation_id property raises ValueError when URL format is invalid + with pytest.raises(ValueError, match="Could not extract operation ID"): + _ = poller.operation_id def test_from_continuation_token(self): """Test the from_continuation_token class method.""" @@ -146,27 +141,28 @@ class TestPollerIntegration: """Test integration with the operations classes.""" def test_analyze_operation_returns_custom_poller(self): - """Test that begin_analyze returns AnalyzeLROPoller with details property.""" + """Test that begin_analyze returns AnalyzeLROPoller with operation_id property.""" # Create a mock client mock_client = Mock(spec=ContentUnderstandingClient) # Create a mock poller with the required structure - mock_poller = Mock(spec=AnalyzeLROPoller) - mock_poller._polling_method = Mock() - mock_poller._polling_method._initial_response = Mock() - mock_poller._polling_method._initial_response.http_response = Mock() - mock_poller._polling_method._initial_response.http_response.headers = { + mock_polling_method = Mock() + mock_initial_response = Mock() + mock_http_response = Mock() + mock_http_response.headers = { "Operation-Location": "https://endpoint.com/analyzerResults/test-op-id-123?api-version=2025-11-01" } + mock_initial_response.http_response = mock_http_response + mock_polling_method.return_value = mock_polling_method + mock_polling_method._initial_response = mock_initial_response # Create actual AnalyzeLROPoller instance result = AnalyzeLROPoller( - mock_client, mock_poller._polling_method._initial_response, Mock(), mock_poller._polling_method + mock_client, mock_initial_response, Mock(), mock_polling_method ) - # Verify it has the details property + # Verify it has the operation_id property assert isinstance(result, AnalyzeLROPoller) - assert hasattr(result, "details") - details = result.details - assert "operation_id" in details - assert details["operation_id"] == "test-op-id-123" + assert hasattr(result, "operation_id") + operation_id = result.operation_id + assert operation_id == "test-op-id-123" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py index 192a59078a6d..4a76ed087839 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py @@ -282,7 +282,7 @@ def test_content_analyzers_begin_create_with_json(self, contentunderstanding_end }, "description": f"test analyzer: {analyzer_id}", "processingLocation": "global", - "models": {"completion": "gpt-4o"}, + "models": {"completion": "gpt-4.1"}, "tags": {"tag1_name": "tag1_value"}, }, ) @@ -518,7 +518,7 @@ def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: - Verify image file content is returned and save to test_output - Clean up created analyzer """ - if not is_live_and_not_recording(): + if not is_live(): pytest.skip( "This test requires live mode to run, as it involves large video files that are too big for test proxy to record" ) @@ -887,220 +887,3 @@ def test_content_analyzers_delete_result(self, contentunderstanding_endpoint: st print(f"✓ Delete result completed successfully") print("Note: Deletion success verified by no exception thrown") print(f"✓ Delete result test completed successfully") - - -# def test_content_analyzers_begin_analyze(self, contentunderstanding_endpoint): -# client = self.create_client(endpoint=contentunderstanding_endpoint) -# response = client.begin_analyze( -# analyzer_id="str", -# body={ -# "inputs": [ -# { -# "data": bytes("bytes", encoding="utf-8"), -# "mimeType": "str", -# "name": "str", -# "range": "str", -# "url": "str", -# } -# ], -# "modelDeployments": {"str": "str"}, -# }, -# ).result() # call '.result()' to poll until service return final result - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# def test_content_analyzers_begin_copy(self, contentunderstanding_endpoint): -# client = self.create_client(endpoint=contentunderstanding_endpoint) -# response = client.begin_copy( -# analyzer_id="str", -# body={"sourceAnalyzerId": "str", "sourceAzureResourceId": "str", "sourceRegion": "str"}, -# source_analyzer_id="str", -# ).result() # call '.result()' to poll until service return final result - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# def test_content_analyzers_begin_create_or_replace(self, contentunderstanding_endpoint): -# client = self.create_client(endpoint=contentunderstanding_endpoint) -# response = client.begin_create_or_replace( -# analyzer_id="str", -# resource={ -# "analyzerId": "str", -# "createdAt": "2020-02-20 00:00:00", -# "lastModifiedAt": "2020-02-20 00:00:00", -# "status": "str", -# "baseAnalyzerId": "str", -# "config": { -# "annotationFormat": "str", -# "chartFormat": "str", -# "contentCategories": {"str": {"analyzer": ..., "analyzerId": "str", "description": "str"}}, -# "disableFaceBlurring": bool, -# "enableAnnotation": bool, -# "enableFigureAnalysis": bool, -# "enableFigureDescription": bool, -# "enableFormula": bool, -# "enableLayout": bool, -# "enableOcr": bool, -# "enableSegment": bool, -# "estimateFieldSourceAndConfidence": bool, -# "locales": ["str"], -# "omitContent": bool, -# "returnDetails": bool, -# "segmentPerPage": bool, -# "tableFormat": "str", -# }, -# "description": "str", -# "dynamicFieldSchema": bool, -# "fieldSchema": { -# "fields": { -# "str": { -# "$ref": "str", -# "description": "str", -# "enum": ["str"], -# "enumDescriptions": {"str": "str"}, -# "estimateSourceAndConfidence": bool, -# "examples": ["str"], -# "items": ..., -# "method": "str", -# "properties": {"str": ...}, -# "type": "str", -# } -# }, -# "definitions": { -# "str": { -# "$ref": "str", -# "description": "str", -# "enum": ["str"], -# "enumDescriptions": {"str": "str"}, -# "estimateSourceAndConfidence": bool, -# "examples": ["str"], -# "items": ..., -# "method": "str", -# "properties": {"str": ...}, -# "type": "str", -# } -# }, -# "description": "str", -# "name": "str", -# }, -# "knowledgeSources": ["knowledge_source"], -# "models": {"str": "str"}, -# "processingLocation": "str", -# "supportedModels": {"completion": {"str": "str"}, "embedding": {"str": "str"}}, -# "tags": {"str": "str"}, -# "warnings": [...], -# }, -# ).result() # call '.result()' to poll until service return final result - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# def test_content_analyzers_delete_result(self, contentunderstanding_endpoint): -# client = self.create_client(endpoint=contentunderstanding_endpoint) -# response = client.delete_result( -# operation_id="str", -# ) - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# def test_content_analyzers_get_defaults(self, contentunderstanding_endpoint): -# client = self.create_client(endpoint=contentunderstanding_endpoint) -# response = client.get_defaults() - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# def test_content_analyzers_get_operation_status(self, contentunderstanding_endpoint): -# client = self.create_client(endpoint=contentunderstanding_endpoint) -# response = client.get_operation_status( -# analyzer_id="str", -# operation_id="str", -# ) - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# def test_content_analyzers_grant_copy_authorization(self, contentunderstanding_endpoint): -# client = self.create_client(endpoint=contentunderstanding_endpoint) -# response = client.grant_copy_authorization( -# analyzer_id="str", -# body={"targetAzureResourceId": "str", "targetRegion": "str"}, -# target_azure_resource_id="str", -# ) - -# please add some check logic here by yourself -# ... - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") - - -# @ContentUnderstandingPreparer() -# @recorded_by_proxy -# @pytest.mark.skip(reason="GA API addition - to be implemented") -# def test_content_analyzers_update_defaults(self, contentunderstanding_endpoint): -# client = self.create_client(endpoint=contentunderstanding_endpoint) -# response = client.update_defaults( -# body={"modelDeployments": {}}, -# ) - -# please add some check logic here by yourself -# ... diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py index f1e2d63f7b5e..d61c82d3a0ee 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py @@ -394,7 +394,7 @@ async def test_create_analyzer_with_json_async(self, contentunderstanding_endpoi }, "mode": "standard", "processingLocation": "global", - "models": {"completion": "gpt-4o"}, # Required when using fieldSchema + "models": {"completion": "gpt-4.1"}, # Required when using fieldSchema "tags": {"tag1_name": "tag1_value"}, }, ) @@ -695,7 +695,7 @@ async def test_get_result_file_async(self, contentunderstanding_endpoint: str) - Tests retrieving result files from a video analysis operation. Verifies that image files generated from video analysis can be retrieved and saved. """ - if not is_live_and_not_recording(): + if not is_live(): pytest.skip( "This test requires live mode to run, as it involves large video files that are too big for test proxy to record" ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py index d73f72d15229..7ddfda633d18 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py @@ -80,7 +80,7 @@ def new_simple_content_analyzer_object( name="schema name here", ), processing_location=ProcessingLocation.GLOBAL, - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema tags=tags, ) @@ -110,7 +110,7 @@ def new_marketing_video_analyzer_object( ), description=description, processing_location=ProcessingLocation.GLOBAL, - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema tags=tags, ) @@ -158,7 +158,7 @@ def assert_simple_content_analyzer_result(analysis_result: Any, result_name: str assert hasattr(first_content, "fields"), "First content should have fields" print(f"Verified fields node exists in first result") - # Verify total_amount field exists and equals 110 + # Verify total_amount field exists and equals 610.0 fields = first_content.fields # Fields is expected to be a dictionary @@ -174,7 +174,7 @@ def assert_simple_content_analyzer_result(analysis_result: Any, result_name: str total_amount_value = total_amount_field.value print(f"Total amount field value: {total_amount_value}") - assert total_amount_value == 110, f"Expected total_amount to be 110, but got {total_amount_value}" + assert total_amount_value == 610.0, f"Expected total_amount to be 610.0, but got {total_amount_value}" print(f"Total amount field validation successful") @@ -461,7 +461,7 @@ def new_invoice_analyzer_object( name="invoice_schema", ), processing_location=ProcessingLocation.GLOBAL, - models={"completion": "gpt-4o"}, # Required when using field_schema + models={"completion": "gpt-4.1"}, # Required when using field_schema tags=tags, ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py index e0095d569f6e..33bfe1eeae8b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py @@ -30,7 +30,14 @@ def get_content_understanding_credential(): class ContentUnderstandingClientTestBase(AzureRecordedTestCase): def create_client(self, endpoint: str) -> ContentUnderstandingClient: - credential = self.get_credential(ContentUnderstandingClient, is_async=False) + # Try API key first (for Content Understanding service) + # Check both CONTENTUNDERSTANDING_KEY (PowerShellPreparer convention) and AZURE_CONTENT_UNDERSTANDING_KEY + key = os.getenv("CONTENTUNDERSTANDING_KEY") or os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + if key and key.strip(): + credential = AzureKeyCredential(key) + else: + # Fall back to service principal or DefaultAzureCredential + credential = self.get_credential(ContentUnderstandingClient, is_async=False) return cast( ContentUnderstandingClient, self.create_client_from_credential( diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py index 6de1d243beba..f344da3d8afa 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py @@ -31,7 +31,14 @@ def get_content_understanding_credential_async(): class ContentUnderstandingClientTestBaseAsync(AzureRecordedTestCase): def create_async_client(self, endpoint: str) -> ContentUnderstandingClient: - credential = self.get_credential(ContentUnderstandingClient, is_async=True) + # Try API key first (for Content Understanding service) + # Check both CONTENTUNDERSTANDING_KEY (PowerShellPreparer convention) and AZURE_CONTENT_UNDERSTANDING_KEY + key = os.getenv("CONTENTUNDERSTANDING_KEY") or os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + if key and key.strip(): + credential = AzureKeyCredential(key) + else: + # Fall back to service principal or DefaultAzureCredential + credential = self.get_credential(ContentUnderstandingClient, is_async=True) return cast( ContentUnderstandingClient, self.create_client_from_credential( From 99422518226438229b773be0e675cd098417d96b Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 17:13:09 +0000 Subject: [PATCH 052/105] CI: Fix cspell issue --- .../azure-ai-contentunderstanding/cspell.json | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/cspell.json diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/cspell.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/cspell.json new file mode 100644 index 000000000000..3dc1f7fb0f8b --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/cspell.json @@ -0,0 +1,17 @@ +{ + "ignoreWords": [ + "laren", + "Milsa", + "nlaren", + "PTIN", + "UPCA", + "UPCE", + "upca", + "upce" + ], + "ignorePaths": [ + "sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/*.json" + ], + "_comment": "ignoreWords: laren/Milsa/nlaren/PTIN from sample JSON files (IRS tax form test data); UPCA/UPCE/upca/upce are barcode types from _enums.py and _models.py as OCR Barcode types standardized in the ISO/IEC 15415:2019 standard" +} + From b6848c79a8e17063be7ede086b5186283efd8f5a Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 17:34:50 +0000 Subject: [PATCH 053/105] TEST: Added assets.json for pushed recording. --- .../azure-ai-contentunderstanding/assets.json | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json new file mode 100644 index 000000000000..967aacdf963b --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json @@ -0,0 +1,6 @@ +{ + "AssetsRepo": "Azure/azure-sdk-assets", + "AssetsRepoPrefixPath": "python", + "TagPrefix": "python/contentunderstanding/azure-ai-contentunderstanding", + "Tag": "python/contentunderstanding/azure-ai-contentunderstanding_7784f7a7b4" +} From 459fbcbb016bf0455d3f1f4c6b09740e77930781 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 17:59:59 +0000 Subject: [PATCH 054/105] TEST: In playback, do not check for required env var --- .../samples/test_sample_grant_copy_auth.py | 107 +++++++++++------- 1 file changed, 66 insertions(+), 41 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py index 59fef1297b4c..81e8f27d13ce 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py @@ -18,9 +18,10 @@ import os import uuid +import pytest from datetime import datetime, timezone from typing import Optional, cast -from devtools_testutils import recorded_by_proxy +from devtools_testutils import recorded_by_proxy, is_live from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase from azure.ai.contentunderstanding import ContentUnderstandingClient from azure.ai.contentunderstanding.models import ( @@ -64,15 +65,23 @@ def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str, **kwar target_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION") target_key = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") - # Require environment variables - if not source_resource_id: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID is required") - if not source_region: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION is required") - if not target_resource_id: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID is required") - if not target_region: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION is required") + # Only require environment variables in live mode + # In playback mode, the test proxy will replay recorded interactions + if is_live(): + if not source_resource_id: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID is required for cross-resource copy test in live mode") + if not source_region: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION is required for cross-resource copy test in live mode") + if not target_resource_id: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID is required for cross-resource copy test in live mode") + if not target_region: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION is required for cross-resource copy test in live mode") + else: + # In playback mode, use placeholder values - test proxy will use recorded values + source_resource_id = source_resource_id or "placeholder-source-resource-id" + source_region = source_region or "placeholder-source-region" + target_resource_id = target_resource_id or "placeholder-target-resource-id" + target_region = target_region or "placeholder-target-region" # Create clients source_client = self.create_client(endpoint=contentunderstanding_endpoint) @@ -117,22 +126,26 @@ def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str, **kwar assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" print("[PASS] Analyzer IDs verified") - # Verify resource information - assert source_resource_id is not None, "Source resource ID should not be null" - assert source_resource_id.strip(), "Source resource ID should not be empty" - assert source_region is not None, "Source region should not be null" - assert source_region.strip(), "Source region should not be empty" - assert target_resource_id is not None, "Target resource ID should not be null" - assert target_resource_id.strip(), "Target resource ID should not be empty" - assert target_region is not None, "Target region should not be null" - assert target_region.strip(), "Target region should not be empty" + # Verify resource information (only in live mode) + # In playback mode, the test proxy will replay recorded interactions + if is_live(): + assert source_resource_id is not None, "Source resource ID should not be null" + assert source_resource_id.strip(), "Source resource ID should not be empty" + assert source_region is not None, "Source region should not be null" + assert source_region.strip(), "Source region should not be empty" + assert target_resource_id is not None, "Target resource ID should not be null" + assert target_resource_id.strip(), "Target resource ID should not be empty" + assert target_region is not None, "Target region should not be null" + assert target_region.strip(), "Target region should not be empty" + assert target_endpoint is not None, "Target endpoint should not be null" assert target_endpoint.strip(), "Target endpoint should not be empty" - print(f"[INFO] Source resource: {source_resource_id}") - print(f"[INFO] Source region: {source_region}") - print(f"[INFO] Target resource: {target_resource_id}") - print(f"[INFO] Target region: {target_region}") + if is_live(): + print(f"[INFO] Source resource: {source_resource_id}") + print(f"[INFO] Source region: {source_region}") + print(f"[INFO] Target resource: {target_resource_id}") + print(f"[INFO] Target region: {target_region}") print(f"[INFO] Target endpoint: {target_endpoint}") # Verify clients @@ -248,28 +261,40 @@ def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str, **kwar assert hasattr(copy_auth, 'target_azure_resource_id'), "Copy authorization should have target_azure_resource_id" assert copy_auth.target_azure_resource_id is not None, "Target Azure resource ID should not be null" assert copy_auth.target_azure_resource_id.strip(), "Target Azure resource ID should not be empty" - assert copy_auth.target_azure_resource_id == target_resource_id, \ - f"Target resource ID should match, but got '{copy_auth.target_azure_resource_id}' instead of '{target_resource_id}'" - print(f"[PASS] Target Azure Resource ID verified: {copy_auth.target_azure_resource_id}") - print(f"[INFO] Target region (tracked): {target_region}") + # In playback mode, compare against the recorded response value + # In live mode, compare against the environment variable + if is_live(): + assert copy_auth.target_azure_resource_id == target_resource_id, \ + f"Target resource ID should match, but got '{copy_auth.target_azure_resource_id}' instead of '{target_resource_id}'" + print(f"[PASS] Target Azure Resource ID verified: {copy_auth.target_azure_resource_id}") + print(f"[INFO] Target region (tracked): {target_region}") + else: + # In playback mode, just verify the response has a value (from recording) + print(f"[INFO] Target Azure Resource ID (from recording): {copy_auth.target_azure_resource_id}") + print(f"[INFO] Target region (from recording): {target_region}") # Verify expiration time assert hasattr(copy_auth, 'expires_at'), "Copy authorization should have expires_at" expires_at = copy_auth.expires_at - now = datetime.now(timezone.utc) - - assert expires_at > now, \ - f"Expiration time should be in the future, but expires at {expires_at} (now: {now})" - - # Calculate time until expiration - time_until_expiration = expires_at - now - assert time_until_expiration.total_seconds() > 0, "Should have positive time until expiration" - - print(f"[PASS] Expiration time verified: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") - print(f"[INFO] Time until expiration: {time_until_expiration.total_seconds() / 60:.2f} minutes") - - if time_until_expiration.total_seconds() / 3600 < 24: - print("[WARN] Note: Authorization expires in less than 24 hours") + # Only verify expiration time in live/record mode, not in playback mode + # (recorded expiration times may be in the past during playback) + if is_live(): + now = datetime.now(timezone.utc) + + assert expires_at > now, \ + f"Expiration time should be in the future, but expires at {expires_at} (now: {now})" + + # Calculate time until expiration + time_until_expiration = expires_at - now + assert time_until_expiration.total_seconds() > 0, "Should have positive time until expiration" + + print(f"[PASS] Expiration time verified: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") + print(f"[INFO] Time until expiration: {time_until_expiration.total_seconds() / 60:.2f} minutes") + + if time_until_expiration.total_seconds() / 3600 < 24: + print("[WARN] Note: Authorization expires in less than 24 hours") + else: + print(f"[INFO] Expiration time: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC (from recorded response)") print(f"[INFO] Copy authorization granted successfully:") print(f"[INFO] Source analyzer: {source_analyzer_id}") From 86cb90bf8238043f28d08ca0eaf70faf27a61c9a Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 18:22:33 +0000 Subject: [PATCH 055/105] TEST: Put required var for grant copy auth and update recording --- .../azure-ai-contentunderstanding/assets.json | 2 +- .../azure-ai-contentunderstanding/tests/conftest.py | 12 ++++++++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json index 967aacdf963b..adb05d228321 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json @@ -2,5 +2,5 @@ "AssetsRepo": "Azure/azure-sdk-assets", "AssetsRepoPrefixPath": "python", "TagPrefix": "python/contentunderstanding/azure-ai-contentunderstanding", - "Tag": "python/contentunderstanding/azure-ai-contentunderstanding_7784f7a7b4" + "Tag": "python/contentunderstanding/azure-ai-contentunderstanding_c38d4e3418" } diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py index cbe5f3548ae9..cb4f98812b6f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py @@ -75,6 +75,18 @@ def add_sanitizers(test_proxy): add_header_regex_sanitizer(key="Set-Cookie", value="[set-cookie;]") add_header_regex_sanitizer(key="Cookie", value="cookie;") add_body_key_sanitizer(json_path="$..access_token", value="access_token") + + # Sanitize cross-resource copy fields in request body + # These fields are required for grant_copy_authorization and copy_analyzer API calls + # Sanitizing them allows playback mode to use placeholder values + add_body_key_sanitizer(json_path="$.targetAzureResourceId", value="placeholder-target-resource-id") + add_body_key_sanitizer(json_path="$.targetRegion", value="placeholder-target-region") + add_body_key_sanitizer(json_path="$..targetAzureResourceId", value="placeholder-target-resource-id") + add_body_key_sanitizer(json_path="$..targetRegion", value="placeholder-target-region") + add_body_key_sanitizer(json_path="$.sourceAzureResourceId", value="placeholder-source-resource-id") + add_body_key_sanitizer(json_path="$.sourceRegion", value="placeholder-source-region") + add_body_key_sanitizer(json_path="$..sourceAzureResourceId", value="placeholder-source-resource-id") + add_body_key_sanitizer(json_path="$..sourceRegion", value="placeholder-source-region") # Sanitize dynamic analyzer IDs in URLs only # Note: We don't sanitize analyzer IDs in response bodies because tests using variables From ae0a7434c6da5535ba823e442aa75bd6d8d0ba5d Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 18:34:37 +0000 Subject: [PATCH 056/105] CI: Update README and CHANGELOG --- .../CHANGELOG.md | 4 +- .../azure-ai-contentunderstanding/README.md | 11 ++++ .../samples/README.md | 6 +- .../tests/README.md | 64 +++++++++++++++++-- 4 files changed, 73 insertions(+), 12 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md index 83f897aac77e..672c4c0b6543 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/CHANGELOG.md @@ -1,9 +1,9 @@ # Release History -## 1.0.0-beta.1 (Unreleased) +## 1.0.0b1 (Unreleased) ### Features Added -- Initial release of Azure AI Content Understanding client library for .NET +- Initial release of Azure AI Content Understanding client library for Python - Added `ContentUnderstandingClient` for analyzing documents, audio, and video content ### Breaking Changes diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index 17965bd15748..7373ffabc458 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -347,5 +347,16 @@ pytest tests/ -n 4 For more information about running tests, see the [Azure SDK Python Testing Guide](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md). +## Contributing + +This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit [cla.microsoft.com][cla]. + +When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. + +This project has adopted the [Microsoft Open Source Code of Conduct][code_of_conduct]. For more information see the [Code of Conduct FAQ][code_of_conduct_faq] or contact [opencode@microsoft.com][opencode_email] with any additional questions or comments. [azure_sub]: https://azure.microsoft.com/free/ +[cla]: https://cla.microsoft.com +[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ +[code_of_conduct_faq]: https://opensource.microsoft.com/codeofconduct/faq/ +[opencode_email]: mailto:opencode@microsoft.com diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index 8684483af168..c80fb85a0fd4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -13,7 +13,7 @@ urlFragment: contentunderstanding-samples These code samples demonstrate common scenarios with the Azure AI Content Understanding client library. -**Note:** All samples in this folder use synchronous operations. For async samples, see the [`async_samples`](async_samples) directory. +**Note:** All samples in this folder use synchronous operations. For async samples, see the [`async_samples`](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples) directory. ## Prerequisites @@ -477,12 +477,12 @@ python samples/sample_analyze_binary.py # Make sure you're in the package direc * Review the [Azure AI Content Understanding documentation][contentunderstanding_docs] * Check the [API reference][apiref] for detailed API information -* See the main [README](../README.md) for more getting started information +* See the main [README](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md) for more getting started information [azure_sub]: https://azure.microsoft.com/free/ [contentunderstanding_docs]: https://learn.microsoft.com/azure/ai-services/content-understanding/ [contentunderstanding_quickstart]: https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api [contentunderstanding_regions]: https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support -[apiref]: https://learn.microsoft.com/python/api/azure-ai-contentunderstanding/ +[apiref]: https://azuresdkdocs.z19.web.core.windows.net/python/azure-ai-contentunderstanding/latest/ diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md index 2a3320ce1c20..55a013fab830 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md @@ -1,8 +1,8 @@ -# Testing Guide for Azure AI Content Understanding SDK +# Azure AI Content Understanding client library for Python - Testing Guide This guide provides instructions for running tests for the Azure AI Content Understanding SDK. -## Prerequisites +## Getting started 1. Python 3.8 or higher 2. Virtual environment activated @@ -95,12 +95,14 @@ If you need to run tests in parallel (`pytest -n auto`), you must manually start **Note:** The string `"true"` is truthy in Python, so setting `PROXY_MANUAL_START=true` correctly tells the framework that the proxy is manually managed. -## Test Modes +## Key concepts -### Playback Mode (Default) +### Test Modes + +#### Playback Mode (Default) Tests run against recorded HTTP responses. No live service calls are made. -### Live Mode +#### Live Mode Tests make actual API calls to Azure services. Requires valid credentials. Set environment variable: @@ -108,7 +110,7 @@ Set environment variable: export AZURE_TEST_RUN_LIVE=true ``` -### Record Mode +#### Record Mode Tests make live API calls and record the responses for future playback. Set environment variable: @@ -117,6 +119,9 @@ export AZURE_TEST_RUN_LIVE=true export AZURE_TEST_RECORD_MODE=true ``` +### Test Proxy +The test framework uses the **test-proxy** for recording and playing back HTTP requests during tests. This allows tests to run consistently without requiring live Azure resources in most scenarios. + ## Troubleshooting ### Connection Refused Errors @@ -146,17 +151,62 @@ MaxRetryError: HTTPConnectionPool(host='localhost', port=5000) 2. Remove any `PROXY_MANUAL_START=false` line 3. The framework will use the default `False` (boolean) for automatic startup +## Examples + +### Running a Single Test +```bash +pytest tests/test_content_understanding_content_analyzers_operations.py::TestContentUnderstandingContentAnalyzersOperations::test_content_analyzers_get +``` + +### Running Tests in Parallel +```bash +# Start test-proxy manually first +./start_test_proxy_for_parallel.sh +export PROXY_MANUAL_START=true + +# Run tests in parallel +pytest -n auto + +# Stop test-proxy when done +./stop_test_proxy.sh +``` + +### Running Tests in Live Mode +```bash +export AZURE_TEST_RUN_LIVE=true +pytest tests/ +``` + ## Helper Scripts - `start_test_proxy_for_parallel.sh` - Start test-proxy manually for parallel execution - `stop_test_proxy.sh` - Stop manually started test-proxy - `enable_parallel_proxy.md` - Detailed guide for parallel execution setup +## Next steps + +- Review the [Azure SDK Python Testing Guide](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md) for comprehensive testing documentation +- Check the [Test-Proxy Documentation](https://github.com/Azure/azure-sdk-tools/tree/main/tools/test-proxy) for test-proxy details +- See the main [README](../README.md) for package documentation + +## Contributing + +This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit [cla.microsoft.com][cla]. + +When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. + +This project has adopted the [Microsoft Open Source Code of Conduct][code_of_conduct]. For more information see the [Code of Conduct FAQ][code_of_conduct_faq] or contact [opencode@microsoft.com][opencode_email] with any additional questions or comments. + ## Additional Resources -- [Azure SDK Python Testing Guide](../../../../../doc/dev/tests.md) - Comprehensive testing documentation +- [Azure SDK Python Testing Guide](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md) - Comprehensive testing documentation - [Test-Proxy Documentation](https://github.com/Azure/azure-sdk-tools/tree/main/tools/test-proxy) - Official test-proxy documentation +[cla]: https://cla.microsoft.com +[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ +[code_of_conduct_faq]: https://opensource.microsoft.com/codeofconduct/faq/ +[opencode_email]: mailto:opencode@microsoft.com + From 9a429b263805a22af7868a554e06dc8a187d4949 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 18:35:07 +0000 Subject: [PATCH 057/105] CI: Fix MyPy issues --- .../azure/ai/contentunderstanding/_patch.py | 14 +++++---- .../ai/contentunderstanding/aio/_patch.py | 14 +++++---- .../contentunderstanding/aio/models/_patch.py | 7 +++-- .../sample_analyze_configs_async.py | 2 +- .../sample_analyze_invoice_async.py | 30 +++++++++---------- .../sample_configure_defaults_async.py | 9 +++--- .../sample_create_analyzer_async.py | 5 ++-- .../sample_create_classifier_async.py | 4 +-- .../sample_delete_result_async.py | 2 +- .../samples/sample_analyze_configs.py | 2 +- .../samples/sample_analyze_invoice.py | 30 +++++++++---------- .../samples/sample_configure_defaults.py | 9 +++--- .../samples/sample_create_analyzer.py | 5 ++-- .../samples/sample_create_classifier.py | 4 +-- .../samples/sample_delete_result.py | 2 +- 15 files changed, 74 insertions(+), 65 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py index efb768887c0c..68f711002ff7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py @@ -47,7 +47,7 @@ class ContentUnderstandingClient(GeneratedClient): Retry-After header is present. """ - @overload + @overload # type: ignore[override] def begin_analyze( self, analyzer_id: str, @@ -86,7 +86,7 @@ def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ - @overload + @overload # type: ignore[override] def begin_analyze( self, analyzer_id: str, @@ -119,7 +119,7 @@ def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ - @overload + @overload # type: ignore[override] def begin_analyze( self, analyzer_id: str, @@ -152,7 +152,7 @@ def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ - def begin_analyze( + def begin_analyze( # type: ignore[override] self, analyzer_id: str, body: Union[JSON, IO[bytes]] = _Unset, @@ -196,12 +196,14 @@ def begin_analyze( # Call parent implementation # Only pass body if it's not _Unset (let parent construct from inputs if not provided) + # Ensure content_type is always a string (not None) + content_type_str = content_type if content_type is not None else "application/json" if body is not _Unset: poller = super().begin_analyze( analyzer_id=analyzer_id, body=body, processing_location=processing_location, - content_type=content_type, + content_type=content_type_str, inputs=inputs, model_deployments=model_deployments, **kwargs, @@ -210,7 +212,7 @@ def begin_analyze( poller = super().begin_analyze( analyzer_id=analyzer_id, processing_location=processing_location, - content_type=content_type, + content_type=content_type_str, inputs=inputs, model_deployments=model_deployments, **kwargs, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py index 06dd013b7818..dce710a2bc08 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py @@ -47,7 +47,7 @@ class ContentUnderstandingClient(GeneratedClient): Retry-After header is present. """ - @overload + @overload # type: ignore[override] async def begin_analyze( self, analyzer_id: str, @@ -86,7 +86,7 @@ async def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ - @overload + @overload # type: ignore[override] async def begin_analyze( self, analyzer_id: str, @@ -119,7 +119,7 @@ async def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ - @overload + @overload # type: ignore[override] async def begin_analyze( self, analyzer_id: str, @@ -152,7 +152,7 @@ async def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ - async def begin_analyze( + async def begin_analyze( # type: ignore[override] self, analyzer_id: str, body: Union[JSON, IO[bytes]] = _Unset, @@ -196,12 +196,14 @@ async def begin_analyze( # Call parent implementation # Only pass body if it's not _Unset (let parent construct from inputs if not provided) + # Ensure content_type is always a string (not None) + content_type_str = content_type if content_type is not None else "application/json" if body is not _Unset: poller = await super().begin_analyze( analyzer_id=analyzer_id, body=body, processing_location=processing_location, - content_type=content_type, + content_type=content_type_str, inputs=inputs, model_deployments=model_deployments, **kwargs, @@ -210,7 +212,7 @@ async def begin_analyze( poller = await super().begin_analyze( analyzer_id=analyzer_id, processing_location=processing_location, - content_type=content_type, + content_type=content_type_str, inputs=inputs, model_deployments=model_deployments, **kwargs, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py index 27d014d5c2a2..b64891867d4b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py @@ -65,7 +65,7 @@ async def from_continuation_token( polling_method: AsyncPollingMethod[PollingReturnType_co], continuation_token: str, **kwargs: Any, - ) -> "AnalyzeAsyncLROPoller": + ) -> AsyncLROPoller[PollingReturnType_co]: """Create a poller from a continuation token. :param polling_method: The polling strategy to adopt @@ -73,14 +73,15 @@ async def from_continuation_token( :param continuation_token: An opaque continuation token :type continuation_token: str :return: An instance of AnalyzeAsyncLROPoller - :rtype: AnalyzeAsyncLROPoller + :rtype: AsyncLROPoller[PollingReturnType_co] :raises ~azure.core.exceptions.HttpResponseError: If the continuation token is invalid. """ + result = await polling_method.from_continuation_token(continuation_token, **kwargs) ( client, initial_response, deserialization_callback, - ) = await polling_method.from_continuation_token(continuation_token, **kwargs) + ) = result return cls(client, initial_response, deserialization_callback, polling_method) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index 72717104ff22..ef44655c52f0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -135,7 +135,7 @@ async def main() -> None: if len(all_formulas) > 0: print(f"\nFound {len(all_formulas)} formula(s)") for formula in all_formulas: - print(f" Formula: {formula.value or '(no value)'}") + print(f" Formula: {formula.value or '(no value)'}") # type: ignore[attr-defined] if hasattr(formula, "kind") and formula.kind: print(f" Kind: {formula.kind}") else: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index 3a5358447940..b4f86d9b0d5f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -94,8 +94,8 @@ async def main() -> None: customer_name_field = document_content.fields.get("CustomerName") invoice_date_field = document_content.fields.get("InvoiceDate") - customer_name = customer_name_field.value if customer_name_field else None - invoice_date = invoice_date_field.value if invoice_date_field else None + customer_name = customer_name_field.value if customer_name_field else None # type: ignore[attr-defined] + invoice_date = invoice_date_field.value if invoice_date_field else None # type: ignore[attr-defined] print(f"Customer Name: {customer_name or '(None)'}") if customer_name_field: @@ -121,13 +121,13 @@ async def main() -> None: # Extract object field (TotalAmount contains Amount and CurrencyCode) total_amount_field = document_content.fields.get("TotalAmount") - if total_amount_field and total_amount_field.value: + if total_amount_field and total_amount_field.value: # type: ignore[attr-defined] total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore amount_field = total_amount_obj.get("Amount") currency_field = total_amount_obj.get("CurrencyCode") - amount = amount_field.value if amount_field else None - currency = currency_field.value if currency_field else None + amount = amount_field.value if amount_field else None # type: ignore[attr-defined] + currency = currency_field.value if currency_field else None # type: ignore[attr-defined] print(f"\nTotal Amount: {amount} {currency}") if total_amount_field.confidence: @@ -136,12 +136,12 @@ async def main() -> None: # Extract array field (LineItems - line items) # Note: The field name is "LineItems" (not "Items") to match the service response line_items_field = document_content.fields.get("LineItems") - if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: + if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: # type: ignore[attr-defined] items_array: list = line_items_field.value # type: ignore print(f"\nLine Items ({len(items_array)}):") for i, item in enumerate(items_array, 1): # Each item in the array is a ContentField (ObjectField for line items) - if isinstance(item, ObjectField) and item.value: + if isinstance(item, ObjectField) and item.value: # type: ignore[attr-defined] item_dict: dict[str, ContentField] = item.value # type: ignore description_field = item_dict.get("Description") quantity_field = item_dict.get("Quantity") @@ -149,21 +149,21 @@ async def main() -> None: unit_price_field = item_dict.get("UnitPrice") amount_field = item_dict.get("Amount") - description = description_field.value if description_field else "(no description)" - quantity = quantity_field.value if quantity_field else "N/A" + description = description_field.value if description_field else "(no description)" # type: ignore[attr-defined] + quantity = quantity_field.value if quantity_field else "N/A" # type: ignore[attr-defined] # Display price information - prefer UnitPrice if available, otherwise Amount # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) price_info = "" - if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: + if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: # type: ignore[attr-defined] unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore unit_price_amount_field = unit_price_obj.get("Amount") unit_price_currency_field = unit_price_obj.get("CurrencyCode") - if unit_price_amount_field and unit_price_amount_field.value is not None: - currency = unit_price_currency_field.value if unit_price_currency_field else "" - price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() - elif amount_field and amount_field.value is not None: - price_info = f"Amount: {amount_field.value}" + if unit_price_amount_field and unit_price_amount_field.value is not None: # type: ignore[attr-defined] + currency = unit_price_currency_field.value if unit_price_currency_field else "" # type: ignore[attr-defined] + price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() # type: ignore[attr-defined] + elif amount_field and amount_field.value is not None: # type: ignore[attr-defined] + price_info = f"Amount: {amount_field.value}" # type: ignore[attr-defined] print(f" {i}. {description}") print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py index 7efeb8712180..9bde37e3748b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py @@ -68,10 +68,11 @@ async def main() -> None: return # Map your deployed models to the models required by prebuilt analyzers - model_deployments = { - "gpt-4.1": gpt_4_1_deployment, - "gpt-4.1-mini": gpt_4_1_mini_deployment, - "text-embedding-3-large": text_embedding_3_large_deployment, + # At this point, all deployments are guaranteed to be non-None due to the check above + model_deployments: dict[str, str] = { + "gpt-4.1": gpt_4_1_deployment, # type: ignore[assignment] + "gpt-4.1-mini": gpt_4_1_mini_deployment, # type: ignore[assignment] + "text-embedding-3-large": text_embedding_3_large_deployment, # type: ignore[assignment] } print("Configuring model deployments...") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py index 55345a34e179..771d33685813 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py @@ -132,8 +132,9 @@ async def main() -> None: if result.field_schema and result.field_schema.fields: print(f" Fields ({len(result.field_schema.fields)}):") for field_name, field_def in result.field_schema.fields.items(): - method = field_def.method.value if field_def.method else "auto" - print(f" - {field_name}: {field_def.type.value if field_def.type else 'unknown'} ({method})") + method = field_def.method if field_def.method else "auto" + field_type = field_def.type if field_def.type else "unknown" + print(f" - {field_name}: {field_type} ({method})") # [END create_analyzer] # Clean up - delete the analyzer diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index a38125410cea..5607026b766c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -116,12 +116,12 @@ async def main() -> None: print(f"\nAnalyzing document with classifier '{analyzer_id}'...") - poller = await client.begin_analyze_binary( + analyze_poller = await client.begin_analyze_binary( analyzer_id=analyzer_id, content_type="application/pdf", binary_input=file_bytes, ) - analyze_result: AnalyzeResult = await poller.result() + analyze_result: AnalyzeResult = await analyze_poller.result() # Display classification results if analyze_result.contents and len(analyze_result.contents) > 0: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py index 1083fdc0a58e..3401aea603ac 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py @@ -94,7 +94,7 @@ async def main() -> None: print(f" Total fields extracted: {len(doc_content.fields)}") customer_name_field = doc_content.fields.get("CustomerName") if customer_name_field: - print(f" Customer Name: {customer_name_field.value or '(not found)'}") + print(f" Customer Name: {customer_name_field.value or '(not found)'}") # type: ignore[attr-defined] # Step 2: Delete the analysis result print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index faf0204c8f2d..5d3023f4475c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -134,7 +134,7 @@ def main() -> None: if len(all_formulas) > 0: print(f"\nFound {len(all_formulas)} formula(s)") for formula in all_formulas: - print(f" Formula: {formula.value or '(no value)'}") + print(f" Formula: {formula.value or '(no value)'}") # type: ignore[attr-defined] if hasattr(formula, "kind") and formula.kind: print(f" Kind: {formula.kind}") else: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index c58696f965f3..6dc228c2ce20 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -96,8 +96,8 @@ def main() -> None: customer_name_field = document_content.fields.get("CustomerName") invoice_date_field = document_content.fields.get("InvoiceDate") - customer_name = customer_name_field.value if customer_name_field else None - invoice_date = invoice_date_field.value if invoice_date_field else None + customer_name = customer_name_field.value if customer_name_field else None # type: ignore[attr-defined] + invoice_date = invoice_date_field.value if invoice_date_field else None # type: ignore[attr-defined] print(f"Customer Name: {customer_name or '(None)'}") if customer_name_field: @@ -123,13 +123,13 @@ def main() -> None: # Extract object field (TotalAmount contains Amount and CurrencyCode) total_amount_field = document_content.fields.get("TotalAmount") - if total_amount_field and total_amount_field.value: + if total_amount_field and total_amount_field.value: # type: ignore[attr-defined] total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore amount_field = total_amount_obj.get("Amount") currency_field = total_amount_obj.get("CurrencyCode") - amount = amount_field.value if amount_field else None - currency = currency_field.value if currency_field else None + amount = amount_field.value if amount_field else None # type: ignore[attr-defined] + currency = currency_field.value if currency_field else None # type: ignore[attr-defined] print(f"\nTotal Amount: {amount} {currency}") if total_amount_field.confidence: @@ -138,12 +138,12 @@ def main() -> None: # Extract array field (LineItems - line items) # Note: The field name is "LineItems" (not "Items") to match the service response line_items_field = document_content.fields.get("LineItems") - if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: + if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: # type: ignore[attr-defined] items_array: list = line_items_field.value # type: ignore print(f"\nLine Items ({len(items_array)}):") for i, item in enumerate(items_array, 1): # Each item in the array is a ContentField (ObjectField for line items) - if isinstance(item, ObjectField) and item.value: + if isinstance(item, ObjectField) and item.value: # type: ignore[attr-defined] item_dict: dict[str, ContentField] = item.value # type: ignore description_field = item_dict.get("Description") quantity_field = item_dict.get("Quantity") @@ -151,21 +151,21 @@ def main() -> None: unit_price_field = item_dict.get("UnitPrice") amount_field = item_dict.get("Amount") - description = description_field.value if description_field else "(no description)" - quantity = quantity_field.value if quantity_field else "N/A" + description = description_field.value if description_field else "(no description)" # type: ignore[attr-defined] + quantity = quantity_field.value if quantity_field else "N/A" # type: ignore[attr-defined] # Display price information - prefer UnitPrice if available, otherwise Amount # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) price_info = "" - if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: + if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: # type: ignore[attr-defined] unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore unit_price_amount_field = unit_price_obj.get("Amount") unit_price_currency_field = unit_price_obj.get("CurrencyCode") - if unit_price_amount_field and unit_price_amount_field.value is not None: - currency = unit_price_currency_field.value if unit_price_currency_field else "" - price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() - elif amount_field and amount_field.value is not None: - price_info = f"Amount: {amount_field.value}" + if unit_price_amount_field and unit_price_amount_field.value is not None: # type: ignore[attr-defined] + currency = unit_price_currency_field.value if unit_price_currency_field else "" # type: ignore[attr-defined] + price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() # type: ignore[attr-defined] + elif amount_field and amount_field.value is not None: # type: ignore[attr-defined] + price_info = f"Amount: {amount_field.value}" # type: ignore[attr-defined] print(f" {i}. {description}") print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py index 518c38e4c5e8..5e593ca7a712 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py @@ -68,10 +68,11 @@ def main() -> None: return # Map your deployed models to the models required by prebuilt analyzers - model_deployments = { - "gpt-4.1": gpt_4_1_deployment, - "gpt-4.1-mini": gpt_4_1_mini_deployment, - "text-embedding-3-large": text_embedding_3_large_deployment, + # At this point, all deployments are guaranteed to be non-None due to the check above + model_deployments: dict[str, str] = { + "gpt-4.1": gpt_4_1_deployment, # type: ignore[assignment] + "gpt-4.1-mini": gpt_4_1_mini_deployment, # type: ignore[assignment] + "text-embedding-3-large": text_embedding_3_large_deployment, # type: ignore[assignment] } print("Configuring model deployments...") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py index 89503d5d30d3..dfed78da4797 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py @@ -132,8 +132,9 @@ def main() -> None: if result.field_schema and result.field_schema.fields: print(f" Fields ({len(result.field_schema.fields)}):") for field_name, field_def in result.field_schema.fields.items(): - method = field_def.method.value if field_def.method else "auto" - print(f" - {field_name}: {field_def.type.value if field_def.type else 'unknown'} ({method})") + method = field_def.method if field_def.method else "auto" + field_type = field_def.type if field_def.type else "unknown" + print(f" - {field_name}: {field_type} ({method})") # [END create_analyzer] # Clean up - delete the analyzer diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index e690cb662cca..22f2a3fddb30 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -116,12 +116,12 @@ def main() -> None: print(f"\nAnalyzing document with classifier '{analyzer_id}'...") - poller = client.begin_analyze_binary( + analyze_poller = client.begin_analyze_binary( analyzer_id=analyzer_id, content_type="application/pdf", binary_input=file_bytes, ) - analyze_result: AnalyzeResult = poller.result() + analyze_result: AnalyzeResult = analyze_poller.result() # Display classification results if analyze_result.contents and len(analyze_result.contents) > 0: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index b5e0f1a79cea..42fa5caf90c3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -96,7 +96,7 @@ def main() -> None: print(f" Total fields extracted: {len(doc_content.fields)}") customer_name_field = doc_content.fields.get("CustomerName") if customer_name_field: - print(f" Customer Name: {customer_name_field.value or '(not found)'}") + print(f" Customer Name: {customer_name_field.value or '(not found)'}") # type: ignore[attr-defined] # Step 2: Delete the analysis result print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") From c1e5957cbbd521c88a6241895e56f4de3449e4b1 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 19:01:41 +0000 Subject: [PATCH 058/105] SDK-EXT: Add proper typing stub for ContentType.values and its derived classes --- .../azure/ai/contentunderstanding/_patch.py | 22 +++--- .../ai/contentunderstanding/aio/_patch.py | 22 +++--- .../contentunderstanding/aio/models/_patch.py | 4 +- .../contentunderstanding/models/_models.pyi | 38 ++++++++++ .../ai/contentunderstanding/models/_patch.py | 76 +++++++++++++------ .../sample_analyze_configs_async.py | 2 +- .../sample_analyze_invoice_async.py | 30 ++++---- .../sample_configure_defaults_async.py | 9 ++- .../sample_delete_result_async.py | 2 +- .../samples/sample_analyze_configs.py | 2 +- .../samples/sample_analyze_invoice.py | 30 ++++---- .../samples/sample_configure_defaults.py | 9 ++- .../samples/sample_delete_result.py | 2 +- 13 files changed, 162 insertions(+), 86 deletions(-) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.pyi diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py index 68f711002ff7..4a40742f89cb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py @@ -57,7 +57,7 @@ def begin_analyze( inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any, - ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -95,7 +95,7 @@ def begin_analyze( processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, content_type: str = "application/json", **kwargs: Any, - ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -128,7 +128,7 @@ def begin_analyze( processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, content_type: str = "application/json", **kwargs: Any, - ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -152,7 +152,7 @@ def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ - def begin_analyze( # type: ignore[override] + def begin_analyze( # type: ignore[override] # pyright: ignore[reportIncompatibleMethodOverride] self, analyzer_id: str, body: Union[JSON, IO[bytes]] = _Unset, @@ -162,7 +162,7 @@ def begin_analyze( # type: ignore[override] inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any, - ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -197,9 +197,9 @@ def begin_analyze( # type: ignore[override] # Call parent implementation # Only pass body if it's not _Unset (let parent construct from inputs if not provided) # Ensure content_type is always a string (not None) - content_type_str = content_type if content_type is not None else "application/json" + content_type_str: str = content_type if content_type is not None else "application/json" if body is not _Unset: - poller = super().begin_analyze( + poller = super().begin_analyze( # pyright: ignore[reportCallIssue] analyzer_id=analyzer_id, body=body, processing_location=processing_location, @@ -209,7 +209,7 @@ def begin_analyze( # type: ignore[override] **kwargs, ) else: - poller = super().begin_analyze( + poller = super().begin_analyze( # pyright: ignore[reportCallIssue] analyzer_id=analyzer_id, processing_location=processing_location, content_type=content_type_str, @@ -219,7 +219,7 @@ def begin_analyze( # type: ignore[override] ) # Wrap in custom poller with .operation_id property - return AnalyzeLROPoller( + return AnalyzeLROPoller( # pyright: ignore[reportInvalidTypeArguments] self._client, poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access @@ -235,7 +235,7 @@ def begin_analyze_binary( input_range: Optional[str] = None, content_type: str = "application/octet-stream", **kwargs: Any, - ) -> AnalyzeLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -275,7 +275,7 @@ def begin_analyze_binary( ) # Wrap in custom poller with .operation_id property - return AnalyzeLROPoller( + return AnalyzeLROPoller( # pyright: ignore[reportInvalidTypeArguments] self._client, poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py index dce710a2bc08..faeb6e29815e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py @@ -57,7 +57,7 @@ async def begin_analyze( inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any, - ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeAsyncLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -95,7 +95,7 @@ async def begin_analyze( processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, content_type: str = "application/json", **kwargs: Any, - ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeAsyncLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -128,7 +128,7 @@ async def begin_analyze( processing_location: Optional[Union[str, _models.ProcessingLocation]] = None, content_type: str = "application/json", **kwargs: Any, - ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeAsyncLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -152,7 +152,7 @@ async def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ - async def begin_analyze( # type: ignore[override] + async def begin_analyze( # type: ignore[override] # pyright: ignore[reportIncompatibleMethodOverride] self, analyzer_id: str, body: Union[JSON, IO[bytes]] = _Unset, @@ -162,7 +162,7 @@ async def begin_analyze( # type: ignore[override] inputs: Optional[list[_models.AnalyzeInput]] = None, model_deployments: Optional[dict[str, str]] = None, **kwargs: Any, - ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeAsyncLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -197,9 +197,9 @@ async def begin_analyze( # type: ignore[override] # Call parent implementation # Only pass body if it's not _Unset (let parent construct from inputs if not provided) # Ensure content_type is always a string (not None) - content_type_str = content_type if content_type is not None else "application/json" + content_type_str: str = content_type if content_type is not None else "application/json" if body is not _Unset: - poller = await super().begin_analyze( + poller = await super().begin_analyze( # pyright: ignore[reportCallIssue] analyzer_id=analyzer_id, body=body, processing_location=processing_location, @@ -209,7 +209,7 @@ async def begin_analyze( # type: ignore[override] **kwargs, ) else: - poller = await super().begin_analyze( + poller = await super().begin_analyze( # pyright: ignore[reportCallIssue] analyzer_id=analyzer_id, processing_location=processing_location, content_type=content_type_str, @@ -219,7 +219,7 @@ async def begin_analyze( # type: ignore[override] ) # Wrap in custom poller with .operation_id property - return AnalyzeAsyncLROPoller( + return AnalyzeAsyncLROPoller( # pyright: ignore[reportInvalidTypeArguments] self._client, poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access @@ -235,7 +235,7 @@ async def begin_analyze_binary( input_range: Optional[str] = None, content_type: str = "application/octet-stream", **kwargs: Any, - ) -> AnalyzeAsyncLROPoller[_models.AnalyzeResult]: + ) -> "AnalyzeAsyncLROPoller[_models.AnalyzeResult]": # pyright: ignore[reportInvalidTypeArguments] """Extract content and fields from input. :param analyzer_id: The unique identifier of the analyzer. Required. @@ -275,7 +275,7 @@ async def begin_analyze_binary( ) # Wrap in custom poller with .operation_id property - return AnalyzeAsyncLROPoller( + return AnalyzeAsyncLROPoller( # pyright: ignore[reportInvalidTypeArguments] self._client, poller._polling_method._initial_response, # type: ignore # pylint: disable=protected-access poller._polling_method._deserialization_callback, # type: ignore # pylint: disable=protected-access diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py index b64891867d4b..d1cb27e5a1e2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py @@ -60,7 +60,7 @@ def operation_id(self) -> str: raise ValueError(f"Could not extract operation ID: {str(e)}") from e @classmethod - async def from_continuation_token( + async def from_continuation_token( # type: ignore[override] cls, polling_method: AsyncPollingMethod[PollingReturnType_co], continuation_token: str, @@ -76,7 +76,7 @@ async def from_continuation_token( :rtype: AsyncLROPoller[PollingReturnType_co] :raises ~azure.core.exceptions.HttpResponseError: If the continuation token is invalid. """ - result = await polling_method.from_continuation_token(continuation_token, **kwargs) + result = await polling_method.from_continuation_token(continuation_token, **kwargs) # type: ignore[misc] ( client, initial_response, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.pyi b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.pyi new file mode 100644 index 000000000000..ae8f4fbe2d89 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.pyi @@ -0,0 +1,38 @@ +# Stub file for _models.py +# This file declares the .value property added at runtime via patch_sdk() +# Type checkers (MyPy, Pyright) use this to understand the properties exist + +from typing import Any, Optional, Dict, List + +# ContentField base class +class ContentField: + value: Any # Added at runtime via patch_sdk() + +# Specific field types with their return types +class StringField(ContentField): + value: Optional[str] # Added at runtime via patch_sdk() + +class IntegerField(ContentField): + value: Optional[int] # Added at runtime via patch_sdk() + +class NumberField(ContentField): + value: Optional[float] # Added at runtime via patch_sdk() + +class BooleanField(ContentField): + value: Optional[bool] # Added at runtime via patch_sdk() + +class DateField(ContentField): + value: Optional[str] # Added at runtime via patch_sdk() + +class TimeField(ContentField): + value: Optional[str] # Added at runtime via patch_sdk() + +class ArrayField(ContentField): + value: Optional[List[Any]] # Added at runtime via patch_sdk() + +class ObjectField(ContentField): + value: Optional[Dict[str, Any]] # Added at runtime via patch_sdk() + +class JsonField(ContentField): + value: Optional[Any] # Added at runtime via patch_sdk() + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index 8369e23d2162..36ce35a9812a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -24,6 +24,9 @@ ContentField, ) +# Note: The .value property is added to ContentField classes at runtime in patch_sdk() +# Type annotations are set on the classes' __annotations__ for type checker support + PollingReturnType_co = TypeVar("PollingReturnType_co", covariant=True) __all__ = [ @@ -110,15 +113,33 @@ def from_continuation_token( return cls(client, initial_response, deserialization_callback, polling_method) -def _add_value_property_to_field(field_class: type, value_attr: str) -> None: - """Add a .value property to a field class that returns the appropriate attribute.""" - - @property # type: ignore[misc] - def value(self) -> Any: # type: ignore[misc] +def _add_value_property_to_field(field_class: type, value_attr: str, return_type: Any = Any) -> None: + """Add a .value property implementation at runtime. + + This function adds the actual property implementation so IntelliSense works. + The type declarations in TYPE_CHECKING tell type checkers about the types. + + :param field_class: The field class to add the property to + :param value_attr: The attribute name to read from (e.g., "value_string") + :param return_type: The expected return type for better type checking + """ + def value_getter(self: Any) -> Any: """Get the value of this field.""" - return getattr(self, value_attr) - - setattr(field_class, "value", value) + return getattr(self, value_attr, None) + + # Set return type annotation for better type checking + value_getter.__annotations__['return'] = return_type + + # Create property with type annotation + value_property = property(value_getter) + + # Add property to class at runtime (for IntelliSense) + setattr(field_class, "value", value_property) + + # Also add to __annotations__ for better IDE support + if not hasattr(field_class, "__annotations__"): + field_class.__annotations__ = {} + field_class.__annotations__["value"] = return_type def patch_sdk(): @@ -128,21 +149,22 @@ def patch_sdk(): # Add RecordMergePatchUpdate as an alias _models.RecordMergePatchUpdate = RecordMergePatchUpdate # type: ignore[attr-defined] - # Add .value property to all ContentField subclasses for easier access - # Note: The attribute names follow the pattern "value_" - _add_value_property_to_field(StringField, "value_string") - _add_value_property_to_field(IntegerField, "value_integer") - _add_value_property_to_field(NumberField, "value_number") - _add_value_property_to_field(BooleanField, "value_boolean") - _add_value_property_to_field(DateField, "value_date") - _add_value_property_to_field(TimeField, "value_time") - _add_value_property_to_field(ArrayField, "value_array") - _add_value_property_to_field(ObjectField, "value_object") - _add_value_property_to_field(JsonField, "value_json") + # Runtime implementation: Add .value property to all ContentField subclasses + # The TYPE_CHECKING block above declares the types for static analysis + # These runtime implementations make IntelliSense work + _add_value_property_to_field(StringField, "value_string", Optional[str]) + _add_value_property_to_field(IntegerField, "value_integer", Optional[int]) + _add_value_property_to_field(NumberField, "value_number", Optional[float]) + _add_value_property_to_field(BooleanField, "value_boolean", Optional[bool]) + _add_value_property_to_field(DateField, "value_date", Optional[str]) + _add_value_property_to_field(TimeField, "value_time", Optional[str]) + _add_value_property_to_field(ArrayField, "value_array", Optional[List[Any]]) + _add_value_property_to_field(ObjectField, "value_object", Optional[Dict[str, Any]]) + _add_value_property_to_field(JsonField, "value_json", Optional[Any]) # Add dynamic .value to ContentField base class # This checks which value_* attribute exists and returns it - def _content_field_value_getter(self) -> Any: + def _content_field_value_getter(self: ContentField) -> Any: """Get the value of this field regardless of its specific type.""" for attr in [ "value_string", @@ -158,8 +180,18 @@ def _content_field_value_getter(self) -> Any: if hasattr(self, attr): return getattr(self, attr) return None - - setattr(ContentField, "value", property(_content_field_value_getter)) + + # Set return type annotation + _content_field_value_getter.__annotations__['return'] = Any + + # Add property to ContentField base class + content_field_value = property(_content_field_value_getter) + setattr(ContentField, "value", content_field_value) + + # Also add to __annotations__ for IDE support + if not hasattr(ContentField, "__annotations__"): + ContentField.__annotations__ = {} + ContentField.__annotations__["value"] = Any # SDK-FIX: Patch AudioVisualContent.__init__ to handle KeyFrameTimesMs casing inconsistency # The service returns "KeyFrameTimesMs" (capital K) but TypeSpec defines "keyFrameTimesMs" (lowercase k) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index ef44655c52f0..72717104ff22 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -135,7 +135,7 @@ async def main() -> None: if len(all_formulas) > 0: print(f"\nFound {len(all_formulas)} formula(s)") for formula in all_formulas: - print(f" Formula: {formula.value or '(no value)'}") # type: ignore[attr-defined] + print(f" Formula: {formula.value or '(no value)'}") if hasattr(formula, "kind") and formula.kind: print(f" Kind: {formula.kind}") else: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index b4f86d9b0d5f..3a5358447940 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -94,8 +94,8 @@ async def main() -> None: customer_name_field = document_content.fields.get("CustomerName") invoice_date_field = document_content.fields.get("InvoiceDate") - customer_name = customer_name_field.value if customer_name_field else None # type: ignore[attr-defined] - invoice_date = invoice_date_field.value if invoice_date_field else None # type: ignore[attr-defined] + customer_name = customer_name_field.value if customer_name_field else None + invoice_date = invoice_date_field.value if invoice_date_field else None print(f"Customer Name: {customer_name or '(None)'}") if customer_name_field: @@ -121,13 +121,13 @@ async def main() -> None: # Extract object field (TotalAmount contains Amount and CurrencyCode) total_amount_field = document_content.fields.get("TotalAmount") - if total_amount_field and total_amount_field.value: # type: ignore[attr-defined] + if total_amount_field and total_amount_field.value: total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore amount_field = total_amount_obj.get("Amount") currency_field = total_amount_obj.get("CurrencyCode") - amount = amount_field.value if amount_field else None # type: ignore[attr-defined] - currency = currency_field.value if currency_field else None # type: ignore[attr-defined] + amount = amount_field.value if amount_field else None + currency = currency_field.value if currency_field else None print(f"\nTotal Amount: {amount} {currency}") if total_amount_field.confidence: @@ -136,12 +136,12 @@ async def main() -> None: # Extract array field (LineItems - line items) # Note: The field name is "LineItems" (not "Items") to match the service response line_items_field = document_content.fields.get("LineItems") - if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: # type: ignore[attr-defined] + if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: items_array: list = line_items_field.value # type: ignore print(f"\nLine Items ({len(items_array)}):") for i, item in enumerate(items_array, 1): # Each item in the array is a ContentField (ObjectField for line items) - if isinstance(item, ObjectField) and item.value: # type: ignore[attr-defined] + if isinstance(item, ObjectField) and item.value: item_dict: dict[str, ContentField] = item.value # type: ignore description_field = item_dict.get("Description") quantity_field = item_dict.get("Quantity") @@ -149,21 +149,21 @@ async def main() -> None: unit_price_field = item_dict.get("UnitPrice") amount_field = item_dict.get("Amount") - description = description_field.value if description_field else "(no description)" # type: ignore[attr-defined] - quantity = quantity_field.value if quantity_field else "N/A" # type: ignore[attr-defined] + description = description_field.value if description_field else "(no description)" + quantity = quantity_field.value if quantity_field else "N/A" # Display price information - prefer UnitPrice if available, otherwise Amount # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) price_info = "" - if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: # type: ignore[attr-defined] + if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore unit_price_amount_field = unit_price_obj.get("Amount") unit_price_currency_field = unit_price_obj.get("CurrencyCode") - if unit_price_amount_field and unit_price_amount_field.value is not None: # type: ignore[attr-defined] - currency = unit_price_currency_field.value if unit_price_currency_field else "" # type: ignore[attr-defined] - price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() # type: ignore[attr-defined] - elif amount_field and amount_field.value is not None: # type: ignore[attr-defined] - price_info = f"Amount: {amount_field.value}" # type: ignore[attr-defined] + if unit_price_amount_field and unit_price_amount_field.value is not None: + currency = unit_price_currency_field.value if unit_price_currency_field else "" + price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() + elif amount_field and amount_field.value is not None: + price_info = f"Amount: {amount_field.value}" print(f" {i}. {description}") print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py index 9bde37e3748b..b770a70b7b35 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py @@ -69,10 +69,13 @@ async def main() -> None: # Map your deployed models to the models required by prebuilt analyzers # At this point, all deployments are guaranteed to be non-None due to the check above + assert gpt_4_1_deployment is not None + assert gpt_4_1_mini_deployment is not None + assert text_embedding_3_large_deployment is not None model_deployments: dict[str, str] = { - "gpt-4.1": gpt_4_1_deployment, # type: ignore[assignment] - "gpt-4.1-mini": gpt_4_1_mini_deployment, # type: ignore[assignment] - "text-embedding-3-large": text_embedding_3_large_deployment, # type: ignore[assignment] + "gpt-4.1": gpt_4_1_deployment, + "gpt-4.1-mini": gpt_4_1_mini_deployment, + "text-embedding-3-large": text_embedding_3_large_deployment, } print("Configuring model deployments...") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py index 3401aea603ac..1083fdc0a58e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py @@ -94,7 +94,7 @@ async def main() -> None: print(f" Total fields extracted: {len(doc_content.fields)}") customer_name_field = doc_content.fields.get("CustomerName") if customer_name_field: - print(f" Customer Name: {customer_name_field.value or '(not found)'}") # type: ignore[attr-defined] + print(f" Customer Name: {customer_name_field.value or '(not found)'}") # Step 2: Delete the analysis result print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index 5d3023f4475c..faf0204c8f2d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -134,7 +134,7 @@ def main() -> None: if len(all_formulas) > 0: print(f"\nFound {len(all_formulas)} formula(s)") for formula in all_formulas: - print(f" Formula: {formula.value or '(no value)'}") # type: ignore[attr-defined] + print(f" Formula: {formula.value or '(no value)'}") if hasattr(formula, "kind") and formula.kind: print(f" Kind: {formula.kind}") else: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index 6dc228c2ce20..c58696f965f3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -96,8 +96,8 @@ def main() -> None: customer_name_field = document_content.fields.get("CustomerName") invoice_date_field = document_content.fields.get("InvoiceDate") - customer_name = customer_name_field.value if customer_name_field else None # type: ignore[attr-defined] - invoice_date = invoice_date_field.value if invoice_date_field else None # type: ignore[attr-defined] + customer_name = customer_name_field.value if customer_name_field else None + invoice_date = invoice_date_field.value if invoice_date_field else None print(f"Customer Name: {customer_name or '(None)'}") if customer_name_field: @@ -123,13 +123,13 @@ def main() -> None: # Extract object field (TotalAmount contains Amount and CurrencyCode) total_amount_field = document_content.fields.get("TotalAmount") - if total_amount_field and total_amount_field.value: # type: ignore[attr-defined] + if total_amount_field and total_amount_field.value: total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore amount_field = total_amount_obj.get("Amount") currency_field = total_amount_obj.get("CurrencyCode") - amount = amount_field.value if amount_field else None # type: ignore[attr-defined] - currency = currency_field.value if currency_field else None # type: ignore[attr-defined] + amount = amount_field.value if amount_field else None + currency = currency_field.value if currency_field else None print(f"\nTotal Amount: {amount} {currency}") if total_amount_field.confidence: @@ -138,12 +138,12 @@ def main() -> None: # Extract array field (LineItems - line items) # Note: The field name is "LineItems" (not "Items") to match the service response line_items_field = document_content.fields.get("LineItems") - if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: # type: ignore[attr-defined] + if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: items_array: list = line_items_field.value # type: ignore print(f"\nLine Items ({len(items_array)}):") for i, item in enumerate(items_array, 1): # Each item in the array is a ContentField (ObjectField for line items) - if isinstance(item, ObjectField) and item.value: # type: ignore[attr-defined] + if isinstance(item, ObjectField) and item.value: item_dict: dict[str, ContentField] = item.value # type: ignore description_field = item_dict.get("Description") quantity_field = item_dict.get("Quantity") @@ -151,21 +151,21 @@ def main() -> None: unit_price_field = item_dict.get("UnitPrice") amount_field = item_dict.get("Amount") - description = description_field.value if description_field else "(no description)" # type: ignore[attr-defined] - quantity = quantity_field.value if quantity_field else "N/A" # type: ignore[attr-defined] + description = description_field.value if description_field else "(no description)" + quantity = quantity_field.value if quantity_field else "N/A" # Display price information - prefer UnitPrice if available, otherwise Amount # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) price_info = "" - if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: # type: ignore[attr-defined] + if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore unit_price_amount_field = unit_price_obj.get("Amount") unit_price_currency_field = unit_price_obj.get("CurrencyCode") - if unit_price_amount_field and unit_price_amount_field.value is not None: # type: ignore[attr-defined] - currency = unit_price_currency_field.value if unit_price_currency_field else "" # type: ignore[attr-defined] - price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() # type: ignore[attr-defined] - elif amount_field and amount_field.value is not None: # type: ignore[attr-defined] - price_info = f"Amount: {amount_field.value}" # type: ignore[attr-defined] + if unit_price_amount_field and unit_price_amount_field.value is not None: + currency = unit_price_currency_field.value if unit_price_currency_field else "" + price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() + elif amount_field and amount_field.value is not None: + price_info = f"Amount: {amount_field.value}" print(f" {i}. {description}") print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py index 5e593ca7a712..2e063b26bb4e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py @@ -69,10 +69,13 @@ def main() -> None: # Map your deployed models to the models required by prebuilt analyzers # At this point, all deployments are guaranteed to be non-None due to the check above + assert gpt_4_1_deployment is not None + assert gpt_4_1_mini_deployment is not None + assert text_embedding_3_large_deployment is not None model_deployments: dict[str, str] = { - "gpt-4.1": gpt_4_1_deployment, # type: ignore[assignment] - "gpt-4.1-mini": gpt_4_1_mini_deployment, # type: ignore[assignment] - "text-embedding-3-large": text_embedding_3_large_deployment, # type: ignore[assignment] + "gpt-4.1": gpt_4_1_deployment, + "gpt-4.1-mini": gpt_4_1_mini_deployment, + "text-embedding-3-large": text_embedding_3_large_deployment, } print("Configuring model deployments...") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index 42fa5caf90c3..b5e0f1a79cea 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -96,7 +96,7 @@ def main() -> None: print(f" Total fields extracted: {len(doc_content.fields)}") customer_name_field = doc_content.fields.get("CustomerName") if customer_name_field: - print(f" Customer Name: {customer_name_field.value or '(not found)'}") # type: ignore[attr-defined] + print(f" Customer Name: {customer_name_field.value or '(not found)'}") # Step 2: Delete the analysis result print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") From 5656986bbf3a727e68c5496b9e452ede149c03de Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 19:14:50 +0000 Subject: [PATCH 059/105] CI: PyLint fixes --- .../_operations/_patch.py | 68 ++++++++++++++----- .../azure/ai/contentunderstanding/_patch.py | 14 ++-- .../aio/_operations/_patch.py | 46 +++++++++---- .../ai/contentunderstanding/aio/_patch.py | 14 ++-- .../contentunderstanding/aio/models/_patch.py | 4 +- .../ai/contentunderstanding/models/_patch.py | 56 ++++++++++----- .../pyproject.toml | 2 +- 7 files changed, 139 insertions(+), 65 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index 63cf3c01da8f..b5e343d47c2f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -11,8 +11,11 @@ - Status codes: Accept both 201 and 202 (service inconsistently returns both status codes) """ -from typing import Any, Optional, Union, IO, Iterator -from azure.core.rest import HttpRequest +import json +from collections.abc import MutableMapping +from io import IOBase +from typing import Any, IO, Iterator, Optional, Union + from azure.core.exceptions import ( ClientAuthenticationError, HttpResponseError, @@ -24,42 +27,55 @@ map_error, ) from azure.core.pipeline import PipelineResponse +from azure.core.rest import HttpRequest from azure.core.utils import case_insensitive_dict -from collections.abc import MutableMapping -from io import IOBase -import json __all__: list[str] = [] def patch_sdk(): """Patch the SDK to fix copy analyzer operations. - + This function: 1. Replaces build_content_understanding_copy_analyzer_request to fix URL path 2. Wraps _copy_analyzer_initial method to accept both 201 and 202 status codes + + :param analyzer_id: The analyzer ID for the copy operation. + :type analyzer_id: str + :keyword allow_replace: Whether to allow replacing an existing analyzer. + :paramtype allow_replace: Optional[bool] + :return: The HTTP request object. + :rtype: HttpRequest """ - from . import _operations - + from . import _operations # pylint: disable=protected-access + # 1. SDK-FIX: Fix URL path from ":copyAnalyzer" to ":copy" _original_build_request = _operations.build_content_understanding_copy_analyzer_request - + def _patched_build_content_understanding_copy_analyzer_request( analyzer_id: str, *, allow_replace: Optional[bool] = None, **kwargs: Any ) -> HttpRequest: - """Patched version that uses correct endpoint path :copy instead of :copyAnalyzer.""" + """Patched version that uses correct endpoint path :copy instead of :copyAnalyzer. + + :param analyzer_id: The analyzer ID for the copy operation. + :type analyzer_id: str + :keyword allow_replace: Whether to allow replacing an existing analyzer. + :paramtype allow_replace: Optional[bool] + :return: The HTTP request object with corrected URL path. + :rtype: HttpRequest + """ request = _original_build_request(analyzer_id, allow_replace=allow_replace, **kwargs) # Fix the URL path if ":copyAnalyzer" in request.url: request.url = request.url.replace(":copyAnalyzer", ":copy") return request - + _operations.build_content_understanding_copy_analyzer_request = _patched_build_content_understanding_copy_analyzer_request - + # 2. SDK-FIX: Wrap _copy_analyzer_initial to accept both 201 and 202 status codes - _original_copy_initial = _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial - - def _patched_copy_analyzer_initial( + _original_copy_initial = _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial # pylint: disable=protected-access + + def _patched_copy_analyzer_initial( # pylint: disable=protected-access self, analyzer_id: str, body: Union[_operations.JSON, IO[bytes]] = _operations._Unset, @@ -70,7 +86,23 @@ def _patched_copy_analyzer_initial( source_region: Optional[str] = None, **kwargs: Any ) -> Iterator[bytes]: - """Patched version that accepts both 201 and 202 status codes.""" + """Patched version that accepts both 201 and 202 status codes. + + :param analyzer_id: The analyzer ID for the copy operation. + :type analyzer_id: str + :param body: The request body. + :type body: Union[JSON, IO[bytes]] + :keyword source_analyzer_id: The source analyzer ID. + :paramtype source_analyzer_id: str + :keyword allow_replace: Whether to allow replacing an existing analyzer. + :paramtype allow_replace: Optional[bool] + :keyword source_azure_resource_id: The source Azure resource ID. + :paramtype source_azure_resource_id: Optional[str] + :keyword source_region: The source region. + :paramtype source_region: Optional[str] + :return: An iterator of bytes. + :rtype: Iterator[bytes] + """ error_map: MutableMapping = { 401: ClientAuthenticationError, 404: ResourceNotFoundError, @@ -144,5 +176,5 @@ def _patched_copy_analyzer_initial( return cls(pipeline_response, deserialized, response_headers) # type: ignore return deserialized # type: ignore - - _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = _patched_copy_analyzer_initial + + _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = _patched_copy_analyzer_initial # pylint: disable=protected-access diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py index 4a40742f89cb..d0728a94a160 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py @@ -8,16 +8,16 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import Any, Optional, Union, IO, overload +from typing import TYPE_CHECKING, Any, IO, Optional, Union, overload from typing_extensions import Self -from azure.core.credentials import AzureKeyCredential from azure.core.rest import HttpRequest, HttpResponse +from azure.core.tracing.decorator import distributed_trace from ._client import ContentUnderstandingClient as GeneratedClient from . import models as _models from .models import AnalyzeLROPoller -if False: # TYPE_CHECKING +if TYPE_CHECKING: from azure.core.credentials import TokenCredential JSON = dict[str, Any] @@ -152,6 +152,7 @@ def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ + @distributed_trace def begin_analyze( # type: ignore[override] # pyright: ignore[reportIncompatibleMethodOverride] self, analyzer_id: str, @@ -226,6 +227,7 @@ def begin_analyze( # type: ignore[override] # pyright: ignore[reportIncompatib poller._polling_method, # pylint: disable=protected-access ) + @distributed_trace def begin_analyze_binary( self, analyzer_id: str, @@ -282,7 +284,7 @@ def begin_analyze_binary( poller._polling_method, # pylint: disable=protected-access ) - def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> HttpResponse: + def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> HttpResponse: # pylint: disable=useless-parent-delegation """Runs the network request through the client's chained policies. >>> from azure.core.rest import HttpRequest @@ -301,7 +303,7 @@ def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: """ return super().send_request(request, stream=stream, **kwargs) - def close(self) -> None: + def close(self) -> None: # pylint: disable=useless-parent-delegation """Close the client session.""" super().close() @@ -309,7 +311,7 @@ def __enter__(self) -> Self: super().__enter__() return self - def __exit__(self, *exc_details: Any) -> None: + def __exit__(self, *exc_details: Any) -> None: # pylint: disable=useless-parent-delegation super().__exit__(*exc_details) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index e39a73f85661..baa7a8d0d8f8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -11,8 +11,11 @@ - Status codes: Accept both 201 and 202 (service inconsistently returns both status codes) """ -from typing import Any, Optional, Union, IO, AsyncIterator -from azure.core.rest import HttpRequest +import json +from collections.abc import MutableMapping +from io import IOBase +from typing import Any, AsyncIterator, IO, Optional, Union + from azure.core.exceptions import ( ClientAuthenticationError, HttpResponseError, @@ -25,30 +28,27 @@ ) from azure.core.pipeline import PipelineResponse from azure.core.utils import case_insensitive_dict -from collections.abc import MutableMapping -from io import IOBase -import json __all__: list[str] = [] def patch_sdk(): """Patch the SDK to fix async copy analyzer operations. - + This function: 1. Uses the patched build_content_understanding_copy_analyzer_request (from sync operations) 2. Wraps _copy_analyzer_initial method to accept both 201 and 202 status codes """ from ..._operations import _operations as sync_operations - from . import _operations - + from . import _operations # pylint: disable=protected-access + # Note: The request builder is shared between sync and async, so it's already patched # by the sync _patch.py. We just need to patch the async _copy_analyzer_initial method. - + # SDK-FIX: Wrap _copy_analyzer_initial to accept both 201 and 202 status codes - _original_copy_initial = _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial - - async def _patched_copy_analyzer_initial( + _original_copy_initial = _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial # pylint: disable=protected-access + + async def _patched_copy_analyzer_initial( # pylint: disable=protected-access self, analyzer_id: str, body: Union[_operations.JSON, IO[bytes]] = _operations._Unset, @@ -59,7 +59,23 @@ async def _patched_copy_analyzer_initial( source_region: Optional[str] = None, **kwargs: Any ) -> AsyncIterator[bytes]: - """Patched version that accepts both 201 and 202 status codes.""" + """Patched version that accepts both 201 and 202 status codes. + + :param analyzer_id: The analyzer ID for the copy operation. + :type analyzer_id: str + :param body: The request body. + :type body: Union[JSON, IO[bytes]] + :keyword source_analyzer_id: The source analyzer ID. + :paramtype source_analyzer_id: str + :keyword allow_replace: Whether to allow replacing an existing analyzer. + :paramtype allow_replace: Optional[bool] + :keyword source_azure_resource_id: The source Azure resource ID. + :paramtype source_azure_resource_id: Optional[str] + :keyword source_region: The source region. + :paramtype source_region: Optional[str] + :return: An async iterator of bytes. + :rtype: AsyncIterator[bytes] + """ error_map: MutableMapping = { 401: ClientAuthenticationError, 404: ResourceNotFoundError, @@ -133,5 +149,5 @@ async def _patched_copy_analyzer_initial( return cls(pipeline_response, deserialized, response_headers) # type: ignore return deserialized # type: ignore - - _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = _patched_copy_analyzer_initial + + _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = _patched_copy_analyzer_initial # pylint: disable=protected-access diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py index faeb6e29815e..9ad9e83de08b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py @@ -8,16 +8,16 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import Any, Optional, Union, IO, overload +from typing import TYPE_CHECKING, Any, IO, Optional, Union, overload from typing_extensions import Self -from azure.core.credentials import AzureKeyCredential from azure.core.rest import AsyncHttpResponse, HttpRequest +from azure.core.tracing.decorator_async import distributed_trace_async from ._client import ContentUnderstandingClient as GeneratedClient from .. import models as _models from .models import AnalyzeAsyncLROPoller -if False: # TYPE_CHECKING +if TYPE_CHECKING: from azure.core.credentials_async import AsyncTokenCredential JSON = dict[str, Any] @@ -152,6 +152,7 @@ async def begin_analyze( This ensures ContentSpan offsets work correctly with Python string slicing. """ + @distributed_trace_async async def begin_analyze( # type: ignore[override] # pyright: ignore[reportIncompatibleMethodOverride] self, analyzer_id: str, @@ -226,6 +227,7 @@ async def begin_analyze( # type: ignore[override] # pyright: ignore[reportInco poller._polling_method, # pylint: disable=protected-access ) + @distributed_trace_async async def begin_analyze_binary( self, analyzer_id: str, @@ -282,7 +284,7 @@ async def begin_analyze_binary( poller._polling_method, # pylint: disable=protected-access ) - async def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> AsyncHttpResponse: + async def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> AsyncHttpResponse: # pylint: disable=invalid-overridden-method,useless-parent-delegation """Runs the network request through the client's chained policies. >>> from azure.core.rest import HttpRequest @@ -301,7 +303,7 @@ async def send_request(self, request: HttpRequest, *, stream: bool = False, **kw """ return await super().send_request(request, stream=stream, **kwargs) - async def close(self) -> None: + async def close(self) -> None: # pylint: disable=useless-parent-delegation """Close the client session.""" await super().close() @@ -309,7 +311,7 @@ async def __aenter__(self) -> Self: await super().__aenter__() return self - async def __aexit__(self, *exc_details: Any) -> None: + async def __aexit__(self, *exc_details: Any) -> None: # pylint: disable=useless-parent-delegation await super().__aexit__(*exc_details) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py index d1cb27e5a1e2..ad7382990a3e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/models/_patch.py @@ -9,7 +9,7 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ import re -from typing import Any, Mapping, TypeVar +from typing import Any, TypeVar from azure.core.polling import AsyncLROPoller, AsyncPollingMethod PollingReturnType_co = TypeVar("PollingReturnType_co", covariant=True) @@ -60,7 +60,7 @@ def operation_id(self) -> str: raise ValueError(f"Could not extract operation ID: {str(e)}") from e @classmethod - async def from_continuation_token( # type: ignore[override] + async def from_continuation_token( # type: ignore[override] # pylint: disable=invalid-overridden-method cls, polling_method: AsyncPollingMethod[PollingReturnType_co], continuation_token: str, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index 36ce35a9812a..527d08c67a25 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -9,7 +9,7 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ import re -from typing import Optional, Any, Dict, List, Union, TYPE_CHECKING, Mapping, TypeVar +from typing import Any, Dict, List, Optional, TypeVar from azure.core.polling import LROPoller, PollingMethod from ._models import ( StringField, @@ -115,27 +115,36 @@ def from_continuation_token( def _add_value_property_to_field(field_class: type, value_attr: str, return_type: Any = Any) -> None: """Add a .value property implementation at runtime. - + This function adds the actual property implementation so IntelliSense works. The type declarations in TYPE_CHECKING tell type checkers about the types. - - :param field_class: The field class to add the property to - :param value_attr: The attribute name to read from (e.g., "value_string") - :param return_type: The expected return type for better type checking + + :param field_class: The field class to add the property to. + :type field_class: type + :param value_attr: The attribute name to read from (e.g., "value_string"). + :type value_attr: str + :param return_type: The expected return type for better type checking. + :type return_type: Any + :return: None + :rtype: None """ def value_getter(self: Any) -> Any: - """Get the value of this field.""" + """Get the value of this field. + + :return: The value of the field. + :rtype: Any + """ return getattr(self, value_attr, None) - + # Set return type annotation for better type checking value_getter.__annotations__['return'] = return_type - + # Create property with type annotation value_property = property(value_getter) - + # Add property to class at runtime (for IntelliSense) setattr(field_class, "value", value_property) - + # Also add to __annotations__ for better IDE support if not hasattr(field_class, "__annotations__"): field_class.__annotations__ = {} @@ -165,7 +174,13 @@ def patch_sdk(): # Add dynamic .value to ContentField base class # This checks which value_* attribute exists and returns it def _content_field_value_getter(self: ContentField) -> Any: - """Get the value of this field regardless of its specific type.""" + """Get the value of this field regardless of its specific type. + + :param self: The ContentField instance. + :type self: ContentField + :return: The value of the field. + :rtype: Any + """ for attr in [ "value_string", "value_integer", @@ -180,14 +195,14 @@ def _content_field_value_getter(self: ContentField) -> Any: if hasattr(self, attr): return getattr(self, attr) return None - + # Set return type annotation _content_field_value_getter.__annotations__['return'] = Any - + # Add property to ContentField base class content_field_value = property(_content_field_value_getter) setattr(ContentField, "value", content_field_value) - + # Also add to __annotations__ for IDE support if not hasattr(ContentField, "__annotations__"): ContentField.__annotations__ = {} @@ -197,13 +212,20 @@ def _content_field_value_getter(self: ContentField) -> Any: # The service returns "KeyFrameTimesMs" (capital K) but TypeSpec defines "keyFrameTimesMs" (lowercase k) # This fix is forward compatible: if the service fixes the issue and returns "keyFrameTimesMs" correctly, # the patch will be a no-op and the correct value will pass through unchanged. - _original_audio_visual_content_init = _models.AudioVisualContent.__init__ + _original_audio_visual_content_init = _models.AudioVisualContent.__init__ # type: ignore[attr-defined] def _patched_audio_visual_content_init(self, *args: Any, **kwargs: Any) -> None: """Patched __init__ that normalizes casing for KeyFrameTimesMs before calling parent. - + This patch is forward compatible: it only normalizes when the service returns incorrect casing. If the service returns the correct "keyFrameTimesMs" casing, the patch does nothing. + + :param args: Positional arguments passed to __init__. + :type args: Any + :param kwargs: Keyword arguments passed to __init__. + :type kwargs: Any + :return: None + :rtype: None """ # If first arg is a dict (mapping), normalize the casing if args and isinstance(args[0], dict): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml index cd660792b3c1..a8e706db3bea 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml @@ -15,7 +15,7 @@ authors = [ { name = "Microsoft Corporation", email = "azpysdkhelp@microsoft.com" }, ] description = "Microsoft Corporation Azure AI Content Understanding Client Library for Python" -license = "MIT" +license = {text = "MIT"} classifiers = [ "Development Status :: 4 - Beta", "Programming Language :: Python", From f8c12bdd1a025b99313840a2e53c4fb1fddaeb52 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 19:46:13 +0000 Subject: [PATCH 060/105] CI: README links --- .../azure-ai-contentunderstanding/samples/README.md | 4 +--- .../azure-ai-contentunderstanding/tests/README.md | 2 +- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index c80fb85a0fd4..7754ab349cd2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -476,7 +476,7 @@ python samples/sample_analyze_binary.py # Make sure you're in the package direc ## Next Steps * Review the [Azure AI Content Understanding documentation][contentunderstanding_docs] -* Check the [API reference][apiref] for detailed API information +* Check the API reference for detailed API information * See the main [README](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md) for more getting started information @@ -484,5 +484,3 @@ python samples/sample_analyze_binary.py # Make sure you're in the package direc [contentunderstanding_docs]: https://learn.microsoft.com/azure/ai-services/content-understanding/ [contentunderstanding_quickstart]: https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api [contentunderstanding_regions]: https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support -[apiref]: https://azuresdkdocs.z19.web.core.windows.net/python/azure-ai-contentunderstanding/latest/ - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md index 55a013fab830..74d3c518c2cb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md @@ -187,7 +187,7 @@ pytest tests/ - Review the [Azure SDK Python Testing Guide](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md) for comprehensive testing documentation - Check the [Test-Proxy Documentation](https://github.com/Azure/azure-sdk-tools/tree/main/tools/test-proxy) for test-proxy details -- See the main [README](../README.md) for package documentation +- See the main [README](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md) for package documentation ## Contributing From fbc9862341cf43d8da4f57fc0ea937f04dcd3d84 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 19:53:29 +0000 Subject: [PATCH 061/105] CI: Exclude generated files for mypy and pyright --- .../azure-ai-contentunderstanding/mypy.ini | 17 +++++++++++++++++ .../pyrightconfig.json | 12 ++++++++++++ 2 files changed, 29 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/mypy.ini create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/pyrightconfig.json diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/mypy.ini b/sdk/contentunderstanding/azure-ai-contentunderstanding/mypy.ini new file mode 100644 index 000000000000..8287a2988a72 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/mypy.ini @@ -0,0 +1,17 @@ +[mypy] +python_version = 3.10 +warn_unused_configs = True +ignore_missing_imports = True + +# Per-module options: + +# Ignore errors in generated _operations.py files +[mypy-azure.ai.contentunderstanding._operations.*] +ignore_errors = True + +[mypy-azure.ai.contentunderstanding.aio._operations.*] +ignore_errors = True + +[mypy-azure.core.*] +ignore_errors = True + diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/pyrightconfig.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyrightconfig.json new file mode 100644 index 000000000000..fedffbab0cb9 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyrightconfig.json @@ -0,0 +1,12 @@ +{ + "reportTypeCommentUsage": true, + "reportMissingImports": false, + "reportAttributeAccessIssue": "none", + "reportGeneralTypeIssues": "warning", + "reportOverlappingOverload": "none", + "exclude": [ + "**/azure/ai/contentunderstanding/_operations/_operations.py", + "**/azure/ai/contentunderstanding/aio/_operations/_operations.py" + ] +} + From 2732352f7c96642e5822b9e5dad1e74e7cbe4827 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 19:54:50 +0000 Subject: [PATCH 062/105] CI: Fix Pylint issues --- .../azure/ai/contentunderstanding/_operations/_patch.py | 7 ------- .../azure/ai/contentunderstanding/models/_models.pyi | 6 +++++- .../azure/ai/contentunderstanding/models/_patch.py | 6 ++---- 3 files changed, 7 insertions(+), 12 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index b5e343d47c2f..614ffa34271d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -39,13 +39,6 @@ def patch_sdk(): This function: 1. Replaces build_content_understanding_copy_analyzer_request to fix URL path 2. Wraps _copy_analyzer_initial method to accept both 201 and 202 status codes - - :param analyzer_id: The analyzer ID for the copy operation. - :type analyzer_id: str - :keyword allow_replace: Whether to allow replacing an existing analyzer. - :paramtype allow_replace: Optional[bool] - :return: The HTTP request object. - :rtype: HttpRequest """ from . import _operations # pylint: disable=protected-access diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.pyi b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.pyi index ae8f4fbe2d89..ccc5a88a9adf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.pyi +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.pyi @@ -1,3 +1,8 @@ +# 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. +# -------------------------------------------------------------------------- # Stub file for _models.py # This file declares the .value property added at runtime via patch_sdk() # Type checkers (MyPy, Pyright) use this to understand the properties exist @@ -35,4 +40,3 @@ class ObjectField(ContentField): class JsonField(ContentField): value: Optional[Any] # Added at runtime via patch_sdk() - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index 527d08c67a25..73fd7916c718 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -222,10 +222,8 @@ def _patched_audio_visual_content_init(self, *args: Any, **kwargs: Any) -> None: :param args: Positional arguments passed to __init__. :type args: Any - :param kwargs: Keyword arguments passed to __init__. - :type kwargs: Any - :return: None - :rtype: None + :keyword kwargs: Keyword arguments passed to __init__. + :paramtype kwargs: Any """ # If first arg is a dict (mapping), normalize the casing if args and isinstance(args[0], dict): From f3af3c7522db691c6dd162227da0bf273a587013 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 1 Dec 2025 11:59:12 -0800 Subject: [PATCH 063/105] [Tests] Update to use AZURE_CONTENT_UNDERSTANDING_ENDPOINT --- .../samples/test_sample_analyze_binary.py | 4 +- .../samples/test_sample_analyze_configs.py | 4 +- .../samples/test_sample_analyze_invoice.py | 4 +- .../test_sample_analyze_return_raw_json.py | 4 +- .../tests/samples/test_sample_analyze_url.py | 4 +- .../samples/test_sample_configure_defaults.py | 4 +- .../samples/test_sample_copy_analyzer.py | 4 +- .../samples/test_sample_create_analyzer.py | 4 +- .../samples/test_sample_create_classifier.py | 4 +- .../samples/test_sample_delete_analyzer.py | 4 +- .../samples/test_sample_delete_result.py | 4 +- .../tests/samples/test_sample_get_analyzer.py | 4 +- .../samples/test_sample_get_result_file.py | 4 +- .../samples/test_sample_grant_copy_auth.py | 8 +-- .../samples/test_sample_list_analyzers.py | 4 +- .../samples/test_sample_update_analyzer.py | 4 +- ...erstanding_content_analyzers_operations.py | 48 ++++++------- ...ding_content_analyzers_operations_async.py | 72 +++++++++---------- .../tests/testpreparer.py | 20 +----- .../tests/testpreparer_async.py | 23 ++---- 20 files changed, 101 insertions(+), 130 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py index d68819c525b6..2dd3721d3f0f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py @@ -27,7 +27,7 @@ class TestSampleAnalyzeBinary(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_analyze_binary(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_binary(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document from binary data. This test validates: @@ -37,7 +37,7 @@ def test_sample_analyze_binary(self, contentunderstanding_endpoint: str) -> None 4. Document properties (MIME type, pages, tables) """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Read the sample file # Use test_data directory from parent tests folder diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py index b96f73d0afc8..0473e1e10a99 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py @@ -27,7 +27,7 @@ class TestSampleAnalyzeConfigs(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_analyze_configs(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_configs(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document with specific configuration options. This test validates: @@ -37,7 +37,7 @@ def test_sample_analyze_configs(self, contentunderstanding_endpoint: str) -> Non 10_AnalyzeConfigs.AnalyzeConfigsAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Read the sample file (using sample_invoice.pdf as it contains various features) tests_dir = os.path.dirname(os.path.dirname(__file__)) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py index 17ab6270d338..9f537339e43e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py @@ -28,7 +28,7 @@ class TestSampleAnalyzeInvoice(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_analyze_invoice(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_invoice(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing an invoice document with prebuilt-invoice analyzer. This test validates: @@ -38,7 +38,7 @@ def test_sample_analyze_invoice(self, contentunderstanding_endpoint: str) -> Non 03_AnalyzeInvoice.AnalyzeInvoiceAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Get the invoice file path (use sample_invoice.pdf from test_data) current_dir = os.path.dirname(os.path.abspath(__file__)) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py index 998ca0a351e0..0fd6cfe69a73 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py @@ -28,7 +28,7 @@ class TestSampleAnalyzeReturnRawJson(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_analyze_return_raw_json(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document and getting raw JSON response. This test validates: @@ -38,7 +38,7 @@ def test_sample_analyze_return_raw_json(self, contentunderstanding_endpoint: str 11_AnalyzeReturnRawJson.AnalyzeReturnRawJsonAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Read the sample file tests_dir = os.path.dirname(os.path.dirname(__file__)) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py index 67121cffc359..5bf0e0f0ae81 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py @@ -28,7 +28,7 @@ class TestSampleAnalyzeUrl(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_analyze_url(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_url(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document from URL. This test validates: @@ -39,7 +39,7 @@ def test_sample_analyze_url(self, contentunderstanding_endpoint: str) -> None: 02_AnalyzeUrl.AnalyzeUrlAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Use a publicly accessible URL for testing # In production, this would be a real URL to a document diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py index 3499fc3469fe..c3e1479713a4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py @@ -26,7 +26,7 @@ class TestSampleConfigureDefaults(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_configure_defaults(self, contentunderstanding_endpoint: str) -> None: + def test_sample_configure_defaults(self, azure_content_understanding_endpoint: str) -> None: """Test configuring and getting model deployment defaults. This test validates: @@ -36,7 +36,7 @@ def test_sample_configure_defaults(self, contentunderstanding_endpoint: str) -> 00_ConfigureDefaults.ConfigureDefaultsAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Test UpdateDefaults - only if deployment names are provided self._test_update_defaults(client) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py index 1ecd09015a3b..b12ede558157 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py @@ -35,7 +35,7 @@ class TestSampleCopyAnalyzer(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_copy_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_copy_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test copying an analyzer (within same resource or across resources). This test validates: @@ -50,7 +50,7 @@ def test_sample_copy_analyzer(self, contentunderstanding_endpoint: str) -> None: """ # Skip this test if API is not available try: - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Generate unique analyzer IDs for this test source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex}" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py index 59b52e995700..cc2aa2289659 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py @@ -33,7 +33,7 @@ class TestSampleCreateAnalyzer(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_create_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_create_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test creating a custom analyzer with field schema. This test validates: @@ -45,7 +45,7 @@ def test_sample_create_analyzer(self, contentunderstanding_endpoint: str) -> Non 04_CreateAnalyzer.CreateAnalyzerAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Generate a unique analyzer ID analyzer_id = f"test_custom_analyzer_{uuid.uuid4().hex[:16]}" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py index ebad787209e9..0a13b7c76bb1 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py @@ -32,7 +32,7 @@ class TestSampleCreateClassifier(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_create_classifier(self, contentunderstanding_endpoint: str) -> None: + def test_sample_create_classifier(self, azure_content_understanding_endpoint: str) -> None: """Test creating a custom classifier with content categories. This test validates: @@ -42,7 +42,7 @@ def test_sample_create_classifier(self, contentunderstanding_endpoint: str) -> N 05_CreateClassifier.CreateClassifierAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Generate a unique analyzer ID analyzer_id = f"test_classifier_{uuid.uuid4().hex[:16]}" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py index bad0fc82b268..d35cbb5f1a61 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py @@ -29,7 +29,7 @@ class TestSampleDeleteAnalyzer(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_delete_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_delete_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analyzer. This test validates: @@ -42,7 +42,7 @@ def test_sample_delete_analyzer(self, contentunderstanding_endpoint: str) -> Non """ # Skip this test if API is not available try: - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Generate unique analyzer ID for this test analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py index e3cfde23cb35..453f5d630204 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py @@ -27,7 +27,7 @@ class TestSampleDeleteResult(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_delete_result(self, contentunderstanding_endpoint: str) -> None: + def test_sample_delete_result(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analysis result. This test validates: @@ -37,7 +37,7 @@ def test_sample_delete_result(self, contentunderstanding_endpoint: str) -> None: 13_DeleteResult.DeleteResultAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # First, analyze a document to create a result tests_dir = os.path.dirname(os.path.dirname(__file__)) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py index 451ac4545b75..c7e8f26b4ab7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py @@ -27,7 +27,7 @@ class TestSampleGetAnalyzer(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_get_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_get_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test getting information about a prebuilt analyzer. This test validates: @@ -37,7 +37,7 @@ def test_sample_get_analyzer(self, contentunderstanding_endpoint: str) -> None: 06_GetAnalyzer.GetPrebuiltAnalyzerAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Get information about a prebuilt analyzer response = client.get_analyzer(analyzer_id="prebuilt-documentSearch") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py index 880d6c8a0bab..59e725c9a70d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py @@ -28,7 +28,7 @@ class TestSampleGetResultFile(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_get_result_file(self, contentunderstanding_endpoint: str) -> None: + def test_sample_get_result_file(self, azure_content_understanding_endpoint: str) -> None: """Test getting result files (like keyframe images) from analysis results. This test validates: @@ -42,7 +42,7 @@ def test_sample_get_result_file(self, contentunderstanding_endpoint: str) -> Non Note: This test uses document analysis as video analysis may not be available. The API pattern is the same for both document and video analysis. """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Use document analysis for testing as video analysis may not be available # The get_result_file API pattern is the same for both document and video diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py index 81e8f27d13ce..e329a97db643 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py @@ -39,7 +39,7 @@ class TestSampleGrantCopyAuth(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str, **kwargs) -> None: + def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, **kwargs) -> None: """Test granting copy authorization for cross-resource analyzer copying. This test validates: @@ -60,7 +60,7 @@ def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str, **kwar # In production, these would be different resources source_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID") source_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION") - target_endpoint = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", contentunderstanding_endpoint) + target_endpoint = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", azure_content_understanding_endpoint) target_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID") target_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION") target_key = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") @@ -84,13 +84,13 @@ def test_sample_grant_copy_auth(self, contentunderstanding_endpoint: str, **kwar target_region = target_region or "placeholder-target-region" # Create clients - source_client = self.create_client(endpoint=contentunderstanding_endpoint) + source_client = self.create_client(endpoint=azure_content_understanding_endpoint) # Create target client (may use different endpoint and credential) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential - if target_endpoint != contentunderstanding_endpoint or target_key: + if target_endpoint != azure_content_understanding_endpoint or target_key: # Create target client with different endpoint/credential target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() target_client = cast( diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py index 79f89989ebe6..66545a5cd65c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py @@ -26,7 +26,7 @@ class TestSampleListAnalyzers(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_list_analyzers(self, contentunderstanding_endpoint: str) -> None: + def test_sample_list_analyzers(self, azure_content_understanding_endpoint: str) -> None: """Test listing all available analyzers. This test validates: @@ -36,7 +36,7 @@ def test_sample_list_analyzers(self, contentunderstanding_endpoint: str) -> None 07_ListAnalyzers.ListAnalyzersAsync() """ - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # List all analyzers analyzers = [] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py index 5f2b4c0d0b61..f4cbbae86c42 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py @@ -28,7 +28,7 @@ class TestSampleUpdateAnalyzer(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_update_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_sample_update_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test updating an analyzer's properties. This test validates: @@ -41,7 +41,7 @@ def test_sample_update_analyzer(self, contentunderstanding_endpoint: str) -> Non """ # Skip this test if API is not available try: - client = self.create_client(endpoint=contentunderstanding_endpoint) + client = self.create_client(endpoint=azure_content_understanding_endpoint) # Generate unique analyzer ID for this test analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py index 4a76ed087839..864a3b1ba000 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py @@ -217,14 +217,14 @@ class TestContentUnderstandingContentAnalyzersOperations(ContentUnderstandingCli @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_begin_create_with_content_analyzer(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_begin_create_with_content_analyzer(self, azure_content_understanding_endpoint: str) -> None: """ Test Summary: - Create analyzer using ContentAnalyzer object - Verify analyzer creation and poller properties - Clean up created analyzer """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "create_sync", is_async=False) created_analyzer = False @@ -251,14 +251,14 @@ def test_content_analyzers_begin_create_with_content_analyzer(self, contentunder @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_begin_create_with_json(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_begin_create_with_json(self, azure_content_understanding_endpoint: str) -> None: """ Test Summary: - Create analyzer using JSON dictionary - Verify analyzer creation and poller properties - Clean up created analyzer """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "create_json_sync", is_async=False) created_analyzer = False @@ -294,7 +294,7 @@ def test_content_analyzers_begin_create_with_json(self, contentunderstanding_end @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_update(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_update(self, azure_content_understanding_endpoint: str) -> None: """ Test Summary: - Create initial analyzer @@ -303,7 +303,7 @@ def test_content_analyzers_update(self, contentunderstanding_endpoint: str) -> N - Get analyzer after update to verify changes persisted - Clean up created analyzer """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "update_sync", is_async=False) created_analyzer = False @@ -362,14 +362,14 @@ def test_content_analyzers_update(self, contentunderstanding_endpoint: str) -> N @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_delete(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_delete(self, azure_content_understanding_endpoint: str) -> None: """ Test Summary: - Create analyzer for deletion test - Delete analyzer - Clean up if deletion failed """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "delete_sync", is_async=False) created_analyzer = False @@ -398,7 +398,7 @@ def test_content_analyzers_delete(self, contentunderstanding_endpoint: str) -> N @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_begin_analyze_url(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_begin_analyze_url(self, azure_content_understanding_endpoint: str) -> None: """ Test Summary: - Create simple analyzer for URL analysis @@ -409,7 +409,7 @@ def test_content_analyzers_begin_analyze_url(self, contentunderstanding_endpoint - Verify total_amount field exists and equals 110 - Clean up created analyzer """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "analyze_url_sync", is_async=False) created_analyzer = False @@ -451,7 +451,7 @@ def test_content_analyzers_begin_analyze_url(self, contentunderstanding_endpoint @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_begin_analyze_binary(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_begin_analyze_binary(self, azure_content_understanding_endpoint: str) -> None: """ Test Summary: - Create simple analyzer for binary analysis @@ -463,7 +463,7 @@ def test_content_analyzers_begin_analyze_binary(self, contentunderstanding_endpo - Verify total_amount field exists and equals 110 - Clean up created analyzer """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "analyze_binary_sync", is_async=False) created_analyzer = False @@ -507,7 +507,7 @@ def test_content_analyzers_begin_analyze_binary(self, contentunderstanding_endpo @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_get_result_file(self, azure_content_understanding_endpoint: str) -> None: """ Test Summary: - Create marketing video analyzer based on the marketing video template @@ -523,7 +523,7 @@ def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: "This test requires live mode to run, as it involves large video files that are too big for test proxy to record" ) return - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "get_result_file_sync", is_async=False) created_analyzer = False @@ -580,13 +580,13 @@ def test_content_analyzers_get_result_file(self, contentunderstanding_endpoint: @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_analyze_binary_extract_markdown(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_analyze_binary_extract_markdown(self, azure_content_understanding_endpoint: str) -> None: """Test extracting markdown content from analyzed binary documents. This test corresponds to .NET AnalyzeBinary_ExtractMarkdown. Verifies that markdown is successfully extracted and is non-empty. """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) print("\n=== Test: Extract Markdown from Binary Document ===") @@ -640,14 +640,14 @@ def test_content_analyzers_analyze_binary_extract_markdown(self, contentundersta @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_create_classifier(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_create_classifier(self, azure_content_understanding_endpoint: str) -> None: """Test creating a classifier with content categories and document segmentation. This test corresponds to .NET CreateClassifier. Verifies that the classifier is created successfully with the specified categories and configuration, and can segment documents into different categories. """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) created_analyzer = False analyzer_id = generate_analyzer_id(client, "test_classifier", is_async=False) @@ -720,13 +720,13 @@ def test_content_analyzers_create_classifier(self, contentunderstanding_endpoint @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_analyze_configs(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_analyze_configs(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document with specific configurations enabled. This test corresponds to .NET AnalyzeConfigs. Verifies that document features can be extracted with formulas, layout, and OCR enabled. """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) print("\n=== Test: Analyze with Specific Configurations ===") @@ -784,13 +784,13 @@ def test_content_analyzers_analyze_configs(self, contentunderstanding_endpoint: @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_analyze_return_raw_json(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_analyze_return_raw_json(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document and returning raw JSON response. This test corresponds to .NET AnalyzeReturnRawJson. Verifies that the raw JSON response can be retrieved and parsed. """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) print("\n=== Test: Analyze and Return Raw JSON ===") @@ -839,13 +839,13 @@ def test_content_analyzers_analyze_return_raw_json(self, contentunderstanding_en @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_delete_result(self, contentunderstanding_endpoint: str) -> None: + def test_content_analyzers_delete_result(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analysis result. This test corresponds to .NET DeleteResult. Verifies that an analysis result can be deleted using its operation ID. """ - client: ContentUnderstandingClient = self.create_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) print("\n=== Test: Delete Analysis Result ===") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py index d61c82d3a0ee..bf701cee0cdc 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py @@ -218,12 +218,12 @@ class TestContentUnderstandingContentAnalyzersOperationsAsync(ContentUnderstandi @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_update_defaults_async(self, contentunderstanding_endpoint: str) -> None: + async def test_update_defaults_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests updating default model deployments for the Content Understanding service. Verifies that model deployments (gpt-4.1, gpt-4.1-mini, text-embedding-3-large) can be updated and are correctly persisted. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) # Check if model deployments are configured in test environment gpt41_deployment = os.getenv("CONTENTUNDERSTANDING_GPT41_DEPLOYMENT") @@ -271,12 +271,12 @@ async def test_update_defaults_async(self, contentunderstanding_endpoint: str) - @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_get_defaults_async(self, contentunderstanding_endpoint: str) -> None: + async def test_get_defaults_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests retrieving default model deployments from the Content Understanding service. Verifies that the returned defaults contain the expected model deployment configurations. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) # Load expected model values from test environment gpt41_deployment = os.getenv("CONTENTUNDERSTANDING_GPT41_DEPLOYMENT") @@ -328,13 +328,13 @@ async def test_get_defaults_async(self, contentunderstanding_endpoint: str) -> N @ContentUnderstandingPreparer() @recorded_by_proxy_async async def test_create_analyzer_async( - self, contentunderstanding_endpoint: str + self, azure_content_understanding_endpoint: str ) -> None: """ Tests creating a custom analyzer using ContentAnalyzer object. Verifies analyzer creation, poller properties, and proper cleanup. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "create_content_analyzer", is_async=True) created_analyzer = False @@ -353,12 +353,12 @@ async def test_create_analyzer_async( @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_create_analyzer_with_json_async(self, contentunderstanding_endpoint: str) -> None: + async def test_create_analyzer_with_json_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests creating a custom analyzer using JSON dictionary representation. Verifies analyzer creation, poller properties, and proper cleanup. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "create_json", is_async=True) created_analyzer = False @@ -406,12 +406,12 @@ async def test_create_analyzer_with_json_async(self, contentunderstanding_endpoi @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_update_analyzer_async(self, contentunderstanding_endpoint: str) -> None: + async def test_update_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests updating an analyzer's properties (description and tags). Verifies that updates are correctly applied and persisted. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "update", is_async=True) created_analyzer = False @@ -486,12 +486,12 @@ async def test_update_analyzer_async(self, contentunderstanding_endpoint: str) - @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_get_analyzer_async(self, contentunderstanding_endpoint: str) -> None: + async def test_get_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests retrieving an analyzer by ID. Verifies that the prebuilt-documentSearch analyzer can be retrieved with all properties. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) response = await client.get_analyzer( analyzer_id="prebuilt-documentSearch", ) @@ -507,13 +507,13 @@ async def test_get_analyzer_async(self, contentunderstanding_endpoint: str) -> N @ContentUnderstandingPreparer() @recorded_by_proxy_async async def test_delete_analyzer_async( - self, contentunderstanding_endpoint: str + self, azure_content_understanding_endpoint: str ) -> None: """ Tests deleting an analyzer. Verifies that an analyzer can be successfully deleted. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "delete", is_async=True) created_analyzer = False @@ -557,13 +557,13 @@ async def test_delete_analyzer_async( @ContentUnderstandingPreparer() @recorded_by_proxy_async async def test_list_analyzers_async( - self, contentunderstanding_endpoint: str + self, azure_content_understanding_endpoint: str ) -> None: """ Tests listing all available analyzers. Verifies that prebuilt analyzers are included and have required properties. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) response = client.list_analyzers() result = [r async for r in response] assert len(result) > 0, "Should have at least one analyzer in the list" @@ -585,12 +585,12 @@ async def test_list_analyzers_async( @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_analyze_url_async(self, contentunderstanding_endpoint: str) -> None: + async def test_analyze_url_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests analyzing a document from a URL. Verifies that analysis completes successfully and returns expected field results. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "analyze_url", is_async=True) created_analyzer = False @@ -637,12 +637,12 @@ async def test_analyze_url_async(self, contentunderstanding_endpoint: str) -> No @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_analyze_binary_basic_async(self, contentunderstanding_endpoint: str) -> None: + async def test_analyze_binary_basic_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests analyzing a document from binary data (PDF file). Verifies that binary analysis completes successfully and returns expected field results. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "analyze_binary", is_async=True) created_analyzer = False @@ -690,7 +690,7 @@ async def test_analyze_binary_basic_async(self, contentunderstanding_endpoint: s @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_get_result_file_async(self, contentunderstanding_endpoint: str) -> None: + async def test_get_result_file_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests retrieving result files from a video analysis operation. Verifies that image files generated from video analysis can be retrieved and saved. @@ -700,7 +700,7 @@ async def test_get_result_file_async(self, contentunderstanding_endpoint: str) - "This test requires live mode to run, as it involves large video files that are too big for test proxy to record" ) return # Skip this test in playback mode as it requires large video files is too big for test proxy to record - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "get_result_file", is_async=True) created_analyzer = False @@ -764,12 +764,12 @@ async def test_get_result_file_async(self, contentunderstanding_endpoint: str) - @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_validate_document_properties_async(self, contentunderstanding_endpoint: str) -> None: + async def test_validate_document_properties_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests document property validation from analysis results. Verifies that analyzed documents contain expected properties like page count, content structure, and layout information. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "validate_props", is_async=True) created_analyzer = False @@ -838,13 +838,13 @@ async def test_validate_document_properties_async(self, contentunderstanding_end @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_analyze_invoice_with_fields_async(self, contentunderstanding_endpoint: str) -> None: + async def test_analyze_invoice_with_fields_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests invoice analysis with comprehensive field extraction. Verifies that invoice-specific fields (invoice_number, dates, amounts, vendor/customer info) are correctly extracted. This test demonstrates structured data extraction from invoices using field schema. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) analyzer_id = generate_analyzer_id(client, "invoice_fields", is_async=True) created_analyzer = False @@ -938,13 +938,13 @@ async def test_analyze_invoice_with_fields_async(self, contentunderstanding_endp @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_analyze_binary_extract_markdown_async(self, contentunderstanding_endpoint: str) -> None: + async def test_analyze_binary_extract_markdown_async(self, azure_content_understanding_endpoint: str) -> None: """Test extracting markdown content from analyzed binary documents. This test corresponds to .NET AnalyzeBinaryAsync_ExtractMarkdown. Verifies that markdown is successfully extracted and is non-empty. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) print("\n=== Test: Extract Markdown from Binary Document ===") @@ -998,14 +998,14 @@ async def test_analyze_binary_extract_markdown_async(self, contentunderstanding_ @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_create_classifier_async(self, contentunderstanding_endpoint: str) -> None: + async def test_create_classifier_async(self, azure_content_understanding_endpoint: str) -> None: """Test creating a classifier with content categories and document segmentation. This test corresponds to .NET CreateClassifierAsync. Verifies that the classifier is created successfully with the specified categories and configuration, and can segment documents into different categories. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) created_analyzer = False analyzer_id = generate_analyzer_id(client, "test_classifier", is_async=True) @@ -1078,13 +1078,13 @@ async def test_create_classifier_async(self, contentunderstanding_endpoint: str) @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_analyze_configs_async(self, contentunderstanding_endpoint: str) -> None: + async def test_analyze_configs_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document with specific configurations enabled. This test corresponds to .NET AnalyzeConfigsAsync. Verifies that document features can be extracted with formulas, layout, and OCR enabled. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) print("\n=== Test: Analyze with Specific Configurations ===") @@ -1142,13 +1142,13 @@ async def test_analyze_configs_async(self, contentunderstanding_endpoint: str) - @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_analyze_return_raw_json_async(self, contentunderstanding_endpoint: str) -> None: + async def test_analyze_return_raw_json_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document and returning raw JSON response. This test corresponds to .NET AnalyzeReturnRawJsonAsync. Verifies that the raw JSON response can be retrieved and parsed. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) print("\n=== Test: Analyze and Return Raw JSON ===") @@ -1197,13 +1197,13 @@ async def test_analyze_return_raw_json_async(self, contentunderstanding_endpoint @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_delete_result_async(self, contentunderstanding_endpoint: str) -> None: + async def test_delete_result_async(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analysis result. This test corresponds to .NET DeleteResultAsync. Verifies that an analysis result can be deleted using its operation ID. """ - client: ContentUnderstandingClient = self.create_async_client(endpoint=contentunderstanding_endpoint) + client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) print("\n=== Test: Delete Analysis Result ===") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py index 33bfe1eeae8b..285734a046bb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py @@ -9,30 +9,16 @@ from typing import cast from azure.ai.contentunderstanding import ContentUnderstandingClient from azure.core.credentials import AzureKeyCredential -from azure.identity import DefaultAzureCredential from devtools_testutils import AzureRecordedTestCase, PowerShellPreparer import functools -def get_content_understanding_credential(): - """Get the appropriate credential for Content Understanding. - - Checks for AZURE_CONTENT_UNDERSTANDING_KEY first, then falls back to DefaultAzureCredential. - """ - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - - if key and key.strip(): - return AzureKeyCredential(key) - else: - return DefaultAzureCredential() - - class ContentUnderstandingClientTestBase(AzureRecordedTestCase): def create_client(self, endpoint: str) -> ContentUnderstandingClient: # Try API key first (for Content Understanding service) # Check both CONTENTUNDERSTANDING_KEY (PowerShellPreparer convention) and AZURE_CONTENT_UNDERSTANDING_KEY - key = os.getenv("CONTENTUNDERSTANDING_KEY") or os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") if key and key.strip(): credential = AzureKeyCredential(key) else: @@ -50,6 +36,6 @@ def create_client(self, endpoint: str) -> ContentUnderstandingClient: ContentUnderstandingPreparer = functools.partial( PowerShellPreparer, - "contentunderstanding", - contentunderstanding_endpoint="https://fake_contentunderstanding_endpoint.services.ai.azure.com/", + "azure_content_understanding", + azure_content_understanding_endpoint="https://fake_contentunderstanding_endpoint.services.ai.azure.com/", ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py index f344da3d8afa..128a432154fd 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py @@ -9,35 +9,20 @@ from typing import cast from azure.ai.contentunderstanding.aio import ContentUnderstandingClient from azure.core.credentials import AzureKeyCredential -from azure.identity import DefaultAzureCredential -from azure.identity.aio import DefaultAzureCredential as AsyncDefaultAzureCredential from devtools_testutils import AzureRecordedTestCase, PowerShellPreparer import functools -def get_content_understanding_credential_async(): - """Get the appropriate async credential for Content Understanding. - - Checks for AZURE_CONTENT_UNDERSTANDING_KEY first, then falls back to DefaultAzureCredential. - """ - key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") - - if key and key.strip(): - return AzureKeyCredential(key) - else: - return AsyncDefaultAzureCredential() - - class ContentUnderstandingClientTestBaseAsync(AzureRecordedTestCase): def create_async_client(self, endpoint: str) -> ContentUnderstandingClient: # Try API key first (for Content Understanding service) # Check both CONTENTUNDERSTANDING_KEY (PowerShellPreparer convention) and AZURE_CONTENT_UNDERSTANDING_KEY - key = os.getenv("CONTENTUNDERSTANDING_KEY") or os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") if key and key.strip(): credential = AzureKeyCredential(key) else: - # Fall back to service principal or DefaultAzureCredential + # Fall back to service principal or AsyncDefaultAzureCredential credential = self.get_credential(ContentUnderstandingClient, is_async=True) return cast( ContentUnderstandingClient, @@ -52,6 +37,6 @@ def create_async_client(self, endpoint: str) -> ContentUnderstandingClient: ContentUnderstandingPreparer = functools.partial( PowerShellPreparer, - "contentunderstanding", - contentunderstanding_endpoint="https://fake_contentunderstanding_endpoint.services.ai.azure.com/", + "azure_content_understanding", + azure_content_understanding_endpoint="https://fake_contentunderstanding_endpoint.services.ai.azure.com/", ) From 6e47c1d25057950bb007b256512f62d2c8c40784 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 20:27:41 +0000 Subject: [PATCH 064/105] CI: Address test issue in CI --- .../tests/samples/test_sample_analyze_invoice.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py index 17ab6270d338..b55f1c85fc84 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py @@ -28,7 +28,7 @@ class TestSampleAnalyzeInvoice(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_analyze_invoice(self, contentunderstanding_endpoint: str) -> None: + def test_sample_analyze_invoice(self, contentunderstanding_endpoint: str, **kwargs) -> None: """Test analyzing an invoice document with prebuilt-invoice analyzer. This test validates: From 6a2b8eb5787340998d95e145087311578b4ceeb8 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Mon, 1 Dec 2025 20:39:23 +0000 Subject: [PATCH 065/105] CI: Pylint issues --- .../azure/ai/contentunderstanding/models/_patch.py | 2 -- 1 file changed, 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index 73fd7916c718..b7ed43ccce1a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -222,8 +222,6 @@ def _patched_audio_visual_content_init(self, *args: Any, **kwargs: Any) -> None: :param args: Positional arguments passed to __init__. :type args: Any - :keyword kwargs: Keyword arguments passed to __init__. - :paramtype kwargs: Any """ # If first arg is a dict (mapping), normalize the casing if args and isinstance(args[0], dict): From 6877dd86d191551925933a963b82aece011ff83a Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 1 Dec 2025 13:37:22 -0800 Subject: [PATCH 066/105] [Tests] Update to use AZURE_CONTENT_UNDERSTANDING_ENDPOINT --- .../azure-ai-contentunderstanding/tests/testpreparer.py | 2 +- .../azure-ai-contentunderstanding/tests/testpreparer_async.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py index 285734a046bb..5d0c03091fbc 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py @@ -17,7 +17,7 @@ class ContentUnderstandingClientTestBase(AzureRecordedTestCase): def create_client(self, endpoint: str) -> ContentUnderstandingClient: # Try API key first (for Content Understanding service) - # Check both CONTENTUNDERSTANDING_KEY (PowerShellPreparer convention) and AZURE_CONTENT_UNDERSTANDING_KEY + # Check AZURE_CONTENT_UNDERSTANDING_KEY key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") if key and key.strip(): credential = AzureKeyCredential(key) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py index 128a432154fd..779cfd0f978d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py @@ -17,7 +17,7 @@ class ContentUnderstandingClientTestBaseAsync(AzureRecordedTestCase): def create_async_client(self, endpoint: str) -> ContentUnderstandingClient: # Try API key first (for Content Understanding service) - # Check both CONTENTUNDERSTANDING_KEY (PowerShellPreparer convention) and AZURE_CONTENT_UNDERSTANDING_KEY + # Check AZURE_CONTENT_UNDERSTANDING_KEY key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") if key and key.strip(): credential = AzureKeyCredential(key) From d1762ece22020a8ce8e6685b9b13b4eeba5f0e45 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 1 Dec 2025 14:09:08 -0800 Subject: [PATCH 067/105] [Tests] change total_amount to amount_due --- ...erstanding_content_analyzers_operations.py | 4 +- ...ding_content_analyzers_operations_async.py | 42 +++++++++---------- .../tests/test_helpers.py | 32 +++++++------- 3 files changed, 39 insertions(+), 39 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py index 864a3b1ba000..ab5fc91f46f2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py @@ -406,7 +406,7 @@ def test_content_analyzers_begin_analyze_url(self, azure_content_understanding_e - Wait for analysis completion - Save analysis result to output file - Verify fields node exists in first result - - Verify total_amount field exists and equals 110 + - Verify amount_due field exists and equals 610 - Clean up created analyzer """ client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -460,7 +460,7 @@ def test_content_analyzers_begin_analyze_binary(self, azure_content_understandin - Wait for analysis completion - Save analysis result to output file - Verify fields node exists in first result - - Verify total_amount field exists and equals 110 + - Verify amount_due field exists and equals 610 - Clean up created analyzer """ client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py index bf701cee0cdc..7be2c5b53212 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py @@ -383,8 +383,8 @@ async def test_create_analyzer_with_json_async(self, azure_content_understanding "description": f"test analyzer: {analyzer_id}", "fieldSchema": { "fields": { - "total_amount": { - "description": "Total amount of this table", + "amount_due": { + "description": "Total amount due of this table", "method": "extract", "type": "number", } @@ -825,10 +825,10 @@ async def test_validate_document_properties_async(self, azure_content_understand # Verify fields were extracted if field schema was defined if hasattr(first_content, 'fields') and first_content.fields: - assert 'total_amount' in first_content.fields, "Should extract total_amount field" - total_amount = first_content.fields['total_amount'] - assert total_amount is not None, "total_amount field should have a value" - print(f"✓ Extracted total_amount: {total_amount}") + assert 'amount_due' in first_content.fields, "Should extract amount_due field" + amount_due = first_content.fields['amount_due'] + assert amount_due is not None, "amount_due field should have a value" + print(f"✓ Extracted amount_due: {amount_due}") print(f"✓ Document properties validation test completed successfully") @@ -889,44 +889,44 @@ async def test_analyze_invoice_with_fields_async(self, azure_content_understandi # Validate invoice fields using the specialized assertion function assert_invoice_fields(analysis_result, "Invoice analysis result") - # Additional validation - verify at least total_amount is extracted (most critical field) + # Additional validation - verify at least amount_due is extracted (most critical field) first_content = analysis_result.contents[0] assert hasattr(first_content, 'fields'), "Content should have fields" assert first_content.fields is not None, "Fields should not be None" fields = first_content.fields - assert 'total_amount' in fields, "Should extract total_amount field (most critical invoice field)" + assert 'amount_due' in fields, "Should extract amount_due field (most critical invoice field)" - total_field = fields['total_amount'] + amount_due_field = fields['amount_due'] print(f"\n✓ Critical field verification:") - print(f" - total_amount extracted successfully") + print(f" - amount_due extracted successfully") - if isinstance(total_field, dict) and 'valueNumber' in total_field: - total_value = total_field['valueNumber'] - print(f" - Total amount value: {total_value}") - assert total_value > 0, "Total amount should be positive" + if isinstance(amount_due_field, dict) and 'valueNumber' in amount_due_field: + amount_due_value = amount_due_field['valueNumber'] + print(f" - Total amount value: {amount_due_value}") + assert amount_due_value > 0, "Total amount should be positive" # Verify confidence if available - if 'confidence' in total_field: - confidence = total_field['confidence'] + if 'confidence' in amount_due_field: + confidence = amount_due_field['confidence'] print(f" - Confidence: {confidence:.2%}") # Note: We don't enforce a minimum confidence as it depends on document quality # Verify source information if available - if 'spans' in total_field: - spans = total_field['spans'] + if 'spans' in amount_due_field: + spans = amount_due_field['spans'] print(f" - Source locations: {len(spans)} span(s)") assert len(spans) > 0, "Should have source location for extracted field" - if 'source' in total_field: - source = total_field['source'] + if 'source' in amount_due_field: + source = amount_due_field['source'] print(f" - Source: {source[:50]}..." if len(source) > 50 else f" - Source: {source}") # Count how many invoice fields were successfully extracted invoice_field_names = [ 'invoice_number', 'invoice_date', 'due_date', 'vendor_name', 'vendor_address', 'customer_name', 'customer_address', - 'subtotal', 'tax_amount', 'total_amount' + 'subtotal', 'tax_amount', 'amount_due' ] extracted_count = sum(1 for field in invoice_field_names if field in fields) print(f"\n✓ Successfully extracted {extracted_count}/{len(invoice_field_names)} invoice fields") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py index 7ddfda633d18..a8273eb532da 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py @@ -70,8 +70,8 @@ def new_simple_content_analyzer_object( description=description, field_schema=ContentFieldSchema( fields={ - "total_amount": ContentFieldDefinition( - description="Total amount of this table", + "amount_due": ContentFieldDefinition( + description="Total amount due of this table", method=GenerationMethod.EXTRACT, type=ContentFieldType.NUMBER, ) @@ -158,23 +158,23 @@ def assert_simple_content_analyzer_result(analysis_result: Any, result_name: str assert hasattr(first_content, "fields"), "First content should have fields" print(f"Verified fields node exists in first result") - # Verify total_amount field exists and equals 610.0 + # Verify amount_due field exists and equals 610.0 fields = first_content.fields # Fields is expected to be a dictionary assert isinstance(fields, dict), f"Fields should be a dictionary, got {type(fields)}" - assert "total_amount" in fields, f"Fields should contain total_amount. Available fields: {list(fields.keys())}" + assert "amount_due" in fields, f"Fields should contain amount_due. Available fields: {list(fields.keys())}" - total_amount_field = fields["total_amount"] - assert total_amount_field is not None, "total_amount field should not be None" + amount_due_field = fields["amount_due"] + assert amount_due_field is not None, "amount_due field should not be None" assert ( - total_amount_field.__class__.__name__ == "NumberField" - ), f"total_amount field should be of type NumberField, got {total_amount_field.__class__.__name__}" + amount_due_field.__class__.__name__ == "NumberField" + ), f"amount_due field should be of type NumberField, got {amount_due_field.__class__.__name__}" - total_amount_value = total_amount_field.value + amount_due_value = amount_due_field.value - print(f"Total amount field value: {total_amount_value}") - assert total_amount_value == 610.0, f"Expected total_amount to be 610.0, but got {total_amount_value}" + print(f"Total amount field value: {amount_due_value}") + assert amount_due_value == 610.0, f"Expected amount_due to be 610.0, but got {amount_due_value}" print(f"Total amount field validation successful") @@ -379,7 +379,7 @@ def new_invoice_analyzer_object( - customer_address: The customer's address - subtotal: The subtotal amount before tax - tax_amount: The tax amount - - total_amount: The total amount due + - amount_due: The total amount due Args: analyzer_id: The analyzer ID @@ -451,7 +451,7 @@ def new_invoice_analyzer_object( method=GenerationMethod.EXTRACT, type=ContentFieldType.NUMBER, ), - "total_amount": ContentFieldDefinition( + "amount_due": ContentFieldDefinition( description="The total amount due", method=GenerationMethod.EXTRACT, type=ContentFieldType.NUMBER, @@ -471,7 +471,7 @@ def assert_invoice_fields(analysis_result: Any, result_name: str = "Invoice anal Validates that the analysis result contains expected invoice fields and their properties: - Fields are present and have values - - Numeric fields (total_amount, subtotal, tax_amount) have correct types + - Numeric fields (amount_due, subtotal, tax_amount) have correct types - String fields (invoice_number, dates, names) are non-empty - Confidence scores are present - Source/span information is available @@ -506,14 +506,14 @@ def assert_invoice_fields(analysis_result: Any, result_name: str = "Invoice anal 'invoice_number', 'invoice_date', 'due_date', 'vendor_name', 'vendor_address', 'customer_name', 'customer_address', - 'subtotal', 'tax_amount', 'total_amount' + 'subtotal', 'tax_amount', 'amount_due' ] found_fields = [f for f in expected_fields if f in fields] print(f"✓ Found {len(found_fields)} expected invoice fields: {found_fields}") # Validate numeric fields if present - numeric_fields = ['total_amount', 'subtotal', 'tax_amount'] + numeric_fields = ['amount_due', 'subtotal', 'tax_amount'] for field_name in numeric_fields: if field_name in fields: field_value = fields[field_name] From 9092f823d2dd7c3f9682dfb064b5d306f0711888 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 1 Dec 2025 15:04:14 -0800 Subject: [PATCH 068/105] [Sample tests] add async sample tests --- .../test_sample_analyze_binary_async.py | 259 ++++++++++++ .../test_sample_analyze_configs_async.py | 161 ++++++++ .../test_sample_analyze_invoice_async.py | 210 ++++++++++ ...st_sample_analyze_return_raw_json_async.py | 135 +++++++ .../samples/test_sample_analyze_url_async.py | 230 +++++++++++ .../test_sample_configure_defaults_async.py | 138 +++++++ .../test_sample_copy_analyzer_async.py | 210 ++++++++++ .../test_sample_create_analyzer_async.py | 171 ++++++++ .../test_sample_create_classifier_async.py | 138 +++++++ .../test_sample_delete_analyzer_async.py | 176 +++++++++ .../test_sample_delete_result_async.py | 112 ++++++ .../samples/test_sample_get_analyzer_async.py | 120 ++++++ .../test_sample_get_result_file_async.py | 152 +++++++ .../test_sample_grant_copy_auth_async.py | 371 ++++++++++++++++++ .../test_sample_list_analyzers_async.py | 119 ++++++ .../test_sample_update_analyzer_async.py | 169 ++++++++ 16 files changed, 2871 insertions(+) create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py create mode 100644 sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py new file mode 100644 index 000000000000..c8a5bae84c66 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py @@ -0,0 +1,259 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_analyze_binary_async.py + +DESCRIPTION: + These tests validate the sample_analyze_binary.py sample code (async version). + +USAGE: + pytest test_sample_analyze_binary_async.py +""" + +import os +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync + + +class TestSampleAnalyzeBinaryAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_analyze_binary.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_binary_async(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing a document from binary data (async version). + + This test validates: + 1. File loading and binary data creation + 2. Document analysis using begin_analyze_binary + 3. Markdown content extraction + 4. Document properties (MIME type, pages, tables) + + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Read the sample file + # Use test_data directory from parent tests folder + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + # Assertion: Verify file exists + assert os.path.exists(file_path), f"Sample file not found at {file_path}" + print(f"[PASS] Sample file exists: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + # Assertion: Verify file is not empty + assert len(file_bytes) > 0, "File should not be empty" + print(f"[PASS] File loaded: {len(file_bytes)} bytes") + + # Assertion: Verify binary data + assert file_bytes is not None, "Binary data should not be null" + print("[PASS] Binary data created successfully") + + # Analyze the document + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf" + ) + + result = await poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + + # Verify raw response + # In Python SDK, we can check if the poller has result and get HTTP response info + # type: ignore is used here because we're accessing internal implementation details + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_initial_response'): + raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if raw_response: + # PipelineResponse has http_response attribute + if hasattr(raw_response, 'http_response'): + status = raw_response.http_response.status_code + elif hasattr(raw_response, 'status_code'): + status = raw_response.status_code + else: + status = None + + if status: + assert status >= 200 and status < 300, \ + f"Response status should be successful (200-299), but was {status}" + print(f"[PASS] Raw response verified (status: {status})") + + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Test markdown extraction + self._test_markdown_extraction(result) + + # Test document properties access + self._test_document_properties(result) + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_binary_async assertions passed") + + def _test_markdown_extraction(self, result): + """Test markdown content extraction. + + """ + # Assertion: Verify contents structure + assert result.contents is not None, "Result should contain contents" + assert len(result.contents) > 0, "Result should have at least one content" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Assertion: Verify markdown content + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + assert markdown.strip(), "Markdown content should not be just whitespace" + print(f"[PASS] Markdown content extracted successfully ({len(markdown)} characters)") + else: + print("[WARN] No markdown content available") + + def _test_document_properties(self, result): + """Test document property access. + + """ + content = result.contents[0] + assert content is not None, "Content should not be null for document properties validation" + + # Check if this is DocumentContent + content_type = type(content).__name__ + print(f"[INFO] Content type: {content_type}") + + # Validate this is document content (should have document-specific properties) + is_document_content = hasattr(content, 'mime_type') and hasattr(content, 'start_page_number') + if not is_document_content: + print(f"[WARN] Expected DocumentContent but got {content_type}, skipping document-specific validations") + return + + # Validate MIME type + mime_type = getattr(content, "mime_type", None) + if mime_type: + assert isinstance(mime_type, str), "MIME type should be a string" + assert mime_type.strip(), "MIME type should not be empty" + assert mime_type == "application/pdf", f"MIME type should be application/pdf, but was {mime_type}" + print(f"[PASS] MIME type verified: {mime_type}") + + # Validate page numbers + start_page = getattr(content, "start_page_number", None) + if start_page is not None: + assert start_page >= 1, f"Start page should be >= 1, but was {start_page}" + + end_page = getattr(content, "end_page_number", None) + if end_page is not None: + assert end_page >= start_page, f"End page {end_page} should be >= start page {start_page}" + total_pages = end_page - start_page + 1 + assert total_pages > 0, f"Total pages should be positive, but was {total_pages}" + print(f"[PASS] Page range verified: {start_page} to {end_page} ({total_pages} pages)") + + # Validate pages collection + pages = getattr(content, "pages", None) + if pages and len(pages) > 0: + assert len(pages) > 0, "Pages collection should not be empty when not null" + assert len(pages) == total_pages, \ + f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" + print(f"[PASS] Pages collection verified: {len(pages)} pages") + + # Validate individual pages + self._validate_pages(pages, start_page, end_page, content) + else: + print("[WARN] No pages collection available in document content") + + # Validate tables collection + tables = getattr(content, "tables", None) + if tables and len(tables) > 0: + self._validate_tables(tables) + else: + print("No tables found in document content") + + # Final validation message + print("[PASS] All document properties validated successfully") + + def _validate_pages(self, pages, start_page, end_page, content=None): + """Validate pages collection details.""" + page_numbers = set() + unit = getattr(content, 'unit', None) if content else None + unit_str = str(unit) if unit else "units" + + for page in pages: + assert page is not None, "Page object should not be null" + assert hasattr(page, "page_number"), "Page should have page_number attribute" + assert page.page_number >= 1, f"Page number should be >= 1, but was {page.page_number}" + assert start_page <= page.page_number <= end_page, \ + f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" + + assert hasattr(page, "width") and page.width > 0, \ + f"Page {page.page_number} width should be > 0, but was {page.width}" + assert hasattr(page, "height") and page.height > 0, \ + f"Page {page.page_number} height should be > 0, but was {page.height}" + + # Ensure page numbers are unique + assert page.page_number not in page_numbers, \ + f"Page number {page.page_number} appears multiple times" + page_numbers.add(page.page_number) + + # Print page details with unit + print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") + + print(f"[PASS] All {len(pages)} pages validated successfully") + + def _validate_tables(self, tables): + """Validate tables collection details.""" + assert len(tables) > 0, "Tables collection should not be empty when not null" + print(f"[PASS] Tables collection verified: {len(tables)} tables") + + for i, table in enumerate(tables, 1): + assert table is not None, f"Table {i} should not be null" + assert hasattr(table, "row_count"), f"Table {i} should have row_count attribute" + assert hasattr(table, "column_count"), f"Table {i} should have column_count attribute" + assert table.row_count > 0, \ + f"Table {i} should have at least 1 row, but had {table.row_count}" + assert table.column_count > 0, \ + f"Table {i} should have at least 1 column, but had {table.column_count}" + + # Validate table cells if available + if hasattr(table, "cells") and table.cells: + assert len(table.cells) > 0, \ + f"Table {i} cells collection should not be empty when not null" + + for cell in table.cells: + assert cell is not None, "Table cell should not be null" + assert hasattr(cell, "row_index"), "Cell should have row_index" + assert hasattr(cell, "column_index"), "Cell should have column_index" + assert 0 <= cell.row_index < table.row_count, \ + f"Cell row index {cell.row_index} should be within table row count {table.row_count}" + assert 0 <= cell.column_index < table.column_count, \ + f"Cell column index {cell.column_index} should be within table column count {table.column_count}" + + if hasattr(cell, "row_span"): + assert cell.row_span >= 1, f"Cell row span should be >= 1, but was {cell.row_span}" + if hasattr(cell, "column_span"): + assert cell.column_span >= 1, f"Cell column span should be >= 1, but was {cell.column_span}" + + print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)") + else: + print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py new file mode 100644 index 000000000000..7529cdeccb50 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py @@ -0,0 +1,161 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_analyze_configs_async.py + +DESCRIPTION: + These tests validate the sample_analyze_configs.py sample code (async version). + +USAGE: + pytest test_sample_analyze_configs_async.py +""" + +import os +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync + + +class TestSampleAnalyzeConfigsAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_analyze_configs.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_configs_async(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing a document with specific configuration options (async version). + + This test validates: + 1. Document analysis with prebuilt-documentSearch analyzer + 2. Configuration options (formulas, layout, OCR enabled) + 3. Document features extraction (charts, annotations, hyperlinks, formulas) + + 10_AnalyzeConfigs.AnalyzeConfigsAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Read the sample file (using sample_invoice.pdf as it contains various features) + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + # Assertion: Verify file exists + assert os.path.exists(file_path), f"Sample file not found at {file_path}" + print(f"[PASS] Sample file exists: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + # Assertion: Verify file is not empty + assert len(file_bytes) > 0, "File should not be empty" + print(f"[PASS] File loaded: {len(file_bytes)} bytes") + + # Assertion: Verify binary data + assert file_bytes is not None, "Binary data should not be null" + print("[PASS] Binary data created successfully") + + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf" + ) + + result = await poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + + # Verify raw response + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_initial_response'): + raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if raw_response: + if hasattr(raw_response, 'http_response'): + status = raw_response.http_response.status_code + elif hasattr(raw_response, 'status_code'): + status = raw_response.status_code + else: + status = None + + if status: + assert status >= 200 and status < 300, \ + f"Response status should be successful (200-299), but was {status}" + print(f"[PASS] Raw response verified (status: {status})") + + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should have at least one content" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Verify document content type + first_content = result.contents[0] + assert first_content is not None, "Content should not be null" + + # Check if this is document content + content_type = type(first_content).__name__ + print(f"[INFO] Content type: {content_type}") + + is_document_content = hasattr(first_content, 'mime_type') and hasattr(first_content, 'start_page_number') + if is_document_content: + start_page = getattr(first_content, "start_page_number", None) + end_page = getattr(first_content, "end_page_number", None) + + if start_page and end_page: + assert start_page >= 1, "Start page should be >= 1" + assert end_page >= start_page, "End page should be >= start page" + total_pages = end_page - start_page + 1 + print(f"[PASS] Document has {total_pages} page(s) from {start_page} to {end_page}") + + print("[PASS] Document features analysis with configs completed successfully") + + # Test document feature extraction + self._test_document_features(first_content) + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_configs_async assertions passed") + + def _test_document_features(self, content): + """Test extraction of document features like charts, annotations, hyperlinks.""" + # Check for charts + charts = getattr(content, "charts", None) + if charts and len(charts) > 0: + print(f"[PASS] Found {len(charts)} chart(s) in document") + for i, chart in enumerate(charts, 1): + assert chart is not None, f"Chart {i} should not be null" + print(f" Chart {i} detected") + else: + print("[INFO] No charts found in document") + + # Check for annotations + annotations = getattr(content, "annotations", None) + if annotations and len(annotations) > 0: + print(f"[PASS] Found {len(annotations)} annotation(s) in document") + else: + print("[INFO] No annotations found in document") + + # Check for hyperlinks + hyperlinks = getattr(content, "hyperlinks", None) + if hyperlinks and len(hyperlinks) > 0: + print(f"[PASS] Found {len(hyperlinks)} hyperlink(s) in document") + else: + print("[INFO] No hyperlinks found in document") + + # Check for formulas + formulas = getattr(content, "formulas", None) + if formulas and len(formulas) > 0: + print(f"[PASS] Found {len(formulas)} formula(s) in document") + else: + print("[INFO] No formulas found in document") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py new file mode 100644 index 000000000000..d1cf335228b7 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py @@ -0,0 +1,210 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_analyze_invoice_async.py + +DESCRIPTION: + These tests validate the sample_analyze_invoice.py sample code (async version). + +USAGE: + pytest test_sample_analyze_invoice_async.py +""" + +import os +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import AnalyzeInput, DocumentContent + + +class TestSampleAnalyzeInvoiceAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_analyze_invoice.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_invoice_async(self, azure_content_understanding_endpoint: str, **kwargs) -> None: + """Test analyzing an invoice document with prebuilt-invoice analyzer (async version). + + This test validates: + 1. Analyzing an invoice using prebuilt-invoice analyzer + 2. Extracting invoice-specific fields (CustomerName, InvoiceDate, TotalAmount, LineItems) + 3. Field confidence scores and source locations + + 03_AnalyzeInvoice.AnalyzeInvoiceAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Get the invoice file path (use sample_invoice.pdf from test_data) + current_dir = os.path.dirname(os.path.abspath(__file__)) + test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") + invoice_path = os.path.join(test_data_dir, "sample_invoice.pdf") + + # Read the invoice file as binary data + with open(invoice_path, "rb") as f: + invoice_data = f.read() + + # Analyze the invoice + poller = await client.begin_analyze( + analyzer_id="prebuilt-invoice", + inputs=[AnalyzeInput(data=invoice_data)] + ) + + # Wait for analysis to complete + result = await poller.result() + + # Assertions for operation + assert poller is not None, "Analysis operation should not be null" + print("[PASS] Analysis operation created successfully") + + # Verify raw response using getattr with type: ignore + raw_response = getattr(poller, '_polling_method', None) + if raw_response: + initial_response = getattr(raw_response, '_initial_response', None) # type: ignore + if initial_response: + status = getattr(initial_response, 'status_code', None) + if status: + assert 200 <= status < 300, f"Response status should be successful, but was {status}" + print(f"[PASS] Response status: {status}") + + # Assertions for result + assert result is not None, "Analysis result should not be null" + print("[PASS] Analysis result received") + + assert hasattr(result, 'contents'), "Result should contain contents" + contents = getattr(result, 'contents', None) + assert contents is not None, "Result contents should not be null" + assert len(contents) > 0, "Result should have at least one content" + assert len(contents) == 1, "Invoice should have exactly one content element" + print(f"[PASS] Analysis result contains {len(contents)} content(s)") + + # Get the document content + content = contents[0] + assert content is not None, "Content should not be null" + assert isinstance(content, DocumentContent), "Content should be of type DocumentContent" + print("[PASS] Content is of type DocumentContent") + + # Verify basic document properties + document_content = content + start_page = getattr(document_content, 'start_page_number', 1) + end_page = getattr(document_content, 'end_page_number', 1) + + assert start_page >= 1, "Start page should be >= 1" + assert end_page >= start_page, "End page should be >= start page" + total_pages = end_page - start_page + 1 + assert total_pages > 0, "Total pages should be positive" + print(f"[PASS] Document has {total_pages} page(s) from {start_page} to {end_page}") + + # Print document unit information + unit = getattr(document_content, 'unit', None) + if unit: + print(f"[INFO] Document unit: {unit}") + else: + print("[INFO] Document unit: unknown") + + # Extract and verify fields + fields = getattr(document_content, 'fields', {}) + + # Extract CustomerName field + customer_name_field = fields.get('CustomerName') + if customer_name_field: + print("[PASS] CustomerName field found") + + value = getattr(customer_name_field, 'value', None) + if value: + assert len(str(value)) > 0, "CustomerName value should not be empty when present" + print(f"[INFO] Customer Name: {value}") + + confidence = getattr(customer_name_field, 'confidence', None) + if confidence is not None: + assert 0 <= confidence <= 1, f"CustomerName confidence should be between 0 and 1, but was {confidence}" + print(f"[INFO] CustomerName confidence: {confidence:.2f}") + + source = getattr(customer_name_field, 'source', None) + if source: + print(f"[INFO] CustomerName source: {source}") + + spans = getattr(customer_name_field, 'spans', None) + if spans and len(spans) > 0: + span = spans[0] + offset = getattr(span, 'offset', None) + length = getattr(span, 'length', None) + if offset is not None and length is not None: + print(f"[INFO] CustomerName position in markdown: offset={offset}, length={length}") + else: + print("[INFO] CustomerName field not found in this document") + + # Extract InvoiceDate field + invoice_date_field = fields.get('InvoiceDate') + if invoice_date_field: + print("[PASS] InvoiceDate field found") + + value = getattr(invoice_date_field, 'value', None) + if value: + print(f"[INFO] Invoice Date: {value}") + + confidence = getattr(invoice_date_field, 'confidence', None) + if confidence is not None: + assert 0 <= confidence <= 1, f"InvoiceDate confidence should be between 0 and 1" + print(f"[INFO] InvoiceDate confidence: {confidence:.2f}") + + source = getattr(invoice_date_field, 'source', None) + if source: + print(f"[INFO] InvoiceDate source: {source}") + else: + print("[INFO] InvoiceDate field not found in this document") + + # Extract TotalAmount field (object field with nested Amount and CurrencyCode) + total_amount_field = fields.get('TotalAmount') + if total_amount_field: + print("[PASS] TotalAmount field found") + + # Try to extract nested fields if it's an object + if hasattr(total_amount_field, 'value') and isinstance(total_amount_field.value, dict): + amount_obj = total_amount_field.value + amount = amount_obj.get('Amount') + currency = amount_obj.get('CurrencyCode', '$') + + if amount: + print(f"[INFO] Total: {currency}{amount:.2f}" if isinstance(amount, (int, float)) else f"[INFO] Total: {currency}{amount}") + else: + value = getattr(total_amount_field, 'value', None) + if value: + print(f"[INFO] Total Amount: {value}") + + confidence = getattr(total_amount_field, 'confidence', None) + if confidence is not None: + print(f"[INFO] TotalAmount confidence: {confidence:.2f}") + else: + print("[INFO] TotalAmount field not found in this document") + + # Extract LineItems field (array field) + line_items_field = fields.get('LineItems') + if line_items_field: + print("[PASS] LineItems field found") + + # Try to extract array items + if hasattr(line_items_field, 'value') and isinstance(line_items_field.value, list): + items = line_items_field.value + print(f"[INFO] Line Items ({len(items)}):") + + for i, item in enumerate(items[:5]): # Show first 5 items + if isinstance(item, dict): + description = item.get('Description', 'N/A') + quantity = item.get('Quantity', 'N/A') + print(f"[INFO] Item {i + 1}: {description} (Qty: {quantity})") + + if len(items) > 5: + print(f"[INFO] ... and {len(items) - 5} more items") + else: + print("[INFO] LineItems format not as expected") + else: + print("[INFO] LineItems field not found in this document") + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_invoice_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py new file mode 100644 index 000000000000..cb6eb376ddf7 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py @@ -0,0 +1,135 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_analyze_return_raw_json_async.py + +DESCRIPTION: + These tests validate the sample_analyze_return_raw_json.py sample code (async version). + +USAGE: + pytest test_sample_analyze_return_raw_json_async.py +""" + +import os +import json +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync + + +class TestSampleAnalyzeReturnRawJsonAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_analyze_return_raw_json.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_return_raw_json_async(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing a document and getting raw JSON response (async version). + + This test validates: + 1. Document analysis using protocol method + 2. Raw JSON response format + 3. JSON structure validation + + 11_AnalyzeReturnRawJson.AnalyzeReturnRawJsonAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Read the sample file + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + # Assertion: Verify file exists + assert os.path.exists(file_path), f"Sample file not found at {file_path}" + print(f"[PASS] Sample file exists: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + # Assertion: Verify file is not empty + assert len(file_bytes) > 0, "File should not be empty" + print(f"[PASS] File loaded: {len(file_bytes)} bytes") + + # Analyze the document and get raw response + # Note: The Python SDK returns structured objects by default + # We can access the raw response through the result + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf" + ) + + result = await poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + + # Verify raw response status + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_initial_response'): + raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if raw_response: + if hasattr(raw_response, 'http_response'): + status = raw_response.http_response.status_code + elif hasattr(raw_response, 'status_code'): + status = raw_response.status_code + else: + status = None + + if status: + assert status >= 200 and status < 300, \ + f"Response status should be successful (200-299), but was {status}" + print(f"[PASS] Raw response status verified: {status}") + + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + print("[PASS] Response data is not null") + + # Convert result to JSON string to verify raw format capability + # In Python SDK, we can serialize the result to JSON + try: + # Try to access the raw response data + if hasattr(result, '__dict__'): + result_dict = result.__dict__ + json_str = json.dumps(result_dict, default=str) + assert json_str is not None, "Response string should not be null" + assert len(json_str) > 0, "Response string should not be empty" + print(f"[PASS] Response converted to JSON string: {len(json_str)} characters") + + # Verify it's valid JSON + parsed_json = json.loads(json_str) + assert parsed_json is not None, "Response should be valid JSON" + print("[PASS] Response is valid JSON format") + else: + print("[INFO] Result does not have __dict__ attribute, using alternative method") + + # Alternative: Check if result has contents (which confirms it's a valid response) + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + print("[PASS] Response data structure verified") + + except json.JSONDecodeError as e: + pytest.fail(f"Response should be valid JSON format: {str(e)}") + except Exception as e: + print(f"[WARN] Could not serialize to JSON: {str(e)}") + # Still verify basic structure + assert result is not None, "Result should not be null" + print("[PASS] Response data verified (structured format)") + + # Verify the response contains expected data + assert hasattr(result, "contents"), "Result should have contents" + if result.contents and len(result.contents) > 0: + print(f"[PASS] Response contains {len(result.contents)} content(s)") + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_return_raw_json_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py new file mode 100644 index 000000000000..1118f00c20c5 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py @@ -0,0 +1,230 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_analyze_url_async.py + +DESCRIPTION: + These tests validate the sample_analyze_url.py sample code (async version). + +USAGE: + pytest test_sample_analyze_url_async.py +""" + +import os +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import AnalyzeInput + + +class TestSampleAnalyzeUrlAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_analyze_url.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_url_async(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing a document from URL (async version). + + This test validates: + 1. URL validation + 2. Document analysis using begin_analyze with URL input + 3. Markdown content extraction + 4. Document properties (MIME type, pages, tables) + + 02_AnalyzeUrl.AnalyzeUrlAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Use a publicly accessible URL for testing + # In production, this would be a real URL to a document + # For testing, we'll use binary data instead since file:// URLs are not supported + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + # Read file as binary data (since test proxy doesn't support file:// URLs) + with open(file_path, "rb") as f: + file_data = f.read() + + print(f"[PASS] Document loaded from: {file_path}") + + # Analyze the document + poller = await client.begin_analyze( + analyzer_id="prebuilt-documentSearch", + inputs=[AnalyzeInput(data=file_data)] + ) + + result = await poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + + # Verify raw response + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_initial_response'): + raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if raw_response: + if hasattr(raw_response, 'http_response'): + status = raw_response.http_response.status_code + elif hasattr(raw_response, 'status_code'): + status = raw_response.status_code + else: + status = None + + if status: + assert status >= 200 and status < 300, \ + f"Response status should be successful (200-299), but was {status}" + print(f"[PASS] Raw response verified (status: {status})") + + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, "contents"), "Result should have contents attribute" + assert result.contents is not None, "Result contents should not be null" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Test markdown extraction + self._test_markdown_extraction(result) + + # Test document properties access + self._test_document_properties(result) + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_url_async assertions passed") + + def _test_markdown_extraction(self, result): + """Test markdown content extraction.""" + assert result.contents is not None, "Result should contain contents" + assert len(result.contents) > 0, "Result should have at least one content" + assert len(result.contents) == 1, "PDF file should have exactly one content element" + + content = result.contents[0] + assert content is not None, "Content should not be null" + + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + assert markdown.strip(), "Markdown content should not be just whitespace" + print(f"[PASS] Markdown content extracted successfully ({len(markdown)} characters)") + else: + print("[WARN] No markdown content available") + + def _test_document_properties(self, result): + """Test document property access.""" + content = result.contents[0] + assert content is not None, "Content should not be null for document properties validation" + + content_type = type(content).__name__ + print(f"[INFO] Content type: {content_type}") + + is_document_content = hasattr(content, 'mime_type') and hasattr(content, 'start_page_number') + if not is_document_content: + print(f"[WARN] Expected DocumentContent but got {content_type}, skipping document-specific validations") + return + + # Validate MIME type + mime_type = getattr(content, "mime_type", None) + if mime_type: + assert isinstance(mime_type, str), "MIME type should be a string" + assert mime_type.strip(), "MIME type should not be empty" + assert mime_type == "application/pdf", f"MIME type should be application/pdf, but was {mime_type}" + print(f"[PASS] MIME type verified: {mime_type}") + + # Validate page numbers + start_page = getattr(content, "start_page_number", None) + if start_page is not None: + assert start_page >= 1, f"Start page should be >= 1, but was {start_page}" + + end_page = getattr(content, "end_page_number", None) + if end_page is not None: + assert end_page >= start_page, f"End page {end_page} should be >= start page {start_page}" + total_pages = end_page - start_page + 1 + assert total_pages > 0, f"Total pages should be positive, but was {total_pages}" + print(f"[PASS] Page range verified: {start_page} to {end_page} ({total_pages} pages)") + + pages = getattr(content, "pages", None) + if pages and len(pages) > 0: + assert len(pages) > 0, "Pages collection should not be empty when not null" + assert len(pages) == total_pages, \ + f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" + print(f"[PASS] Pages collection verified: {len(pages)} pages") + self._validate_pages(pages, start_page, end_page, content) + else: + print("[WARN] No pages collection available in document content") + + tables = getattr(content, "tables", None) + if tables and len(tables) > 0: + self._validate_tables(tables) + else: + print("No tables found in document content") + + print("[PASS] All document properties validated successfully") + + def _validate_pages(self, pages, start_page, end_page, content=None): + """Validate pages collection details.""" + page_numbers = set() + unit = getattr(content, 'unit', None) if content else None + unit_str = str(unit) if unit else "units" + + for page in pages: + assert page is not None, "Page object should not be null" + assert hasattr(page, "page_number"), "Page should have page_number attribute" + assert page.page_number >= 1, f"Page number should be >= 1, but was {page.page_number}" + assert start_page <= page.page_number <= end_page, \ + f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" + + assert hasattr(page, "width") and page.width > 0, \ + f"Page {page.page_number} width should be > 0, but was {page.width}" + assert hasattr(page, "height") and page.height > 0, \ + f"Page {page.page_number} height should be > 0, but was {page.height}" + + assert page.page_number not in page_numbers, \ + f"Page number {page.page_number} appears multiple times" + page_numbers.add(page.page_number) + + print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") + + print(f"[PASS] All {len(pages)} pages validated successfully") + + def _validate_tables(self, tables): + """Validate tables collection details.""" + assert len(tables) > 0, "Tables collection should not be empty when not null" + print(f"[PASS] Tables collection verified: {len(tables)} tables") + + for i, table in enumerate(tables, 1): + assert table is not None, f"Table {i} should not be null" + assert hasattr(table, "row_count"), f"Table {i} should have row_count attribute" + assert hasattr(table, "column_count"), f"Table {i} should have column_count attribute" + assert table.row_count > 0, f"Table {i} should have at least 1 row, but had {table.row_count}" + assert table.column_count > 0, f"Table {i} should have at least 1 column, but had {table.column_count}" + + if hasattr(table, "cells") and table.cells: + assert len(table.cells) > 0, f"Table {i} cells collection should not be empty when not null" + + for cell in table.cells: + assert cell is not None, "Table cell should not be null" + assert hasattr(cell, "row_index"), "Cell should have row_index" + assert hasattr(cell, "column_index"), "Cell should have column_index" + assert 0 <= cell.row_index < table.row_count, \ + f"Cell row index {cell.row_index} should be within table row count {table.row_count}" + assert 0 <= cell.column_index < table.column_count, \ + f"Cell column index {cell.column_index} should be within table column count {table.column_count}" + + if hasattr(cell, "row_span"): + assert cell.row_span >= 1, f"Cell row span should be >= 1, but was {cell.row_span}" + if hasattr(cell, "column_span"): + assert cell.column_span >= 1, f"Cell column span should be >= 1, but was {cell.column_span}" + + print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)") + else: + print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py new file mode 100644 index 000000000000..d8bfa324e450 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py @@ -0,0 +1,138 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_configure_defaults_async.py + +DESCRIPTION: + These tests validate the sample_configure_defaults.py sample code (async version). + +USAGE: + pytest test_sample_configure_defaults_async.py +""" + +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync + + +class TestSampleConfigureDefaultsAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_configure_defaults.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_configure_defaults_async(self, azure_content_understanding_endpoint: str) -> None: + """Test configuring and getting model deployment defaults (async version). + + This test validates: + 1. Optional model deployment configuration (UpdateDefaults) + 2. Getting current defaults (GetDefaults) + 3. Model deployment mappings structure + + 00_ConfigureDefaults.ConfigureDefaultsAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Test UpdateDefaults - only if deployment names are provided + await self._test_update_defaults(client) + + # Test GetDefaults - always run + await self._test_get_defaults(client) + + await client.close() + print("\n[SUCCESS] All test_sample_configure_defaults_async assertions passed") + + async def _test_update_defaults(self, client): + """Test updating model deployment defaults. + + + """ + # Check if deployment names are configured in environment + # In Python tests, these would come from environment variables or test configuration + # For now, we'll check if the deployments are configured + + try: + # Get current defaults to check structure + response = await client.get_defaults() + current_defaults = response + + # Verify the response structure exists + assert current_defaults is not None, "GetDefaults response should not be null" + + # Check if model_deployments attribute exists + model_deployments = getattr(current_defaults, "model_deployments", None) + + if model_deployments and len(model_deployments) > 0: + print(f"[PASS] UpdateDefaults: Model deployments already configured ({len(model_deployments)} models)") + + # Validate structure of existing deployments + assert isinstance(model_deployments, dict), "Model deployments should be a dictionary" + + for key, value in model_deployments.items(): + assert isinstance(key, str) and key.strip(), f"Model key should be non-empty string, got {key}" + assert isinstance(value, str) and value.strip(), f"Deployment value should be non-empty string for key {key}" + print(f" {key} → {value}") + else: + print("[WARN] UpdateDefaults: No model deployments configured (this is optional)") + + except Exception as e: + # If update_defaults is not available or fails, that's okay + print(f"[WARN] UpdateDefaults: Skipping - {str(e)}") + + async def _test_get_defaults(self, client): + """Test getting current model deployment defaults. + + and assertions + """ + # Get current defaults + get_response = await client.get_defaults() + + # Assertion: Verify response is not null + assert get_response is not None, "GetDefaults response should not be null" + print("[PASS] GetDefaults: Successfully retrieved defaults") + + # Get the defaults object + defaults = get_response + + # Assertion: Verify defaults object + assert defaults is not None, "Defaults object should not be null" + + # Check model deployments attribute + model_deployments = getattr(defaults, "model_deployments", None) + + if model_deployments: + # Assertion: Verify model_deployments structure + assert isinstance(model_deployments, dict), \ + "model_deployments should be a dictionary" + + if len(model_deployments) > 0: + print(f"[PASS] Current model deployment mappings ({len(model_deployments)} models):") + + # Assertion: Validate each deployment mapping + for key, value in model_deployments.items(): + assert isinstance(key, str), f"Model key should be string, got {type(key)}" + assert key.strip(), "Model key should not be empty or whitespace" + assert isinstance(value, str), f"Deployment value should be string for key {key}, got {type(value)}" + assert value.strip(), f"Deployment value should not be empty for key {key}" + print(f" {key} → {value}") + + # Assertion: Check for expected model keys (if any configured) + # Common models: gpt-4.1, gpt-4.1-mini, text-embedding-3-large + expected_keys = {"gpt-4.1", "gpt-4.1-mini", "text-embedding-3-large"} + found_keys = set(model_deployments.keys()) + + if found_keys & expected_keys: # If any expected keys are present + common_keys = found_keys & expected_keys + print(f"[PASS] Found expected model keys: {', '.join(sorted(common_keys))}") + else: + print(" No model deployments configured yet (this is valid)") + else: + # No model deployments is a valid state + print(" No model deployments configured yet (model_deployments attribute not present)") + + print("[PASS] GetDefaults: All assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py new file mode 100644 index 000000000000..113919d9b2d6 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py @@ -0,0 +1,210 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_copy_analyzer_async.py + +DESCRIPTION: + These tests validate the sample_copy_analyzer.py sample code (async version). + +USAGE: + pytest test_sample_copy_analyzer_async.py +""" + +import uuid +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod +) + + +class TestSampleCopyAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_copy_analyzer.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_copy_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: + """Test copying an analyzer (within same resource or across resources) (async version). + + This test validates: + 1. Creating a source analyzer with complex configuration + 2. Initiating a copy operation + 3. Verifying the copy completed successfully + 4. Validating the target analyzer has the same configuration + + 14_CopyAnalyzer.CopyAnalyzerAsync() + + Note: This test requires copy API support. If not available, test will be skipped. + """ + # Skip this test if API is not available + try: + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Generate unique analyzer IDs for this test + source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex}" + target_analyzer_id = f"test_analyzer_target_{uuid.uuid4().hex}" + + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") + print(f"[INFO] Target analyzer ID: {target_analyzer_id}") + + assert source_analyzer_id is not None, "Source analyzer ID should not be null" + assert len(source_analyzer_id) > 0, "Source analyzer ID should not be empty" + assert target_analyzer_id is not None, "Target analyzer ID should not be null" + assert len(target_analyzer_id) > 0, "Target analyzer ID should not be empty" + assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" + print("[PASS] Analyzer IDs verified") + + # Step 1: Create the source analyzer with complex configuration + source_config = ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True + ) + + # Verify source config + assert source_config is not None, "Source config should not be null" + assert source_config.enable_formula is False, "EnableFormula should be false" + assert source_config.enable_layout is True, "EnableLayout should be true" + assert source_config.enable_ocr is True, "EnableOcr should be true" + assert source_config.estimate_field_source_and_confidence is True, "EstimateFieldSourceAndConfidence should be true" + assert source_config.return_details is True, "ReturnDetails should be true" + print("[PASS] Source config verified") + + # Create field schema + source_field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company" + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document" + ) + } + ) + + # Verify field schema + assert source_field_schema is not None, "Source field schema should not be null" + assert source_field_schema.name == "company_schema", "Field schema name should match" + assert source_field_schema.description == "Schema for extracting company information", "Field schema description should match" + assert len(source_field_schema.fields) == 2, "Should have 2 fields" + print(f"[PASS] Source field schema verified: {source_field_schema.name}") + + # Verify individual fields + assert "company_name" in source_field_schema.fields, "Should contain company_name field" + company_name_field = source_field_schema.fields["company_name"] + assert company_name_field.type == ContentFieldType.STRING, "company_name should be String type" + assert company_name_field.method == GenerationMethod.EXTRACT, "company_name should use Extract method" + print("[PASS] company_name field verified") + + assert "total_amount" in source_field_schema.fields, "Should contain total_amount field" + total_amount_field = source_field_schema.fields["total_amount"] + assert total_amount_field.type == ContentFieldType.NUMBER, "total_amount should be Number type" + assert total_amount_field.method == GenerationMethod.EXTRACT, "total_amount should use Extract method" + print("[PASS] total_amount field verified") + + # Create source analyzer + source_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for copying", + config=source_config, + field_schema=source_field_schema, + models={ + "completion": "gpt-4.1" + }, + tags={ + "modelType": "in_development" + } + ) + + # Create the source analyzer + create_poller = await client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=source_analyzer, + allow_replace=True + ) + source_result = await create_poller.result() + print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") + + # Step 2: Copy the analyzer + # Note: Copy API may require authorization token for cross-resource copying + # For same-resource copying, no authorization is needed + print(f"\n[INFO] Attempting to copy analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'") + + # Check if copy_analyzer API exists + if not hasattr(client, 'begin_copy_analyzer') and not hasattr(client, 'copy_analyzer'): + pytest.skip("Copy analyzer API not available") + + # Try to copy (this may not be implemented yet) + try: + if hasattr(client, 'begin_copy_analyzer'): + # begin_copy_analyzer requires: + # - analyzer_id: target analyzer ID + # - source_analyzer_id: source analyzer ID (as keyword arg) + copy_poller = await client.begin_copy_analyzer( # type: ignore + analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id + ) + copy_result = await copy_poller.result() # type: ignore + print(f"[PASS] Analyzer copied successfully to '{target_analyzer_id}'") + else: + print("[INFO] Copy analyzer API not yet implemented in Python SDK") + pytest.skip("Copy analyzer API not yet implemented") + + except Exception as copy_error: + error_msg = str(copy_error).lower() + if "not found" in error_msg or "not implemented" in error_msg or "not supported" in error_msg: + print(f"[INFO] Copy API not available: {str(copy_error)[:100]}") + pytest.skip(f"Copy analyzer API not available: {str(copy_error)[:100]}") + raise + + print("\n[SUCCESS] All test_sample_copy_analyzer_async assertions passed") + print("[INFO] Copy analyzer functionality demonstrated") + + except Exception as e: + error_msg = str(e).lower() + if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: + pytest.skip(f"API not available: {str(e)[:100]}") + raise + finally: + # Clean up: delete test analyzers + try: + if 'source_analyzer_id' in locals() and 'client' in locals(): + await client.delete_analyzer(analyzer_id=source_analyzer_id) # type: ignore + print(f"\n[INFO] Source analyzer deleted: {source_analyzer_id}") # type: ignore + except Exception as cleanup_error: + print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") + + try: + if 'target_analyzer_id' in locals() and 'client' in locals(): + # Only try to delete if copy succeeded + if 'copy_result' in locals(): + await client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore + print(f"[INFO] Target analyzer deleted: {target_analyzer_id}") # type: ignore + except Exception as cleanup_error: + print(f"[WARN] Could not delete target analyzer: {str(cleanup_error)[:100]}") + + try: + if 'client' in locals(): + await client.close() + except Exception: + pass diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py new file mode 100644 index 000000000000..4301e2443a14 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py @@ -0,0 +1,171 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_create_analyzer_async.py + +DESCRIPTION: + These tests validate the sample_create_analyzer.py sample code (async version). + +USAGE: + pytest test_sample_create_analyzer_async.py +""" + +import pytest +import uuid +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldDefinition, + ContentFieldSchema, +) + + +class TestSampleCreateAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_create_analyzer.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_create_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: + """Test creating a custom analyzer with field schema (async version). + + This test validates: + 1. Analyzer ID generation + 2. Field schema definition with multiple field types + 3. Analyzer configuration + 4. Model mappings + 5. Analyzer creation operation + + 04_CreateAnalyzer.CreateAnalyzerAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Generate a unique analyzer ID + analyzer_id = f"test_custom_analyzer_{uuid.uuid4().hex[:16]}" + assert analyzer_id and analyzer_id.strip(), "Analyzer ID should not be empty" + print(f"[PASS] Analyzer ID generated: {analyzer_id}") + + # Define field schema with custom fields + # This example demonstrates three extraction methods: + # - extract: Literal text extraction + # - generate: AI-generated values based on content interpretation + # - classify: Classification against predefined categories + field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type="string", + method="extract", + description="Name of the company" + ), + "total_amount": ContentFieldDefinition( + type="number", + method="extract", + description="Total amount on the document" + ), + "document_summary": ContentFieldDefinition( + type="string", + method="generate", + description="A brief summary of the document content" + ), + "document_type": ContentFieldDefinition( + type="string", + method="classify", + description="Type of document", + enum=["invoice", "receipt", "contract", "report", "other"] + ) + } + ) + + # Validate field schema + assert field_schema and field_schema.fields, "Field schema should have fields" + assert len(field_schema.fields) == 4, "Field schema should have 4 fields" + assert field_schema.name == "company_schema", "Field schema name should match" + print(f"[PASS] Field schema defined with {len(field_schema.fields)} fields") + + # Validate each field definition + for field_name, field_def in field_schema.fields.items(): + assert field_def.type and field_def.method and field_def.description, \ + f"Field {field_name} should have type, method, and description" + assert field_def.method in ["extract", "generate", "classify"], \ + f"Field {field_name} method should be valid" + + # Verify enum for classify field + document_type_field = field_schema.fields["document_type"] + assert document_type_field.enum and len(document_type_field.enum) == 5, \ + "Document type should have 5 enum values" + print("[PASS] Field definitions validated") + + # Create analyzer configuration + config = ContentAnalyzerConfig( + enable_formula=True, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True + ) + + assert config.enable_formula and config.enable_layout and config.enable_ocr, \ + "Core features should be enabled" + print("[PASS] Analyzer configuration created") + + # Create custom analyzer definition + custom_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom analyzer for extracting company information", + config=config, + field_schema=field_schema, + models={ + "completion": "gpt-4.1", + "embedding": "text-embedding-3-large" + } + ) + + assert custom_analyzer.base_analyzer_id == "prebuilt-document", \ + "Base analyzer should be prebuilt-document" + assert custom_analyzer.models and len(custom_analyzer.models) >= 2, \ + "Should have at least 2 model mappings" + print("[PASS] Custom analyzer definition validated") + + # Create the analyzer + try: + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=custom_analyzer + ) + result = await poller.result() + + # Verify operation completed + assert poller.done(), "Operation should be completed" + print(f"[PASS] Analyzer '{analyzer_id}' created successfully") + + # Verify result properties if available + if result: + result_id = getattr(result, "analyzer_id", None) or getattr(result, "id", None) + if result_id: + assert result_id == analyzer_id, "Result analyzer ID should match" + print(f"[PASS] Result analyzer ID verified: {result_id}") + + except Exception as e: + error_msg = str(e) + print(f"\n[ERROR] Analyzer creation failed: {error_msg}") + pytest.skip(f"Analyzer creation not available: {error_msg[:100]}") + finally: + # Cleanup: Delete the analyzer + try: + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"[PASS] Cleanup: Analyzer '{analyzer_id}' deleted") + except Exception as e: + print(f"[WARN] Cleanup failed: {str(e)}") + + await client.close() + + print("\n[SUCCESS] All test_sample_create_analyzer_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py new file mode 100644 index 000000000000..1a1722aa6e76 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py @@ -0,0 +1,138 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_create_classifier_async.py + +DESCRIPTION: + These tests validate the sample_create_classifier.py sample code (async version). + +USAGE: + pytest test_sample_create_classifier_async.py +""" + +import pytest +import uuid +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentCategory, +) + + +class TestSampleCreateClassifierAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_create_classifier.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_create_classifier_async(self, azure_content_understanding_endpoint: str) -> None: + """Test creating a custom classifier with content categories (async version). + + This test validates: + 1. Content categories definition + 2. Analyzer configuration with segmentation + 3. Classifier creation + + 05_CreateClassifier.CreateClassifierAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Generate a unique analyzer ID + analyzer_id = f"test_classifier_{uuid.uuid4().hex[:16]}" + + print(f"[PASS] Classifier ID generated: {analyzer_id}") + + # Define content categories for classification using ContentCategory objects + categories = { + "Loan_Application": ContentCategory( + description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." + ), + "Invoice": ContentCategory( + description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." + ), + "Bank_Statement": ContentCategory( + description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." + ) + } + + # Assertions for categories + assert categories is not None, "Categories should not be null" + assert len(categories) == 3, "Should have 3 categories" + print(f"[PASS] Content categories defined: {len(categories)} categories") + + # Validate each category has description + for cat_name, cat_def in categories.items(): + assert cat_def.description is not None, f"Category {cat_name} should have description" + assert cat_def.description.strip(), f"Category {cat_name} description should not be empty" + + print("[PASS] All category definitions validated") + + # Create analyzer configuration using ContentAnalyzerConfig model + config = ContentAnalyzerConfig( + return_details=True, + enable_segment=True, # Enable automatic segmentation by category + content_categories=categories + ) + + # Assertions for config + assert config is not None, "Config should not be null" + assert config.enable_segment is True, "Segmentation should be enabled" + assert config.content_categories is not None, "Config should have content categories" + assert len(config.content_categories) == 3, "Config should have 3 content categories" + print("[PASS] Classifier configuration created") + + # Create the classifier analyzer using ContentAnalyzer model + classifier = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom classifier for financial document categorization", + config=config, + models={ + "completion": "gpt-4.1" + } + ) + + # Assertions for classifier + assert classifier is not None, "Classifier should not be null" + assert classifier.base_analyzer_id == "prebuilt-document", \ + "Base analyzer should be prebuilt-document" + assert classifier.models is not None, "Classifier should have models" + assert "completion" in classifier.models, "Classifier should have completion model" + print("[PASS] Classifier definition validated") + + # Create the classifier + try: + poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=classifier + ) + + result = await poller.result() + + # Assertions + assert poller is not None, "Create classifier operation should not be null" + assert poller.done(), "Operation should be completed" + print(f"[PASS] Classifier '{analyzer_id}' created successfully") + + assert result is not None, "Create classifier result should not be null" + print("[PASS] Create classifier result validated") + + # Cleanup + try: + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"[PASS] Cleanup: Classifier '{analyzer_id}' deleted") + except Exception as e: + print(f"[WARN] Cleanup failed: {str(e)}") + except Exception as e: + error_msg = str(e) + print(f"\n[ERROR] Full error message:\n{error_msg}") + pytest.skip(f"Classifier creation not available or failed: {error_msg[:100]}") + + await client.close() + print("\n[SUCCESS] All test_sample_create_classifier_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py new file mode 100644 index 000000000000..f358662a61dd --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py @@ -0,0 +1,176 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_delete_analyzer_async.py + +DESCRIPTION: + These tests validate the sample_delete_analyzer.py sample code (async version). + +USAGE: + pytest test_sample_delete_analyzer_async.py +""" + +import uuid +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import ContentAnalyzer, ContentAnalyzerConfig +from azure.core.exceptions import ResourceNotFoundError + + +class TestSampleDeleteAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_delete_analyzer.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_delete_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: + """Test deleting an analyzer (async version). + + This test validates: + 1. Creating a simple analyzer + 2. Verifying the analyzer exists + 3. Deleting the analyzer + 4. Verifying deletion was successful + + 09_DeleteAnalyzer.DeleteAnalyzerAsync() + """ + # Skip this test if API is not available + try: + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Generate unique analyzer ID for this test + analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" + print(f"[INFO] Analyzer ID generated: {analyzer_id}") + + # Create a simple analyzer + analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Simple analyzer for deletion example", + config=ContentAnalyzerConfig( + return_details=True + ), + models={ + "completion": "gpt-4.1" + } + ) + + # Assertions for analyzer object + assert analyzer is not None, "Analyzer object should not be null" + assert analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" + assert analyzer.description == "Simple analyzer for deletion example", "Description should match" + assert analyzer.config is not None, "Config should not be null" + assert analyzer.config.return_details is True, "ReturnDetails should be true" + assert analyzer.models is not None, "Models should not be null" + assert "completion" in analyzer.models, "Should have completion model" + assert analyzer.models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" + print("[PASS] Analyzer object configured correctly") + + # Create the analyzer + create_poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=analyzer, + allow_replace=True + ) + create_result = await create_poller.result() + print(f"[PASS] Analyzer '{analyzer_id}' created successfully") + + # Verify the analyzer was created successfully + get_response = await client.get_analyzer(analyzer_id=analyzer_id) + + # Assertions for get response + assert get_response is not None, "Get analyzer response should not be null" + print("[PASS] Analyzer retrieved successfully after creation") + + # Verify analyzer properties + created_base_id = getattr(get_response, 'base_analyzer_id', None) + assert created_base_id is not None, "Base analyzer ID should not be null" + assert created_base_id == "prebuilt-document", "Base analyzer ID should match" + print(f"[PASS] Base analyzer ID verified: {created_base_id}") + + created_description = getattr(get_response, 'description', None) + assert created_description is not None, "Description should not be null" + assert created_description == "Simple analyzer for deletion example", "Description should match" + print(f"[PASS] Description verified: '{created_description}'") + + # Verify config + created_config = getattr(get_response, 'config', None) + if created_config is not None: + print("[INFO] Config exists") + return_details = getattr(created_config, 'return_details', None) + if return_details is not None: + assert return_details is True, "ReturnDetails should be true" + print(f"[PASS] ReturnDetails: {return_details}") + + # Verify models + created_models = getattr(get_response, 'models', None) + if created_models is not None: + assert len(created_models) >= 1, "Should have at least 1 model" + print(f"[PASS] Models verified: {len(created_models)} model(s)") + + if "completion" in created_models: + assert created_models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" + print(f"[PASS] completion: {created_models['completion']}") + + print(f"[PASS] Verified analyzer '{analyzer_id}' exists and is correctly configured before deletion") + + # Delete the analyzer + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"[PASS] Analyzer '{analyzer_id}' deleted successfully") + + # Verify the analyzer was deleted by trying to get it + print(f"[INFO] Attempting to verify deletion of analyzer '{analyzer_id}'...") + + deletion_verified = False + status_code = None + error_message = None + + try: + deleted_response = await client.get_analyzer(analyzer_id=analyzer_id) + + # If we reach here, the call succeeded which is unexpected + print("[WARN] Unexpected: Get analyzer call succeeded after deletion") + raw_response = getattr(deleted_response, '_response', None) + if raw_response: + status_code = getattr(raw_response, 'status_code', None) + print(f"[WARN] Response status: {status_code}") + + if deleted_response is not None: + analyzer_id_attr = getattr(deleted_response, 'analyzer_id', None) + description_attr = getattr(deleted_response, 'description', None) + print(f"[WARN] Analyzer ID: {analyzer_id_attr or '(null)'}") + print(f"[WARN] Description: {description_attr or '(null)'}") + + except ResourceNotFoundError as e: + # Expected: analyzer should not be found + deletion_verified = True + status_code = getattr(e, 'status_code', 404) + error_message = str(e) + print(f"[PASS] Expected error received: Analyzer not found") + print(f"[PASS] Status code: {status_code}") + print(f"[PASS] Error message: {error_message[:100]}{'...' if len(error_message) > 100 else ''}") + + except Exception as e: + # Some other error occurred + print(f"[WARN] Unexpected error during verification: {str(e)[:100]}") + # Still consider it verified if we got an error trying to get it + deletion_verified = True + error_message = str(e) + + # Final assertions + assert deletion_verified, "Deletion should be verified (analyzer not found after deletion)" + print(f"[PASS] Deletion verified: Analyzer '{analyzer_id}' is no longer accessible") + + await client.close() + print("\n[SUCCESS] All test_sample_delete_analyzer_async assertions passed") + + except Exception as e: + error_msg = str(e).lower() + if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: + pytest.skip(f"API not available: {str(e)[:100]}") + raise diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py new file mode 100644 index 000000000000..205313a32bcb --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py @@ -0,0 +1,112 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_delete_result_async.py + +DESCRIPTION: + These tests validate the sample_delete_result.py sample code (async version). + +USAGE: + pytest test_sample_delete_result_async.py +""" + +import os +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync + + +class TestSampleDeleteResultAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_delete_result.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_delete_result_async(self, azure_content_understanding_endpoint: str) -> None: + """Test deleting an analysis result (async version). + + This test validates: + 1. Document analysis to create a result + 2. Extracting result ID + 3. Deleting the result + + 13_DeleteResult.DeleteResultAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # First, analyze a document to create a result + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + + assert os.path.exists(file_path), f"Sample file not found at {file_path}" + print(f"[PASS] Sample file exists: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + assert len(file_bytes) > 0, "File should not be empty" + print(f"[PASS] File loaded: {len(file_bytes)} bytes") + + # Analyze to get a result ID + poller = await client.begin_analyze_binary( + analyzer_id="prebuilt-documentSearch", + binary_input=file_bytes, + content_type="application/pdf" + ) + + result = await poller.result() + + # Assertions for analysis + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + assert result is not None, "Analysis result should not be null" + print("[PASS] Analysis completed successfully") + + # Extract operation ID from the poller + # The operation ID is needed to delete the result + operation_id = None + try: + # Extract operation ID from polling URL + if hasattr(poller, '_polling_method'): + polling_method = getattr(poller, '_polling_method', None) + if polling_method and hasattr(polling_method, '_operation'): + operation = getattr(polling_method, '_operation', None) # type: ignore + if operation and hasattr(operation, 'get_polling_url'): + polling_url = operation.get_polling_url() # type: ignore + # Extract operation ID from URL (last segment before query string) + operation_id = polling_url.split('/')[-1] + if '?' in operation_id: + operation_id = operation_id.split('?')[0] + except Exception as e: + print(f"[WARN] Could not extract operation ID: {str(e)[:100]}") + + # Assertion: Verify we have an operation ID + if operation_id: + assert operation_id is not None, "Operation ID should not be null" + assert isinstance(operation_id, str), "Operation ID should be a string" + assert operation_id.strip(), "Operation ID should not be empty" + print(f"[PASS] Operation ID extracted: {operation_id[:50]}...") + + # Delete the result + try: + await client.delete_result(operation_id=operation_id) + print(f"[PASS] Result deleted successfully (operation ID: {operation_id[:50]}...)") + print("[INFO] Deletion success verified by no exception thrown") + except Exception as e: + error_msg = str(e) + # Some implementations might not support result deletion or result might auto-expire + if "not found" in error_msg.lower() or "404" in error_msg: + print(f"[INFO] Result already deleted or not found: {error_msg[:100]}") + else: + print(f"[WARN] Delete result failed: {error_msg[:100]}") + else: + print("[INFO] Operation ID not available in response") + print("[INFO] Delete result operation skipped - operation ID extraction not supported") + + await client.close() + print("\n[SUCCESS] All test_sample_delete_result_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py new file mode 100644 index 000000000000..e2973812b599 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py @@ -0,0 +1,120 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_get_analyzer_async.py + +DESCRIPTION: + These tests validate the sample_get_analyzer.py sample code (async version). + +USAGE: + pytest test_sample_get_analyzer_async.py +""" + +import json +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync + + +class TestSampleGetAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_get_analyzer.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_get_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: + """Test getting information about a prebuilt analyzer (async version). + + This test validates: + 1. Getting analyzer information using get_analyzer + 2. Analyzer response structure + 3. Analyzer JSON serialization + + 06_GetAnalyzer.GetPrebuiltAnalyzerAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Get information about a prebuilt analyzer + response = await client.get_analyzer(analyzer_id="prebuilt-documentSearch") + + # Assertions + assert response is not None, "Response should not be null" + print("[PASS] Get analyzer response received") + + analyzer = response + assert analyzer is not None, "Analyzer should not be null" + print("[PASS] Analyzer object is not null") + + # Verify basic analyzer properties for prebuilt-documentSearch + if hasattr(analyzer, 'base_analyzer_id'): + base_id = getattr(analyzer, 'base_analyzer_id', None) + if base_id: + print(f"[INFO] Base analyzer ID: {base_id}") + + if hasattr(analyzer, 'description'): + description = getattr(analyzer, 'description', None) + if description: + print(f"[INFO] Description: {description[:100]}{'...' if len(description) > 100 else ''}") + + # Verify config if present + if hasattr(analyzer, 'config'): + config = getattr(analyzer, 'config', None) + if config: + print("[INFO] Analyzer has configuration") + if hasattr(config, 'enable_ocr'): + enable_ocr = getattr(config, 'enable_ocr', None) + if enable_ocr is not None: + print(f"[INFO] EnableOcr: {enable_ocr}") + if hasattr(config, 'enable_layout'): + enable_layout = getattr(config, 'enable_layout', None) + if enable_layout is not None: + print(f"[INFO] EnableLayout: {enable_layout}") + + # Verify models if present + if hasattr(analyzer, 'models'): + models = getattr(analyzer, 'models', None) + if models and len(models) > 0: + print(f"[INFO] Analyzer has {len(models)} model mapping(s)") + for key, value in list(models.items())[:5]: # Show first 5 + print(f"[INFO] {key}: {value}") + + # Verify analyzer can be serialized to JSON + try: + # Convert analyzer to dict and then to JSON + if hasattr(analyzer, '__dict__'): + analyzer_dict = analyzer.__dict__ + elif hasattr(analyzer, 'as_dict'): + analyzer_dict = analyzer.as_dict() # type: ignore + else: + analyzer_dict = {"analyzer": str(analyzer)} + + analyzer_json = json.dumps(analyzer_dict, indent=2, default=str) + + assert analyzer_json is not None, "Analyzer JSON should not be null" + assert len(analyzer_json) > 0, "Analyzer JSON should not be empty" + print(f"[PASS] Analyzer JSON serialized successfully ({len(analyzer_json)} characters)") + + # Verify JSON contains analyzer identifier + assert "documentSearch" in analyzer_json.lower() or "prebuilt" in analyzer_json.lower(), \ + "Analyzer JSON should contain analyzer identifier" + print("[PASS] Analyzer JSON contains expected identifiers") + print(f"[PASS] Analyzer JSON length: {len(analyzer_json)} characters") + + # Display formatted JSON (first 500 chars for brevity) + print("\n[INFO] Prebuilt-documentSearch Analyzer (preview):") + print(analyzer_json[:500] + "..." if len(analyzer_json) > 500 else analyzer_json) + + except Exception as e: + print(f"[WARN] Could not fully serialize analyzer to JSON: {str(e)[:100]}") + # Still verify basic properties + assert analyzer is not None, "Analyzer should not be null" + + print("\n[PASS] All prebuilt analyzer properties validated successfully") + + await client.close() + print("\n[SUCCESS] All test_sample_get_analyzer_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py new file mode 100644 index 000000000000..44bd675f0eb8 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py @@ -0,0 +1,152 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_get_result_file_async.py + +DESCRIPTION: + These tests validate the sample_get_result_file.py sample code (async version). + +USAGE: + pytest test_sample_get_result_file_async.py +""" + +import os +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import AnalyzeInput + + +class TestSampleGetResultFileAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_get_result_file.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_get_result_file_async(self, azure_content_understanding_endpoint: str) -> None: + """Test getting result files (like keyframe images) from analysis results (async version). + + This test validates: + 1. Starting video analysis operation + 2. Getting operation ID immediately after start + 3. Waiting for operation completion + 4. Retrieving keyframe images using get_result_file + + 12_GetResultFile.GetResultFileAsync() + + Note: This test uses document analysis as video analysis may not be available. + The API pattern is the same for both document and video analysis. + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Use document analysis for testing as video analysis may not be available + # The get_result_file API pattern is the same for both document and video + current_dir = os.path.dirname(os.path.abspath(__file__)) + test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") + document_path = os.path.join(test_data_dir, "sample_invoice.pdf") + + # Read the document file as binary data + with open(document_path, "rb") as f: + document_data = f.read() + + # Start the analysis operation (WaitUntil.Started equivalent) + poller = await client.begin_analyze( + analyzer_id="prebuilt-document", + inputs=[AnalyzeInput(data=document_data)] + ) + + # Get the operation ID from the poller (available after Started) + # Extract operation ID from the polling URL + polling_url = poller._polling_method._operation.get_polling_url() # type: ignore + operation_id = polling_url.split('/')[-1].split('?')[0] + + assert operation_id is not None, "Operation ID should not be null" + assert len(operation_id) > 0, "Operation ID should not be empty" + print(f"[PASS] Operation ID obtained: {operation_id}") + + # Verify operation ID format + assert ' ' not in operation_id, "Operation ID should not contain spaces" + print(f"[PASS] Operation ID length: {len(operation_id)} characters") + + print(f"[INFO] Operation started (ID: {operation_id})") + + # Wait for completion + result = await poller.result() + + # Verify operation completed + assert poller is not None, "Operation should not be null after waiting" + print("[PASS] Operation completed successfully") + + # Verify raw response + raw_response = getattr(poller, '_polling_method', None) + if raw_response: + initial_response = getattr(raw_response, '_initial_response', None) # type: ignore + if initial_response: + status = getattr(initial_response, 'status_code', None) + if status: + assert 200 <= status < 300, f"Response status should be successful, but was {status}" + print(f"[PASS] Response status: {status}") + + # Verify result + assert result is not None, "Analysis result should not be null" + assert hasattr(result, 'contents'), "Result should contain contents" + contents = getattr(result, 'contents', None) + assert contents is not None and len(contents) > 0, "Result should have at least one content" + print(f"[PASS] Analysis result contains {len(contents)} content(s)") + + print(f"\n[INFO] Operation verification completed:") + print(f" Operation ID: {operation_id}") + print(f" Status: Completed") + print(f" Contents: {len(contents)}") + + # Demonstrate get_result_file API usage + # Note: For video analysis, this would retrieve keyframe images + # For document analysis, result files may not be available + print("\n[INFO] Demonstrating get_result_file API pattern:") + print(f" Operation ID: {operation_id}") + print(" For video analysis with keyframes:") + print(" - Keyframes are found in AudioVisualContent.key_frame_times_ms") + print(" - Path format: 'keyframes/{frameTimeMs}'") + print(" - Example: client.get_result_file(operation_id, 'keyframes/1000')") + + # Try to get a result file (this may not be available for document analysis) + try: + # Example path (would be actual keyframe path for video) + # For document analysis, this is just demonstrating the API + test_path = "keyframes/0" + + file_response = await client.get_result_file( + operation_id=operation_id, + path=test_path + ) + + if file_response: + # get_result_file returns AsyncIterator[bytes], need to collect the data + chunks = [] + async for chunk in file_response: + chunks.append(chunk) + file_data = b''.join(chunks) + print(f"[PASS] Result file retrieved ({len(file_data)} bytes)") + + # For video keyframes, you would save the image: + # with open(f"keyframe_{frame_time}.jpg", "wb") as f: + # f.write(file_data) + else: + print("[INFO] No result file available at test path (expected for document analysis)") + + except Exception as e: + error_msg = str(e).lower() + if "not found" in error_msg or "not available" in error_msg: + print("[INFO] Result files not available for this analysis type (expected)") + print(f"[INFO] This is normal for document analysis without video keyframes") + else: + print(f"[INFO] get_result_file returned: {str(e)[:100]}") + + await client.close() + print("\n[SUCCESS] All test_sample_get_result_file_async assertions passed") + print("[INFO] get_result_file API pattern demonstrated successfully") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py new file mode 100644 index 000000000000..6e73c02e1a8a --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py @@ -0,0 +1,371 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_grant_copy_auth_async.py + +DESCRIPTION: + These tests validate the sample_grant_copy_auth.py sample code (async version). + +USAGE: + pytest test_sample_grant_copy_auth_async.py +""" + +import os +import uuid +import pytest +from datetime import datetime, timezone +from typing import Optional, cast +from devtools_testutils import is_live +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.ai.contentunderstanding.models import ( + ContentAnalyzer, + ContentAnalyzerConfig, + ContentFieldSchema, + ContentFieldDefinition, + ContentFieldType, + GenerationMethod +) + + +class TestSampleGrantCopyAuthAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_grant_copy_auth.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_grant_copy_auth_async(self, azure_content_understanding_endpoint: str, **kwargs) -> None: + """Test granting copy authorization for cross-resource analyzer copying (async version). + + This test validates: + 1. Creating a source analyzer + 2. Granting copy authorization from source resource + 3. Using authorization to copy analyzer across resources + 4. Verifying the copied analyzer + """ + # Initialize variables for cleanup + source_analyzer_id: str = "" + target_analyzer_id: str = "" + source_client: Optional[ContentUnderstandingClient] = None + target_client: Optional[ContentUnderstandingClient] = None + + try: + # Get source and target resource information from environment + # For testing, we may use the same endpoint for both source and target + # In production, these would be different resources + source_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID") + source_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION") + target_endpoint = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", azure_content_understanding_endpoint) + target_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID") + target_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION") + target_key = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") + + # Only require environment variables in live mode + # In playback mode, the test proxy will replay recorded interactions + if is_live(): + if not source_resource_id: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID is required for cross-resource copy test in live mode") + if not source_region: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION is required for cross-resource copy test in live mode") + if not target_resource_id: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID is required for cross-resource copy test in live mode") + if not target_region: + raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION is required for cross-resource copy test in live mode") + else: + # In playback mode, use placeholder values - test proxy will use recorded values + source_resource_id = source_resource_id or "placeholder-source-resource-id" + source_region = source_region or "placeholder-source-region" + target_resource_id = target_resource_id or "placeholder-target-resource-id" + target_region = target_region or "placeholder-target-region" + + # Create clients + source_client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Create target client (may use different endpoint and credential) + from azure.core.credentials import AzureKeyCredential + from azure.identity.aio import DefaultAzureCredential + + if target_endpoint != azure_content_understanding_endpoint or target_key: + # Create target client with different endpoint/credential + target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() + target_client = cast( + ContentUnderstandingClient, + self.create_client_from_credential( + ContentUnderstandingClient, + credential=target_credential, + endpoint=target_endpoint, + ), + ) + else: + # Use same endpoint and credential as source + target_client = self.create_async_client(endpoint=target_endpoint) + + # Get variables from test proxy (for playback mode) or use defaults (for record mode) + variables = kwargs.pop("variables", {}) + + # Generate unique analyzer IDs for this test + # Use variables from recording if available (playback mode), otherwise generate new ones (record mode) + default_source_id = f"test_analyzer_source_{uuid.uuid4().hex[:16]}" + default_target_id = f"test_analyzer_target_{uuid.uuid4().hex[:16]}" + source_analyzer_id = variables.setdefault("grantCopySourceAnalyzerId", default_source_id) + target_analyzer_id = variables.setdefault("grantCopyTargetAnalyzerId", default_target_id) + + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") + print(f"[INFO] Target analyzer ID: {target_analyzer_id}") + + # Verify IDs + assert source_analyzer_id is not None, "Source analyzer ID should not be null" + assert source_analyzer_id.strip(), "Source analyzer ID should not be empty" + assert target_analyzer_id is not None, "Target analyzer ID should not be null" + assert target_analyzer_id.strip(), "Target analyzer ID should not be empty" + assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" + print("[PASS] Analyzer IDs verified") + + # Verify resource information (only in live mode) + # In playback mode, the test proxy will replay recorded interactions + if is_live(): + assert source_resource_id is not None, "Source resource ID should not be null" + assert source_resource_id.strip(), "Source resource ID should not be empty" + assert source_region is not None, "Source region should not be null" + assert source_region.strip(), "Source region should not be empty" + assert target_resource_id is not None, "Target resource ID should not be null" + assert target_resource_id.strip(), "Target resource ID should not be empty" + assert target_region is not None, "Target region should not be null" + assert target_region.strip(), "Target region should not be empty" + + assert target_endpoint is not None, "Target endpoint should not be null" + assert target_endpoint.strip(), "Target endpoint should not be empty" + + if is_live(): + print(f"[INFO] Source resource: {source_resource_id}") + print(f"[INFO] Source region: {source_region}") + print(f"[INFO] Target resource: {target_resource_id}") + print(f"[INFO] Target region: {target_region}") + print(f"[INFO] Target endpoint: {target_endpoint}") + + # Verify clients + assert source_client is not None, "Source client should not be null" + assert target_client is not None, "Target client should not be null" + print("[PASS] Source and target clients created") + + # Step 1: Create the source analyzer + source_config = ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True + ) + + # Verify source config + assert source_config is not None, "Source config should not be null" + assert source_config.enable_formula is False, "EnableFormula should be false" + assert source_config.enable_layout is True, "EnableLayout should be true" + assert source_config.enable_ocr is True, "EnableOcr should be true" + assert source_config.estimate_field_source_and_confidence is True, "EstimateFieldSourceAndConfidence should be true" + assert source_config.return_details is True, "ReturnDetails should be true" + print("[PASS] Source config verified") + + source_field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company" + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document" + ) + } + ) + + # Verify source field schema + assert source_field_schema is not None, "Source field schema should not be null" + assert source_field_schema.name == "company_schema", "Field schema name should match" + assert source_field_schema.description == "Schema for extracting company information", "Field schema description should match" + assert len(source_field_schema.fields) == 2, "Should have 2 fields" + assert "company_name" in source_field_schema.fields, "Should contain company_name field" + assert "total_amount" in source_field_schema.fields, "Should contain total_amount field" + print(f"[PASS] Source field schema verified: {source_field_schema.name} ({len(source_field_schema.fields)} fields)") + + source_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Source analyzer for cross-resource copying", + config=source_config, + field_schema=source_field_schema, + models={ + "completion": "gpt-4.1" + } + ) + + # Verify source analyzer object + assert source_analyzer is not None, "Source analyzer object should not be null" + assert source_analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" + assert source_analyzer.description == "Source analyzer for cross-resource copying", "Description should match" + assert source_analyzer.models is not None, "Models should not be null" + assert "completion" in source_analyzer.models, "Should have completion model" + assert source_analyzer.models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" + print("[PASS] Source analyzer object verified") + + # Create the source analyzer + create_poller = await source_client.begin_create_analyzer( + analyzer_id=source_analyzer_id, + resource=source_analyzer, + allow_replace=True + ) + await create_poller.result() # Wait for creation to complete + print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") + + # Get the full analyzer details after creation (LRO result doesn't contain full details) + source_result = await source_client.get_analyzer(analyzer_id=source_analyzer_id) + + # Verify create operation + assert source_result is not None, "Source analyzer result should not be null" + assert source_result.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" + assert source_result.description == "Source analyzer for cross-resource copying", "Description should match" + assert source_result.config is not None, "Config should not be null" + assert source_result.field_schema is not None, "Field schema should not be null" + assert len(source_result.field_schema.fields) == 2, "Should have 2 fields" + assert source_result.models is not None, "Models should not be null" + assert "completion" in source_result.models, "Should have completion model" + print(f"[PASS] Source analyzer created: '{source_analyzer_id}'") + print(f"[INFO] Base: {source_result.base_analyzer_id}") + print(f"[INFO] Fields: {len(source_result.field_schema.fields)}") + print(f"[INFO] Models: {len(source_result.models)}") + print("[INFO] Ready for cross-resource copy") + + # Step 2: Grant copy authorization from source resource + # Grant authorization on the source client for copying to the target resource + print(f"\n[INFO] Granting copy authorization from source resource") + + copy_auth = await source_client.grant_copy_authorization( + analyzer_id=source_analyzer_id, + target_azure_resource_id=target_resource_id, + target_region=target_region, + ) + + print("[PASS] Copy authorization granted successfully!") + + # Verify copy authorization response + assert copy_auth is not None, "Copy authorization response should not be null" + assert hasattr(copy_auth, 'target_azure_resource_id'), "Copy authorization should have target_azure_resource_id" + assert copy_auth.target_azure_resource_id is not None, "Target Azure resource ID should not be null" + assert copy_auth.target_azure_resource_id.strip(), "Target Azure resource ID should not be empty" + # In playback mode, compare against the recorded response value + # In live mode, compare against the environment variable + if is_live(): + assert copy_auth.target_azure_resource_id == target_resource_id, \ + f"Target resource ID should match, but got '{copy_auth.target_azure_resource_id}' instead of '{target_resource_id}'" + print(f"[PASS] Target Azure Resource ID verified: {copy_auth.target_azure_resource_id}") + print(f"[INFO] Target region (tracked): {target_region}") + else: + # In playback mode, just verify the response has a value (from recording) + print(f"[INFO] Target Azure Resource ID (from recording): {copy_auth.target_azure_resource_id}") + print(f"[INFO] Target region (from recording): {target_region}") + + # Verify expiration time + assert hasattr(copy_auth, 'expires_at'), "Copy authorization should have expires_at" + expires_at = copy_auth.expires_at + # Only verify expiration time in live/record mode, not in playback mode + # (recorded expiration times may be in the past during playback) + if is_live(): + now = datetime.now(timezone.utc) + + assert expires_at > now, \ + f"Expiration time should be in the future, but expires at {expires_at} (now: {now})" + + # Calculate time until expiration + time_until_expiration = expires_at - now + assert time_until_expiration.total_seconds() > 0, "Should have positive time until expiration" + + print(f"[PASS] Expiration time verified: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") + print(f"[INFO] Time until expiration: {time_until_expiration.total_seconds() / 60:.2f} minutes") + + if time_until_expiration.total_seconds() / 3600 < 24: + print("[WARN] Note: Authorization expires in less than 24 hours") + else: + print(f"[INFO] Expiration time: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC (from recorded response)") + + print(f"[INFO] Copy authorization granted successfully:") + print(f"[INFO] Source analyzer: {source_analyzer_id}") + print(f"[INFO] Target resource: {copy_auth.target_azure_resource_id}") + print(f"[INFO] Target region: {target_region}") + print(f"[INFO] Expires: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") + print("[INFO] Authorization ready for cross-resource copy") + + # Step 3: Copy analyzer using authorization + # Copy is performed on the target client, copying from source to target + print(f"\n[INFO] Copying analyzer from source to target") + + copy_poller = await target_client.begin_copy_analyzer( + analyzer_id=target_analyzer_id, + source_analyzer_id=source_analyzer_id, + source_azure_resource_id=source_resource_id, + source_region=source_region, + ) + copy_result = await copy_poller.result() + print(f"[PASS] Target analyzer '{target_analyzer_id}' copied successfully to target resource!") + + # Verify copy result + assert copy_result is not None, "Copy result should not be null" + if hasattr(copy_result, 'description'): + print(f"[INFO] Target analyzer description: {copy_result.description}") + + # Step 4: Verify the copied analyzer + copied_analyzer = await target_client.get_analyzer(analyzer_id=target_analyzer_id) + + assert copied_analyzer is not None, "Copied analyzer should not be null" + print("[PASS] Copied analyzer retrieved successfully") + + # Verify basic properties match + if hasattr(copied_analyzer, 'analyzer_id'): + assert copied_analyzer.analyzer_id == target_analyzer_id, "Analyzer ID should match" + print(f"[INFO] Target Analyzer ID: {copied_analyzer.analyzer_id}") + + copied_description = getattr(copied_analyzer, 'description', None) + assert copied_description == "Source analyzer for cross-resource copying", "Description should match" + print(f"[INFO] Description: {copied_description}") + + if hasattr(copied_analyzer, 'status'): + print(f"[INFO] Status: {copied_analyzer.status}") + + print("[PASS] Copied analyzer properties verified") + + print("\n[SUCCESS] All test_sample_grant_copy_auth_async assertions passed") + print("[INFO] Grant copy authorization functionality demonstrated") + + # Return variables to be recorded for playback mode + return variables + finally: + # Clean up: delete test analyzers + try: + if source_analyzer_id and source_client: + await source_client.delete_analyzer(analyzer_id=source_analyzer_id) # type: ignore[attr-defined] + print(f"\n[INFO] Source analyzer '{source_analyzer_id}' deleted successfully.") + except Exception as cleanup_error: + print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") + + try: + if target_analyzer_id and target_client: + await target_client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore[attr-defined] + print(f"[INFO] Target analyzer '{target_analyzer_id}' deleted successfully.") + except Exception as cleanup_error: + print(f"[WARN] Could not delete target analyzer: {str(cleanup_error)[:100]}") + + try: + if source_client: + await source_client.close() + if target_client and target_client != source_client: + await target_client.close() + except Exception: + pass diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py new file mode 100644 index 000000000000..ebc51a0043e8 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py @@ -0,0 +1,119 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_list_analyzers_async.py + +DESCRIPTION: + These tests validate the sample_list_analyzers.py sample code (async version). + +USAGE: + pytest test_sample_list_analyzers_async.py +""" + +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync + + +class TestSampleListAnalyzersAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_list_analyzers.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_list_analyzers_async(self, azure_content_understanding_endpoint: str) -> None: + """Test listing all available analyzers (async version). + + This test validates: + 1. Listing all analyzers using list_analyzers + 2. Counting prebuilt vs custom analyzers + 3. Displaying analyzer details + + 07_ListAnalyzers.ListAnalyzersAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # List all analyzers + analyzers = [] + async for analyzer in client.list_analyzers(): + analyzers.append(analyzer) + + # Assertions + assert analyzers is not None, "Analyzers list should not be null" + assert len(analyzers) > 0, "Should have at least one analyzer" + print(f"[PASS] Found {len(analyzers)} analyzer(s)") + + # Count prebuilt vs custom analyzers + prebuilt_count = sum(1 for a in analyzers + if hasattr(a, 'analyzer_id') and + getattr(a, 'analyzer_id', '').startswith('prebuilt-')) + custom_count = sum(1 for a in analyzers + if hasattr(a, 'analyzer_id') and + not getattr(a, 'analyzer_id', '').startswith('prebuilt-')) + + print(f"[INFO] Prebuilt analyzers: {prebuilt_count}") + print(f"[INFO] Custom analyzers: {custom_count}") + + # Verify counts + assert prebuilt_count >= 0, "Prebuilt count should be >= 0" + assert custom_count >= 0, "Custom count should be >= 0" + assert len(analyzers) == prebuilt_count + custom_count, "Total count should equal prebuilt + custom count" + print(f"[PASS] Count breakdown: {prebuilt_count} prebuilt, {custom_count} custom") + + # Verify we have some prebuilt analyzers + assert prebuilt_count > 0, "Should have at least one prebuilt analyzer" + print(f"[PASS] Prebuilt analyzers found: {prebuilt_count}") + + # Display details for first 10 analyzers (for test output brevity) + print("\n[INFO] Analyzer details (first 10):") + for i, analyzer in enumerate(analyzers[:10]): + analyzer_id = getattr(analyzer, 'analyzer_id', 'unknown') + description = getattr(analyzer, 'description', '(none)') + status = getattr(analyzer, 'status', 'unknown') + + print(f"\n [{i+1}] ID: {analyzer_id}") + if description and description != '(none)': + print(f" Description: {description[:80]}{'...' if len(description) > 80 else ''}") + else: + print(f" Description: (none)") + print(f" Status: {status}") + + if analyzer_id.startswith('prebuilt-'): + print(" Type: Prebuilt analyzer") + else: + print(" Type: Custom analyzer") + + if len(analyzers) > 10: + print(f"\n[INFO] ... and {len(analyzers) - 10} more analyzer(s)") + + # Verify each analyzer has required properties + valid_analyzers = 0 + analyzers_with_description = 0 + + for analyzer in analyzers: + assert hasattr(analyzer, 'analyzer_id'), "Analyzer should have analyzer_id property" + analyzer_id = getattr(analyzer, 'analyzer_id', None) + assert analyzer_id is not None, "Analyzer ID should not be null" + assert len(analyzer_id) > 0, "Analyzer ID should not be empty" + + # Verify analyzer ID format (should not contain spaces) + assert ' ' not in analyzer_id, f"Analyzer ID should not contain spaces: {analyzer_id}" + + valid_analyzers += 1 + + # Track optional properties + description = getattr(analyzer, 'description', None) + if description and len(str(description).strip()) > 0: + analyzers_with_description += 1 + + assert len(analyzers) == valid_analyzers, "All analyzers should have valid IDs" + print(f"\n[PASS] All {valid_analyzers} analyzers have valid IDs") + print(f"[INFO] Analyzers with description: {analyzers_with_description}") + + await client.close() + print("\n[SUCCESS] All test_sample_list_analyzers_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py new file mode 100644 index 000000000000..0c3d327c74f0 --- /dev/null +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py @@ -0,0 +1,169 @@ +# 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. +# -------------------------------------------------------------------------- + +""" +TEST FILE: test_sample_update_analyzer_async.py + +DESCRIPTION: + These tests validate the sample_update_analyzer.py sample code (async version). + +USAGE: + pytest test_sample_update_analyzer_async.py +""" + +import uuid +import pytest +from devtools_testutils.aio import recorded_by_proxy_async +from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import ContentAnalyzer, ContentAnalyzerConfig + + +class TestSampleUpdateAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_update_analyzer.py (async version)""" + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_update_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: + """Test updating an analyzer's properties (async version). + + This test validates: + 1. Creating an initial analyzer + 2. Getting current analyzer state + 3. Updating analyzer description and tags + 4. Verifying updates were applied correctly + + 08_UpdateAnalyzer.UpdateAnalyzerAsync() + """ + # Skip this test if API is not available + try: + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Generate unique analyzer ID for this test + analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" + print(f"[INFO] Creating test analyzer: {analyzer_id}") + + # Create initial analyzer + initial_analyzer = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Initial description", + config=ContentAnalyzerConfig( + return_details=True + ), + models={ + "completion": "gpt-4.1" + }, + tags={ + "tag1": "tag1_initial_value", + "tag2": "tag2_initial_value" + } + ) + + # Create the analyzer + create_poller = await client.begin_create_analyzer( + analyzer_id=analyzer_id, + resource=initial_analyzer, + allow_replace=True + ) + create_result = await create_poller.result() + assert create_result is not None, "Created analyzer should not be null" + print("[PASS] Initial analyzer created successfully") + + # Get the current analyzer to preserve base analyzer ID + current_analyzer = await client.get_analyzer(analyzer_id=analyzer_id) + + # Assertions for initial retrieval + assert current_analyzer is not None, "Current analyzer response should not be null" + print("[PASS] Current analyzer retrieved successfully") + + # Display current analyzer information + print("\n[INFO] Current analyzer information:") + current_description = getattr(current_analyzer, 'description', None) + current_tags = getattr(current_analyzer, 'tags', {}) + print(f" Description: {current_description}") + print(f" Tags: {', '.join(f'{k}={v}' for k, v in current_tags.items())}") + + # Verify initial state + assert current_description == "Initial description", "Initial description should match" + assert "tag1" in current_tags, "tag1 should exist" + assert current_tags.get("tag1") == "tag1_initial_value", "tag1 value should match" + assert "tag2" in current_tags, "tag2 should exist" + assert current_tags.get("tag2") == "tag2_initial_value", "tag2 value should match" + print("[PASS] Initial analyzer state verified") + + # Create an updated analyzer with new description and tags + base_id = getattr(current_analyzer, 'base_analyzer_id', 'prebuilt-document') + updated_analyzer = ContentAnalyzer( + base_analyzer_id=base_id, + description="Updated description", + tags={ + "tag1": "tag1_updated_value", + "tag2": "", # Remove tag2 (empty string) + "tag3": "tag3_value" # Add tag3 + } + ) + + # Update the analyzer + await client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) + print("[PASS] Analyzer updated successfully") + + # Verify the update + updated = await client.get_analyzer(analyzer_id=analyzer_id) + + # Assertions for updated analyzer + assert updated is not None, "Updated analyzer response should not be null" + print("[PASS] Updated analyzer retrieved successfully") + + # Display updated analyzer information + print("\n[INFO] Updated analyzer information:") + updated_description = getattr(updated, 'description', None) + updated_tags = getattr(updated, 'tags', {}) + print(f" Description: {updated_description}") + print(f" Tags: {', '.join(f'{k}={v}' for k, v in updated_tags.items())}") + + # Verify description was updated + assert updated_description == "Updated description", "Description should be updated" + print("[PASS] Description updated correctly") + + # Verify tags were updated + assert "tag1" in updated_tags, "tag1 should still exist" + assert updated_tags.get("tag1") == "tag1_updated_value", "tag1 value should be updated" + print("[PASS] tag1 updated correctly") + + # Verify tag2 was removed (or has empty value) + if "tag2" in updated_tags: + assert updated_tags.get("tag2") == "", "tag2 should have empty value" + print("[PASS] tag2 set to empty value") + else: + print("[PASS] tag2 removed successfully") + + # Verify tag3 was added + assert "tag3" in updated_tags, "tag3 should be added" + assert updated_tags.get("tag3") == "tag3_value", "tag3 value should match" + print("[PASS] tag3 added correctly") + + print("\n[SUCCESS] All test_sample_update_analyzer_async assertions passed") + + except Exception as e: + error_msg = str(e).lower() + if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: + pytest.skip(f"API not available: {str(e)[:100]}") + raise + finally: + # Clean up: delete the test analyzer + try: + if 'analyzer_id' in locals() and 'client' in locals(): + await client.delete_analyzer(analyzer_id=analyzer_id) # type: ignore + print(f"\n[INFO] Test analyzer deleted: {analyzer_id}") # type: ignore + except Exception as cleanup_error: + print(f"\n[WARN] Could not delete test analyzer: {str(cleanup_error)[:100]}") + + try: + if 'client' in locals(): + await client.close() + except Exception: + pass From b08a81877b5604058bdf6a7ae37386fc88564b7f Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 1 Dec 2025 15:18:34 -0800 Subject: [PATCH 069/105] [Tests] Update to use AZURE_CONTENT_UNDERSTANDING_ENDPOINT --- .../azure-ai-contentunderstanding/README.md | 2 +- .../azure-ai-contentunderstanding/tests/testpreparer.py | 2 +- .../azure-ai-contentunderstanding/tests/testpreparer_async.py | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index 7373ffabc458..d3b1d2360002 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -311,7 +311,7 @@ To run the tests for this package, you need to set up a `.env` file with your te ``` 4. Edit the `.env` file at the repo root and fill in your actual values: - - `CONTENTUNDERSTANDING_ENDPOINT`: Your Microsoft Foundry resource endpoint + - `AZURE_CONTENT_UNDERSTANDING_ENDPOINT`: Your Microsoft Foundry resource endpoint - `AZURE_CONTENT_UNDERSTANDING_KEY`: Your API key (optional if using DefaultAzureCredential) - `AZURE_TEST_RUN_LIVE`: Set to `true` to run tests against real Azure resources - `AZURE_SKIP_LIVE_RECORDING`: Set to `true` to skip recording when running live tests diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py index 5d0c03091fbc..5b1715aafb74 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer.py @@ -37,5 +37,5 @@ def create_client(self, endpoint: str) -> ContentUnderstandingClient: ContentUnderstandingPreparer = functools.partial( PowerShellPreparer, "azure_content_understanding", - azure_content_understanding_endpoint="https://fake_contentunderstanding_endpoint.services.ai.azure.com/", + azure_content_understanding_endpoint="https://fake_azure_content_understanding_endpoint.services.ai.azure.com/", ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py index 779cfd0f978d..b0335b013fd9 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/testpreparer_async.py @@ -38,5 +38,5 @@ def create_async_client(self, endpoint: str) -> ContentUnderstandingClient: ContentUnderstandingPreparer = functools.partial( PowerShellPreparer, "azure_content_understanding", - azure_content_understanding_endpoint="https://fake_contentunderstanding_endpoint.services.ai.azure.com/", + azure_content_understanding_endpoint="https://fake_azure_content_understanding_endpoint.services.ai.azure.com/", ) From fd85503013f457f91f68f0a69c6b2cb5d1a59c00 Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Tue, 2 Dec 2025 00:03:00 +0000 Subject: [PATCH 070/105] README: Improve main README --- .../azure-ai-contentunderstanding/README.md | 413 +++++++++++++++--- 1 file changed, 356 insertions(+), 57 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index d3b1d2360002..d8439587513a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -1,28 +1,40 @@ # Azure AI Content Understanding client library for Python -Azure AI Content Understanding is a solution that analyzes and comprehends various media content—such as documents, images, audio, and video—transforming it into structured, organized, and searchable data. +Azure AI Content Understanding is a multimodal AI service that extracts semantic content from documents, audio, and video files. It transforms unstructured content into structured, machine-readable data optimized for retrieval-augmented generation (RAG) and automated workflows. -This table shows the relationship between SDK versions and supported API service versions: +Use the client library for Azure AI Content Understanding to: -| SDK version | Supported API service version | -| ----------- | ----------------------------- | -| 1.0.0 | 2025-11-01 | +* **Extract document content** - Extract text, tables, figures, layout information, and structured markdown from documents (PDF, images, Office documents) +* **Transcribe and analyze audio** - Convert audio content into searchable transcripts with speaker diarization and timing information +* **Analyze video content** - Extract visual frames, transcribe audio tracks, and generate structured summaries from video files +* **Create custom analyzers** - Build domain-specific analyzers for specialized content extraction needs +* **Classify documents** - Automatically categorize and organize documents by type or content -## Getting started +[Source code][python_cu_src] | [Package (PyPI)][python_cu_pypi] | [Product documentation][python_cu_product_docs] | [Samples][python_cu_samples] -### Prerequisites - -- Python 3.9 or later is required to use this package. -- You need an [Azure subscription][azure_sub] to use this package. -- Once you have your Azure subscription, create an [Microsoft Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) in the Azure portal. Be sure to create it in a [supported region](https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support). -- For more information, see: https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api?tabs=document +## Getting started ### Install the package +Install the client library for Python with [pip][pip]: + ```bash python -m pip install azure-ai-contentunderstanding ``` +This table shows the relationship between SDK versions and supported API service versions: + +| SDK version | Supported API service version | +| ----------- | ----------------------------- | +| 1.0.0b1 | 2025-11-01 | + +### Prerequisites + +- Python 3.9 or later is required to use this package. +- You need an [Azure subscription][azure_sub] to use this package. +- Once you have your Azure subscription, create a [Microsoft Foundry resource][cu_quickstart] in the Azure portal. Be sure to create it in a [supported region][cu_region_support]. +- **If running async APIs:** The async transport is designed to be opt-in. The [aiohttp](https://pypi.org/project/aiohttp/) framework is one of the supported implementations of async transport. It's not installed by default. You need to install it separately as follows: `pip install aiohttp` + ### Configure your Microsoft Foundry resource and required model deployments Before running most samples (especially those that use prebuilt analyzers) you need to: @@ -33,9 +45,18 @@ Before running most samples (especially those that use prebuilt analyzers) you n 4. Map those deployments to standard model names using the SDK's `update_defaults` API (one-time per resource) 5. Provide environment variables (via a `.env` file at the repository root for tests, or your shell/session for ad‑hoc runs) -#### 1. Create the Microsoft Foundry resource +#### Step 1: Create the Microsoft Foundry resource + +> **Important:** You must create your Microsoft Foundry resource in a region that supports Content Understanding. For a list of available regions, see [Azure Content Understanding region and language support][cu_region_support]. + +1. Follow the steps in the [Azure Content Understanding quickstart][cu_quickstart] to create a Microsoft Foundry resource in the Azure portal +2. Get your Foundry resource's endpoint URL from Azure Portal: + - Go to [Azure Portal][azure_portal] + - Navigate to your Microsoft Foundry resource + - Go to **Resource Management** > **Keys and Endpoint** + - Copy the **Endpoint** URL (typically `https://.services.ai.azure.com/`) -Follow the steps in the Azure portal (Create a resource > AI Foundry). The Content Understanding service is hosted within this resource. After creation, locate the endpoint under: Resource Management > Keys and Endpoint. It typically looks like: +The Content Understanding service is hosted within this resource. After creation, locate the endpoint under: Resource Management > Keys and Endpoint. It typically looks like: ``` https://.services.ai.azure.com/ @@ -43,25 +64,44 @@ https://.services.ai.azure.com/ Set this as `AZURE_CONTENT_UNDERSTANDING_ENDPOINT`. -#### 2. Grant required permissions +**Important: Grant Required Permissions** -To configure default model deployments you (or the service principal / managed identity you use) must have the **Cognitive Services User** role on the Microsoft Foundry resource, even if you are already an Owner. In the Azure portal: +After creating your Microsoft Foundry resource, you must grant yourself the **Cognitive Services User** role to enable API calls for setting default GPT deployments: -1. Go to your resource -2. Access Control (IAM) > Add > Add role assignment -3. Choose Cognitive Services User -4. Assign it to your identity +1. Go to [Azure Portal][azure_portal] +2. Navigate to your Microsoft Foundry resource +3. Go to **Access Control (IAM)** in the left menu +4. Click **Add** > **Add role assignment** +5. Select the **Cognitive Services User** role +6. Assign it to yourself (or the user/service principal that will run the application) -Without this role, calls to `update_defaults` will fail. +> **Note:** This role assignment is required even if you are the owner of the resource. Without this role, you will not be able to call the Content Understanding API to configure model deployments for prebuilt analyzers. -#### 3. Deploy required models +#### Step 2: Deploy required models -Prebuilt analyzers rely on specific model families: +**Important:** The prebuilt analyzers require model deployments. You must deploy these models before using prebuilt analyzers: +- `prebuilt-documentSearch`, `prebuilt-audioSearch`, `prebuilt-videoSearch` require **GPT-4.1-mini** and **text-embedding-3-large** +- Other prebuilt analyzers like `prebuilt-invoice`, `prebuilt-receipt` require **GPT-4.1** and **text-embedding-3-large** -| Prebuilt analyzers | Required deployments | -| ------------------ | -------------------- | -| `prebuilt-documentSearch`, `prebuilt-audioSearch`, `prebuilt-videoSearch` | `gpt-4.1-mini`, `text-embedding-3-large` | -| `prebuilt-invoice`, `prebuilt-receipt` and similar structured document analyzers | `gpt-4.1`, `text-embedding-3-large` | +1. **Deploy GPT-4.1:** + - In Microsoft Foundry, go to **Deployments** > **Deploy model** > **Deploy base model** + - Search for and select **gpt-4.1** + - Complete the deployment with your preferred settings + - Note the deployment name (by convention, use `gpt-4.1`) + +2. **Deploy GPT-4.1-mini:** + - In Microsoft Foundry, go to **Deployments** > **Deploy model** > **Deploy base model** + - Search for and select **gpt-4.1-mini** + - Complete the deployment with your preferred settings + - Note the deployment name (by convention, use `gpt-4.1-mini`) + +3. **Deploy text-embedding-3-large:** + - In Microsoft Foundry, go to **Deployments** > **Deploy model** > **Deploy base model** + - Search for and select **text-embedding-3-large** + - Complete the deployment with your preferred settings + - Note the deployment name (by convention, use `text-embedding-3-large`) + +For more information on deploying models, see [Create model deployments in Microsoft Foundry portal][deploy_models_docs]. In Microsoft Foundry: Deployments > Deploy model > Deploy base model. Deploy each of: @@ -71,11 +111,17 @@ In Microsoft Foundry: Deployments > Deploy model > Deploy base model. Deploy eac If you choose different deployment names, record them—you will use them in environment variables and when calling `update_defaults`. -#### 4. Configure environment variables +#### Step 3: Configure model deployments (Required for Prebuilt Analyzers) -For local development and tests this repository uses a root-level `.env` file. A template is provided at: +> **IMPORTANT:** Before using prebuilt analyzers, you must configure the model deployments. This is a **one-time setup per Microsoft Foundry resource** that maps your deployed models to the prebuilt analyzers. -`sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample` +You need to configure the default model mappings in your Microsoft Foundry resource. This can be done programmatically using the SDK or through the Azure Portal. The configuration maps your deployed models (GPT-4.1, GPT-4.1-mini, and text-embedding-3-large) to the prebuilt analyzers that require them. + +> **Note:** The configuration is persisted in your Microsoft Foundry resource, so you only need to run this once per resource (or whenever you change your deployment names). If you have multiple Microsoft Foundry resources, you need to configure each one separately. + +#### 4. Configure environment variables + +For local development and tests this repository uses a root-level `.env` file. A template is provided in the package directory as `env.sample`. Copy it to the repository root: @@ -99,11 +145,9 @@ Notes: - Keep the `.env` file out of version control—do not commit secrets. - The model deployment variables are required for configuring defaults and for samples that use prebuilt analyzers. -#### 5. Set default model deployments (one-time) +Content Understanding expects a mapping from standard model names to your deployment names. Run the sample `update_defaults.py` (located in the samples directory) after the environment variables are set and roles assigned. -Content Understanding expects a mapping from standard model names to your deployment names. Run the sample `update_defaults.py` (located in `samples/`) after the environment variables are set and roles assigned. - -Short example (async): +**Example using async client:** ```python import os, asyncio @@ -129,33 +173,158 @@ async def configure(): asyncio.run(configure()) ``` +**Example using sync client:** + +```python +import os +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential +from azure.identity import DefaultAzureCredential + +def configure(): + endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] + key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") + credential = AzureKeyCredential(key) if key else DefaultAzureCredential() + + with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: + client.update_defaults( + model_deployments={ + "gpt-4.1": os.environ["GPT_4_1_DEPLOYMENT"], + "gpt-4.1-mini": os.environ["GPT_4_1_MINI_DEPLOYMENT"], + "text-embedding-3-large": os.environ["TEXT_EMBEDDING_3_LARGE_DEPLOYMENT"], + } + ) + +configure() +``` + After a successful run you can immediately use prebuilt analyzers such as `prebuilt-invoice` or `prebuilt-documentSearch`. If you encounter errors: - Recheck deployment names (they must match exactly) - Confirm the **Cognitive Services User** role assignment - Verify the endpoint points to the correct resource -You only need to perform this configuration again if you change deployment names or create a new Microsoft Foundry resource. +### Authenticate the client + +To authenticate the client, you need your Microsoft Foundry resource endpoint and credentials. You can use either an API key or Azure Active Directory (Azure AD) authentication. + +#### Using DefaultAzureCredential + +The simplest way to authenticate is using `DefaultAzureCredential`, which supports multiple authentication methods and works well in both local development and production environments: + +```python +import os +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.identity import DefaultAzureCredential + +endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] +credential = DefaultAzureCredential() +client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) +``` + +For async operations: + +```python +import os +from azure.ai.contentunderstanding.aio import ContentUnderstandingClient +from azure.identity.aio import DefaultAzureCredential + +endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] +credential = DefaultAzureCredential() +client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) +``` + +#### Using API Key + +You can also authenticate using an API key from your Microsoft Foundry resource: + +```python +import os +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential + +endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] +api_key = os.environ["AZURE_CONTENT_UNDERSTANDING_KEY"] +client = ContentUnderstandingClient(endpoint=endpoint, credential=AzureKeyCredential(api_key)) +``` -#### Troubleshooting quick tips -- Missing model variables: ensure all three deployment environment variables are present; samples will warn politely if any are absent. -- Permission errors calling `update_defaults`: add (or re-add) the Cognitive Services User role. -- Authentication failures with DefaultAzureCredential: run `az login` (CLI) or configure another supported credential method. +To get your API key: +1. Go to [Azure Portal][azure_portal] +2. Navigate to your Microsoft Foundry resource +3. Go to **Resource Management** > **Keys and Endpoint** +4. Copy one of the **Keys** (Key1 or Key2) -For more detailed setup guidance, see the official service quickstart (linked below) and the inline comments in `env.sample`. +For more information on authentication, see [Azure Identity client library][azure_identity_readme]. ## Key concepts -Content Understanding provides the following main capability: +### Prebuilt Analyzers + +Content Understanding provides prebuilt analyzers that are ready to use without any configuration. These analyzers use the `*Search` naming pattern: + +* **`prebuilt-documentSearch`** - Extracts content from documents (PDF, images, Office documents) with layout preservation, table detection, figure analysis, and structured markdown output. Optimized for RAG scenarios. +* **`prebuilt-audioSearch`** - Transcribes audio content with speaker diarization, timing information, and conversation summaries. Supports multilingual transcription. +* **`prebuilt-videoSearch`** - Analyzes video content with visual frame extraction, audio transcription, and structured summaries. Provides temporal alignment of visual and audio content. + +> **Note:** The prebuilt analyzers use the `prebuilt-{type}Search` naming pattern (not `prebuilt-{type}Analyzer`). This is a recent change in the Content Understanding service. + +For a full list of prebuilt analyzers, see [Azure AI Content Understanding prebuilt analyzers][cu_prebuilt_analyzers]. + +### Custom Analyzers + +You can create custom analyzers with specific field schemas for multi-modal content processing (documents, images, audio, video). Custom analyzers allow you to extract domain-specific information tailored to your use case. + +### Content Types + +The API returns different content types based on the input: + +* **`document`** - For document files (PDF, images, Office documents). Contains pages, tables, figures, paragraphs, and markdown representation. +* **`audioVisual`** - For audio and video files. Contains transcript phrases, timing information, and for video, visual frame references. + +### Asynchronous Operations + +Content Understanding operations are asynchronous long-running operations. The workflow is: + +1. **Begin Analysis** - Start the analysis operation (returns immediately with an operation location) +2. **Poll for Results** - Poll the operation location until the analysis completes +3. **Process Results** - Extract and display the structured results + +The SDK provides `LROPoller` types that handle polling automatically when using `.result()`. For analysis operations, the SDK returns a poller that provides access to the operation ID via the `operation_id` property. This operation ID can be used with `get_result_file*` and `delete_result*` methods. -### Content Analyzers -Analyze documents and extract structured information using prebuilt or custom analyzers: -- **Prebuilt analyzers**: Ready-to-use analyzers for multi-modal content processing including `prebuilt-documentSearch`, `prebuilt-invoice`, `prebuilt-videoSearch` (examples - see [full list of prebuilt analyzers](https://learn.microsoft.com/azure/ai-services/content-understanding/concepts/prebuilt-analyzers)) -- **Custom analyzers**: Create analyzers with specific field schemas for multi-modal content processing (documents, images, audio, video) -- **Multiple input formats**: URLs, binary data, and various document types +### Main Classes + +* **`ContentUnderstandingClient`** - The main client for analyzing content, as well as creating, managing, and configuring analyzers +* **`AnalyzeResult`** - Contains the structured results of an analysis operation, including content elements, markdown, and metadata +* **`LROPoller`** - A long-running operation wrapper for analysis results that provides access to the operation ID + +### Thread safety + +We guarantee that all client instance methods are thread-safe and independent of each other. This ensures that the recommendation of reusing client instances is always safe, even across threads. + +### Additional concepts + +[Client options][client_options] | +[Accessing the response][accessing_response] | +[Long-running operations][long_running_operations] | +[Handling failures][handling_failures] | +[Diagnostics][diagnostics] | +[Mocking][mocking] | +[Client lifetime][client_lifetime] ## Examples +You can familiarize yourself with different APIs using [Samples][python_cu_samples]. + +The samples demonstrate: + +* **Document Analysis** - Extract content from PDFs and images using `prebuilt-documentSearch` +* **Audio Analysis** - Transcribe and analyze audio files using `prebuilt-audioSearch` +* **Video Analysis** - Analyze video content using `prebuilt-videoSearch` +* **Custom Analyzers** - Create domain-specific analyzers for specialized extraction needs +* **Document Classification** - Classify documents by type or content + +See the [samples directory][python_cu_samples] for complete examples. + ### Extract Markdown Content from Documents Use the `prebuilt-documentSearch` to extract markdown content from documents: @@ -272,29 +441,134 @@ asyncio.run(analyze_invoice()) ## Troubleshooting +### Common Issues + +**Error: "Access denied due to invalid subscription key or wrong API endpoint"** +- Verify your endpoint URL is correct and includes the trailing slash +- Ensure your API key is valid or that your Azure AD credentials have the correct permissions +- Make sure you have the **Cognitive Services User** role assigned to your account + +**Error: "Model deployment not found" or "Default model deployment not configured"** +- Ensure you have deployed the required models (GPT-4.1, GPT-4.1-mini, text-embedding-3-large) in Microsoft Foundry +- Verify you have configured the default model deployments (see [Configure Model Deployments](#step-3-configure-model-deployments-required-for-prebuilt-analyzers)) +- Check that your deployment names match what you configured in the defaults + +**Error: "Operation failed" or timeout** +- Content Understanding operations are asynchronous and may take time to complete +- Ensure you are properly polling for results using `.result()` on the poller object +- Check the operation status for more details about the failure + ### Microsoft Foundry Resource and Regional Support -Azure AI Content Understanding requires an [Microsoft Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) and is only available in certain [supported regions](https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support). Make sure to: +Azure AI Content Understanding requires a [Microsoft Foundry resource][cu_quickstart] and is only available in certain [supported regions][cu_region_support]. Make sure to: -- Create an Microsoft Foundry resource in the Azure portal under **AI Foundry** > **AI Foundry** +- Create a Microsoft Foundry resource in the Azure portal under **AI Foundry** > **AI Foundry** - Select a supported region when creating the resource -For detailed setup instructions and current supported regions, see: **[Azure AI Content Understanding Quickstart Guide](https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api)** +For detailed setup instructions and current supported regions, see: **[Azure AI Content Understanding Quickstart Guide][cu_quickstart]** + +### Enable Logging + +This library uses the standard [logging][python_logging] library for logging. + +Basic information about HTTP sessions (URLs, headers, etc.) is logged at `INFO` level. + +Detailed `DEBUG` level logging, including request/response bodies and **unredacted** headers, can be enabled on the client or per-operation with the `logging_enable` keyword argument. + +```python +import logging +from azure.ai.contentunderstanding import ContentUnderstandingClient +from azure.core.credentials import AzureKeyCredential + +# Enable logging +logging.basicConfig(level=logging.DEBUG) + +# Create client with logging enabled +client = ContentUnderstandingClient( + endpoint=endpoint, + credential=AzureKeyCredential(api_key), + logging_enable=True +) +``` + +See full SDK logging documentation with examples [here][sdk_logging_docs]. ## Next steps -For more information about Azure AI Content Understanding, see the following additional resources: -- **[Azure AI Content Understanding Documentation](https://learn.microsoft.com/azure/ai-services/content-understanding/)** -- **[REST API Reference](https://learn.microsoft.com/rest/api/content-understanding/)** -- **[Quickstart Guide](https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api)** +### More sample code + +See the [Sample README][sample_readme] for several code snippets illustrating common patterns used in the Content Understanding Python API. + +### Additional documentation + +For more extensive documentation on Azure AI Content Understanding, see the [Content Understanding documentation][python_cu_product_docs] on docs.microsoft.com. + +* Explore the [samples directory][python_cu_samples] for complete code examples +* Read the [Azure AI Content Understanding documentation][python_cu_product_docs] for detailed service information + +## Running the Update Defaults Sample + +To run the `update_defaults` code example shown above, you need to set environment variables with your credentials and model deployment names. + +### Setting environment variables + +**On Linux/macOS (bash):** +```bash +export AZURE_CONTENT_UNDERSTANDING_ENDPOINT="https://.services.ai.azure.com/" +export AZURE_CONTENT_UNDERSTANDING_KEY="" # Optional if using DefaultAzureCredential +export GPT_4_1_DEPLOYMENT="gpt-4.1" +export GPT_4_1_MINI_DEPLOYMENT="gpt-4.1-mini" +export TEXT_EMBEDDING_3_LARGE_DEPLOYMENT="text-embedding-3-large" +``` + +**On Windows (PowerShell):** +```powershell +$env:AZURE_CONTENT_UNDERSTANDING_ENDPOINT="https://.services.ai.azure.com/" +$env:AZURE_CONTENT_UNDERSTANDING_KEY="" # Optional if using DefaultAzureCredential +$env:GPT_4_1_DEPLOYMENT="gpt-4.1" +$env:GPT_4_1_MINI_DEPLOYMENT="gpt-4.1-mini" +$env:TEXT_EMBEDDING_3_LARGE_DEPLOYMENT="text-embedding-3-large" +``` + +**On Windows (Command Prompt):** +```cmd +set AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://.services.ai.azure.com/ +set AZURE_CONTENT_UNDERSTANDING_KEY= # Optional if using DefaultAzureCredential +set GPT_4_1_DEPLOYMENT=gpt-4.1 +set GPT_4_1_MINI_DEPLOYMENT=gpt-4.1-mini +set TEXT_EMBEDDING_3_LARGE_DEPLOYMENT=text-embedding-3-large +``` + +### Running the sample code + +After setting the environment variables, you can run the code examples shown in the [Configure Model Deployments](#step-3-configure-model-deployments-required-for-prebuilt-analyzers) section above. + +**Alternatively, use the prepared sample script:** + +For a complete, ready-to-use example, see `sample_configure_defaults.py` in the [samples directory][sample_readme]. This sample includes error handling and additional features: + +```bash +# Navigate to samples directory +cd samples + +# Run the prepared sample +python sample_configure_defaults.py +``` + +For async version: +```bash +python async_samples/sample_configure_defaults_async.py +``` + +For comprehensive documentation on all available samples, see the [samples README][sample_readme]. ## Running Tests -To run the tests for this package, you need to set up a `.env` file with your test credentials. +To run the tests for this package, you need to set up a `.env` file at the repository root with your test credentials. -### Setting up the .env file +### Setting up the .env file for tests -1. The `env.sample` file is located in this package directory (`sdk/contentunderstanding/azure-ai-contentunderstanding/env.sample`). This file contains a template with all the required environment variables. +1. The `env.sample` file is located in this package directory. This file contains a template with all the required environment variables. 2. **Important**: The `.env` file should be placed at the **root of the `azure-sdk-for-python` repository**, not in the package directory. This follows the Azure SDK testing guidelines. @@ -345,7 +619,7 @@ pytest tests/ -n 4 **Note:** The test proxy server is session-scoped and automatically handles parallel execution, so no additional configuration is needed. -For more information about running tests, see the [Azure SDK Python Testing Guide](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md). +For more information about running tests, see the [tests README][tests_readme] and the [Azure SDK Python Testing Guide][azure_sdk_testing_guide]. ## Contributing @@ -355,7 +629,32 @@ When you submit a pull request, a CLA-bot will automatically determine whether y This project has adopted the [Microsoft Open Source Code of Conduct][code_of_conduct]. For more information see the [Code of Conduct FAQ][code_of_conduct_faq] or contact [opencode@microsoft.com][opencode_email] with any additional questions or comments. + + +[python_cu_src]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding +[python_cu_pypi]: https://pypi.org/project/azure-ai-contentunderstanding/ +[python_cu_product_docs]: https://learn.microsoft.com/azure/ai-services/content-understanding/ +[python_cu_samples]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/contentunderstanding/azure-ai-contentunderstanding/samples [azure_sub]: https://azure.microsoft.com/free/ +[cu_quickstart]: https://learn.microsoft.com/azure/ai-services/content-understanding/quickstart/use-rest-api?tabs=portal%2Cdocument +[cu_region_support]: https://learn.microsoft.com/azure/ai-services/content-understanding/language-region-support +[azure_portal]: https://portal.azure.com/ +[deploy_models_docs]: https://learn.microsoft.com/azure/ai-studio/how-to/deploy-models-openai +[azure_identity_readme]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity/README.md +[cu_prebuilt_analyzers]: https://learn.microsoft.com/azure/ai-services/content-understanding/concepts/prebuilt-analyzers +[client_options]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/README.md#configuring-service-clients-using-clientoptions +[accessing_response]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/README.md#accessing-http-response-details-using-responset +[long_running_operations]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/README.md#consuming-long-running-operations-using-operationt +[handling_failures]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/README.md#reporting-errors-requestfailedexception +[diagnostics]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/samples/Diagnostics.md +[mocking]: https://learn.microsoft.com/azure/developer/python/sdk/azure-sdk-mock-helpers +[client_lifetime]: https://devblogs.microsoft.com/azure-sdk/lifetime-management-and-thread-safety-guarantees-of-azure-sdk-python-clients/ +[python_logging]: https://docs.python.org/3/library/logging.html +[sdk_logging_docs]: https://learn.microsoft.com/azure/developer/python/sdk/azure-sdk-logging +[sample_readme]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/contentunderstanding/azure-ai-contentunderstanding/samples +[tests_readme]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/README.md +[azure_sdk_testing_guide]: https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md +[pip]: https://pypi.org/project/pip/ [cla]: https://cla.microsoft.com [code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ [code_of_conduct_faq]: https://opensource.microsoft.com/codeofconduct/faq/ From 8ee6099d73d71ff5324562cf44995508ce96bd9c Mon Sep 17 00:00:00 2001 From: Yung-Shin Lin Date: Tue, 2 Dec 2025 00:04:06 +0000 Subject: [PATCH 071/105] TEST: Updated assets.json for the new recordings --- .../azure-ai-contentunderstanding/assets.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json index adb05d228321..b8a63d4e720c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/assets.json @@ -2,5 +2,5 @@ "AssetsRepo": "Azure/azure-sdk-assets", "AssetsRepoPrefixPath": "python", "TagPrefix": "python/contentunderstanding/azure-ai-contentunderstanding", - "Tag": "python/contentunderstanding/azure-ai-contentunderstanding_c38d4e3418" + "Tag": "python/contentunderstanding/azure-ai-contentunderstanding_2d9b35e90e" } From bcfcd5105042f1c9d38ac08eb637cea786842b34 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 8 Dec 2025 12:09:54 -0800 Subject: [PATCH 072/105] [Sample] get raw json for analyze_return_raw_json samples and tests --- .../sample_analyze_return_raw_json_async.py | 59 ++++++--- .../samples/sample_analyze_return_raw_json.py | 59 ++++++--- .../test_sample_analyze_return_raw_json.py | 115 ++++++++---------- ...st_sample_analyze_return_raw_json_async.py | 113 ++++++++--------- 4 files changed, 179 insertions(+), 167 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py index 3b9d7371dfe4..15496f904630 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py @@ -9,14 +9,18 @@ DESCRIPTION: This sample demonstrates how to access the raw JSON response from analysis operations - using protocol methods. This is useful for advanced scenarios where you need direct access - to the JSON structure. + using the 'cls' callback parameter (async version). This is useful for advanced scenarios + where you need direct access to the JSON structure. The Content Understanding SDK provides two approaches for accessing analysis results: + 1. Object model approach (recommended): Returns strongly-typed AnalyzeResult objects - 2. Protocol method approach: Returns raw BinaryData containing the JSON response + that are easier to navigate and use. This is shown in sample_analyze_binary_async.py. + + 2. Protocol method approach: Returns raw HTTP response containing the JSON. This sample + demonstrates this approach for advanced scenarios. - For production use, prefer the object model approach as it provides: + IMPORTANT: For production use, prefer the object model approach as it provides: - Type safety - IntelliSense support - Easier navigation of results @@ -66,21 +70,31 @@ async def main() -> None: print(f"Analyzing {file_path} with prebuilt-documentSearch...") - # Use the standard method which returns an AnalyzeResult - # Then serialize to JSON for raw access + # Use the 'cls' callback parameter to get the raw HTTP response + # The 'cls' parameter allows us to intercept the response and return custom data + # We return a tuple: (deserialized_object, raw_http_response) + # Note: For production use, prefer the object model approach (without cls parameter) + # which returns AnalyzeResult objects that are easier to work with poller = await client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, + content_type="application/pdf", + cls=lambda pipeline_response, deserialized_obj, response_headers: ( + deserialized_obj, + pipeline_response.http_response, + ), ) - result = await poller.result() - # Convert to dictionary and then to JSON - result_dict = result.as_dict() + # Wait for completion and get both the deserialized object and raw HTTP response + _, raw_http_response = await poller.result() # [END analyze_return_raw_json] # [START parse_raw_json] + # Parse the raw JSON response + response_json = raw_http_response.json() + # Pretty-print the JSON - pretty_json = json.dumps(result_dict, indent=2, ensure_ascii=False, default=str) + pretty_json = json.dumps(response_json, indent=2, ensure_ascii=False) # Create output directory if it doesn't exist output_dir = Path(__file__).parent.parent / "sample_output" @@ -94,17 +108,26 @@ async def main() -> None: with open(output_path, "w", encoding="utf-8") as f: f.write(pretty_json) - print(f"\nRaw JSON response saved to: {output_path}") + print(f"Raw JSON response saved to: {output_path}") print(f"File size: {len(pretty_json):,} characters") - - # Show a preview of the JSON structure - print("\nJSON Structure Preview:") - print("=" * 50) - preview = pretty_json[:2000] + "..." if len(pretty_json) > 2000 else pretty_json - print(preview) - print("=" * 50) # [END parse_raw_json] + # [START extract_from_raw_json] + # Extract key information from raw JSON + if "result" in response_json: + result_data = response_json["result"] + if "analyzerId" in result_data: + print(f"Analyzer ID: {result_data['analyzerId']}") + if "contents" in result_data and isinstance(result_data["contents"], list): + print(f"Contents count: {len(result_data['contents'])}") + if len(result_data["contents"]) > 0: + first_content = result_data["contents"][0] + if "kind" in first_content: + print(f"Content kind: {first_content['kind']}") + if "mimeType" in first_content: + print(f"MIME type: {first_content['mimeType']}") + # [END extract_from_raw_json] + if not isinstance(credential, AzureKeyCredential): await credential.close() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py index 19f9411a9f7a..0a4057384e5e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py @@ -9,14 +9,18 @@ DESCRIPTION: This sample demonstrates how to access the raw JSON response from analysis operations - using protocol methods. This is useful for advanced scenarios where you need direct access - to the JSON structure. + using the 'cls' callback parameter. This is useful for advanced scenarios where you need + direct access to the JSON structure. The Content Understanding SDK provides two approaches for accessing analysis results: + 1. Object model approach (recommended): Returns strongly-typed AnalyzeResult objects - 2. Protocol method approach: Returns raw BinaryData containing the JSON response + that are easier to navigate and use. This is shown in sample_analyze_binary.py. + + 2. Protocol method approach: Returns raw HTTP response containing the JSON. This sample + demonstrates this approach for advanced scenarios. - For production use, prefer the object model approach as it provides: + IMPORTANT: For production use, prefer the object model approach as it provides: - Type safety - IntelliSense support - Easier navigation of results @@ -66,21 +70,31 @@ def main() -> None: print(f"Analyzing {file_path} with prebuilt-documentSearch...") - # Use the standard method which returns an AnalyzeResult - # Then serialize to JSON for raw access + # Use the 'cls' callback parameter to get the raw HTTP response + # The 'cls' parameter allows us to intercept the response and return custom data + # We return a tuple: (deserialized_object, raw_http_response) + # Note: For production use, prefer the object model approach (without cls parameter) + # which returns AnalyzeResult objects that are easier to work with poller = client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, + content_type="application/pdf", + cls=lambda pipeline_response, deserialized_obj, response_headers: ( + deserialized_obj, + pipeline_response.http_response, + ), ) - result = poller.result() - # Convert to dictionary and then to JSON - result_dict = result.as_dict() + # Wait for completion and get both the deserialized object and raw HTTP response + _, raw_http_response = poller.result() # [END analyze_return_raw_json] # [START parse_raw_json] + # Parse the raw JSON response + response_json = raw_http_response.json() + # Pretty-print the JSON - pretty_json = json.dumps(result_dict, indent=2, ensure_ascii=False, default=str) + pretty_json = json.dumps(response_json, indent=2, ensure_ascii=False) # Create output directory if it doesn't exist output_dir = Path(__file__).parent / "sample_output" @@ -94,17 +108,26 @@ def main() -> None: with open(output_path, "w", encoding="utf-8") as f: f.write(pretty_json) - print(f"\nRaw JSON response saved to: {output_path}") + print(f"Raw JSON response saved to: {output_path}") print(f"File size: {len(pretty_json):,} characters") - - # Show a preview of the JSON structure - print("\nJSON Structure Preview:") - print("=" * 50) - preview = pretty_json[:2000] + "..." if len(pretty_json) > 2000 else pretty_json - print(preview) - print("=" * 50) # [END parse_raw_json] + # [START extract_from_raw_json] + # Extract key information from raw JSON + if "result" in response_json: + result_data = response_json["result"] + if "analyzerId" in result_data: + print(f"Analyzer ID: {result_data['analyzerId']}") + if "contents" in result_data and isinstance(result_data["contents"], list): + print(f"Contents count: {len(result_data['contents'])}") + if len(result_data["contents"]) > 0: + first_content = result_data["contents"][0] + if "kind" in first_content: + print(f"Content kind: {first_content['kind']}") + if "mimeType" in first_content: + print(f"MIME type: {first_content['mimeType']}") + # [END extract_from_raw_json] + if __name__ == "__main__": main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py index 0fd6cfe69a73..da6ae5d40ae7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py @@ -18,7 +18,6 @@ import os import json -import pytest from devtools_testutils import recorded_by_proxy from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase @@ -32,11 +31,11 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi """Test analyzing a document and getting raw JSON response. This test validates: - 1. Document analysis using protocol method + 1. Document analysis using 'cls' callback to get raw HTTP response 2. Raw JSON response format 3. JSON structure validation - 11_AnalyzeReturnRawJson.AnalyzeReturnRawJsonAsync() + 11_AnalyzeReturnRawJson.AnalyzeReturnRawJson() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -55,80 +54,64 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - # Analyze the document and get raw response - # Note: The Python SDK returns structured objects by default - # We can access the raw response through the result + # Use 'cls' callback to get raw HTTP response + # The 'cls' parameter allows us to intercept the response before it gets deserialized as an object model + # We return a tuple: (deserialized_object, raw_http_response) poller = client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, - content_type="application/pdf" + content_type="application/pdf", + cls=lambda pipeline_response, deserialized_obj, response_headers: ( + deserialized_obj, + pipeline_response.http_response, + ), ) - result = poller.result() + # Wait for completion and get both model and raw HTTP response + _, raw_http_response = poller.result() # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - - # Verify raw response status - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_initial_response'): - raw_response = getattr(polling_method, '_initial_response', None) # type: ignore - if raw_response: - if hasattr(raw_response, 'http_response'): - status = raw_response.http_response.status_code - elif hasattr(raw_response, 'status_code'): - status = raw_response.status_code - else: - status = None - - if status: - assert status >= 200 and status < 300, \ - f"Response status should be successful (200-299), but was {status}" - print(f"[PASS] Raw response status verified: {status}") - assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - # Assertion: Verify result - assert result is not None, "Analysis result should not be null" - print("[PASS] Response data is not null") - - # Convert result to JSON string to verify raw format capability - # In Python SDK, we can serialize the result to JSON - try: - # Try to access the raw response data - if hasattr(result, '__dict__'): - result_dict = result.__dict__ - json_str = json.dumps(result_dict, default=str) - assert json_str is not None, "Response string should not be null" - assert len(json_str) > 0, "Response string should not be empty" - print(f"[PASS] Response converted to JSON string: {len(json_str)} characters") - - # Verify it's valid JSON - parsed_json = json.loads(json_str) - assert parsed_json is not None, "Response should be valid JSON" - print("[PASS] Response is valid JSON format") - else: - print("[INFO] Result does not have __dict__ attribute, using alternative method") - - # Alternative: Check if result has contents (which confirms it's a valid response) - assert hasattr(result, "contents"), "Result should have contents attribute" - assert result.contents is not None, "Result contents should not be null" - print("[PASS] Response data structure verified") - - except json.JSONDecodeError as e: - pytest.fail(f"Response should be valid JSON format: {str(e)}") - except Exception as e: - print(f"[WARN] Could not serialize to JSON: {str(e)}") - # Still verify basic structure - assert result is not None, "Result should not be null" - print("[PASS] Response data verified (structured format)") - - # Verify the response contains expected data - assert hasattr(result, "contents"), "Result should have contents" - if result.contents and len(result.contents) > 0: - print(f"[PASS] Response contains {len(result.contents)} content(s)") + # Assertion: Verify raw HTTP response + assert raw_http_response is not None, "Raw HTTP response should not be null" + print("[PASS] Raw HTTP response is not null") + + # Parse the raw JSON response + response_json = raw_http_response.json() + + # Assertion: Verify JSON is not empty + assert response_json is not None, "Response JSON should not be null" + print("[PASS] Response JSON parsed successfully") + + # Verify it's valid JSON by serializing + json_str = json.dumps(response_json, indent=2, ensure_ascii=False) + assert json_str is not None, "Response string should not be null" + assert len(json_str) > 0, "Response string should not be empty" + print(f"[PASS] Response converted to JSON string: {len(json_str)} characters") + + # Verify the response contains expected structure (matching C# sample validation) + assert "result" in response_json, "Response should contain 'result' key" + result_data = response_json["result"] + print("[PASS] Response contains 'result' key") + + # Verify analyzerId + if "analyzerId" in result_data: + print(f"[PASS] Analyzer ID: {result_data['analyzerId']}") + + # Verify contents + if "contents" in result_data and isinstance(result_data["contents"], list): + contents_count = len(result_data["contents"]) + print(f"[PASS] Contents count: {contents_count}") + + if contents_count > 0: + first_content = result_data["contents"][0] + if "kind" in first_content: + print(f"[PASS] Content kind: {first_content['kind']}") + if "mimeType" in first_content: + print(f"[PASS] MIME type: {first_content['mimeType']}") print("\n[SUCCESS] All test_sample_analyze_return_raw_json assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py index cb6eb376ddf7..f9e00b62c0ac 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py @@ -18,7 +18,6 @@ import os import json -import pytest from devtools_testutils.aio import recorded_by_proxy_async from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync @@ -32,7 +31,7 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa """Test analyzing a document and getting raw JSON response (async version). This test validates: - 1. Document analysis using protocol method + 1. Document analysis using 'cls' callback to get raw HTTP response 2. Raw JSON response format 3. JSON structure validation @@ -55,81 +54,65 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - # Analyze the document and get raw response - # Note: The Python SDK returns structured objects by default - # We can access the raw response through the result + # Use 'cls' callback to get raw HTTP response + # The 'cls' parameter allows us to intercept the response before it gets deserialized as an object model + # We return a tuple: (deserialized_object, raw_http_response) poller = await client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, - content_type="application/pdf" + content_type="application/pdf", + cls=lambda pipeline_response, deserialized_obj, response_headers: ( + deserialized_obj, + pipeline_response.http_response, + ), ) - result = await poller.result() + # Wait for completion and get both model and raw HTTP response + _, raw_http_response = await poller.result() # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - - # Verify raw response status - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_initial_response'): - raw_response = getattr(polling_method, '_initial_response', None) # type: ignore - if raw_response: - if hasattr(raw_response, 'http_response'): - status = raw_response.http_response.status_code - elif hasattr(raw_response, 'status_code'): - status = raw_response.status_code - else: - status = None - - if status: - assert status >= 200 and status < 300, \ - f"Response status should be successful (200-299), but was {status}" - print(f"[PASS] Raw response status verified: {status}") - assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - # Assertion: Verify result - assert result is not None, "Analysis result should not be null" - print("[PASS] Response data is not null") - - # Convert result to JSON string to verify raw format capability - # In Python SDK, we can serialize the result to JSON - try: - # Try to access the raw response data - if hasattr(result, '__dict__'): - result_dict = result.__dict__ - json_str = json.dumps(result_dict, default=str) - assert json_str is not None, "Response string should not be null" - assert len(json_str) > 0, "Response string should not be empty" - print(f"[PASS] Response converted to JSON string: {len(json_str)} characters") - - # Verify it's valid JSON - parsed_json = json.loads(json_str) - assert parsed_json is not None, "Response should be valid JSON" - print("[PASS] Response is valid JSON format") - else: - print("[INFO] Result does not have __dict__ attribute, using alternative method") - - # Alternative: Check if result has contents (which confirms it's a valid response) - assert hasattr(result, "contents"), "Result should have contents attribute" - assert result.contents is not None, "Result contents should not be null" - print("[PASS] Response data structure verified") - - except json.JSONDecodeError as e: - pytest.fail(f"Response should be valid JSON format: {str(e)}") - except Exception as e: - print(f"[WARN] Could not serialize to JSON: {str(e)}") - # Still verify basic structure - assert result is not None, "Result should not be null" - print("[PASS] Response data verified (structured format)") - - # Verify the response contains expected data - assert hasattr(result, "contents"), "Result should have contents" - if result.contents and len(result.contents) > 0: - print(f"[PASS] Response contains {len(result.contents)} content(s)") + # Assertion: Verify raw HTTP response + assert raw_http_response is not None, "Raw HTTP response should not be null" + print("[PASS] Raw HTTP response is not null") + + # Parse the raw JSON response + response_json = raw_http_response.json() + + # Assertion: Verify JSON is not empty + assert response_json is not None, "Response JSON should not be null" + print("[PASS] Response JSON parsed successfully") + + # Verify it's valid JSON by serializing + json_str = json.dumps(response_json, indent=2, ensure_ascii=False) + assert json_str is not None, "Response string should not be null" + assert len(json_str) > 0, "Response string should not be empty" + print(f"[PASS] Response converted to JSON string: {len(json_str)} characters") + + # Verify the response contains expected structure (matching C# sample validation) + assert "result" in response_json, "Response should contain 'result' key" + result_data = response_json["result"] + print("[PASS] Response contains 'result' key") + + # Verify analyzerId + if "analyzerId" in result_data: + print(f"[PASS] Analyzer ID: {result_data['analyzerId']}") + + # Verify contents + if "contents" in result_data and isinstance(result_data["contents"], list): + contents_count = len(result_data["contents"]) + print(f"[PASS] Contents count: {contents_count}") + + if contents_count > 0: + first_content = result_data["contents"][0] + if "kind" in first_content: + print(f"[PASS] Content kind: {first_content['kind']}") + if "mimeType" in first_content: + print(f"[PASS] MIME type: {first_content['mimeType']}") await client.close() print("\n[SUCCESS] All test_sample_analyze_return_raw_json_async assertions passed") From 6cdca09f8a3321feec539e9dfa408ecae4e05145 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 8 Dec 2025 15:17:33 -0800 Subject: [PATCH 073/105] [Sample] print out markdown for get_raw_json sample --- .../sample_analyze_return_raw_json_async.py | 44 ++++++++++++++++++- .../samples/sample_analyze_return_raw_json.py | 44 ++++++++++++++++++- 2 files changed, 86 insertions(+), 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py index 15496f904630..d190635c212c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py @@ -114,18 +114,60 @@ async def main() -> None: # [START extract_from_raw_json] # Extract key information from raw JSON + # This demonstrates accessing the same data that would be available via the object model if "result" in response_json: result_data = response_json["result"] + if "analyzerId" in result_data: - print(f"Analyzer ID: {result_data['analyzerId']}") + print(f"\nAnalyzer ID: {result_data['analyzerId']}") + if "contents" in result_data and isinstance(result_data["contents"], list): print(f"Contents count: {len(result_data['contents'])}") + if len(result_data["contents"]) > 0: first_content = result_data["contents"][0] + if "kind" in first_content: print(f"Content kind: {first_content['kind']}") if "mimeType" in first_content: print(f"MIME type: {first_content['mimeType']}") + + # Extract markdown content from raw JSON + # Object model equivalent: content.markdown + print("\nMarkdown Content (from raw JSON):") + print("=" * 50) + if "markdown" in first_content and first_content["markdown"]: + print(first_content["markdown"]) + else: + print("No markdown content available.") + print("=" * 50) + + # Extract document properties from raw JSON + # Object model equivalent: document_content.start_page_number, etc. + if first_content.get("kind") == "document": + print("\nDocument Information (from raw JSON):") + if "startPageNumber" in first_content: + print(f" Start page: {first_content['startPageNumber']}") + if "endPageNumber" in first_content: + print(f" End page: {first_content['endPageNumber']}") + + start_page = first_content.get("startPageNumber") + end_page = first_content.get("endPageNumber") + if start_page and end_page: + total_pages = end_page - start_page + 1 + print(f" Total pages: {total_pages}") + + # Extract pages information + # Object model equivalent: document_content.pages + if "pages" in first_content and first_content["pages"]: + pages = first_content["pages"] + unit = first_content.get("unit", "units") + print(f"\nPages ({len(pages)}):") + for page in pages: + page_num = page.get("pageNumber") + width = page.get("width") + height = page.get("height") + print(f" Page {page_num}: {width} x {height} {unit}") # [END extract_from_raw_json] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py index 0a4057384e5e..d8af896d59af 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py @@ -114,18 +114,60 @@ def main() -> None: # [START extract_from_raw_json] # Extract key information from raw JSON + # This demonstrates accessing the same data that would be available via the object model if "result" in response_json: result_data = response_json["result"] + if "analyzerId" in result_data: - print(f"Analyzer ID: {result_data['analyzerId']}") + print(f"\nAnalyzer ID: {result_data['analyzerId']}") + if "contents" in result_data and isinstance(result_data["contents"], list): print(f"Contents count: {len(result_data['contents'])}") + if len(result_data["contents"]) > 0: first_content = result_data["contents"][0] + if "kind" in first_content: print(f"Content kind: {first_content['kind']}") if "mimeType" in first_content: print(f"MIME type: {first_content['mimeType']}") + + # Extract markdown content from raw JSON + # Object model equivalent: content.markdown + print("\nMarkdown Content (from raw JSON):") + print("=" * 50) + if "markdown" in first_content and first_content["markdown"]: + print(first_content["markdown"]) + else: + print("No markdown content available.") + print("=" * 50) + + # Extract document properties from raw JSON + # Object model equivalent: document_content.start_page_number, etc. + if first_content.get("kind") == "document": + print("\nDocument Information (from raw JSON):") + if "startPageNumber" in first_content: + print(f" Start page: {first_content['startPageNumber']}") + if "endPageNumber" in first_content: + print(f" End page: {first_content['endPageNumber']}") + + start_page = first_content.get("startPageNumber") + end_page = first_content.get("endPageNumber") + if start_page and end_page: + total_pages = end_page - start_page + 1 + print(f" Total pages: {total_pages}") + + # Extract pages information + # Object model equivalent: document_content.pages + if "pages" in first_content and first_content["pages"]: + pages = first_content["pages"] + unit = first_content.get("unit", "units") + print(f"\nPages ({len(pages)}):") + for page in pages: + page_num = page.get("pageNumber") + width = page.get("width") + height = page.get("height") + print(f" Page {page_num}: {width} x {height} {unit}") # [END extract_from_raw_json] From 58f4fd0528d5d39e8247b087ce113c1d50174b1b Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 16 Dec 2025 16:32:24 -0800 Subject: [PATCH 074/105] [TypeSpec] Commit update --- .../azure-ai-contentunderstanding/tsp-location.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml index b45f7d5ee721..276e0386c962 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tsp-location.yaml @@ -1,4 +1,4 @@ directory: specification/ai/ContentUnderstanding -commit: e14eec8796b4d481a942a41e103881589ec648d8 +commit: a3291026612253abe544704a27bfad1dbdd5dcc2 repo: Azure/azure-rest-api-specs additionalDirectories: From eba319032977bb829c5ea308724f3010df3023b1 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 16 Dec 2025 17:04:48 -0800 Subject: [PATCH 075/105] [SDK-UPDATE] a3291026612253abe544704a27bfad1dbdd5dcc2 --- .../apiview-properties.json | 3 +- .../_operations/_operations.py | 14 +- .../_operations/_patch.py | 13 +- .../azure/ai/contentunderstanding/_patch.py | 4 +- .../aio/_operations/_operations.py | 12 +- .../aio/_operations/_patch.py | 9 +- .../ai/contentunderstanding/aio/_patch.py | 4 +- .../contentunderstanding/models/__init__.py | 6 +- .../ai/contentunderstanding/models/_models.py | 29 ++- .../ai/contentunderstanding/models/_patch.py | 5 +- .../pyproject.toml | 2 +- .../sample_analyze_invoice_async.py | 4 +- .../samples/sample_analyze_invoice.py | 4 +- .../tests/conftest.py | 2 +- .../samples/test_sample_analyze_binary.py | 155 +++++++------ .../test_sample_analyze_binary_async.py | 154 ++++++------- .../samples/test_sample_analyze_configs.py | 69 +++--- .../test_sample_analyze_configs_async.py | 69 +++--- .../samples/test_sample_analyze_invoice.py | 135 +++++------ .../test_sample_analyze_invoice_async.py | 135 +++++------ .../test_sample_analyze_return_raw_json.py | 34 +-- ...st_sample_analyze_return_raw_json_async.py | 34 +-- .../tests/samples/test_sample_analyze_url.py | 132 +++++------ .../samples/test_sample_analyze_url_async.py | 130 ++++++----- .../samples/test_sample_configure_defaults.py | 59 +++-- .../test_sample_configure_defaults_async.py | 58 +++-- .../samples/test_sample_copy_analyzer.py | 89 ++++---- .../test_sample_copy_analyzer_async.py | 93 ++++---- .../samples/test_sample_create_analyzer.py | 82 +++---- .../test_sample_create_analyzer_async.py | 84 +++---- .../samples/test_sample_create_classifier.py | 51 ++--- .../test_sample_create_classifier_async.py | 51 ++--- .../samples/test_sample_delete_analyzer.py | 84 ++++--- .../test_sample_delete_analyzer_async.py | 82 ++++--- .../samples/test_sample_delete_result.py | 44 ++-- .../test_sample_delete_result_async.py | 44 ++-- .../tests/samples/test_sample_get_analyzer.py | 63 +++--- .../samples/test_sample_get_analyzer_async.py | 65 +++--- .../samples/test_sample_get_result_file.py | 68 +++--- .../test_sample_get_result_file_async.py | 68 +++--- .../samples/test_sample_grant_copy_auth.py | 178 ++++++++------- .../test_sample_grant_copy_auth_async.py | 179 ++++++++------- .../samples/test_sample_list_analyzers.py | 66 +++--- .../test_sample_list_analyzers_async.py | 68 +++--- .../samples/test_sample_update_analyzer.py | 73 +++--- .../test_sample_update_analyzer_async.py | 77 +++---- .../tests/test_analyzer_operation_id.py | 4 +- ...erstanding_content_analyzers_operations.py | 136 ++++++----- ...ding_content_analyzers_operations_async.py | 213 +++++++++--------- .../tests/test_helpers.py | 98 ++++---- 50 files changed, 1657 insertions(+), 1678 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json index 77bb9601d363..6c59b2aa33f5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/apiview-properties.json @@ -13,7 +13,7 @@ "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.ContentCategory": "ContentUnderstanding.ContentCategoryDefinition", + "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", @@ -45,6 +45,7 @@ "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", diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py index b332a661f32e..5ebd158784a4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_operations.py @@ -133,7 +133,7 @@ def build_content_understanding_copy_analyzer_request( # pylint: disable=name-t accept = _headers.pop("Accept", "application/json") # Construct URL - _url = "/analyzers/{analyzerId}:copyAnalyzer" + _url = "/analyzers/{analyzerId}:copy" path_format_arguments = { "analyzerId": _SERIALIZER.url("analyzer_id", analyzer_id, "str"), } @@ -965,7 +965,7 @@ def _copy_analyzer_initial( response = pipeline_response.http_response - if response.status_code not in [202]: + if response.status_code not in [200, 201]: try: response.read() # Load the body in memory and close the socket except (StreamConsumedError, StreamClosedError): @@ -1234,10 +1234,10 @@ def _create_analyzer_initial( raise HttpResponseError(response=response) response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) response_headers["x-ms-client-request-id"] = self._deserialize( "str", response.headers.get("x-ms-client-request-id") ) - response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) deserialized = response.iter_bytes() @@ -1379,14 +1379,14 @@ def begin_create_analyzer( def get_long_running_output(pipeline_response): response_headers = {} response = pipeline_response.http_response - response_headers["x-ms-client-request-id"] = self._deserialize( - "str", response.headers.get("x-ms-client-request-id") - ) response_headers["Operation-Location"] = self._deserialize( "str", response.headers.get("Operation-Location") ) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) - deserialized = _deserialize(_models.ContentAnalyzer, response.json().get("result", {})) + deserialized = _deserialize(_models.ContentAnalyzer, response.json()) if cls: return cls(pipeline_response, deserialized, response_headers) # type: ignore return deserialized diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index 614ffa34271d..ecf1d86b7b90 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -63,10 +63,14 @@ def _patched_build_content_understanding_copy_analyzer_request( request.url = request.url.replace(":copyAnalyzer", ":copy") return request - _operations.build_content_understanding_copy_analyzer_request = _patched_build_content_understanding_copy_analyzer_request + _operations.build_content_understanding_copy_analyzer_request = ( + _patched_build_content_understanding_copy_analyzer_request + ) # 2. SDK-FIX: Wrap _copy_analyzer_initial to accept both 201 and 202 status codes - _original_copy_initial = _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial # pylint: disable=protected-access + _original_copy_initial = ( + _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial + ) # pylint: disable=protected-access def _patched_copy_analyzer_initial( # pylint: disable=protected-access self, @@ -125,6 +129,7 @@ def _patched_copy_analyzer_initial( # pylint: disable=protected-access _content = body else: from .._utils.model_base import SdkJSONEncoder + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore _request = _operations.build_content_understanding_copy_analyzer_request( @@ -170,4 +175,6 @@ def _patched_copy_analyzer_initial( # pylint: disable=protected-access return deserialized # type: ignore - _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = _patched_copy_analyzer_initial # pylint: disable=protected-access + _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = ( + _patched_copy_analyzer_initial # pylint: disable=protected-access + ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py index d0728a94a160..edb384719761 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py @@ -284,7 +284,9 @@ def begin_analyze_binary( poller._polling_method, # pylint: disable=protected-access ) - def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> HttpResponse: # pylint: disable=useless-parent-delegation + def send_request( + self, request: HttpRequest, *, stream: bool = False, **kwargs: Any + ) -> HttpResponse: # pylint: disable=useless-parent-delegation """Runs the network request through the client's chained policies. >>> from azure.core.rest import HttpRequest diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py index d740c7601d06..95b4657f176c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_operations.py @@ -576,7 +576,7 @@ async def _copy_analyzer_initial( response = pipeline_response.http_response - if response.status_code not in [202]: + if response.status_code not in [200, 201]: try: await response.read() # Load the body in memory and close the socket except (StreamConsumedError, StreamClosedError): @@ -850,10 +850,10 @@ async def _create_analyzer_initial( raise HttpResponseError(response=response) response_headers = {} + response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) response_headers["x-ms-client-request-id"] = self._deserialize( "str", response.headers.get("x-ms-client-request-id") ) - response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) deserialized = response.iter_bytes() @@ -999,14 +999,14 @@ async def begin_create_analyzer( def get_long_running_output(pipeline_response): response_headers = {} response = pipeline_response.http_response - response_headers["x-ms-client-request-id"] = self._deserialize( - "str", response.headers.get("x-ms-client-request-id") - ) response_headers["Operation-Location"] = self._deserialize( "str", response.headers.get("Operation-Location") ) + response_headers["x-ms-client-request-id"] = self._deserialize( + "str", response.headers.get("x-ms-client-request-id") + ) - deserialized = _deserialize(_models.ContentAnalyzer, response.json().get("result", {})) + deserialized = _deserialize(_models.ContentAnalyzer, response.json()) if cls: return cls(pipeline_response, deserialized, response_headers) # type: ignore return deserialized diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index baa7a8d0d8f8..a180fb12e95f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -46,7 +46,9 @@ def patch_sdk(): # by the sync _patch.py. We just need to patch the async _copy_analyzer_initial method. # SDK-FIX: Wrap _copy_analyzer_initial to accept both 201 and 202 status codes - _original_copy_initial = _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial # pylint: disable=protected-access + _original_copy_initial = ( + _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial + ) # pylint: disable=protected-access async def _patched_copy_analyzer_initial( # pylint: disable=protected-access self, @@ -105,6 +107,7 @@ async def _patched_copy_analyzer_initial( # pylint: disable=protected-access _content = body else: from ..._utils.model_base import SdkJSONEncoder + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore _request = sync_operations.build_content_understanding_copy_analyzer_request( @@ -150,4 +153,6 @@ async def _patched_copy_analyzer_initial( # pylint: disable=protected-access return deserialized # type: ignore - _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = _patched_copy_analyzer_initial # pylint: disable=protected-access + _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = ( + _patched_copy_analyzer_initial # pylint: disable=protected-access + ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py index 9ad9e83de08b..56401d0965c0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py @@ -284,7 +284,9 @@ async def begin_analyze_binary( poller._polling_method, # pylint: disable=protected-access ) - async def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> AsyncHttpResponse: # pylint: disable=invalid-overridden-method,useless-parent-delegation + async def send_request( + self, request: HttpRequest, *, stream: bool = False, **kwargs: Any + ) -> AsyncHttpResponse: # pylint: disable=invalid-overridden-method,useless-parent-delegation """Runs the network request through the client's chained policies. >>> from azure.core.rest import HttpRequest diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py index c1fe5cd4fbf0..b307e6b84cb7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/__init__.py @@ -24,7 +24,7 @@ ContentAnalyzerAnalyzeOperationStatus, ContentAnalyzerConfig, ContentAnalyzerOperationStatus, - ContentCategory, + ContentCategoryDefinition, ContentField, ContentFieldDefinition, ContentFieldSchema, @@ -58,6 +58,7 @@ MediaContent, NumberField, ObjectField, + RecordMergePatchUpdate, StringField, SupportedModels, TimeField, @@ -100,7 +101,7 @@ "ContentAnalyzerAnalyzeOperationStatus", "ContentAnalyzerConfig", "ContentAnalyzerOperationStatus", - "ContentCategory", + "ContentCategoryDefinition", "ContentField", "ContentFieldDefinition", "ContentFieldSchema", @@ -134,6 +135,7 @@ "MediaContent", "NumberField", "ObjectField", + "RecordMergePatchUpdate", "StringField", "SupportedModels", "TimeField", diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py index 4a49c6fbad9a..1529695fd830 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_models.py @@ -693,7 +693,8 @@ class ContentAnalyzerConfig(_Model): :ivar estimate_field_source_and_confidence: Return field grounding source and confidence. :vartype estimate_field_source_and_confidence: bool :ivar content_categories: Map of categories to classify the input content(s) against. - :vartype content_categories: dict[str, ~azure.ai.contentunderstanding.models.ContentCategory] + :vartype content_categories: dict[str, + ~azure.ai.contentunderstanding.models.ContentCategoryDefinition] :ivar enable_segment: Enable segmentation of the input by contentCategories. :vartype enable_segment: bool :ivar segment_per_page: Force segmentation of document content by page. @@ -752,7 +753,7 @@ class ContentAnalyzerConfig(_Model): name="estimateFieldSourceAndConfidence", visibility=["read", "create", "update", "delete", "query"] ) """Return field grounding source and confidence.""" - content_categories: Optional[dict[str, "_models.ContentCategory"]] = rest_field( + content_categories: Optional[dict[str, "_models.ContentCategoryDefinition"]] = rest_field( name="contentCategories", visibility=["read", "create", "update", "delete", "query"] ) """Map of categories to classify the input content(s) against.""" @@ -786,7 +787,7 @@ def __init__( annotation_format: Optional[Union[str, "_models.AnnotationFormat"]] = None, disable_face_blurring: Optional[bool] = None, estimate_field_source_and_confidence: Optional[bool] = None, - content_categories: Optional[dict[str, "_models.ContentCategory"]] = None, + content_categories: Optional[dict[str, "_models.ContentCategoryDefinition"]] = None, enable_segment: Optional[bool] = None, segment_per_page: Optional[bool] = None, omit_content: Optional[bool] = None, @@ -855,7 +856,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None: super().__init__(*args, **kwargs) -class ContentCategory(_Model): +class ContentCategoryDefinition(_Model): """Content category definition. :ivar description: The description of the category. @@ -2613,6 +2614,10 @@ def __init__(self, *args: Any, **kwargs: Any) -> None: self.field_type = ContentFieldType.OBJECT # type: ignore +class RecordMergePatchUpdate(_Model): + """RecordMergePatchUpdate.""" + + class StringField(ContentField, discriminator="string"): """String field extracted from the content. @@ -2668,23 +2673,23 @@ def __init__(self, *args: Any, **kwargs: Any) -> None: class SupportedModels(_Model): """Chat completion and embedding models supported by the analyzer. - :ivar completion: Chat completion models supported by the analyzer. Required. + :ivar completion: Chat completion models supported by the analyzer. :vartype completion: list[str] - :ivar embedding: Embedding models supported by the analyzer. Required. + :ivar embedding: Embedding models supported by the analyzer. :vartype embedding: list[str] """ - completion: list[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) - """Chat completion models supported by the analyzer. Required.""" - embedding: list[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) - """Embedding models supported by the analyzer. Required.""" + completion: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Chat completion models supported by the analyzer.""" + embedding: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Embedding models supported by the analyzer.""" @overload def __init__( self, *, - completion: list[str], - embedding: list[str], + completion: Optional[list[str]] = None, + embedding: Optional[list[str]] = None, ) -> None: ... @overload diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py index b7ed43ccce1a..24655d5f4698 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/models/_patch.py @@ -128,6 +128,7 @@ def _add_value_property_to_field(field_class: type, value_attr: str, return_type :return: None :rtype: None """ + def value_getter(self: Any) -> Any: """Get the value of this field. @@ -137,7 +138,7 @@ def value_getter(self: Any) -> Any: return getattr(self, value_attr, None) # Set return type annotation for better type checking - value_getter.__annotations__['return'] = return_type + value_getter.__annotations__["return"] = return_type # Create property with type annotation value_property = property(value_getter) @@ -197,7 +198,7 @@ def _content_field_value_getter(self: ContentField) -> Any: return None # Set return type annotation - _content_field_value_getter.__annotations__['return'] = Any + _content_field_value_getter.__annotations__["return"] = Any # Add property to ContentField base class content_field_value = property(_content_field_value_getter) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml index a8e706db3bea..cd660792b3c1 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml @@ -15,7 +15,7 @@ authors = [ { name = "Microsoft Corporation", email = "azpysdkhelp@microsoft.com" }, ] description = "Microsoft Corporation Azure AI Content Understanding Client Library for Python" -license = {text = "MIT"} +license = "MIT" classifiers = [ "Development Status :: 4 - Beta", "Programming Language :: Python", diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index 3a5358447940..40a3556abaaa 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -151,7 +151,7 @@ async def main() -> None: description = description_field.value if description_field else "(no description)" quantity = quantity_field.value if quantity_field else "N/A" - + # Display price information - prefer UnitPrice if available, otherwise Amount # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) price_info = "" @@ -164,7 +164,7 @@ async def main() -> None: price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() elif amount_field and amount_field.value is not None: price_info = f"Amount: {amount_field.value}" - + print(f" {i}. {description}") print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) # [END extract_invoice_fields] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index c58696f965f3..84cb7ad6754f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -153,7 +153,7 @@ def main() -> None: description = description_field.value if description_field else "(no description)" quantity = quantity_field.value if quantity_field else "N/A" - + # Display price information - prefer UnitPrice if available, otherwise Amount # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) price_info = "" @@ -166,7 +166,7 @@ def main() -> None: price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() elif amount_field and amount_field.value is not None: price_info = f"Amount: {amount_field.value}" - + print(f" {i}. {description}") print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) # [END extract_invoice_fields] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py index cb4f98812b6f..4be40c724076 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/conftest.py @@ -75,7 +75,7 @@ def add_sanitizers(test_proxy): add_header_regex_sanitizer(key="Set-Cookie", value="[set-cookie;]") add_header_regex_sanitizer(key="Cookie", value="cookie;") add_body_key_sanitizer(json_path="$..access_token", value="access_token") - + # Sanitize cross-resource copy fields in request body # These fields are required for grant_copy_authorization and copy_analyzer API calls # Sanitizing them allows playback mode to use placeholder values diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py index 2dd3721d3f0f..abfb8c30e5b6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 # ------------------------------------------------------------------------- @@ -29,13 +30,13 @@ class TestSampleAnalyzeBinary(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_analyze_binary(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document from binary data. - + This test validates: 1. File loading and binary data creation 2. Document analysis using begin_analyze_binary 3. Markdown content extraction 4. Document properties (MIME type, pages, tables) - + """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -43,85 +44,82 @@ def test_sample_analyze_binary(self, azure_content_understanding_endpoint: str) # Use test_data directory from parent tests folder tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + # Assertion: Verify file exists assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") - + with open(file_path, "rb") as f: file_bytes = f.read() - + # Assertion: Verify file is not empty assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - + # Assertion: Verify binary data assert file_bytes is not None, "Binary data should not be null" print("[PASS] Binary data created successfully") - + # Analyze the document poller = client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=file_bytes, - content_type="application/pdf" + analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" ) - + result = poller.result() - + # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - + # Verify raw response # In Python SDK, we can check if the poller has result and get HTTP response info # type: ignore is used here because we're accessing internal implementation details - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_initial_response'): - raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if hasattr(poller, "_polling_method"): + polling_method = getattr(poller, "_polling_method", None) + if polling_method and hasattr(polling_method, "_initial_response"): + raw_response = getattr(polling_method, "_initial_response", None) # type: ignore if raw_response: # PipelineResponse has http_response attribute - if hasattr(raw_response, 'http_response'): + if hasattr(raw_response, "http_response"): status = raw_response.http_response.status_code - elif hasattr(raw_response, 'status_code'): + elif hasattr(raw_response, "status_code"): status = raw_response.status_code else: status = None - + if status: - assert status >= 200 and status < 300, \ - f"Response status should be successful (200-299), but was {status}" + assert ( + status >= 200 and status < 300 + ), f"Response status should be successful (200-299), but was {status}" print(f"[PASS] Raw response verified (status: {status})") - + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - + # Assertion: Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" assert result.contents is not None, "Result contents should not be null" print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") - + # Test markdown extraction self._test_markdown_extraction(result) - + # Test document properties access self._test_document_properties(result) - + print("\n[SUCCESS] All test_sample_analyze_binary assertions passed") def _test_markdown_extraction(self, result): - """Test markdown content extraction. - - """ + """Test markdown content extraction.""" # Assertion: Verify contents structure assert result.contents is not None, "Result should contain contents" assert len(result.contents) > 0, "Result should have at least one content" assert len(result.contents) == 1, "PDF file should have exactly one content element" - + content = result.contents[0] assert content is not None, "Content should not be null" - + # Assertion: Verify markdown content markdown = getattr(content, "markdown", None) if markdown: @@ -133,22 +131,20 @@ def _test_markdown_extraction(self, result): print("[WARN] No markdown content available") def _test_document_properties(self, result): - """Test document property access. - - """ + """Test document property access.""" content = result.contents[0] assert content is not None, "Content should not be null for document properties validation" - + # Check if this is DocumentContent content_type = type(content).__name__ print(f"[INFO] Content type: {content_type}") - + # Validate this is document content (should have document-specific properties) - is_document_content = hasattr(content, 'mime_type') and hasattr(content, 'start_page_number') + is_document_content = hasattr(content, "mime_type") and hasattr(content, "start_page_number") if not is_document_content: print(f"[WARN] Expected DocumentContent but got {content_type}, skipping document-specific validations") return - + # Validate MIME type mime_type = getattr(content, "mime_type", None) if mime_type: @@ -156,104 +152,107 @@ def _test_document_properties(self, result): assert mime_type.strip(), "MIME type should not be empty" assert mime_type == "application/pdf", f"MIME type should be application/pdf, but was {mime_type}" print(f"[PASS] MIME type verified: {mime_type}") - + # Validate page numbers start_page = getattr(content, "start_page_number", None) if start_page is not None: assert start_page >= 1, f"Start page should be >= 1, but was {start_page}" - + end_page = getattr(content, "end_page_number", None) if end_page is not None: assert end_page >= start_page, f"End page {end_page} should be >= start page {start_page}" total_pages = end_page - start_page + 1 assert total_pages > 0, f"Total pages should be positive, but was {total_pages}" print(f"[PASS] Page range verified: {start_page} to {end_page} ({total_pages} pages)") - + # Validate pages collection pages = getattr(content, "pages", None) if pages and len(pages) > 0: assert len(pages) > 0, "Pages collection should not be empty when not null" - assert len(pages) == total_pages, \ - f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" + assert ( + len(pages) == total_pages + ), f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" print(f"[PASS] Pages collection verified: {len(pages)} pages") - + # Validate individual pages self._validate_pages(pages, start_page, end_page, content) else: print("[WARN] No pages collection available in document content") - + # Validate tables collection tables = getattr(content, "tables", None) if tables and len(tables) > 0: self._validate_tables(tables) else: print("No tables found in document content") - + # Final validation message print("[PASS] All document properties validated successfully") def _validate_pages(self, pages, start_page, end_page, content=None): """Validate pages collection details.""" page_numbers = set() - unit = getattr(content, 'unit', None) if content else None + unit = getattr(content, "unit", None) if content else None unit_str = str(unit) if unit else "units" - + for page in pages: assert page is not None, "Page object should not be null" assert hasattr(page, "page_number"), "Page should have page_number attribute" assert page.page_number >= 1, f"Page number should be >= 1, but was {page.page_number}" - assert start_page <= page.page_number <= end_page, \ - f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" - - assert hasattr(page, "width") and page.width > 0, \ - f"Page {page.page_number} width should be > 0, but was {page.width}" - assert hasattr(page, "height") and page.height > 0, \ - f"Page {page.page_number} height should be > 0, but was {page.height}" - + assert ( + start_page <= page.page_number <= end_page + ), f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" + + assert ( + hasattr(page, "width") and page.width > 0 + ), f"Page {page.page_number} width should be > 0, but was {page.width}" + assert ( + hasattr(page, "height") and page.height > 0 + ), f"Page {page.page_number} height should be > 0, but was {page.height}" + # Ensure page numbers are unique - assert page.page_number not in page_numbers, \ - f"Page number {page.page_number} appears multiple times" + assert page.page_number not in page_numbers, f"Page number {page.page_number} appears multiple times" page_numbers.add(page.page_number) - + # Print page details with unit print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") - + print(f"[PASS] All {len(pages)} pages validated successfully") def _validate_tables(self, tables): """Validate tables collection details.""" assert len(tables) > 0, "Tables collection should not be empty when not null" print(f"[PASS] Tables collection verified: {len(tables)} tables") - + for i, table in enumerate(tables, 1): assert table is not None, f"Table {i} should not be null" assert hasattr(table, "row_count"), f"Table {i} should have row_count attribute" assert hasattr(table, "column_count"), f"Table {i} should have column_count attribute" - assert table.row_count > 0, \ - f"Table {i} should have at least 1 row, but had {table.row_count}" - assert table.column_count > 0, \ - f"Table {i} should have at least 1 column, but had {table.column_count}" - + assert table.row_count > 0, f"Table {i} should have at least 1 row, but had {table.row_count}" + assert table.column_count > 0, f"Table {i} should have at least 1 column, but had {table.column_count}" + # Validate table cells if available if hasattr(table, "cells") and table.cells: - assert len(table.cells) > 0, \ - f"Table {i} cells collection should not be empty when not null" - + assert len(table.cells) > 0, f"Table {i} cells collection should not be empty when not null" + for cell in table.cells: assert cell is not None, "Table cell should not be null" assert hasattr(cell, "row_index"), "Cell should have row_index" assert hasattr(cell, "column_index"), "Cell should have column_index" - assert 0 <= cell.row_index < table.row_count, \ - f"Cell row index {cell.row_index} should be within table row count {table.row_count}" - assert 0 <= cell.column_index < table.column_count, \ - f"Cell column index {cell.column_index} should be within table column count {table.column_count}" - + assert ( + 0 <= cell.row_index < table.row_count + ), f"Cell row index {cell.row_index} should be within table row count {table.row_count}" + assert ( + 0 <= cell.column_index < table.column_count + ), f"Cell column index {cell.column_index} should be within table column count {table.column_count}" + if hasattr(cell, "row_span"): assert cell.row_span >= 1, f"Cell row span should be >= 1, but was {cell.row_span}" if hasattr(cell, "column_span"): assert cell.column_span >= 1, f"Cell column span should be >= 1, but was {cell.column_span}" - - print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)") + + print( + f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)" + ) else: print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") - diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py index c8a5bae84c66..c3a10f46d921 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 # ------------------------------------------------------------------------- @@ -29,13 +30,13 @@ class TestSampleAnalyzeBinaryAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_analyze_binary_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document from binary data (async version). - + This test validates: 1. File loading and binary data creation 2. Document analysis using begin_analyze_binary 3. Markdown content extraction 4. Document properties (MIME type, pages, tables) - + """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -43,86 +44,83 @@ async def test_sample_analyze_binary_async(self, azure_content_understanding_end # Use test_data directory from parent tests folder tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + # Assertion: Verify file exists assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") - + with open(file_path, "rb") as f: file_bytes = f.read() - + # Assertion: Verify file is not empty assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - + # Assertion: Verify binary data assert file_bytes is not None, "Binary data should not be null" print("[PASS] Binary data created successfully") - + # Analyze the document poller = await client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=file_bytes, - content_type="application/pdf" + analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" ) - + result = await poller.result() - + # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - + # Verify raw response # In Python SDK, we can check if the poller has result and get HTTP response info # type: ignore is used here because we're accessing internal implementation details - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_initial_response'): - raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if hasattr(poller, "_polling_method"): + polling_method = getattr(poller, "_polling_method", None) + if polling_method and hasattr(polling_method, "_initial_response"): + raw_response = getattr(polling_method, "_initial_response", None) # type: ignore if raw_response: # PipelineResponse has http_response attribute - if hasattr(raw_response, 'http_response'): + if hasattr(raw_response, "http_response"): status = raw_response.http_response.status_code - elif hasattr(raw_response, 'status_code'): + elif hasattr(raw_response, "status_code"): status = raw_response.status_code else: status = None - + if status: - assert status >= 200 and status < 300, \ - f"Response status should be successful (200-299), but was {status}" + assert ( + status >= 200 and status < 300 + ), f"Response status should be successful (200-299), but was {status}" print(f"[PASS] Raw response verified (status: {status})") - + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - + # Assertion: Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" assert result.contents is not None, "Result contents should not be null" print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") - + # Test markdown extraction self._test_markdown_extraction(result) - + # Test document properties access self._test_document_properties(result) - + await client.close() print("\n[SUCCESS] All test_sample_analyze_binary_async assertions passed") def _test_markdown_extraction(self, result): - """Test markdown content extraction. - - """ + """Test markdown content extraction.""" # Assertion: Verify contents structure assert result.contents is not None, "Result should contain contents" assert len(result.contents) > 0, "Result should have at least one content" assert len(result.contents) == 1, "PDF file should have exactly one content element" - + content = result.contents[0] assert content is not None, "Content should not be null" - + # Assertion: Verify markdown content markdown = getattr(content, "markdown", None) if markdown: @@ -134,22 +132,20 @@ def _test_markdown_extraction(self, result): print("[WARN] No markdown content available") def _test_document_properties(self, result): - """Test document property access. - - """ + """Test document property access.""" content = result.contents[0] assert content is not None, "Content should not be null for document properties validation" - + # Check if this is DocumentContent content_type = type(content).__name__ print(f"[INFO] Content type: {content_type}") - + # Validate this is document content (should have document-specific properties) - is_document_content = hasattr(content, 'mime_type') and hasattr(content, 'start_page_number') + is_document_content = hasattr(content, "mime_type") and hasattr(content, "start_page_number") if not is_document_content: print(f"[WARN] Expected DocumentContent but got {content_type}, skipping document-specific validations") return - + # Validate MIME type mime_type = getattr(content, "mime_type", None) if mime_type: @@ -157,103 +153,107 @@ def _test_document_properties(self, result): assert mime_type.strip(), "MIME type should not be empty" assert mime_type == "application/pdf", f"MIME type should be application/pdf, but was {mime_type}" print(f"[PASS] MIME type verified: {mime_type}") - + # Validate page numbers start_page = getattr(content, "start_page_number", None) if start_page is not None: assert start_page >= 1, f"Start page should be >= 1, but was {start_page}" - + end_page = getattr(content, "end_page_number", None) if end_page is not None: assert end_page >= start_page, f"End page {end_page} should be >= start page {start_page}" total_pages = end_page - start_page + 1 assert total_pages > 0, f"Total pages should be positive, but was {total_pages}" print(f"[PASS] Page range verified: {start_page} to {end_page} ({total_pages} pages)") - + # Validate pages collection pages = getattr(content, "pages", None) if pages and len(pages) > 0: assert len(pages) > 0, "Pages collection should not be empty when not null" - assert len(pages) == total_pages, \ - f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" + assert ( + len(pages) == total_pages + ), f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" print(f"[PASS] Pages collection verified: {len(pages)} pages") - + # Validate individual pages self._validate_pages(pages, start_page, end_page, content) else: print("[WARN] No pages collection available in document content") - + # Validate tables collection tables = getattr(content, "tables", None) if tables and len(tables) > 0: self._validate_tables(tables) else: print("No tables found in document content") - + # Final validation message print("[PASS] All document properties validated successfully") def _validate_pages(self, pages, start_page, end_page, content=None): """Validate pages collection details.""" page_numbers = set() - unit = getattr(content, 'unit', None) if content else None + unit = getattr(content, "unit", None) if content else None unit_str = str(unit) if unit else "units" - + for page in pages: assert page is not None, "Page object should not be null" assert hasattr(page, "page_number"), "Page should have page_number attribute" assert page.page_number >= 1, f"Page number should be >= 1, but was {page.page_number}" - assert start_page <= page.page_number <= end_page, \ - f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" - - assert hasattr(page, "width") and page.width > 0, \ - f"Page {page.page_number} width should be > 0, but was {page.width}" - assert hasattr(page, "height") and page.height > 0, \ - f"Page {page.page_number} height should be > 0, but was {page.height}" - + assert ( + start_page <= page.page_number <= end_page + ), f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" + + assert ( + hasattr(page, "width") and page.width > 0 + ), f"Page {page.page_number} width should be > 0, but was {page.width}" + assert ( + hasattr(page, "height") and page.height > 0 + ), f"Page {page.page_number} height should be > 0, but was {page.height}" + # Ensure page numbers are unique - assert page.page_number not in page_numbers, \ - f"Page number {page.page_number} appears multiple times" + assert page.page_number not in page_numbers, f"Page number {page.page_number} appears multiple times" page_numbers.add(page.page_number) - + # Print page details with unit print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") - + print(f"[PASS] All {len(pages)} pages validated successfully") def _validate_tables(self, tables): """Validate tables collection details.""" assert len(tables) > 0, "Tables collection should not be empty when not null" print(f"[PASS] Tables collection verified: {len(tables)} tables") - + for i, table in enumerate(tables, 1): assert table is not None, f"Table {i} should not be null" assert hasattr(table, "row_count"), f"Table {i} should have row_count attribute" assert hasattr(table, "column_count"), f"Table {i} should have column_count attribute" - assert table.row_count > 0, \ - f"Table {i} should have at least 1 row, but had {table.row_count}" - assert table.column_count > 0, \ - f"Table {i} should have at least 1 column, but had {table.column_count}" - + assert table.row_count > 0, f"Table {i} should have at least 1 row, but had {table.row_count}" + assert table.column_count > 0, f"Table {i} should have at least 1 column, but had {table.column_count}" + # Validate table cells if available if hasattr(table, "cells") and table.cells: - assert len(table.cells) > 0, \ - f"Table {i} cells collection should not be empty when not null" - + assert len(table.cells) > 0, f"Table {i} cells collection should not be empty when not null" + for cell in table.cells: assert cell is not None, "Table cell should not be null" assert hasattr(cell, "row_index"), "Cell should have row_index" assert hasattr(cell, "column_index"), "Cell should have column_index" - assert 0 <= cell.row_index < table.row_count, \ - f"Cell row index {cell.row_index} should be within table row count {table.row_count}" - assert 0 <= cell.column_index < table.column_count, \ - f"Cell column index {cell.column_index} should be within table column count {table.column_count}" - + assert ( + 0 <= cell.row_index < table.row_count + ), f"Cell row index {cell.row_index} should be within table row count {table.row_count}" + assert ( + 0 <= cell.column_index < table.column_count + ), f"Cell column index {cell.column_index} should be within table column count {table.column_count}" + if hasattr(cell, "row_span"): assert cell.row_span >= 1, f"Cell row span should be >= 1, but was {cell.row_span}" if hasattr(cell, "column_span"): assert cell.column_span >= 1, f"Cell column span should be >= 1, but was {cell.column_span}" - - print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)") + + print( + f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)" + ) else: print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py index 0473e1e10a99..437e7fd4c775 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py @@ -29,12 +29,12 @@ class TestSampleAnalyzeConfigs(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_analyze_configs(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document with specific configuration options. - + This test validates: 1. Document analysis with prebuilt-documentSearch analyzer 2. Configuration options (formulas, layout, OCR enabled) 3. Document features extraction (charts, annotations, hyperlinks, formulas) - + 10_AnalyzeConfigs.AnalyzeConfigsAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -42,56 +42,55 @@ def test_sample_analyze_configs(self, azure_content_understanding_endpoint: str) # Read the sample file (using sample_invoice.pdf as it contains various features) tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + # Assertion: Verify file exists assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") - + with open(file_path, "rb") as f: file_bytes = f.read() - + # Assertion: Verify file is not empty assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - + # Assertion: Verify binary data assert file_bytes is not None, "Binary data should not be null" print("[PASS] Binary data created successfully") - + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled poller = client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=file_bytes, - content_type="application/pdf" + analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" ) - + result = poller.result() - + # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - + # Verify raw response - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_initial_response'): - raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if hasattr(poller, "_polling_method"): + polling_method = getattr(poller, "_polling_method", None) + if polling_method and hasattr(polling_method, "_initial_response"): + raw_response = getattr(polling_method, "_initial_response", None) # type: ignore if raw_response: - if hasattr(raw_response, 'http_response'): + if hasattr(raw_response, "http_response"): status = raw_response.http_response.status_code - elif hasattr(raw_response, 'status_code'): + elif hasattr(raw_response, "status_code"): status = raw_response.status_code else: status = None - + if status: - assert status >= 200 and status < 300, \ - f"Response status should be successful (200-299), but was {status}" + assert ( + status >= 200 and status < 300 + ), f"Response status should be successful (200-299), but was {status}" print(f"[PASS] Raw response verified (status: {status})") - + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - + # Assertion: Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" @@ -99,31 +98,31 @@ def test_sample_analyze_configs(self, azure_content_understanding_endpoint: str) assert len(result.contents) > 0, "Result should have at least one content" assert len(result.contents) == 1, "PDF file should have exactly one content element" print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") - + # Verify document content type first_content = result.contents[0] assert first_content is not None, "Content should not be null" - + # Check if this is document content content_type = type(first_content).__name__ print(f"[INFO] Content type: {content_type}") - - is_document_content = hasattr(first_content, 'mime_type') and hasattr(first_content, 'start_page_number') + + is_document_content = hasattr(first_content, "mime_type") and hasattr(first_content, "start_page_number") if is_document_content: start_page = getattr(first_content, "start_page_number", None) end_page = getattr(first_content, "end_page_number", None) - + if start_page and end_page: assert start_page >= 1, "Start page should be >= 1" assert end_page >= start_page, "End page should be >= start page" total_pages = end_page - start_page + 1 print(f"[PASS] Document has {total_pages} page(s) from {start_page} to {end_page}") - + print("[PASS] Document features analysis with configs completed successfully") - + # Test document feature extraction self._test_document_features(first_content) - + print("\n[SUCCESS] All test_sample_analyze_configs assertions passed") def _test_document_features(self, content): @@ -137,21 +136,21 @@ def _test_document_features(self, content): print(f" Chart {i} detected") else: print("[INFO] No charts found in document") - + # Check for annotations annotations = getattr(content, "annotations", None) if annotations and len(annotations) > 0: print(f"[PASS] Found {len(annotations)} annotation(s) in document") else: print("[INFO] No annotations found in document") - + # Check for hyperlinks hyperlinks = getattr(content, "hyperlinks", None) if hyperlinks and len(hyperlinks) > 0: print(f"[PASS] Found {len(hyperlinks)} hyperlink(s) in document") else: print("[INFO] No hyperlinks found in document") - + # Check for formulas formulas = getattr(content, "formulas", None) if formulas and len(formulas) > 0: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py index 7529cdeccb50..8844e83fd895 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py @@ -29,12 +29,12 @@ class TestSampleAnalyzeConfigsAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_analyze_configs_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document with specific configuration options (async version). - + This test validates: 1. Document analysis with prebuilt-documentSearch analyzer 2. Configuration options (formulas, layout, OCR enabled) 3. Document features extraction (charts, annotations, hyperlinks, formulas) - + 10_AnalyzeConfigs.AnalyzeConfigsAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -42,56 +42,55 @@ async def test_sample_analyze_configs_async(self, azure_content_understanding_en # Read the sample file (using sample_invoice.pdf as it contains various features) tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + # Assertion: Verify file exists assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") - + with open(file_path, "rb") as f: file_bytes = f.read() - + # Assertion: Verify file is not empty assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - + # Assertion: Verify binary data assert file_bytes is not None, "Binary data should not be null" print("[PASS] Binary data created successfully") - + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled poller = await client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=file_bytes, - content_type="application/pdf" + analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" ) - + result = await poller.result() - + # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - + # Verify raw response - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_initial_response'): - raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if hasattr(poller, "_polling_method"): + polling_method = getattr(poller, "_polling_method", None) + if polling_method and hasattr(polling_method, "_initial_response"): + raw_response = getattr(polling_method, "_initial_response", None) # type: ignore if raw_response: - if hasattr(raw_response, 'http_response'): + if hasattr(raw_response, "http_response"): status = raw_response.http_response.status_code - elif hasattr(raw_response, 'status_code'): + elif hasattr(raw_response, "status_code"): status = raw_response.status_code else: status = None - + if status: - assert status >= 200 and status < 300, \ - f"Response status should be successful (200-299), but was {status}" + assert ( + status >= 200 and status < 300 + ), f"Response status should be successful (200-299), but was {status}" print(f"[PASS] Raw response verified (status: {status})") - + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - + # Assertion: Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" @@ -99,31 +98,31 @@ async def test_sample_analyze_configs_async(self, azure_content_understanding_en assert len(result.contents) > 0, "Result should have at least one content" assert len(result.contents) == 1, "PDF file should have exactly one content element" print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") - + # Verify document content type first_content = result.contents[0] assert first_content is not None, "Content should not be null" - + # Check if this is document content content_type = type(first_content).__name__ print(f"[INFO] Content type: {content_type}") - - is_document_content = hasattr(first_content, 'mime_type') and hasattr(first_content, 'start_page_number') + + is_document_content = hasattr(first_content, "mime_type") and hasattr(first_content, "start_page_number") if is_document_content: start_page = getattr(first_content, "start_page_number", None) end_page = getattr(first_content, "end_page_number", None) - + if start_page and end_page: assert start_page >= 1, "Start page should be >= 1" assert end_page >= start_page, "End page should be >= start page" total_pages = end_page - start_page + 1 print(f"[PASS] Document has {total_pages} page(s) from {start_page} to {end_page}") - + print("[PASS] Document features analysis with configs completed successfully") - + # Test document feature extraction self._test_document_features(first_content) - + await client.close() print("\n[SUCCESS] All test_sample_analyze_configs_async assertions passed") @@ -138,21 +137,21 @@ def _test_document_features(self, content): print(f" Chart {i} detected") else: print("[INFO] No charts found in document") - + # Check for annotations annotations = getattr(content, "annotations", None) if annotations and len(annotations) > 0: print(f"[PASS] Found {len(annotations)} annotation(s) in document") else: print("[INFO] No annotations found in document") - + # Check for hyperlinks hyperlinks = getattr(content, "hyperlinks", None) if hyperlinks and len(hyperlinks) > 0: print(f"[PASS] Found {len(hyperlinks)} hyperlink(s) in document") else: print("[INFO] No hyperlinks found in document") - + # Check for formulas formulas = getattr(content, "formulas", None) if formulas and len(formulas) > 0: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py index 897b98937c67..4f8bc284531a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py @@ -30,12 +30,12 @@ class TestSampleAnalyzeInvoice(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_analyze_invoice(self, azure_content_understanding_endpoint: str, **kwargs) -> None: """Test analyzing an invoice document with prebuilt-invoice analyzer. - + This test validates: 1. Analyzing an invoice using prebuilt-invoice analyzer 2. Extracting invoice-specific fields (CustomerName, InvoiceDate, TotalAmount, LineItems) 3. Field confidence scores and source locations - + 03_AnalyzeInvoice.AnalyzeInvoiceAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -44,166 +44,167 @@ def test_sample_analyze_invoice(self, azure_content_understanding_endpoint: str, current_dir = os.path.dirname(os.path.abspath(__file__)) test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") invoice_path = os.path.join(test_data_dir, "sample_invoice.pdf") - + # Read the invoice file as binary data with open(invoice_path, "rb") as f: invoice_data = f.read() - + # Analyze the invoice - poller = client.begin_analyze( - analyzer_id="prebuilt-invoice", - inputs=[AnalyzeInput(data=invoice_data)] - ) - + poller = client.begin_analyze(analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(data=invoice_data)]) + # Wait for analysis to complete result = poller.result() - + # Assertions for operation assert poller is not None, "Analysis operation should not be null" print("[PASS] Analysis operation created successfully") - + # Verify raw response using getattr with type: ignore - raw_response = getattr(poller, '_polling_method', None) + raw_response = getattr(poller, "_polling_method", None) if raw_response: - initial_response = getattr(raw_response, '_initial_response', None) # type: ignore + initial_response = getattr(raw_response, "_initial_response", None) # type: ignore if initial_response: - status = getattr(initial_response, 'status_code', None) + status = getattr(initial_response, "status_code", None) if status: assert 200 <= status < 300, f"Response status should be successful, but was {status}" print(f"[PASS] Response status: {status}") - + # Assertions for result assert result is not None, "Analysis result should not be null" print("[PASS] Analysis result received") - - assert hasattr(result, 'contents'), "Result should contain contents" - contents = getattr(result, 'contents', None) + + assert hasattr(result, "contents"), "Result should contain contents" + contents = getattr(result, "contents", None) assert contents is not None, "Result contents should not be null" assert len(contents) > 0, "Result should have at least one content" assert len(contents) == 1, "Invoice should have exactly one content element" print(f"[PASS] Analysis result contains {len(contents)} content(s)") - + # Get the document content content = contents[0] assert content is not None, "Content should not be null" assert isinstance(content, DocumentContent), "Content should be of type DocumentContent" print("[PASS] Content is of type DocumentContent") - + # Verify basic document properties document_content = content - start_page = getattr(document_content, 'start_page_number', 1) - end_page = getattr(document_content, 'end_page_number', 1) - + start_page = getattr(document_content, "start_page_number", 1) + end_page = getattr(document_content, "end_page_number", 1) + assert start_page >= 1, "Start page should be >= 1" assert end_page >= start_page, "End page should be >= start page" total_pages = end_page - start_page + 1 assert total_pages > 0, "Total pages should be positive" print(f"[PASS] Document has {total_pages} page(s) from {start_page} to {end_page}") - + # Print document unit information - unit = getattr(document_content, 'unit', None) + unit = getattr(document_content, "unit", None) if unit: print(f"[INFO] Document unit: {unit}") else: print("[INFO] Document unit: unknown") - + # Extract and verify fields - fields = getattr(document_content, 'fields', {}) - + fields = getattr(document_content, "fields", {}) + # Extract CustomerName field - customer_name_field = fields.get('CustomerName') + customer_name_field = fields.get("CustomerName") if customer_name_field: print("[PASS] CustomerName field found") - - value = getattr(customer_name_field, 'value', None) + + value = getattr(customer_name_field, "value", None) if value: assert len(str(value)) > 0, "CustomerName value should not be empty when present" print(f"[INFO] Customer Name: {value}") - - confidence = getattr(customer_name_field, 'confidence', None) + + confidence = getattr(customer_name_field, "confidence", None) if confidence is not None: assert 0 <= confidence <= 1, f"CustomerName confidence should be between 0 and 1, but was {confidence}" print(f"[INFO] CustomerName confidence: {confidence:.2f}") - - source = getattr(customer_name_field, 'source', None) + + source = getattr(customer_name_field, "source", None) if source: print(f"[INFO] CustomerName source: {source}") - - spans = getattr(customer_name_field, 'spans', None) + + spans = getattr(customer_name_field, "spans", None) if spans and len(spans) > 0: span = spans[0] - offset = getattr(span, 'offset', None) - length = getattr(span, 'length', None) + offset = getattr(span, "offset", None) + length = getattr(span, "length", None) if offset is not None and length is not None: print(f"[INFO] CustomerName position in markdown: offset={offset}, length={length}") else: print("[INFO] CustomerName field not found in this document") - + # Extract InvoiceDate field - invoice_date_field = fields.get('InvoiceDate') + invoice_date_field = fields.get("InvoiceDate") if invoice_date_field: print("[PASS] InvoiceDate field found") - - value = getattr(invoice_date_field, 'value', None) + + value = getattr(invoice_date_field, "value", None) if value: print(f"[INFO] Invoice Date: {value}") - - confidence = getattr(invoice_date_field, 'confidence', None) + + confidence = getattr(invoice_date_field, "confidence", None) if confidence is not None: assert 0 <= confidence <= 1, f"InvoiceDate confidence should be between 0 and 1" print(f"[INFO] InvoiceDate confidence: {confidence:.2f}") - - source = getattr(invoice_date_field, 'source', None) + + source = getattr(invoice_date_field, "source", None) if source: print(f"[INFO] InvoiceDate source: {source}") else: print("[INFO] InvoiceDate field not found in this document") - + # Extract TotalAmount field (object field with nested Amount and CurrencyCode) - total_amount_field = fields.get('TotalAmount') + total_amount_field = fields.get("TotalAmount") if total_amount_field: print("[PASS] TotalAmount field found") - + # Try to extract nested fields if it's an object - if hasattr(total_amount_field, 'value') and isinstance(total_amount_field.value, dict): + if hasattr(total_amount_field, "value") and isinstance(total_amount_field.value, dict): amount_obj = total_amount_field.value - amount = amount_obj.get('Amount') - currency = amount_obj.get('CurrencyCode', '$') - + amount = amount_obj.get("Amount") + currency = amount_obj.get("CurrencyCode", "$") + if amount: - print(f"[INFO] Total: {currency}{amount:.2f}" if isinstance(amount, (int, float)) else f"[INFO] Total: {currency}{amount}") + print( + f"[INFO] Total: {currency}{amount:.2f}" + if isinstance(amount, (int, float)) + else f"[INFO] Total: {currency}{amount}" + ) else: - value = getattr(total_amount_field, 'value', None) + value = getattr(total_amount_field, "value", None) if value: print(f"[INFO] Total Amount: {value}") - - confidence = getattr(total_amount_field, 'confidence', None) + + confidence = getattr(total_amount_field, "confidence", None) if confidence is not None: print(f"[INFO] TotalAmount confidence: {confidence:.2f}") else: print("[INFO] TotalAmount field not found in this document") - + # Extract LineItems field (array field) - line_items_field = fields.get('LineItems') + line_items_field = fields.get("LineItems") if line_items_field: print("[PASS] LineItems field found") - + # Try to extract array items - if hasattr(line_items_field, 'value') and isinstance(line_items_field.value, list): + if hasattr(line_items_field, "value") and isinstance(line_items_field.value, list): items = line_items_field.value print(f"[INFO] Line Items ({len(items)}):") - + for i, item in enumerate(items[:5]): # Show first 5 items if isinstance(item, dict): - description = item.get('Description', 'N/A') - quantity = item.get('Quantity', 'N/A') + description = item.get("Description", "N/A") + quantity = item.get("Quantity", "N/A") print(f"[INFO] Item {i + 1}: {description} (Qty: {quantity})") - + if len(items) > 5: print(f"[INFO] ... and {len(items) - 5} more items") else: print("[INFO] LineItems format not as expected") else: print("[INFO] LineItems field not found in this document") - + print("\n[SUCCESS] All test_sample_analyze_invoice assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py index d1cf335228b7..d9130e092640 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py @@ -30,12 +30,12 @@ class TestSampleAnalyzeInvoiceAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_analyze_invoice_async(self, azure_content_understanding_endpoint: str, **kwargs) -> None: """Test analyzing an invoice document with prebuilt-invoice analyzer (async version). - + This test validates: 1. Analyzing an invoice using prebuilt-invoice analyzer 2. Extracting invoice-specific fields (CustomerName, InvoiceDate, TotalAmount, LineItems) 3. Field confidence scores and source locations - + 03_AnalyzeInvoice.AnalyzeInvoiceAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -44,167 +44,168 @@ async def test_sample_analyze_invoice_async(self, azure_content_understanding_en current_dir = os.path.dirname(os.path.abspath(__file__)) test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") invoice_path = os.path.join(test_data_dir, "sample_invoice.pdf") - + # Read the invoice file as binary data with open(invoice_path, "rb") as f: invoice_data = f.read() - + # Analyze the invoice - poller = await client.begin_analyze( - analyzer_id="prebuilt-invoice", - inputs=[AnalyzeInput(data=invoice_data)] - ) - + poller = await client.begin_analyze(analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(data=invoice_data)]) + # Wait for analysis to complete result = await poller.result() - + # Assertions for operation assert poller is not None, "Analysis operation should not be null" print("[PASS] Analysis operation created successfully") - + # Verify raw response using getattr with type: ignore - raw_response = getattr(poller, '_polling_method', None) + raw_response = getattr(poller, "_polling_method", None) if raw_response: - initial_response = getattr(raw_response, '_initial_response', None) # type: ignore + initial_response = getattr(raw_response, "_initial_response", None) # type: ignore if initial_response: - status = getattr(initial_response, 'status_code', None) + status = getattr(initial_response, "status_code", None) if status: assert 200 <= status < 300, f"Response status should be successful, but was {status}" print(f"[PASS] Response status: {status}") - + # Assertions for result assert result is not None, "Analysis result should not be null" print("[PASS] Analysis result received") - - assert hasattr(result, 'contents'), "Result should contain contents" - contents = getattr(result, 'contents', None) + + assert hasattr(result, "contents"), "Result should contain contents" + contents = getattr(result, "contents", None) assert contents is not None, "Result contents should not be null" assert len(contents) > 0, "Result should have at least one content" assert len(contents) == 1, "Invoice should have exactly one content element" print(f"[PASS] Analysis result contains {len(contents)} content(s)") - + # Get the document content content = contents[0] assert content is not None, "Content should not be null" assert isinstance(content, DocumentContent), "Content should be of type DocumentContent" print("[PASS] Content is of type DocumentContent") - + # Verify basic document properties document_content = content - start_page = getattr(document_content, 'start_page_number', 1) - end_page = getattr(document_content, 'end_page_number', 1) - + start_page = getattr(document_content, "start_page_number", 1) + end_page = getattr(document_content, "end_page_number", 1) + assert start_page >= 1, "Start page should be >= 1" assert end_page >= start_page, "End page should be >= start page" total_pages = end_page - start_page + 1 assert total_pages > 0, "Total pages should be positive" print(f"[PASS] Document has {total_pages} page(s) from {start_page} to {end_page}") - + # Print document unit information - unit = getattr(document_content, 'unit', None) + unit = getattr(document_content, "unit", None) if unit: print(f"[INFO] Document unit: {unit}") else: print("[INFO] Document unit: unknown") - + # Extract and verify fields - fields = getattr(document_content, 'fields', {}) - + fields = getattr(document_content, "fields", {}) + # Extract CustomerName field - customer_name_field = fields.get('CustomerName') + customer_name_field = fields.get("CustomerName") if customer_name_field: print("[PASS] CustomerName field found") - - value = getattr(customer_name_field, 'value', None) + + value = getattr(customer_name_field, "value", None) if value: assert len(str(value)) > 0, "CustomerName value should not be empty when present" print(f"[INFO] Customer Name: {value}") - - confidence = getattr(customer_name_field, 'confidence', None) + + confidence = getattr(customer_name_field, "confidence", None) if confidence is not None: assert 0 <= confidence <= 1, f"CustomerName confidence should be between 0 and 1, but was {confidence}" print(f"[INFO] CustomerName confidence: {confidence:.2f}") - - source = getattr(customer_name_field, 'source', None) + + source = getattr(customer_name_field, "source", None) if source: print(f"[INFO] CustomerName source: {source}") - - spans = getattr(customer_name_field, 'spans', None) + + spans = getattr(customer_name_field, "spans", None) if spans and len(spans) > 0: span = spans[0] - offset = getattr(span, 'offset', None) - length = getattr(span, 'length', None) + offset = getattr(span, "offset", None) + length = getattr(span, "length", None) if offset is not None and length is not None: print(f"[INFO] CustomerName position in markdown: offset={offset}, length={length}") else: print("[INFO] CustomerName field not found in this document") - + # Extract InvoiceDate field - invoice_date_field = fields.get('InvoiceDate') + invoice_date_field = fields.get("InvoiceDate") if invoice_date_field: print("[PASS] InvoiceDate field found") - - value = getattr(invoice_date_field, 'value', None) + + value = getattr(invoice_date_field, "value", None) if value: print(f"[INFO] Invoice Date: {value}") - - confidence = getattr(invoice_date_field, 'confidence', None) + + confidence = getattr(invoice_date_field, "confidence", None) if confidence is not None: assert 0 <= confidence <= 1, f"InvoiceDate confidence should be between 0 and 1" print(f"[INFO] InvoiceDate confidence: {confidence:.2f}") - - source = getattr(invoice_date_field, 'source', None) + + source = getattr(invoice_date_field, "source", None) if source: print(f"[INFO] InvoiceDate source: {source}") else: print("[INFO] InvoiceDate field not found in this document") - + # Extract TotalAmount field (object field with nested Amount and CurrencyCode) - total_amount_field = fields.get('TotalAmount') + total_amount_field = fields.get("TotalAmount") if total_amount_field: print("[PASS] TotalAmount field found") - + # Try to extract nested fields if it's an object - if hasattr(total_amount_field, 'value') and isinstance(total_amount_field.value, dict): + if hasattr(total_amount_field, "value") and isinstance(total_amount_field.value, dict): amount_obj = total_amount_field.value - amount = amount_obj.get('Amount') - currency = amount_obj.get('CurrencyCode', '$') - + amount = amount_obj.get("Amount") + currency = amount_obj.get("CurrencyCode", "$") + if amount: - print(f"[INFO] Total: {currency}{amount:.2f}" if isinstance(amount, (int, float)) else f"[INFO] Total: {currency}{amount}") + print( + f"[INFO] Total: {currency}{amount:.2f}" + if isinstance(amount, (int, float)) + else f"[INFO] Total: {currency}{amount}" + ) else: - value = getattr(total_amount_field, 'value', None) + value = getattr(total_amount_field, "value", None) if value: print(f"[INFO] Total Amount: {value}") - - confidence = getattr(total_amount_field, 'confidence', None) + + confidence = getattr(total_amount_field, "confidence", None) if confidence is not None: print(f"[INFO] TotalAmount confidence: {confidence:.2f}") else: print("[INFO] TotalAmount field not found in this document") - + # Extract LineItems field (array field) - line_items_field = fields.get('LineItems') + line_items_field = fields.get("LineItems") if line_items_field: print("[PASS] LineItems field found") - + # Try to extract array items - if hasattr(line_items_field, 'value') and isinstance(line_items_field.value, list): + if hasattr(line_items_field, "value") and isinstance(line_items_field.value, list): items = line_items_field.value print(f"[INFO] Line Items ({len(items)}):") - + for i, item in enumerate(items[:5]): # Show first 5 items if isinstance(item, dict): - description = item.get('Description', 'N/A') - quantity = item.get('Quantity', 'N/A') + description = item.get("Description", "N/A") + quantity = item.get("Quantity", "N/A") print(f"[INFO] Item {i + 1}: {description} (Qty: {quantity})") - + if len(items) > 5: print(f"[INFO] ... and {len(items) - 5} more items") else: print("[INFO] LineItems format not as expected") else: print("[INFO] LineItems field not found in this document") - + await client.close() print("\n[SUCCESS] All test_sample_analyze_invoice_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py index da6ae5d40ae7..50287f6a4133 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py @@ -29,12 +29,12 @@ class TestSampleAnalyzeReturnRawJson(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document and getting raw JSON response. - + This test validates: 1. Document analysis using 'cls' callback to get raw HTTP response 2. Raw JSON response format 3. JSON structure validation - + 11_AnalyzeReturnRawJson.AnalyzeReturnRawJson() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -42,18 +42,18 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi # Read the sample file tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + # Assertion: Verify file exists assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") - + with open(file_path, "rb") as f: file_bytes = f.read() - + # Assertion: Verify file is not empty assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - + # Use 'cls' callback to get raw HTTP response # The 'cls' parameter allows us to intercept the response before it gets deserialized as an object model # We return a tuple: (deserialized_object, raw_http_response) @@ -66,52 +66,52 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi pipeline_response.http_response, ), ) - + # Wait for completion and get both model and raw HTTP response _, raw_http_response = poller.result() - + # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - + # Assertion: Verify raw HTTP response assert raw_http_response is not None, "Raw HTTP response should not be null" print("[PASS] Raw HTTP response is not null") - + # Parse the raw JSON response response_json = raw_http_response.json() - + # Assertion: Verify JSON is not empty assert response_json is not None, "Response JSON should not be null" print("[PASS] Response JSON parsed successfully") - + # Verify it's valid JSON by serializing json_str = json.dumps(response_json, indent=2, ensure_ascii=False) assert json_str is not None, "Response string should not be null" assert len(json_str) > 0, "Response string should not be empty" print(f"[PASS] Response converted to JSON string: {len(json_str)} characters") - + # Verify the response contains expected structure (matching C# sample validation) assert "result" in response_json, "Response should contain 'result' key" result_data = response_json["result"] print("[PASS] Response contains 'result' key") - + # Verify analyzerId if "analyzerId" in result_data: print(f"[PASS] Analyzer ID: {result_data['analyzerId']}") - + # Verify contents if "contents" in result_data and isinstance(result_data["contents"], list): contents_count = len(result_data["contents"]) print(f"[PASS] Contents count: {contents_count}") - + if contents_count > 0: first_content = result_data["contents"][0] if "kind" in first_content: print(f"[PASS] Content kind: {first_content['kind']}") if "mimeType" in first_content: print(f"[PASS] MIME type: {first_content['mimeType']}") - + print("\n[SUCCESS] All test_sample_analyze_return_raw_json assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py index f9e00b62c0ac..2aec2c6e1b33 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py @@ -29,12 +29,12 @@ class TestSampleAnalyzeReturnRawJsonAsync(ContentUnderstandingClientTestBaseAsyn @recorded_by_proxy_async async def test_sample_analyze_return_raw_json_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document and getting raw JSON response (async version). - + This test validates: 1. Document analysis using 'cls' callback to get raw HTTP response 2. Raw JSON response format 3. JSON structure validation - + 11_AnalyzeReturnRawJson.AnalyzeReturnRawJsonAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -42,18 +42,18 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa # Read the sample file tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + # Assertion: Verify file exists assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") - + with open(file_path, "rb") as f: file_bytes = f.read() - + # Assertion: Verify file is not empty assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - + # Use 'cls' callback to get raw HTTP response # The 'cls' parameter allows us to intercept the response before it gets deserialized as an object model # We return a tuple: (deserialized_object, raw_http_response) @@ -66,53 +66,53 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa pipeline_response.http_response, ), ) - + # Wait for completion and get both model and raw HTTP response _, raw_http_response = await poller.result() - + # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - + # Assertion: Verify raw HTTP response assert raw_http_response is not None, "Raw HTTP response should not be null" print("[PASS] Raw HTTP response is not null") - + # Parse the raw JSON response response_json = raw_http_response.json() - + # Assertion: Verify JSON is not empty assert response_json is not None, "Response JSON should not be null" print("[PASS] Response JSON parsed successfully") - + # Verify it's valid JSON by serializing json_str = json.dumps(response_json, indent=2, ensure_ascii=False) assert json_str is not None, "Response string should not be null" assert len(json_str) > 0, "Response string should not be empty" print(f"[PASS] Response converted to JSON string: {len(json_str)} characters") - + # Verify the response contains expected structure (matching C# sample validation) assert "result" in response_json, "Response should contain 'result' key" result_data = response_json["result"] print("[PASS] Response contains 'result' key") - + # Verify analyzerId if "analyzerId" in result_data: print(f"[PASS] Analyzer ID: {result_data['analyzerId']}") - + # Verify contents if "contents" in result_data and isinstance(result_data["contents"], list): contents_count = len(result_data["contents"]) print(f"[PASS] Contents count: {contents_count}") - + if contents_count > 0: first_content = result_data["contents"][0] if "kind" in first_content: print(f"[PASS] Content kind: {first_content['kind']}") if "mimeType" in first_content: print(f"[PASS] MIME type: {first_content['mimeType']}") - + await client.close() print("\n[SUCCESS] All test_sample_analyze_return_raw_json_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py index 5bf0e0f0ae81..9681fae5a71a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 # ------------------------------------------------------------------------- @@ -30,13 +31,13 @@ class TestSampleAnalyzeUrl(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_analyze_url(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document from URL. - + This test validates: 1. URL validation 2. Document analysis using begin_analyze with URL input 3. Markdown content extraction 4. Document properties (MIME type, pages, tables) - + 02_AnalyzeUrl.AnalyzeUrlAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -46,58 +47,56 @@ def test_sample_analyze_url(self, azure_content_understanding_endpoint: str) -> # For testing, we'll use binary data instead since file:// URLs are not supported tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + # Read file as binary data (since test proxy doesn't support file:// URLs) with open(file_path, "rb") as f: file_data = f.read() - + print(f"[PASS] Document loaded from: {file_path}") - + # Analyze the document - poller = client.begin_analyze( - analyzer_id="prebuilt-documentSearch", - inputs=[AnalyzeInput(data=file_data)] - ) - + poller = client.begin_analyze(analyzer_id="prebuilt-documentSearch", inputs=[AnalyzeInput(data=file_data)]) + result = poller.result() - + # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - + # Verify raw response - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_initial_response'): - raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if hasattr(poller, "_polling_method"): + polling_method = getattr(poller, "_polling_method", None) + if polling_method and hasattr(polling_method, "_initial_response"): + raw_response = getattr(polling_method, "_initial_response", None) # type: ignore if raw_response: - if hasattr(raw_response, 'http_response'): + if hasattr(raw_response, "http_response"): status = raw_response.http_response.status_code - elif hasattr(raw_response, 'status_code'): + elif hasattr(raw_response, "status_code"): status = raw_response.status_code else: status = None - + if status: - assert status >= 200 and status < 300, \ - f"Response status should be successful (200-299), but was {status}" + assert ( + status >= 200 and status < 300 + ), f"Response status should be successful (200-299), but was {status}" print(f"[PASS] Raw response verified (status: {status})") - + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - + # Assertion: Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" assert result.contents is not None, "Result contents should not be null" print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") - + # Test markdown extraction self._test_markdown_extraction(result) - + # Test document properties access self._test_document_properties(result) - + print("\n[SUCCESS] All test_sample_analyze_url assertions passed") def _test_markdown_extraction(self, result): @@ -105,10 +104,10 @@ def _test_markdown_extraction(self, result): assert result.contents is not None, "Result should contain contents" assert len(result.contents) > 0, "Result should have at least one content" assert len(result.contents) == 1, "PDF file should have exactly one content element" - + content = result.contents[0] assert content is not None, "Content should not be null" - + markdown = getattr(content, "markdown", None) if markdown: assert isinstance(markdown, str), "Markdown should be a string" @@ -122,15 +121,15 @@ def _test_document_properties(self, result): """Test document property access.""" content = result.contents[0] assert content is not None, "Content should not be null for document properties validation" - + content_type = type(content).__name__ print(f"[INFO] Content type: {content_type}") - - is_document_content = hasattr(content, 'mime_type') and hasattr(content, 'start_page_number') + + is_document_content = hasattr(content, "mime_type") and hasattr(content, "start_page_number") if not is_document_content: print(f"[WARN] Expected DocumentContent but got {content_type}, skipping document-specific validations") return - + # Validate MIME type mime_type = getattr(content, "mime_type", None) if mime_type: @@ -138,92 +137,99 @@ def _test_document_properties(self, result): assert mime_type.strip(), "MIME type should not be empty" assert mime_type == "application/pdf", f"MIME type should be application/pdf, but was {mime_type}" print(f"[PASS] MIME type verified: {mime_type}") - + # Validate page numbers start_page = getattr(content, "start_page_number", None) if start_page is not None: assert start_page >= 1, f"Start page should be >= 1, but was {start_page}" - + end_page = getattr(content, "end_page_number", None) if end_page is not None: assert end_page >= start_page, f"End page {end_page} should be >= start page {start_page}" total_pages = end_page - start_page + 1 assert total_pages > 0, f"Total pages should be positive, but was {total_pages}" print(f"[PASS] Page range verified: {start_page} to {end_page} ({total_pages} pages)") - + pages = getattr(content, "pages", None) if pages and len(pages) > 0: assert len(pages) > 0, "Pages collection should not be empty when not null" - assert len(pages) == total_pages, \ - f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" + assert ( + len(pages) == total_pages + ), f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" print(f"[PASS] Pages collection verified: {len(pages)} pages") self._validate_pages(pages, start_page, end_page, content) else: print("[WARN] No pages collection available in document content") - + tables = getattr(content, "tables", None) if tables and len(tables) > 0: self._validate_tables(tables) else: print("No tables found in document content") - + print("[PASS] All document properties validated successfully") def _validate_pages(self, pages, start_page, end_page, content=None): """Validate pages collection details.""" page_numbers = set() - unit = getattr(content, 'unit', None) if content else None + unit = getattr(content, "unit", None) if content else None unit_str = str(unit) if unit else "units" - + for page in pages: assert page is not None, "Page object should not be null" assert hasattr(page, "page_number"), "Page should have page_number attribute" assert page.page_number >= 1, f"Page number should be >= 1, but was {page.page_number}" - assert start_page <= page.page_number <= end_page, \ - f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" - - assert hasattr(page, "width") and page.width > 0, \ - f"Page {page.page_number} width should be > 0, but was {page.width}" - assert hasattr(page, "height") and page.height > 0, \ - f"Page {page.page_number} height should be > 0, but was {page.height}" - - assert page.page_number not in page_numbers, \ - f"Page number {page.page_number} appears multiple times" + assert ( + start_page <= page.page_number <= end_page + ), f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" + + assert ( + hasattr(page, "width") and page.width > 0 + ), f"Page {page.page_number} width should be > 0, but was {page.width}" + assert ( + hasattr(page, "height") and page.height > 0 + ), f"Page {page.page_number} height should be > 0, but was {page.height}" + + assert page.page_number not in page_numbers, f"Page number {page.page_number} appears multiple times" page_numbers.add(page.page_number) - + print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") - + print(f"[PASS] All {len(pages)} pages validated successfully") def _validate_tables(self, tables): """Validate tables collection details.""" assert len(tables) > 0, "Tables collection should not be empty when not null" print(f"[PASS] Tables collection verified: {len(tables)} tables") - + for i, table in enumerate(tables, 1): assert table is not None, f"Table {i} should not be null" assert hasattr(table, "row_count"), f"Table {i} should have row_count attribute" assert hasattr(table, "column_count"), f"Table {i} should have column_count attribute" assert table.row_count > 0, f"Table {i} should have at least 1 row, but had {table.row_count}" assert table.column_count > 0, f"Table {i} should have at least 1 column, but had {table.column_count}" - + if hasattr(table, "cells") and table.cells: assert len(table.cells) > 0, f"Table {i} cells collection should not be empty when not null" - + for cell in table.cells: assert cell is not None, "Table cell should not be null" assert hasattr(cell, "row_index"), "Cell should have row_index" assert hasattr(cell, "column_index"), "Cell should have column_index" - assert 0 <= cell.row_index < table.row_count, \ - f"Cell row index {cell.row_index} should be within table row count {table.row_count}" - assert 0 <= cell.column_index < table.column_count, \ - f"Cell column index {cell.column_index} should be within table column count {table.column_count}" - + assert ( + 0 <= cell.row_index < table.row_count + ), f"Cell row index {cell.row_index} should be within table row count {table.row_count}" + assert ( + 0 <= cell.column_index < table.column_count + ), f"Cell column index {cell.column_index} should be within table column count {table.column_count}" + if hasattr(cell, "row_span"): assert cell.row_span >= 1, f"Cell row span should be >= 1, but was {cell.row_span}" if hasattr(cell, "column_span"): assert cell.column_span >= 1, f"Cell column span should be >= 1, but was {cell.column_span}" - - print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)") + + print( + f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)" + ) else: print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py index 1118f00c20c5..49580552cea4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 # ------------------------------------------------------------------------- @@ -30,13 +31,13 @@ class TestSampleAnalyzeUrlAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_analyze_url_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document from URL (async version). - + This test validates: 1. URL validation 2. Document analysis using begin_analyze with URL input 3. Markdown content extraction 4. Document properties (MIME type, pages, tables) - + 02_AnalyzeUrl.AnalyzeUrlAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -46,58 +47,58 @@ async def test_sample_analyze_url_async(self, azure_content_understanding_endpoi # For testing, we'll use binary data instead since file:// URLs are not supported tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + # Read file as binary data (since test proxy doesn't support file:// URLs) with open(file_path, "rb") as f: file_data = f.read() - + print(f"[PASS] Document loaded from: {file_path}") - + # Analyze the document poller = await client.begin_analyze( - analyzer_id="prebuilt-documentSearch", - inputs=[AnalyzeInput(data=file_data)] + analyzer_id="prebuilt-documentSearch", inputs=[AnalyzeInput(data=file_data)] ) - + result = await poller.result() - + # Assertion: Verify analysis operation completed assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" - + # Verify raw response - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_initial_response'): - raw_response = getattr(polling_method, '_initial_response', None) # type: ignore + if hasattr(poller, "_polling_method"): + polling_method = getattr(poller, "_polling_method", None) + if polling_method and hasattr(polling_method, "_initial_response"): + raw_response = getattr(polling_method, "_initial_response", None) # type: ignore if raw_response: - if hasattr(raw_response, 'http_response'): + if hasattr(raw_response, "http_response"): status = raw_response.http_response.status_code - elif hasattr(raw_response, 'status_code'): + elif hasattr(raw_response, "status_code"): status = raw_response.status_code else: status = None - + if status: - assert status >= 200 and status < 300, \ - f"Response status should be successful (200-299), but was {status}" + assert ( + status >= 200 and status < 300 + ), f"Response status should be successful (200-299), but was {status}" print(f"[PASS] Raw response verified (status: {status})") - + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" print("[PASS] Analysis operation completed successfully") - + # Assertion: Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" assert result.contents is not None, "Result contents should not be null" print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") - + # Test markdown extraction self._test_markdown_extraction(result) - + # Test document properties access self._test_document_properties(result) - + await client.close() print("\n[SUCCESS] All test_sample_analyze_url_async assertions passed") @@ -106,10 +107,10 @@ def _test_markdown_extraction(self, result): assert result.contents is not None, "Result should contain contents" assert len(result.contents) > 0, "Result should have at least one content" assert len(result.contents) == 1, "PDF file should have exactly one content element" - + content = result.contents[0] assert content is not None, "Content should not be null" - + markdown = getattr(content, "markdown", None) if markdown: assert isinstance(markdown, str), "Markdown should be a string" @@ -123,15 +124,15 @@ def _test_document_properties(self, result): """Test document property access.""" content = result.contents[0] assert content is not None, "Content should not be null for document properties validation" - + content_type = type(content).__name__ print(f"[INFO] Content type: {content_type}") - - is_document_content = hasattr(content, 'mime_type') and hasattr(content, 'start_page_number') + + is_document_content = hasattr(content, "mime_type") and hasattr(content, "start_page_number") if not is_document_content: print(f"[WARN] Expected DocumentContent but got {content_type}, skipping document-specific validations") return - + # Validate MIME type mime_type = getattr(content, "mime_type", None) if mime_type: @@ -139,92 +140,99 @@ def _test_document_properties(self, result): assert mime_type.strip(), "MIME type should not be empty" assert mime_type == "application/pdf", f"MIME type should be application/pdf, but was {mime_type}" print(f"[PASS] MIME type verified: {mime_type}") - + # Validate page numbers start_page = getattr(content, "start_page_number", None) if start_page is not None: assert start_page >= 1, f"Start page should be >= 1, but was {start_page}" - + end_page = getattr(content, "end_page_number", None) if end_page is not None: assert end_page >= start_page, f"End page {end_page} should be >= start page {start_page}" total_pages = end_page - start_page + 1 assert total_pages > 0, f"Total pages should be positive, but was {total_pages}" print(f"[PASS] Page range verified: {start_page} to {end_page} ({total_pages} pages)") - + pages = getattr(content, "pages", None) if pages and len(pages) > 0: assert len(pages) > 0, "Pages collection should not be empty when not null" - assert len(pages) == total_pages, \ - f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" + assert ( + len(pages) == total_pages + ), f"Pages collection count {len(pages)} should match calculated total pages {total_pages}" print(f"[PASS] Pages collection verified: {len(pages)} pages") self._validate_pages(pages, start_page, end_page, content) else: print("[WARN] No pages collection available in document content") - + tables = getattr(content, "tables", None) if tables and len(tables) > 0: self._validate_tables(tables) else: print("No tables found in document content") - + print("[PASS] All document properties validated successfully") def _validate_pages(self, pages, start_page, end_page, content=None): """Validate pages collection details.""" page_numbers = set() - unit = getattr(content, 'unit', None) if content else None + unit = getattr(content, "unit", None) if content else None unit_str = str(unit) if unit else "units" - + for page in pages: assert page is not None, "Page object should not be null" assert hasattr(page, "page_number"), "Page should have page_number attribute" assert page.page_number >= 1, f"Page number should be >= 1, but was {page.page_number}" - assert start_page <= page.page_number <= end_page, \ - f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" - - assert hasattr(page, "width") and page.width > 0, \ - f"Page {page.page_number} width should be > 0, but was {page.width}" - assert hasattr(page, "height") and page.height > 0, \ - f"Page {page.page_number} height should be > 0, but was {page.height}" - - assert page.page_number not in page_numbers, \ - f"Page number {page.page_number} appears multiple times" + assert ( + start_page <= page.page_number <= end_page + ), f"Page number {page.page_number} should be within document range [{start_page}, {end_page}]" + + assert ( + hasattr(page, "width") and page.width > 0 + ), f"Page {page.page_number} width should be > 0, but was {page.width}" + assert ( + hasattr(page, "height") and page.height > 0 + ), f"Page {page.page_number} height should be > 0, but was {page.height}" + + assert page.page_number not in page_numbers, f"Page number {page.page_number} appears multiple times" page_numbers.add(page.page_number) - + print(f" Page {page.page_number}: {page.width} x {page.height} {unit_str}") - + print(f"[PASS] All {len(pages)} pages validated successfully") def _validate_tables(self, tables): """Validate tables collection details.""" assert len(tables) > 0, "Tables collection should not be empty when not null" print(f"[PASS] Tables collection verified: {len(tables)} tables") - + for i, table in enumerate(tables, 1): assert table is not None, f"Table {i} should not be null" assert hasattr(table, "row_count"), f"Table {i} should have row_count attribute" assert hasattr(table, "column_count"), f"Table {i} should have column_count attribute" assert table.row_count > 0, f"Table {i} should have at least 1 row, but had {table.row_count}" assert table.column_count > 0, f"Table {i} should have at least 1 column, but had {table.column_count}" - + if hasattr(table, "cells") and table.cells: assert len(table.cells) > 0, f"Table {i} cells collection should not be empty when not null" - + for cell in table.cells: assert cell is not None, "Table cell should not be null" assert hasattr(cell, "row_index"), "Cell should have row_index" assert hasattr(cell, "column_index"), "Cell should have column_index" - assert 0 <= cell.row_index < table.row_count, \ - f"Cell row index {cell.row_index} should be within table row count {table.row_count}" - assert 0 <= cell.column_index < table.column_count, \ - f"Cell column index {cell.column_index} should be within table column count {table.column_count}" - + assert ( + 0 <= cell.row_index < table.row_count + ), f"Cell row index {cell.row_index} should be within table row count {table.row_count}" + assert ( + 0 <= cell.column_index < table.column_count + ), f"Cell column index {cell.column_index} should be within table column count {table.column_count}" + if hasattr(cell, "row_span"): assert cell.row_span >= 1, f"Cell row span should be >= 1, but was {cell.row_span}" if hasattr(cell, "column_span"): assert cell.column_span >= 1, f"Cell column span should be >= 1, but was {cell.column_span}" - - print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)") + + print( + f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns ({len(table.cells)} cells)" + ) else: print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py index c3e1479713a4..8007337033d5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py @@ -28,90 +28,88 @@ class TestSampleConfigureDefaults(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_configure_defaults(self, azure_content_understanding_endpoint: str) -> None: """Test configuring and getting model deployment defaults. - + This test validates: 1. Optional model deployment configuration (UpdateDefaults) 2. Getting current defaults (GetDefaults) 3. Model deployment mappings structure - + 00_ConfigureDefaults.ConfigureDefaultsAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) # Test UpdateDefaults - only if deployment names are provided self._test_update_defaults(client) - + # Test GetDefaults - always run self._test_get_defaults(client) - + print("\n[SUCCESS] All test_sample_configure_defaults assertions passed") def _test_update_defaults(self, client): - """Test updating model deployment defaults. - - - """ + """Test updating model deployment defaults.""" # Check if deployment names are configured in environment # In Python tests, these would come from environment variables or test configuration # For now, we'll check if the deployments are configured - + try: # Get current defaults to check structure response = client.get_defaults() current_defaults = response - + # Verify the response structure exists assert current_defaults is not None, "GetDefaults response should not be null" - + # Check if model_deployments attribute exists model_deployments = getattr(current_defaults, "model_deployments", None) - + if model_deployments and len(model_deployments) > 0: print(f"[PASS] UpdateDefaults: Model deployments already configured ({len(model_deployments)} models)") - + # Validate structure of existing deployments assert isinstance(model_deployments, dict), "Model deployments should be a dictionary" - + for key, value in model_deployments.items(): assert isinstance(key, str) and key.strip(), f"Model key should be non-empty string, got {key}" - assert isinstance(value, str) and value.strip(), f"Deployment value should be non-empty string for key {key}" + assert ( + isinstance(value, str) and value.strip() + ), f"Deployment value should be non-empty string for key {key}" print(f" {key} → {value}") else: print("[WARN] UpdateDefaults: No model deployments configured (this is optional)") - + except Exception as e: # If update_defaults is not available or fails, that's okay print(f"[WARN] UpdateDefaults: Skipping - {str(e)}") def _test_get_defaults(self, client): """Test getting current model deployment defaults. - - and assertions + + and assertions """ # Get current defaults get_response = client.get_defaults() - + # Assertion: Verify response is not null assert get_response is not None, "GetDefaults response should not be null" print("[PASS] GetDefaults: Successfully retrieved defaults") - + # Get the defaults object defaults = get_response - + # Assertion: Verify defaults object assert defaults is not None, "Defaults object should not be null" - + # Check model deployments attribute model_deployments = getattr(defaults, "model_deployments", None) - + if model_deployments: # Assertion: Verify model_deployments structure - assert isinstance(model_deployments, dict), \ - "model_deployments should be a dictionary" - + assert isinstance(model_deployments, dict), "model_deployments should be a dictionary" + if len(model_deployments) > 0: print(f"[PASS] Current model deployment mappings ({len(model_deployments)} models):") - + # Assertion: Validate each deployment mapping for key, value in model_deployments.items(): assert isinstance(key, str), f"Model key should be string, got {type(key)}" @@ -119,12 +117,12 @@ def _test_get_defaults(self, client): assert isinstance(value, str), f"Deployment value should be string for key {key}, got {type(value)}" assert value.strip(), f"Deployment value should not be empty for key {key}" print(f" {key} → {value}") - + # Assertion: Check for expected model keys (if any configured) # Common models: gpt-4.1, gpt-4.1-mini, text-embedding-3-large expected_keys = {"gpt-4.1", "gpt-4.1-mini", "text-embedding-3-large"} found_keys = set(model_deployments.keys()) - + if found_keys & expected_keys: # If any expected keys are present common_keys = found_keys & expected_keys print(f"[PASS] Found expected model keys: {', '.join(sorted(common_keys))}") @@ -133,6 +131,5 @@ def _test_get_defaults(self, client): else: # No model deployments is a valid state print(" No model deployments configured yet (model_deployments attribute not present)") - - print("[PASS] GetDefaults: All assertions passed") + print("[PASS] GetDefaults: All assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py index d8bfa324e450..01f5cb77a391 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py @@ -28,91 +28,89 @@ class TestSampleConfigureDefaultsAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_configure_defaults_async(self, azure_content_understanding_endpoint: str) -> None: """Test configuring and getting model deployment defaults (async version). - + This test validates: 1. Optional model deployment configuration (UpdateDefaults) 2. Getting current defaults (GetDefaults) 3. Model deployment mappings structure - + 00_ConfigureDefaults.ConfigureDefaultsAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) # Test UpdateDefaults - only if deployment names are provided await self._test_update_defaults(client) - + # Test GetDefaults - always run await self._test_get_defaults(client) - + await client.close() print("\n[SUCCESS] All test_sample_configure_defaults_async assertions passed") async def _test_update_defaults(self, client): - """Test updating model deployment defaults. - - - """ + """Test updating model deployment defaults.""" # Check if deployment names are configured in environment # In Python tests, these would come from environment variables or test configuration # For now, we'll check if the deployments are configured - + try: # Get current defaults to check structure response = await client.get_defaults() current_defaults = response - + # Verify the response structure exists assert current_defaults is not None, "GetDefaults response should not be null" - + # Check if model_deployments attribute exists model_deployments = getattr(current_defaults, "model_deployments", None) - + if model_deployments and len(model_deployments) > 0: print(f"[PASS] UpdateDefaults: Model deployments already configured ({len(model_deployments)} models)") - + # Validate structure of existing deployments assert isinstance(model_deployments, dict), "Model deployments should be a dictionary" - + for key, value in model_deployments.items(): assert isinstance(key, str) and key.strip(), f"Model key should be non-empty string, got {key}" - assert isinstance(value, str) and value.strip(), f"Deployment value should be non-empty string for key {key}" + assert ( + isinstance(value, str) and value.strip() + ), f"Deployment value should be non-empty string for key {key}" print(f" {key} → {value}") else: print("[WARN] UpdateDefaults: No model deployments configured (this is optional)") - + except Exception as e: # If update_defaults is not available or fails, that's okay print(f"[WARN] UpdateDefaults: Skipping - {str(e)}") async def _test_get_defaults(self, client): """Test getting current model deployment defaults. - - and assertions + + and assertions """ # Get current defaults get_response = await client.get_defaults() - + # Assertion: Verify response is not null assert get_response is not None, "GetDefaults response should not be null" print("[PASS] GetDefaults: Successfully retrieved defaults") - + # Get the defaults object defaults = get_response - + # Assertion: Verify defaults object assert defaults is not None, "Defaults object should not be null" - + # Check model deployments attribute model_deployments = getattr(defaults, "model_deployments", None) - + if model_deployments: # Assertion: Verify model_deployments structure - assert isinstance(model_deployments, dict), \ - "model_deployments should be a dictionary" - + assert isinstance(model_deployments, dict), "model_deployments should be a dictionary" + if len(model_deployments) > 0: print(f"[PASS] Current model deployment mappings ({len(model_deployments)} models):") - + # Assertion: Validate each deployment mapping for key, value in model_deployments.items(): assert isinstance(key, str), f"Model key should be string, got {type(key)}" @@ -120,12 +118,12 @@ async def _test_get_defaults(self, client): assert isinstance(value, str), f"Deployment value should be string for key {key}, got {type(value)}" assert value.strip(), f"Deployment value should not be empty for key {key}" print(f" {key} → {value}") - + # Assertion: Check for expected model keys (if any configured) # Common models: gpt-4.1, gpt-4.1-mini, text-embedding-3-large expected_keys = {"gpt-4.1", "gpt-4.1-mini", "text-embedding-3-large"} found_keys = set(model_deployments.keys()) - + if found_keys & expected_keys: # If any expected keys are present common_keys = found_keys & expected_keys print(f"[PASS] Found expected model keys: {', '.join(sorted(common_keys))}") @@ -134,5 +132,5 @@ async def _test_get_defaults(self, client): else: # No model deployments is a valid state print(" No model deployments configured yet (model_deployments attribute not present)") - + print("[PASS] GetDefaults: All assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py index b12ede558157..ee5306a131c8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py @@ -26,7 +26,7 @@ ContentFieldSchema, ContentFieldDefinition, ContentFieldType, - GenerationMethod + GenerationMethod, ) @@ -37,149 +37,144 @@ class TestSampleCopyAnalyzer(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_copy_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test copying an analyzer (within same resource or across resources). - + This test validates: 1. Creating a source analyzer with complex configuration 2. Initiating a copy operation 3. Verifying the copy completed successfully 4. Validating the target analyzer has the same configuration - + 14_CopyAnalyzer.CopyAnalyzerAsync() - + Note: This test requires copy API support. If not available, test will be skipped. """ # Skip this test if API is not available try: client = self.create_client(endpoint=azure_content_understanding_endpoint) - + # Generate unique analyzer IDs for this test source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex}" target_analyzer_id = f"test_analyzer_target_{uuid.uuid4().hex}" - + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") print(f"[INFO] Target analyzer ID: {target_analyzer_id}") - + assert source_analyzer_id is not None, "Source analyzer ID should not be null" assert len(source_analyzer_id) > 0, "Source analyzer ID should not be empty" assert target_analyzer_id is not None, "Target analyzer ID should not be null" assert len(target_analyzer_id) > 0, "Target analyzer ID should not be empty" assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" print("[PASS] Analyzer IDs verified") - + # Step 1: Create the source analyzer with complex configuration source_config = ContentAnalyzerConfig( enable_formula=False, enable_layout=True, enable_ocr=True, estimate_field_source_and_confidence=True, - return_details=True + return_details=True, ) - + # Verify source config assert source_config is not None, "Source config should not be null" assert source_config.enable_formula is False, "EnableFormula should be false" assert source_config.enable_layout is True, "EnableLayout should be true" assert source_config.enable_ocr is True, "EnableOcr should be true" - assert source_config.estimate_field_source_and_confidence is True, "EstimateFieldSourceAndConfidence should be true" + assert ( + source_config.estimate_field_source_and_confidence is True + ), "EstimateFieldSourceAndConfidence should be true" assert source_config.return_details is True, "ReturnDetails should be true" print("[PASS] Source config verified") - + # Create field schema source_field_schema = ContentFieldSchema( name="company_schema", description="Schema for extracting company information", fields={ "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company" + type=ContentFieldType.STRING, method=GenerationMethod.EXTRACT, description="Name of the company" ), "total_amount": ContentFieldDefinition( type=ContentFieldType.NUMBER, method=GenerationMethod.EXTRACT, - description="Total amount on the document" - ) - } + description="Total amount on the document", + ), + }, ) - + # Verify field schema assert source_field_schema is not None, "Source field schema should not be null" assert source_field_schema.name == "company_schema", "Field schema name should match" - assert source_field_schema.description == "Schema for extracting company information", "Field schema description should match" + assert ( + source_field_schema.description == "Schema for extracting company information" + ), "Field schema description should match" assert len(source_field_schema.fields) == 2, "Should have 2 fields" print(f"[PASS] Source field schema verified: {source_field_schema.name}") - + # Verify individual fields assert "company_name" in source_field_schema.fields, "Should contain company_name field" company_name_field = source_field_schema.fields["company_name"] assert company_name_field.type == ContentFieldType.STRING, "company_name should be String type" assert company_name_field.method == GenerationMethod.EXTRACT, "company_name should use Extract method" print("[PASS] company_name field verified") - + assert "total_amount" in source_field_schema.fields, "Should contain total_amount field" total_amount_field = source_field_schema.fields["total_amount"] assert total_amount_field.type == ContentFieldType.NUMBER, "total_amount should be Number type" assert total_amount_field.method == GenerationMethod.EXTRACT, "total_amount should use Extract method" print("[PASS] total_amount field verified") - + # Create source analyzer source_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Source analyzer for copying", config=source_config, field_schema=source_field_schema, - models={ - "completion": "gpt-4.1" - }, - tags={ - "modelType": "in_development" - } + models={"completion": "gpt-4.1"}, + tags={"modelType": "in_development"}, ) - + # Create the source analyzer create_poller = client.begin_create_analyzer( - analyzer_id=source_analyzer_id, - resource=source_analyzer, - allow_replace=True + analyzer_id=source_analyzer_id, resource=source_analyzer, allow_replace=True ) source_result = create_poller.result() print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") - + # Step 2: Copy the analyzer # Note: Copy API may require authorization token for cross-resource copying # For same-resource copying, no authorization is needed print(f"\n[INFO] Attempting to copy analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'") - + # Check if copy_analyzer API exists - if not hasattr(client, 'begin_copy_analyzer') and not hasattr(client, 'copy_analyzer'): + if not hasattr(client, "begin_copy_analyzer") and not hasattr(client, "copy_analyzer"): pytest.skip("Copy analyzer API not available") - + # Try to copy (this may not be implemented yet) try: - if hasattr(client, 'begin_copy_analyzer'): + if hasattr(client, "begin_copy_analyzer"): # begin_copy_analyzer requires: # - analyzer_id: target analyzer ID # - source_analyzer_id: source analyzer ID (as keyword arg) copy_poller = client.begin_copy_analyzer( # type: ignore - analyzer_id=target_analyzer_id, - source_analyzer_id=source_analyzer_id + analyzer_id=target_analyzer_id, source_analyzer_id=source_analyzer_id ) copy_result = copy_poller.result() # type: ignore print(f"[PASS] Analyzer copied successfully to '{target_analyzer_id}'") else: print("[INFO] Copy analyzer API not yet implemented in Python SDK") pytest.skip("Copy analyzer API not yet implemented") - + except Exception as copy_error: error_msg = str(copy_error).lower() if "not found" in error_msg or "not implemented" in error_msg or "not supported" in error_msg: print(f"[INFO] Copy API not available: {str(copy_error)[:100]}") pytest.skip(f"Copy analyzer API not available: {str(copy_error)[:100]}") raise - + print("\n[SUCCESS] All test_sample_copy_analyzer assertions passed") print("[INFO] Copy analyzer functionality demonstrated") - + except Exception as e: error_msg = str(e).lower() if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: @@ -188,16 +183,16 @@ def test_sample_copy_analyzer(self, azure_content_understanding_endpoint: str) - finally: # Clean up: delete test analyzers try: - if 'source_analyzer_id' in locals() and 'client' in locals(): + if "source_analyzer_id" in locals() and "client" in locals(): client.delete_analyzer(analyzer_id=source_analyzer_id) # type: ignore print(f"\n[INFO] Source analyzer deleted: {source_analyzer_id}") # type: ignore except Exception as cleanup_error: print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") - + try: - if 'target_analyzer_id' in locals() and 'client' in locals(): + if "target_analyzer_id" in locals() and "client" in locals(): # Only try to delete if copy succeeded - if 'copy_result' in locals(): + if "copy_result" in locals(): client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore print(f"[INFO] Target analyzer deleted: {target_analyzer_id}") # type: ignore except Exception as cleanup_error: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py index 113919d9b2d6..8cb593e6cdda 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py @@ -26,7 +26,7 @@ ContentFieldSchema, ContentFieldDefinition, ContentFieldType, - GenerationMethod + GenerationMethod, ) @@ -37,149 +37,144 @@ class TestSampleCopyAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_copy_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """Test copying an analyzer (within same resource or across resources) (async version). - + This test validates: 1. Creating a source analyzer with complex configuration 2. Initiating a copy operation 3. Verifying the copy completed successfully 4. Validating the target analyzer has the same configuration - + 14_CopyAnalyzer.CopyAnalyzerAsync() - + Note: This test requires copy API support. If not available, test will be skipped. """ # Skip this test if API is not available try: client = self.create_async_client(endpoint=azure_content_understanding_endpoint) - + # Generate unique analyzer IDs for this test source_analyzer_id = f"test_analyzer_source_{uuid.uuid4().hex}" target_analyzer_id = f"test_analyzer_target_{uuid.uuid4().hex}" - + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") print(f"[INFO] Target analyzer ID: {target_analyzer_id}") - + assert source_analyzer_id is not None, "Source analyzer ID should not be null" assert len(source_analyzer_id) > 0, "Source analyzer ID should not be empty" assert target_analyzer_id is not None, "Target analyzer ID should not be null" assert len(target_analyzer_id) > 0, "Target analyzer ID should not be empty" assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" print("[PASS] Analyzer IDs verified") - + # Step 1: Create the source analyzer with complex configuration source_config = ContentAnalyzerConfig( enable_formula=False, enable_layout=True, enable_ocr=True, estimate_field_source_and_confidence=True, - return_details=True + return_details=True, ) - + # Verify source config assert source_config is not None, "Source config should not be null" assert source_config.enable_formula is False, "EnableFormula should be false" assert source_config.enable_layout is True, "EnableLayout should be true" assert source_config.enable_ocr is True, "EnableOcr should be true" - assert source_config.estimate_field_source_and_confidence is True, "EstimateFieldSourceAndConfidence should be true" + assert ( + source_config.estimate_field_source_and_confidence is True + ), "EstimateFieldSourceAndConfidence should be true" assert source_config.return_details is True, "ReturnDetails should be true" print("[PASS] Source config verified") - + # Create field schema source_field_schema = ContentFieldSchema( name="company_schema", description="Schema for extracting company information", fields={ "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company" + type=ContentFieldType.STRING, method=GenerationMethod.EXTRACT, description="Name of the company" ), "total_amount": ContentFieldDefinition( type=ContentFieldType.NUMBER, method=GenerationMethod.EXTRACT, - description="Total amount on the document" - ) - } + description="Total amount on the document", + ), + }, ) - + # Verify field schema assert source_field_schema is not None, "Source field schema should not be null" assert source_field_schema.name == "company_schema", "Field schema name should match" - assert source_field_schema.description == "Schema for extracting company information", "Field schema description should match" + assert ( + source_field_schema.description == "Schema for extracting company information" + ), "Field schema description should match" assert len(source_field_schema.fields) == 2, "Should have 2 fields" print(f"[PASS] Source field schema verified: {source_field_schema.name}") - + # Verify individual fields assert "company_name" in source_field_schema.fields, "Should contain company_name field" company_name_field = source_field_schema.fields["company_name"] assert company_name_field.type == ContentFieldType.STRING, "company_name should be String type" assert company_name_field.method == GenerationMethod.EXTRACT, "company_name should use Extract method" print("[PASS] company_name field verified") - + assert "total_amount" in source_field_schema.fields, "Should contain total_amount field" total_amount_field = source_field_schema.fields["total_amount"] assert total_amount_field.type == ContentFieldType.NUMBER, "total_amount should be Number type" assert total_amount_field.method == GenerationMethod.EXTRACT, "total_amount should use Extract method" print("[PASS] total_amount field verified") - + # Create source analyzer source_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Source analyzer for copying", config=source_config, field_schema=source_field_schema, - models={ - "completion": "gpt-4.1" - }, - tags={ - "modelType": "in_development" - } + models={"completion": "gpt-4.1"}, + tags={"modelType": "in_development"}, ) - + # Create the source analyzer create_poller = await client.begin_create_analyzer( - analyzer_id=source_analyzer_id, - resource=source_analyzer, - allow_replace=True + analyzer_id=source_analyzer_id, resource=source_analyzer, allow_replace=True ) source_result = await create_poller.result() print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") - + # Step 2: Copy the analyzer # Note: Copy API may require authorization token for cross-resource copying # For same-resource copying, no authorization is needed print(f"\n[INFO] Attempting to copy analyzer from '{source_analyzer_id}' to '{target_analyzer_id}'") - + # Check if copy_analyzer API exists - if not hasattr(client, 'begin_copy_analyzer') and not hasattr(client, 'copy_analyzer'): + if not hasattr(client, "begin_copy_analyzer") and not hasattr(client, "copy_analyzer"): pytest.skip("Copy analyzer API not available") - + # Try to copy (this may not be implemented yet) try: - if hasattr(client, 'begin_copy_analyzer'): + if hasattr(client, "begin_copy_analyzer"): # begin_copy_analyzer requires: # - analyzer_id: target analyzer ID # - source_analyzer_id: source analyzer ID (as keyword arg) copy_poller = await client.begin_copy_analyzer( # type: ignore - analyzer_id=target_analyzer_id, - source_analyzer_id=source_analyzer_id + analyzer_id=target_analyzer_id, source_analyzer_id=source_analyzer_id ) copy_result = await copy_poller.result() # type: ignore print(f"[PASS] Analyzer copied successfully to '{target_analyzer_id}'") else: print("[INFO] Copy analyzer API not yet implemented in Python SDK") pytest.skip("Copy analyzer API not yet implemented") - + except Exception as copy_error: error_msg = str(copy_error).lower() if "not found" in error_msg or "not implemented" in error_msg or "not supported" in error_msg: print(f"[INFO] Copy API not available: {str(copy_error)[:100]}") pytest.skip(f"Copy analyzer API not available: {str(copy_error)[:100]}") raise - + print("\n[SUCCESS] All test_sample_copy_analyzer_async assertions passed") print("[INFO] Copy analyzer functionality demonstrated") - + except Exception as e: error_msg = str(e).lower() if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: @@ -188,23 +183,23 @@ async def test_sample_copy_analyzer_async(self, azure_content_understanding_endp finally: # Clean up: delete test analyzers try: - if 'source_analyzer_id' in locals() and 'client' in locals(): + if "source_analyzer_id" in locals() and "client" in locals(): await client.delete_analyzer(analyzer_id=source_analyzer_id) # type: ignore print(f"\n[INFO] Source analyzer deleted: {source_analyzer_id}") # type: ignore except Exception as cleanup_error: print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") - + try: - if 'target_analyzer_id' in locals() and 'client' in locals(): + if "target_analyzer_id" in locals() and "client" in locals(): # Only try to delete if copy succeeded - if 'copy_result' in locals(): + if "copy_result" in locals(): await client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore print(f"[INFO] Target analyzer deleted: {target_analyzer_id}") # type: ignore except Exception as cleanup_error: print(f"[WARN] Could not delete target analyzer: {str(cleanup_error)[:100]}") - + try: - if 'client' in locals(): + if "client" in locals(): await client.close() except Exception: pass diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py index cc2aa2289659..309beb0ed212 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py @@ -35,14 +35,14 @@ class TestSampleCreateAnalyzer(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_create_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test creating a custom analyzer with field schema. - + This test validates: 1. Analyzer ID generation 2. Field schema definition with multiple field types 3. Analyzer configuration 4. Model mappings 5. Analyzer creation operation - + 04_CreateAnalyzer.CreateAnalyzerAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -51,7 +51,7 @@ def test_sample_create_analyzer(self, azure_content_understanding_endpoint: str) analyzer_id = f"test_custom_analyzer_{uuid.uuid4().hex[:16]}" assert analyzer_id and analyzer_id.strip(), "Analyzer ID should not be empty" print(f"[PASS] Analyzer ID generated: {analyzer_id}") - + # Define field schema with custom fields # This example demonstrates three extraction methods: # - extract: Literal text extraction @@ -62,98 +62,84 @@ def test_sample_create_analyzer(self, azure_content_understanding_endpoint: str) description="Schema for extracting company information", fields={ "company_name": ContentFieldDefinition( - type="string", - method="extract", - description="Name of the company" + type="string", method="extract", description="Name of the company" ), "total_amount": ContentFieldDefinition( - type="number", - method="extract", - description="Total amount on the document" + type="number", method="extract", description="Total amount on the document" ), "document_summary": ContentFieldDefinition( - type="string", - method="generate", - description="A brief summary of the document content" + type="string", method="generate", description="A brief summary of the document content" ), "document_type": ContentFieldDefinition( type="string", method="classify", description="Type of document", - enum=["invoice", "receipt", "contract", "report", "other"] - ) - } + enum=["invoice", "receipt", "contract", "report", "other"], + ), + }, ) - + # Validate field schema assert field_schema and field_schema.fields, "Field schema should have fields" assert len(field_schema.fields) == 4, "Field schema should have 4 fields" assert field_schema.name == "company_schema", "Field schema name should match" print(f"[PASS] Field schema defined with {len(field_schema.fields)} fields") - + # Validate each field definition for field_name, field_def in field_schema.fields.items(): - assert field_def.type and field_def.method and field_def.description, \ - f"Field {field_name} should have type, method, and description" - assert field_def.method in ["extract", "generate", "classify"], \ - f"Field {field_name} method should be valid" - + assert ( + field_def.type and field_def.method and field_def.description + ), f"Field {field_name} should have type, method, and description" + assert field_def.method in ["extract", "generate", "classify"], f"Field {field_name} method should be valid" + # Verify enum for classify field document_type_field = field_schema.fields["document_type"] - assert document_type_field.enum and len(document_type_field.enum) == 5, \ - "Document type should have 5 enum values" + assert ( + document_type_field.enum and len(document_type_field.enum) == 5 + ), "Document type should have 5 enum values" print("[PASS] Field definitions validated") - + # Create analyzer configuration config = ContentAnalyzerConfig( enable_formula=True, enable_layout=True, enable_ocr=True, estimate_field_source_and_confidence=True, - return_details=True + return_details=True, ) - - assert config.enable_formula and config.enable_layout and config.enable_ocr, \ - "Core features should be enabled" + + assert config.enable_formula and config.enable_layout and config.enable_ocr, "Core features should be enabled" print("[PASS] Analyzer configuration created") - + # Create custom analyzer definition custom_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Custom analyzer for extracting company information", config=config, field_schema=field_schema, - models={ - "completion": "gpt-4.1", - "embedding": "text-embedding-3-large" - } + models={"completion": "gpt-4.1", "embedding": "text-embedding-3-large"}, ) - - assert custom_analyzer.base_analyzer_id == "prebuilt-document", \ - "Base analyzer should be prebuilt-document" - assert custom_analyzer.models and len(custom_analyzer.models) >= 2, \ - "Should have at least 2 model mappings" + + assert custom_analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer should be prebuilt-document" + assert custom_analyzer.models and len(custom_analyzer.models) >= 2, "Should have at least 2 model mappings" print("[PASS] Custom analyzer definition validated") - + # Create the analyzer try: - poller = client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=custom_analyzer - ) + poller = client.begin_create_analyzer(analyzer_id=analyzer_id, resource=custom_analyzer) result = poller.result() - + # Verify operation completed assert poller.done(), "Operation should be completed" print(f"[PASS] Analyzer '{analyzer_id}' created successfully") - + # Verify result properties if available if result: result_id = getattr(result, "analyzer_id", None) or getattr(result, "id", None) if result_id: assert result_id == analyzer_id, "Result analyzer ID should match" print(f"[PASS] Result analyzer ID verified: {result_id}") - + except Exception as e: error_msg = str(e) print(f"\n[ERROR] Analyzer creation failed: {error_msg}") @@ -165,5 +151,5 @@ def test_sample_create_analyzer(self, azure_content_understanding_endpoint: str) print(f"[PASS] Cleanup: Analyzer '{analyzer_id}' deleted") except Exception as e: print(f"[WARN] Cleanup failed: {str(e)}") - + print("\n[SUCCESS] All test_sample_create_analyzer assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py index 4301e2443a14..ae6cb1501483 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py @@ -35,14 +35,14 @@ class TestSampleCreateAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_create_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """Test creating a custom analyzer with field schema (async version). - + This test validates: 1. Analyzer ID generation 2. Field schema definition with multiple field types 3. Analyzer configuration 4. Model mappings 5. Analyzer creation operation - + 04_CreateAnalyzer.CreateAnalyzerAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -51,7 +51,7 @@ async def test_sample_create_analyzer_async(self, azure_content_understanding_en analyzer_id = f"test_custom_analyzer_{uuid.uuid4().hex[:16]}" assert analyzer_id and analyzer_id.strip(), "Analyzer ID should not be empty" print(f"[PASS] Analyzer ID generated: {analyzer_id}") - + # Define field schema with custom fields # This example demonstrates three extraction methods: # - extract: Literal text extraction @@ -62,98 +62,84 @@ async def test_sample_create_analyzer_async(self, azure_content_understanding_en description="Schema for extracting company information", fields={ "company_name": ContentFieldDefinition( - type="string", - method="extract", - description="Name of the company" + type="string", method="extract", description="Name of the company" ), "total_amount": ContentFieldDefinition( - type="number", - method="extract", - description="Total amount on the document" + type="number", method="extract", description="Total amount on the document" ), "document_summary": ContentFieldDefinition( - type="string", - method="generate", - description="A brief summary of the document content" + type="string", method="generate", description="A brief summary of the document content" ), "document_type": ContentFieldDefinition( type="string", method="classify", description="Type of document", - enum=["invoice", "receipt", "contract", "report", "other"] - ) - } + enum=["invoice", "receipt", "contract", "report", "other"], + ), + }, ) - + # Validate field schema assert field_schema and field_schema.fields, "Field schema should have fields" assert len(field_schema.fields) == 4, "Field schema should have 4 fields" assert field_schema.name == "company_schema", "Field schema name should match" print(f"[PASS] Field schema defined with {len(field_schema.fields)} fields") - + # Validate each field definition for field_name, field_def in field_schema.fields.items(): - assert field_def.type and field_def.method and field_def.description, \ - f"Field {field_name} should have type, method, and description" - assert field_def.method in ["extract", "generate", "classify"], \ - f"Field {field_name} method should be valid" - + assert ( + field_def.type and field_def.method and field_def.description + ), f"Field {field_name} should have type, method, and description" + assert field_def.method in ["extract", "generate", "classify"], f"Field {field_name} method should be valid" + # Verify enum for classify field document_type_field = field_schema.fields["document_type"] - assert document_type_field.enum and len(document_type_field.enum) == 5, \ - "Document type should have 5 enum values" + assert ( + document_type_field.enum and len(document_type_field.enum) == 5 + ), "Document type should have 5 enum values" print("[PASS] Field definitions validated") - + # Create analyzer configuration config = ContentAnalyzerConfig( enable_formula=True, enable_layout=True, enable_ocr=True, estimate_field_source_and_confidence=True, - return_details=True + return_details=True, ) - - assert config.enable_formula and config.enable_layout and config.enable_ocr, \ - "Core features should be enabled" + + assert config.enable_formula and config.enable_layout and config.enable_ocr, "Core features should be enabled" print("[PASS] Analyzer configuration created") - + # Create custom analyzer definition custom_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Custom analyzer for extracting company information", config=config, field_schema=field_schema, - models={ - "completion": "gpt-4.1", - "embedding": "text-embedding-3-large" - } + models={"completion": "gpt-4.1", "embedding": "text-embedding-3-large"}, ) - - assert custom_analyzer.base_analyzer_id == "prebuilt-document", \ - "Base analyzer should be prebuilt-document" - assert custom_analyzer.models and len(custom_analyzer.models) >= 2, \ - "Should have at least 2 model mappings" + + assert custom_analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer should be prebuilt-document" + assert custom_analyzer.models and len(custom_analyzer.models) >= 2, "Should have at least 2 model mappings" print("[PASS] Custom analyzer definition validated") - + # Create the analyzer try: - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=custom_analyzer - ) + poller = await client.begin_create_analyzer(analyzer_id=analyzer_id, resource=custom_analyzer) result = await poller.result() - + # Verify operation completed assert poller.done(), "Operation should be completed" print(f"[PASS] Analyzer '{analyzer_id}' created successfully") - + # Verify result properties if available if result: result_id = getattr(result, "analyzer_id", None) or getattr(result, "id", None) if result_id: assert result_id == analyzer_id, "Result analyzer ID should match" print(f"[PASS] Result analyzer ID verified: {result_id}") - + except Exception as e: error_msg = str(e) print(f"\n[ERROR] Analyzer creation failed: {error_msg}") @@ -165,7 +151,7 @@ async def test_sample_create_analyzer_async(self, azure_content_understanding_en print(f"[PASS] Cleanup: Analyzer '{analyzer_id}' deleted") except Exception as e: print(f"[WARN] Cleanup failed: {str(e)}") - + await client.close() - + print("\n[SUCCESS] All test_sample_create_analyzer_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py index 0a13b7c76bb1..a4bca1bac261 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 # ------------------------------------------------------------------------- @@ -34,21 +35,21 @@ class TestSampleCreateClassifier(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_create_classifier(self, azure_content_understanding_endpoint: str) -> None: """Test creating a custom classifier with content categories. - + This test validates: 1. Content categories definition 2. Analyzer configuration with segmentation 3. Classifier creation - + 05_CreateClassifier.CreateClassifierAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) # Generate a unique analyzer ID analyzer_id = f"test_classifier_{uuid.uuid4().hex[:16]}" - + print(f"[PASS] Classifier ID generated: {analyzer_id}") - + # Define content categories for classification using ContentCategory objects categories = { "Loan_Application": ContentCategory( @@ -59,70 +60,64 @@ def test_sample_create_classifier(self, azure_content_understanding_endpoint: st ), "Bank_Statement": ContentCategory( description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." - ) + ), } - + # Assertions for categories assert categories is not None, "Categories should not be null" assert len(categories) == 3, "Should have 3 categories" print(f"[PASS] Content categories defined: {len(categories)} categories") - + # Validate each category has description for cat_name, cat_def in categories.items(): assert cat_def.description is not None, f"Category {cat_name} should have description" assert cat_def.description.strip(), f"Category {cat_name} description should not be empty" - + print("[PASS] All category definitions validated") - + # Create analyzer configuration using ContentAnalyzerConfig model config = ContentAnalyzerConfig( return_details=True, enable_segment=True, # Enable automatic segmentation by category - content_categories=categories + content_categories=categories, ) - + # Assertions for config assert config is not None, "Config should not be null" assert config.enable_segment is True, "Segmentation should be enabled" assert config.content_categories is not None, "Config should have content categories" assert len(config.content_categories) == 3, "Config should have 3 content categories" print("[PASS] Classifier configuration created") - + # Create the classifier analyzer using ContentAnalyzer model classifier = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Custom classifier for financial document categorization", config=config, - models={ - "completion": "gpt-4.1" - } + models={"completion": "gpt-4.1"}, ) - + # Assertions for classifier assert classifier is not None, "Classifier should not be null" - assert classifier.base_analyzer_id == "prebuilt-document", \ - "Base analyzer should be prebuilt-document" + assert classifier.base_analyzer_id == "prebuilt-document", "Base analyzer should be prebuilt-document" assert classifier.models is not None, "Classifier should have models" assert "completion" in classifier.models, "Classifier should have completion model" print("[PASS] Classifier definition validated") - + # Create the classifier try: - poller = client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=classifier - ) - + poller = client.begin_create_analyzer(analyzer_id=analyzer_id, resource=classifier) + result = poller.result() - + # Assertions assert poller is not None, "Create classifier operation should not be null" assert poller.done(), "Operation should be completed" print(f"[PASS] Classifier '{analyzer_id}' created successfully") - + assert result is not None, "Create classifier result should not be null" print("[PASS] Create classifier result validated") - + # Cleanup try: client.delete_analyzer(analyzer_id=analyzer_id) @@ -133,5 +128,5 @@ def test_sample_create_classifier(self, azure_content_understanding_endpoint: st error_msg = str(e) print(f"\n[ERROR] Full error message:\n{error_msg}") pytest.skip(f"Classifier creation not available or failed: {error_msg[:100]}") - + print("\n[SUCCESS] All test_sample_create_classifier assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py index 1a1722aa6e76..83002e7560b3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 # ------------------------------------------------------------------------- @@ -34,21 +35,21 @@ class TestSampleCreateClassifierAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_create_classifier_async(self, azure_content_understanding_endpoint: str) -> None: """Test creating a custom classifier with content categories (async version). - + This test validates: 1. Content categories definition 2. Analyzer configuration with segmentation 3. Classifier creation - + 05_CreateClassifier.CreateClassifierAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) # Generate a unique analyzer ID analyzer_id = f"test_classifier_{uuid.uuid4().hex[:16]}" - + print(f"[PASS] Classifier ID generated: {analyzer_id}") - + # Define content categories for classification using ContentCategory objects categories = { "Loan_Application": ContentCategory( @@ -59,70 +60,64 @@ async def test_sample_create_classifier_async(self, azure_content_understanding_ ), "Bank_Statement": ContentCategory( description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." - ) + ), } - + # Assertions for categories assert categories is not None, "Categories should not be null" assert len(categories) == 3, "Should have 3 categories" print(f"[PASS] Content categories defined: {len(categories)} categories") - + # Validate each category has description for cat_name, cat_def in categories.items(): assert cat_def.description is not None, f"Category {cat_name} should have description" assert cat_def.description.strip(), f"Category {cat_name} description should not be empty" - + print("[PASS] All category definitions validated") - + # Create analyzer configuration using ContentAnalyzerConfig model config = ContentAnalyzerConfig( return_details=True, enable_segment=True, # Enable automatic segmentation by category - content_categories=categories + content_categories=categories, ) - + # Assertions for config assert config is not None, "Config should not be null" assert config.enable_segment is True, "Segmentation should be enabled" assert config.content_categories is not None, "Config should have content categories" assert len(config.content_categories) == 3, "Config should have 3 content categories" print("[PASS] Classifier configuration created") - + # Create the classifier analyzer using ContentAnalyzer model classifier = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Custom classifier for financial document categorization", config=config, - models={ - "completion": "gpt-4.1" - } + models={"completion": "gpt-4.1"}, ) - + # Assertions for classifier assert classifier is not None, "Classifier should not be null" - assert classifier.base_analyzer_id == "prebuilt-document", \ - "Base analyzer should be prebuilt-document" + assert classifier.base_analyzer_id == "prebuilt-document", "Base analyzer should be prebuilt-document" assert classifier.models is not None, "Classifier should have models" assert "completion" in classifier.models, "Classifier should have completion model" print("[PASS] Classifier definition validated") - + # Create the classifier try: - poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=classifier - ) - + poller = await client.begin_create_analyzer(analyzer_id=analyzer_id, resource=classifier) + result = await poller.result() - + # Assertions assert poller is not None, "Create classifier operation should not be null" assert poller.done(), "Operation should be completed" print(f"[PASS] Classifier '{analyzer_id}' created successfully") - + assert result is not None, "Create classifier result should not be null" print("[PASS] Create classifier result validated") - + # Cleanup try: await client.delete_analyzer(analyzer_id=analyzer_id) @@ -133,6 +128,6 @@ async def test_sample_create_classifier_async(self, azure_content_understanding_ error_msg = str(e) print(f"\n[ERROR] Full error message:\n{error_msg}") pytest.skip(f"Classifier creation not available or failed: {error_msg[:100]}") - + await client.close() print("\n[SUCCESS] All test_sample_create_classifier_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py index d35cbb5f1a61..f10b191b4146 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py @@ -31,35 +31,31 @@ class TestSampleDeleteAnalyzer(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_delete_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analyzer. - + This test validates: 1. Creating a simple analyzer 2. Verifying the analyzer exists 3. Deleting the analyzer 4. Verifying deletion was successful - + 09_DeleteAnalyzer.DeleteAnalyzerAsync() """ # Skip this test if API is not available try: client = self.create_client(endpoint=azure_content_understanding_endpoint) - + # Generate unique analyzer ID for this test analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" print(f"[INFO] Analyzer ID generated: {analyzer_id}") - + # Create a simple analyzer analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Simple analyzer for deletion example", - config=ContentAnalyzerConfig( - return_details=True - ), - models={ - "completion": "gpt-4.1" - } + config=ContentAnalyzerConfig(return_details=True), + models={"completion": "gpt-4.1"}, ) - + # Assertions for analyzer object assert analyzer is not None, "Analyzer object should not be null" assert analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" @@ -70,104 +66,100 @@ def test_sample_delete_analyzer(self, azure_content_understanding_endpoint: str) assert "completion" in analyzer.models, "Should have completion model" assert analyzer.models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" print("[PASS] Analyzer object configured correctly") - + # Create the analyzer - create_poller = client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=analyzer, - allow_replace=True - ) + create_poller = client.begin_create_analyzer(analyzer_id=analyzer_id, resource=analyzer, allow_replace=True) create_result = create_poller.result() print(f"[PASS] Analyzer '{analyzer_id}' created successfully") - + # Verify the analyzer was created successfully get_response = client.get_analyzer(analyzer_id=analyzer_id) - + # Assertions for get response assert get_response is not None, "Get analyzer response should not be null" print("[PASS] Analyzer retrieved successfully after creation") - + # Verify analyzer properties - created_base_id = getattr(get_response, 'base_analyzer_id', None) + created_base_id = getattr(get_response, "base_analyzer_id", None) assert created_base_id is not None, "Base analyzer ID should not be null" assert created_base_id == "prebuilt-document", "Base analyzer ID should match" print(f"[PASS] Base analyzer ID verified: {created_base_id}") - - created_description = getattr(get_response, 'description', None) + + created_description = getattr(get_response, "description", None) assert created_description is not None, "Description should not be null" assert created_description == "Simple analyzer for deletion example", "Description should match" print(f"[PASS] Description verified: '{created_description}'") - + # Verify config - created_config = getattr(get_response, 'config', None) + created_config = getattr(get_response, "config", None) if created_config is not None: print("[INFO] Config exists") - return_details = getattr(created_config, 'return_details', None) + return_details = getattr(created_config, "return_details", None) if return_details is not None: assert return_details is True, "ReturnDetails should be true" print(f"[PASS] ReturnDetails: {return_details}") - + # Verify models - created_models = getattr(get_response, 'models', None) + created_models = getattr(get_response, "models", None) if created_models is not None: assert len(created_models) >= 1, "Should have at least 1 model" print(f"[PASS] Models verified: {len(created_models)} model(s)") - + if "completion" in created_models: assert created_models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" print(f"[PASS] completion: {created_models['completion']}") - + print(f"[PASS] Verified analyzer '{analyzer_id}' exists and is correctly configured before deletion") - + # Delete the analyzer client.delete_analyzer(analyzer_id=analyzer_id) print(f"[PASS] Analyzer '{analyzer_id}' deleted successfully") - + # Verify the analyzer was deleted by trying to get it print(f"[INFO] Attempting to verify deletion of analyzer '{analyzer_id}'...") - + deletion_verified = False status_code = None error_message = None - + try: deleted_response = client.get_analyzer(analyzer_id=analyzer_id) - + # If we reach here, the call succeeded which is unexpected print("[WARN] Unexpected: Get analyzer call succeeded after deletion") - raw_response = getattr(deleted_response, '_response', None) + raw_response = getattr(deleted_response, "_response", None) if raw_response: - status_code = getattr(raw_response, 'status_code', None) + status_code = getattr(raw_response, "status_code", None) print(f"[WARN] Response status: {status_code}") - + if deleted_response is not None: - analyzer_id_attr = getattr(deleted_response, 'analyzer_id', None) - description_attr = getattr(deleted_response, 'description', None) + analyzer_id_attr = getattr(deleted_response, "analyzer_id", None) + description_attr = getattr(deleted_response, "description", None) print(f"[WARN] Analyzer ID: {analyzer_id_attr or '(null)'}") print(f"[WARN] Description: {description_attr or '(null)'}") - + except ResourceNotFoundError as e: # Expected: analyzer should not be found deletion_verified = True - status_code = getattr(e, 'status_code', 404) + status_code = getattr(e, "status_code", 404) error_message = str(e) print(f"[PASS] Expected error received: Analyzer not found") print(f"[PASS] Status code: {status_code}") print(f"[PASS] Error message: {error_message[:100]}{'...' if len(error_message) > 100 else ''}") - + except Exception as e: # Some other error occurred print(f"[WARN] Unexpected error during verification: {str(e)[:100]}") # Still consider it verified if we got an error trying to get it deletion_verified = True error_message = str(e) - + # Final assertions assert deletion_verified, "Deletion should be verified (analyzer not found after deletion)" print(f"[PASS] Deletion verified: Analyzer '{analyzer_id}' is no longer accessible") - + print("\n[SUCCESS] All test_sample_delete_analyzer assertions passed") - + except Exception as e: error_msg = str(e).lower() if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py index f358662a61dd..53e2d72d2d89 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py @@ -31,35 +31,31 @@ class TestSampleDeleteAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_delete_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analyzer (async version). - + This test validates: 1. Creating a simple analyzer 2. Verifying the analyzer exists 3. Deleting the analyzer 4. Verifying deletion was successful - + 09_DeleteAnalyzer.DeleteAnalyzerAsync() """ # Skip this test if API is not available try: client = self.create_async_client(endpoint=azure_content_understanding_endpoint) - + # Generate unique analyzer ID for this test analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" print(f"[INFO] Analyzer ID generated: {analyzer_id}") - + # Create a simple analyzer analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Simple analyzer for deletion example", - config=ContentAnalyzerConfig( - return_details=True - ), - models={ - "completion": "gpt-4.1" - } + config=ContentAnalyzerConfig(return_details=True), + models={"completion": "gpt-4.1"}, ) - + # Assertions for analyzer object assert analyzer is not None, "Analyzer object should not be null" assert analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" @@ -70,105 +66,103 @@ async def test_sample_delete_analyzer_async(self, azure_content_understanding_en assert "completion" in analyzer.models, "Should have completion model" assert analyzer.models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" print("[PASS] Analyzer object configured correctly") - + # Create the analyzer create_poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=analyzer, - allow_replace=True + analyzer_id=analyzer_id, resource=analyzer, allow_replace=True ) create_result = await create_poller.result() print(f"[PASS] Analyzer '{analyzer_id}' created successfully") - + # Verify the analyzer was created successfully get_response = await client.get_analyzer(analyzer_id=analyzer_id) - + # Assertions for get response assert get_response is not None, "Get analyzer response should not be null" print("[PASS] Analyzer retrieved successfully after creation") - + # Verify analyzer properties - created_base_id = getattr(get_response, 'base_analyzer_id', None) + created_base_id = getattr(get_response, "base_analyzer_id", None) assert created_base_id is not None, "Base analyzer ID should not be null" assert created_base_id == "prebuilt-document", "Base analyzer ID should match" print(f"[PASS] Base analyzer ID verified: {created_base_id}") - - created_description = getattr(get_response, 'description', None) + + created_description = getattr(get_response, "description", None) assert created_description is not None, "Description should not be null" assert created_description == "Simple analyzer for deletion example", "Description should match" print(f"[PASS] Description verified: '{created_description}'") - + # Verify config - created_config = getattr(get_response, 'config', None) + created_config = getattr(get_response, "config", None) if created_config is not None: print("[INFO] Config exists") - return_details = getattr(created_config, 'return_details', None) + return_details = getattr(created_config, "return_details", None) if return_details is not None: assert return_details is True, "ReturnDetails should be true" print(f"[PASS] ReturnDetails: {return_details}") - + # Verify models - created_models = getattr(get_response, 'models', None) + created_models = getattr(get_response, "models", None) if created_models is not None: assert len(created_models) >= 1, "Should have at least 1 model" print(f"[PASS] Models verified: {len(created_models)} model(s)") - + if "completion" in created_models: assert created_models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" print(f"[PASS] completion: {created_models['completion']}") - + print(f"[PASS] Verified analyzer '{analyzer_id}' exists and is correctly configured before deletion") - + # Delete the analyzer await client.delete_analyzer(analyzer_id=analyzer_id) print(f"[PASS] Analyzer '{analyzer_id}' deleted successfully") - + # Verify the analyzer was deleted by trying to get it print(f"[INFO] Attempting to verify deletion of analyzer '{analyzer_id}'...") - + deletion_verified = False status_code = None error_message = None - + try: deleted_response = await client.get_analyzer(analyzer_id=analyzer_id) - + # If we reach here, the call succeeded which is unexpected print("[WARN] Unexpected: Get analyzer call succeeded after deletion") - raw_response = getattr(deleted_response, '_response', None) + raw_response = getattr(deleted_response, "_response", None) if raw_response: - status_code = getattr(raw_response, 'status_code', None) + status_code = getattr(raw_response, "status_code", None) print(f"[WARN] Response status: {status_code}") - + if deleted_response is not None: - analyzer_id_attr = getattr(deleted_response, 'analyzer_id', None) - description_attr = getattr(deleted_response, 'description', None) + analyzer_id_attr = getattr(deleted_response, "analyzer_id", None) + description_attr = getattr(deleted_response, "description", None) print(f"[WARN] Analyzer ID: {analyzer_id_attr or '(null)'}") print(f"[WARN] Description: {description_attr or '(null)'}") - + except ResourceNotFoundError as e: # Expected: analyzer should not be found deletion_verified = True - status_code = getattr(e, 'status_code', 404) + status_code = getattr(e, "status_code", 404) error_message = str(e) print(f"[PASS] Expected error received: Analyzer not found") print(f"[PASS] Status code: {status_code}") print(f"[PASS] Error message: {error_message[:100]}{'...' if len(error_message) > 100 else ''}") - + except Exception as e: # Some other error occurred print(f"[WARN] Unexpected error during verification: {str(e)[:100]}") # Still consider it verified if we got an error trying to get it deletion_verified = True error_message = str(e) - + # Final assertions assert deletion_verified, "Deletion should be verified (analyzer not found after deletion)" print(f"[PASS] Deletion verified: Analyzer '{analyzer_id}' is no longer accessible") - + await client.close() print("\n[SUCCESS] All test_sample_delete_analyzer_async assertions passed") - + except Exception as e: error_msg = str(e).lower() if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py index 453f5d630204..bf6e2b5e4352 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py @@ -29,12 +29,12 @@ class TestSampleDeleteResult(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_delete_result(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analysis result. - + This test validates: 1. Document analysis to create a result 2. Extracting result ID 3. Deleting the result - + 13_DeleteResult.DeleteResultAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -42,56 +42,54 @@ def test_sample_delete_result(self, azure_content_understanding_endpoint: str) - # First, analyze a document to create a result tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") - + with open(file_path, "rb") as f: file_bytes = f.read() - + assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - + # Analyze to get a result ID poller = client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=file_bytes, - content_type="application/pdf" + analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" ) - + result = poller.result() - + # Assertions for analysis assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" assert result is not None, "Analysis result should not be null" print("[PASS] Analysis completed successfully") - + # Extract operation ID from the poller # The operation ID is needed to delete the result operation_id = None try: # Extract operation ID from polling URL - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_operation'): - operation = getattr(polling_method, '_operation', None) # type: ignore - if operation and hasattr(operation, 'get_polling_url'): + if hasattr(poller, "_polling_method"): + polling_method = getattr(poller, "_polling_method", None) + if polling_method and hasattr(polling_method, "_operation"): + operation = getattr(polling_method, "_operation", None) # type: ignore + if operation and hasattr(operation, "get_polling_url"): polling_url = operation.get_polling_url() # type: ignore # Extract operation ID from URL (last segment before query string) - operation_id = polling_url.split('/')[-1] - if '?' in operation_id: - operation_id = operation_id.split('?')[0] + operation_id = polling_url.split("/")[-1] + if "?" in operation_id: + operation_id = operation_id.split("?")[0] except Exception as e: print(f"[WARN] Could not extract operation ID: {str(e)[:100]}") - + # Assertion: Verify we have an operation ID if operation_id: assert operation_id is not None, "Operation ID should not be null" assert isinstance(operation_id, str), "Operation ID should be a string" assert operation_id.strip(), "Operation ID should not be empty" print(f"[PASS] Operation ID extracted: {operation_id[:50]}...") - + # Delete the result try: client.delete_result(operation_id=operation_id) @@ -107,5 +105,5 @@ def test_sample_delete_result(self, azure_content_understanding_endpoint: str) - else: print("[INFO] Operation ID not available in response") print("[INFO] Delete result operation skipped - operation ID extraction not supported") - + print("\n[SUCCESS] All test_sample_delete_result assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py index 205313a32bcb..95c3c2d6daf6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py @@ -29,12 +29,12 @@ class TestSampleDeleteResultAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_delete_result_async(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analysis result (async version). - + This test validates: 1. Document analysis to create a result 2. Extracting result ID 3. Deleting the result - + 13_DeleteResult.DeleteResultAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -42,56 +42,54 @@ async def test_sample_delete_result_async(self, azure_content_understanding_endp # First, analyze a document to create a result tests_dir = os.path.dirname(os.path.dirname(__file__)) file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") - + assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") - + with open(file_path, "rb") as f: file_bytes = f.read() - + assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - + # Analyze to get a result ID poller = await client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", - binary_input=file_bytes, - content_type="application/pdf" + analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" ) - + result = await poller.result() - + # Assertions for analysis assert poller is not None, "Analysis operation should not be null" assert poller.done(), "Operation should be completed" assert result is not None, "Analysis result should not be null" print("[PASS] Analysis completed successfully") - + # Extract operation ID from the poller # The operation ID is needed to delete the result operation_id = None try: # Extract operation ID from polling URL - if hasattr(poller, '_polling_method'): - polling_method = getattr(poller, '_polling_method', None) - if polling_method and hasattr(polling_method, '_operation'): - operation = getattr(polling_method, '_operation', None) # type: ignore - if operation and hasattr(operation, 'get_polling_url'): + if hasattr(poller, "_polling_method"): + polling_method = getattr(poller, "_polling_method", None) + if polling_method and hasattr(polling_method, "_operation"): + operation = getattr(polling_method, "_operation", None) # type: ignore + if operation and hasattr(operation, "get_polling_url"): polling_url = operation.get_polling_url() # type: ignore # Extract operation ID from URL (last segment before query string) - operation_id = polling_url.split('/')[-1] - if '?' in operation_id: - operation_id = operation_id.split('?')[0] + operation_id = polling_url.split("/")[-1] + if "?" in operation_id: + operation_id = operation_id.split("?")[0] except Exception as e: print(f"[WARN] Could not extract operation ID: {str(e)[:100]}") - + # Assertion: Verify we have an operation ID if operation_id: assert operation_id is not None, "Operation ID should not be null" assert isinstance(operation_id, str), "Operation ID should be a string" assert operation_id.strip(), "Operation ID should not be empty" print(f"[PASS] Operation ID extracted: {operation_id[:50]}...") - + # Delete the result try: await client.delete_result(operation_id=operation_id) @@ -107,6 +105,6 @@ async def test_sample_delete_result_async(self, azure_content_understanding_endp else: print("[INFO] Operation ID not available in response") print("[INFO] Delete result operation skipped - operation ID extraction not supported") - + await client.close() print("\n[SUCCESS] All test_sample_delete_result_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py index c7e8f26b4ab7..d745b2b9dd10 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py @@ -29,90 +29,91 @@ class TestSampleGetAnalyzer(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_get_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test getting information about a prebuilt analyzer. - + This test validates: 1. Getting analyzer information using get_analyzer 2. Analyzer response structure 3. Analyzer JSON serialization - + 06_GetAnalyzer.GetPrebuiltAnalyzerAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) # Get information about a prebuilt analyzer response = client.get_analyzer(analyzer_id="prebuilt-documentSearch") - + # Assertions assert response is not None, "Response should not be null" print("[PASS] Get analyzer response received") - + analyzer = response assert analyzer is not None, "Analyzer should not be null" print("[PASS] Analyzer object is not null") - + # Verify basic analyzer properties for prebuilt-documentSearch - if hasattr(analyzer, 'base_analyzer_id'): - base_id = getattr(analyzer, 'base_analyzer_id', None) + if hasattr(analyzer, "base_analyzer_id"): + base_id = getattr(analyzer, "base_analyzer_id", None) if base_id: print(f"[INFO] Base analyzer ID: {base_id}") - - if hasattr(analyzer, 'description'): - description = getattr(analyzer, 'description', None) + + if hasattr(analyzer, "description"): + description = getattr(analyzer, "description", None) if description: print(f"[INFO] Description: {description[:100]}{'...' if len(description) > 100 else ''}") - + # Verify config if present - if hasattr(analyzer, 'config'): - config = getattr(analyzer, 'config', None) + if hasattr(analyzer, "config"): + config = getattr(analyzer, "config", None) if config: print("[INFO] Analyzer has configuration") - if hasattr(config, 'enable_ocr'): - enable_ocr = getattr(config, 'enable_ocr', None) + if hasattr(config, "enable_ocr"): + enable_ocr = getattr(config, "enable_ocr", None) if enable_ocr is not None: print(f"[INFO] EnableOcr: {enable_ocr}") - if hasattr(config, 'enable_layout'): - enable_layout = getattr(config, 'enable_layout', None) + if hasattr(config, "enable_layout"): + enable_layout = getattr(config, "enable_layout", None) if enable_layout is not None: print(f"[INFO] EnableLayout: {enable_layout}") - + # Verify models if present - if hasattr(analyzer, 'models'): - models = getattr(analyzer, 'models', None) + if hasattr(analyzer, "models"): + models = getattr(analyzer, "models", None) if models and len(models) > 0: print(f"[INFO] Analyzer has {len(models)} model mapping(s)") for key, value in list(models.items())[:5]: # Show first 5 print(f"[INFO] {key}: {value}") - + # Verify analyzer can be serialized to JSON try: # Convert analyzer to dict and then to JSON - if hasattr(analyzer, '__dict__'): + if hasattr(analyzer, "__dict__"): analyzer_dict = analyzer.__dict__ - elif hasattr(analyzer, 'as_dict'): + elif hasattr(analyzer, "as_dict"): analyzer_dict = analyzer.as_dict() # type: ignore else: analyzer_dict = {"analyzer": str(analyzer)} - + analyzer_json = json.dumps(analyzer_dict, indent=2, default=str) - + assert analyzer_json is not None, "Analyzer JSON should not be null" assert len(analyzer_json) > 0, "Analyzer JSON should not be empty" print(f"[PASS] Analyzer JSON serialized successfully ({len(analyzer_json)} characters)") - + # Verify JSON contains analyzer identifier - assert "documentSearch" in analyzer_json.lower() or "prebuilt" in analyzer_json.lower(), \ - "Analyzer JSON should contain analyzer identifier" + assert ( + "documentSearch" in analyzer_json.lower() or "prebuilt" in analyzer_json.lower() + ), "Analyzer JSON should contain analyzer identifier" print("[PASS] Analyzer JSON contains expected identifiers") print(f"[PASS] Analyzer JSON length: {len(analyzer_json)} characters") - + # Display formatted JSON (first 500 chars for brevity) print("\n[INFO] Prebuilt-documentSearch Analyzer (preview):") print(analyzer_json[:500] + "..." if len(analyzer_json) > 500 else analyzer_json) - + except Exception as e: print(f"[WARN] Could not fully serialize analyzer to JSON: {str(e)[:100]}") # Still verify basic properties assert analyzer is not None, "Analyzer should not be null" - + print("\n[PASS] All prebuilt analyzer properties validated successfully") print("\n[SUCCESS] All test_sample_get_analyzer assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py index e2973812b599..1da82e16d627 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py @@ -29,92 +29,93 @@ class TestSampleGetAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_get_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """Test getting information about a prebuilt analyzer (async version). - + This test validates: 1. Getting analyzer information using get_analyzer 2. Analyzer response structure 3. Analyzer JSON serialization - + 06_GetAnalyzer.GetPrebuiltAnalyzerAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) # Get information about a prebuilt analyzer response = await client.get_analyzer(analyzer_id="prebuilt-documentSearch") - + # Assertions assert response is not None, "Response should not be null" print("[PASS] Get analyzer response received") - + analyzer = response assert analyzer is not None, "Analyzer should not be null" print("[PASS] Analyzer object is not null") - + # Verify basic analyzer properties for prebuilt-documentSearch - if hasattr(analyzer, 'base_analyzer_id'): - base_id = getattr(analyzer, 'base_analyzer_id', None) + if hasattr(analyzer, "base_analyzer_id"): + base_id = getattr(analyzer, "base_analyzer_id", None) if base_id: print(f"[INFO] Base analyzer ID: {base_id}") - - if hasattr(analyzer, 'description'): - description = getattr(analyzer, 'description', None) + + if hasattr(analyzer, "description"): + description = getattr(analyzer, "description", None) if description: print(f"[INFO] Description: {description[:100]}{'...' if len(description) > 100 else ''}") - + # Verify config if present - if hasattr(analyzer, 'config'): - config = getattr(analyzer, 'config', None) + if hasattr(analyzer, "config"): + config = getattr(analyzer, "config", None) if config: print("[INFO] Analyzer has configuration") - if hasattr(config, 'enable_ocr'): - enable_ocr = getattr(config, 'enable_ocr', None) + if hasattr(config, "enable_ocr"): + enable_ocr = getattr(config, "enable_ocr", None) if enable_ocr is not None: print(f"[INFO] EnableOcr: {enable_ocr}") - if hasattr(config, 'enable_layout'): - enable_layout = getattr(config, 'enable_layout', None) + if hasattr(config, "enable_layout"): + enable_layout = getattr(config, "enable_layout", None) if enable_layout is not None: print(f"[INFO] EnableLayout: {enable_layout}") - + # Verify models if present - if hasattr(analyzer, 'models'): - models = getattr(analyzer, 'models', None) + if hasattr(analyzer, "models"): + models = getattr(analyzer, "models", None) if models and len(models) > 0: print(f"[INFO] Analyzer has {len(models)} model mapping(s)") for key, value in list(models.items())[:5]: # Show first 5 print(f"[INFO] {key}: {value}") - + # Verify analyzer can be serialized to JSON try: # Convert analyzer to dict and then to JSON - if hasattr(analyzer, '__dict__'): + if hasattr(analyzer, "__dict__"): analyzer_dict = analyzer.__dict__ - elif hasattr(analyzer, 'as_dict'): + elif hasattr(analyzer, "as_dict"): analyzer_dict = analyzer.as_dict() # type: ignore else: analyzer_dict = {"analyzer": str(analyzer)} - + analyzer_json = json.dumps(analyzer_dict, indent=2, default=str) - + assert analyzer_json is not None, "Analyzer JSON should not be null" assert len(analyzer_json) > 0, "Analyzer JSON should not be empty" print(f"[PASS] Analyzer JSON serialized successfully ({len(analyzer_json)} characters)") - + # Verify JSON contains analyzer identifier - assert "documentSearch" in analyzer_json.lower() or "prebuilt" in analyzer_json.lower(), \ - "Analyzer JSON should contain analyzer identifier" + assert ( + "documentSearch" in analyzer_json.lower() or "prebuilt" in analyzer_json.lower() + ), "Analyzer JSON should contain analyzer identifier" print("[PASS] Analyzer JSON contains expected identifiers") print(f"[PASS] Analyzer JSON length: {len(analyzer_json)} characters") - + # Display formatted JSON (first 500 chars for brevity) print("\n[INFO] Prebuilt-documentSearch Analyzer (preview):") print(analyzer_json[:500] + "..." if len(analyzer_json) > 500 else analyzer_json) - + except Exception as e: print(f"[WARN] Could not fully serialize analyzer to JSON: {str(e)[:100]}") # Still verify basic properties assert analyzer is not None, "Analyzer should not be null" - + print("\n[PASS] All prebuilt analyzer properties validated successfully") - + await client.close() print("\n[SUCCESS] All test_sample_get_analyzer_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py index 59e725c9a70d..87970ea92280 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py @@ -30,15 +30,15 @@ class TestSampleGetResultFile(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_get_result_file(self, azure_content_understanding_endpoint: str) -> None: """Test getting result files (like keyframe images) from analysis results. - + This test validates: 1. Starting video analysis operation 2. Getting operation ID immediately after start 3. Waiting for operation completion 4. Retrieving keyframe images using get_result_file - + 12_GetResultFile.GetResultFileAsync() - + Note: This test uses document analysis as video analysis may not be available. The API pattern is the same for both document and video analysis. """ @@ -49,61 +49,58 @@ def test_sample_get_result_file(self, azure_content_understanding_endpoint: str) current_dir = os.path.dirname(os.path.abspath(__file__)) test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") document_path = os.path.join(test_data_dir, "sample_invoice.pdf") - + # Read the document file as binary data with open(document_path, "rb") as f: document_data = f.read() - + # Start the analysis operation (WaitUntil.Started equivalent) - poller = client.begin_analyze( - analyzer_id="prebuilt-document", - inputs=[AnalyzeInput(data=document_data)] - ) - + poller = client.begin_analyze(analyzer_id="prebuilt-document", inputs=[AnalyzeInput(data=document_data)]) + # Get the operation ID from the poller (available after Started) # Extract operation ID from the polling URL polling_url = poller._polling_method._operation.get_polling_url() # type: ignore - operation_id = polling_url.split('/')[-1].split('?')[0] - + operation_id = polling_url.split("/")[-1].split("?")[0] + assert operation_id is not None, "Operation ID should not be null" assert len(operation_id) > 0, "Operation ID should not be empty" print(f"[PASS] Operation ID obtained: {operation_id}") - + # Verify operation ID format - assert ' ' not in operation_id, "Operation ID should not contain spaces" + assert " " not in operation_id, "Operation ID should not contain spaces" print(f"[PASS] Operation ID length: {len(operation_id)} characters") - + print(f"[INFO] Operation started (ID: {operation_id})") - + # Wait for completion result = poller.result() - + # Verify operation completed assert poller is not None, "Operation should not be null after waiting" print("[PASS] Operation completed successfully") - + # Verify raw response - raw_response = getattr(poller, '_polling_method', None) + raw_response = getattr(poller, "_polling_method", None) if raw_response: - initial_response = getattr(raw_response, '_initial_response', None) # type: ignore + initial_response = getattr(raw_response, "_initial_response", None) # type: ignore if initial_response: - status = getattr(initial_response, 'status_code', None) + status = getattr(initial_response, "status_code", None) if status: assert 200 <= status < 300, f"Response status should be successful, but was {status}" print(f"[PASS] Response status: {status}") - + # Verify result assert result is not None, "Analysis result should not be null" - assert hasattr(result, 'contents'), "Result should contain contents" - contents = getattr(result, 'contents', None) + assert hasattr(result, "contents"), "Result should contain contents" + contents = getattr(result, "contents", None) assert contents is not None and len(contents) > 0, "Result should have at least one content" print(f"[PASS] Analysis result contains {len(contents)} content(s)") - + print(f"\n[INFO] Operation verification completed:") print(f" Operation ID: {operation_id}") print(f" Status: Completed") print(f" Contents: {len(contents)}") - + # Demonstrate get_result_file API usage # Note: For video analysis, this would retrieve keyframe images # For document analysis, result files may not be available @@ -113,29 +110,26 @@ def test_sample_get_result_file(self, azure_content_understanding_endpoint: str) print(" - Keyframes are found in AudioVisualContent.key_frame_times_ms") print(" - Path format: 'keyframes/{frameTimeMs}'") print(" - Example: client.get_result_file(operation_id, 'keyframes/1000')") - + # Try to get a result file (this may not be available for document analysis) try: # Example path (would be actual keyframe path for video) # For document analysis, this is just demonstrating the API test_path = "keyframes/0" - - file_response = client.get_result_file( - operation_id=operation_id, - path=test_path - ) - + + file_response = client.get_result_file(operation_id=operation_id, path=test_path) + if file_response: # get_result_file returns Iterator[bytes], need to collect the data - file_data = b''.join(file_response) + file_data = b"".join(file_response) print(f"[PASS] Result file retrieved ({len(file_data)} bytes)") - + # For video keyframes, you would save the image: # with open(f"keyframe_{frame_time}.jpg", "wb") as f: # f.write(file_data) else: print("[INFO] No result file available at test path (expected for document analysis)") - + except Exception as e: error_msg = str(e).lower() if "not found" in error_msg or "not available" in error_msg: @@ -143,6 +137,6 @@ def test_sample_get_result_file(self, azure_content_understanding_endpoint: str) print(f"[INFO] This is normal for document analysis without video keyframes") else: print(f"[INFO] get_result_file returned: {str(e)[:100]}") - + print("\n[SUCCESS] All test_sample_get_result_file assertions passed") print("[INFO] get_result_file API pattern demonstrated successfully") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py index 44bd675f0eb8..763f7160fa29 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py @@ -30,15 +30,15 @@ class TestSampleGetResultFileAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_get_result_file_async(self, azure_content_understanding_endpoint: str) -> None: """Test getting result files (like keyframe images) from analysis results (async version). - + This test validates: 1. Starting video analysis operation 2. Getting operation ID immediately after start 3. Waiting for operation completion 4. Retrieving keyframe images using get_result_file - + 12_GetResultFile.GetResultFileAsync() - + Note: This test uses document analysis as video analysis may not be available. The API pattern is the same for both document and video analysis. """ @@ -49,61 +49,58 @@ async def test_sample_get_result_file_async(self, azure_content_understanding_en current_dir = os.path.dirname(os.path.abspath(__file__)) test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") document_path = os.path.join(test_data_dir, "sample_invoice.pdf") - + # Read the document file as binary data with open(document_path, "rb") as f: document_data = f.read() - + # Start the analysis operation (WaitUntil.Started equivalent) - poller = await client.begin_analyze( - analyzer_id="prebuilt-document", - inputs=[AnalyzeInput(data=document_data)] - ) - + poller = await client.begin_analyze(analyzer_id="prebuilt-document", inputs=[AnalyzeInput(data=document_data)]) + # Get the operation ID from the poller (available after Started) # Extract operation ID from the polling URL polling_url = poller._polling_method._operation.get_polling_url() # type: ignore - operation_id = polling_url.split('/')[-1].split('?')[0] - + operation_id = polling_url.split("/")[-1].split("?")[0] + assert operation_id is not None, "Operation ID should not be null" assert len(operation_id) > 0, "Operation ID should not be empty" print(f"[PASS] Operation ID obtained: {operation_id}") - + # Verify operation ID format - assert ' ' not in operation_id, "Operation ID should not contain spaces" + assert " " not in operation_id, "Operation ID should not contain spaces" print(f"[PASS] Operation ID length: {len(operation_id)} characters") - + print(f"[INFO] Operation started (ID: {operation_id})") - + # Wait for completion result = await poller.result() - + # Verify operation completed assert poller is not None, "Operation should not be null after waiting" print("[PASS] Operation completed successfully") - + # Verify raw response - raw_response = getattr(poller, '_polling_method', None) + raw_response = getattr(poller, "_polling_method", None) if raw_response: - initial_response = getattr(raw_response, '_initial_response', None) # type: ignore + initial_response = getattr(raw_response, "_initial_response", None) # type: ignore if initial_response: - status = getattr(initial_response, 'status_code', None) + status = getattr(initial_response, "status_code", None) if status: assert 200 <= status < 300, f"Response status should be successful, but was {status}" print(f"[PASS] Response status: {status}") - + # Verify result assert result is not None, "Analysis result should not be null" - assert hasattr(result, 'contents'), "Result should contain contents" - contents = getattr(result, 'contents', None) + assert hasattr(result, "contents"), "Result should contain contents" + contents = getattr(result, "contents", None) assert contents is not None and len(contents) > 0, "Result should have at least one content" print(f"[PASS] Analysis result contains {len(contents)} content(s)") - + print(f"\n[INFO] Operation verification completed:") print(f" Operation ID: {operation_id}") print(f" Status: Completed") print(f" Contents: {len(contents)}") - + # Demonstrate get_result_file API usage # Note: For video analysis, this would retrieve keyframe images # For document analysis, result files may not be available @@ -113,32 +110,29 @@ async def test_sample_get_result_file_async(self, azure_content_understanding_en print(" - Keyframes are found in AudioVisualContent.key_frame_times_ms") print(" - Path format: 'keyframes/{frameTimeMs}'") print(" - Example: client.get_result_file(operation_id, 'keyframes/1000')") - + # Try to get a result file (this may not be available for document analysis) try: # Example path (would be actual keyframe path for video) # For document analysis, this is just demonstrating the API test_path = "keyframes/0" - - file_response = await client.get_result_file( - operation_id=operation_id, - path=test_path - ) - + + file_response = await client.get_result_file(operation_id=operation_id, path=test_path) + if file_response: # get_result_file returns AsyncIterator[bytes], need to collect the data chunks = [] async for chunk in file_response: chunks.append(chunk) - file_data = b''.join(chunks) + file_data = b"".join(chunks) print(f"[PASS] Result file retrieved ({len(file_data)} bytes)") - + # For video keyframes, you would save the image: # with open(f"keyframe_{frame_time}.jpg", "wb") as f: # f.write(file_data) else: print("[INFO] No result file available at test path (expected for document analysis)") - + except Exception as e: error_msg = str(e).lower() if "not found" in error_msg or "not available" in error_msg: @@ -146,7 +140,7 @@ async def test_sample_get_result_file_async(self, azure_content_understanding_en print(f"[INFO] This is normal for document analysis without video keyframes") else: print(f"[INFO] get_result_file returned: {str(e)[:100]}") - + await client.close() print("\n[SUCCESS] All test_sample_get_result_file_async assertions passed") print("[INFO] get_result_file API pattern demonstrated successfully") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py index e329a97db643..4f78dcab6b26 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 # ------------------------------------------------------------------------- @@ -30,7 +31,7 @@ ContentFieldSchema, ContentFieldDefinition, ContentFieldType, - GenerationMethod + GenerationMethod, ) @@ -41,7 +42,7 @@ class TestSampleGrantCopyAuth(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, **kwargs) -> None: """Test granting copy authorization for cross-resource analyzer copying. - + This test validates: 1. Creating a source analyzer 2. Granting copy authorization from source resource @@ -53,43 +54,53 @@ def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, target_analyzer_id: str = "" source_client: Optional[ContentUnderstandingClient] = None target_client: Optional[ContentUnderstandingClient] = None - + try: # Get source and target resource information from environment # For testing, we may use the same endpoint for both source and target # In production, these would be different resources source_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID") source_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION") - target_endpoint = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", azure_content_understanding_endpoint) + target_endpoint = os.environ.get( + "AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", azure_content_understanding_endpoint + ) target_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID") target_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION") target_key = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") - + # Only require environment variables in live mode # In playback mode, the test proxy will replay recorded interactions if is_live(): if not source_resource_id: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID is required for cross-resource copy test in live mode") + raise ValueError( + "AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID is required for cross-resource copy test in live mode" + ) if not source_region: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION is required for cross-resource copy test in live mode") + raise ValueError( + "AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION is required for cross-resource copy test in live mode" + ) if not target_resource_id: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID is required for cross-resource copy test in live mode") + raise ValueError( + "AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID is required for cross-resource copy test in live mode" + ) if not target_region: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION is required for cross-resource copy test in live mode") + raise ValueError( + "AZURE_CONTENT_UNDERSTANDING_TARGET_REGION is required for cross-resource copy test in live mode" + ) else: # In playback mode, use placeholder values - test proxy will use recorded values source_resource_id = source_resource_id or "placeholder-source-resource-id" source_region = source_region or "placeholder-source-region" target_resource_id = target_resource_id or "placeholder-target-resource-id" target_region = target_region or "placeholder-target-region" - + # Create clients source_client = self.create_client(endpoint=azure_content_understanding_endpoint) - + # Create target client (may use different endpoint and credential) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential - + if target_endpoint != azure_content_understanding_endpoint or target_key: # Create target client with different endpoint/credential target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() @@ -104,20 +115,20 @@ def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, else: # Use same endpoint and credential as source target_client = self.create_client(endpoint=target_endpoint) - + # Get variables from test proxy (for playback mode) or use defaults (for record mode) variables = kwargs.pop("variables", {}) - + # Generate unique analyzer IDs for this test # Use variables from recording if available (playback mode), otherwise generate new ones (record mode) default_source_id = f"test_analyzer_source_{uuid.uuid4().hex[:16]}" default_target_id = f"test_analyzer_target_{uuid.uuid4().hex[:16]}" source_analyzer_id = variables.setdefault("grantCopySourceAnalyzerId", default_source_id) target_analyzer_id = variables.setdefault("grantCopyTargetAnalyzerId", default_target_id) - + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") print(f"[INFO] Target analyzer ID: {target_analyzer_id}") - + # Verify IDs assert source_analyzer_id is not None, "Source analyzer ID should not be null" assert source_analyzer_id.strip(), "Source analyzer ID should not be empty" @@ -125,7 +136,7 @@ def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, assert target_analyzer_id.strip(), "Target analyzer ID should not be empty" assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" print("[PASS] Analyzer IDs verified") - + # Verify resource information (only in live mode) # In playback mode, the test proxy will replay recorded interactions if is_live(): @@ -137,98 +148,99 @@ def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, assert target_resource_id.strip(), "Target resource ID should not be empty" assert target_region is not None, "Target region should not be null" assert target_region.strip(), "Target region should not be empty" - + assert target_endpoint is not None, "Target endpoint should not be null" assert target_endpoint.strip(), "Target endpoint should not be empty" - + if is_live(): print(f"[INFO] Source resource: {source_resource_id}") print(f"[INFO] Source region: {source_region}") print(f"[INFO] Target resource: {target_resource_id}") print(f"[INFO] Target region: {target_region}") print(f"[INFO] Target endpoint: {target_endpoint}") - + # Verify clients assert source_client is not None, "Source client should not be null" assert target_client is not None, "Target client should not be null" print("[PASS] Source and target clients created") - + # Step 1: Create the source analyzer source_config = ContentAnalyzerConfig( enable_formula=False, enable_layout=True, enable_ocr=True, estimate_field_source_and_confidence=True, - return_details=True + return_details=True, ) - + # Verify source config assert source_config is not None, "Source config should not be null" assert source_config.enable_formula is False, "EnableFormula should be false" assert source_config.enable_layout is True, "EnableLayout should be true" assert source_config.enable_ocr is True, "EnableOcr should be true" - assert source_config.estimate_field_source_and_confidence is True, "EstimateFieldSourceAndConfidence should be true" + assert ( + source_config.estimate_field_source_and_confidence is True + ), "EstimateFieldSourceAndConfidence should be true" assert source_config.return_details is True, "ReturnDetails should be true" print("[PASS] Source config verified") - + source_field_schema = ContentFieldSchema( name="company_schema", description="Schema for extracting company information", fields={ "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company" + type=ContentFieldType.STRING, method=GenerationMethod.EXTRACT, description="Name of the company" ), "total_amount": ContentFieldDefinition( type=ContentFieldType.NUMBER, method=GenerationMethod.EXTRACT, - description="Total amount on the document" - ) - } + description="Total amount on the document", + ), + }, ) - + # Verify source field schema assert source_field_schema is not None, "Source field schema should not be null" assert source_field_schema.name == "company_schema", "Field schema name should match" - assert source_field_schema.description == "Schema for extracting company information", "Field schema description should match" + assert ( + source_field_schema.description == "Schema for extracting company information" + ), "Field schema description should match" assert len(source_field_schema.fields) == 2, "Should have 2 fields" assert "company_name" in source_field_schema.fields, "Should contain company_name field" assert "total_amount" in source_field_schema.fields, "Should contain total_amount field" - print(f"[PASS] Source field schema verified: {source_field_schema.name} ({len(source_field_schema.fields)} fields)") - + print( + f"[PASS] Source field schema verified: {source_field_schema.name} ({len(source_field_schema.fields)} fields)" + ) + source_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Source analyzer for cross-resource copying", config=source_config, field_schema=source_field_schema, - models={ - "completion": "gpt-4.1" - } + models={"completion": "gpt-4.1"}, ) - - + # Verify source analyzer object assert source_analyzer is not None, "Source analyzer object should not be null" assert source_analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" - assert source_analyzer.description == "Source analyzer for cross-resource copying", "Description should match" + assert ( + source_analyzer.description == "Source analyzer for cross-resource copying" + ), "Description should match" assert source_analyzer.models is not None, "Models should not be null" assert "completion" in source_analyzer.models, "Should have completion model" assert source_analyzer.models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" print("[PASS] Source analyzer object verified") - + # Create the source analyzer create_poller = source_client.begin_create_analyzer( - analyzer_id=source_analyzer_id, - resource=source_analyzer, - allow_replace=True + analyzer_id=source_analyzer_id, resource=source_analyzer, allow_replace=True ) create_poller.result() # Wait for creation to complete print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") - + # Get the full analyzer details after creation (LRO result doesn't contain full details) source_result = source_client.get_analyzer(analyzer_id=source_analyzer_id) - + # Verify create operation assert source_result is not None, "Source analyzer result should not be null" assert source_result.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" @@ -243,70 +255,76 @@ def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, print(f"[INFO] Fields: {len(source_result.field_schema.fields)}") print(f"[INFO] Models: {len(source_result.models)}") print("[INFO] Ready for cross-resource copy") - + # Step 2: Grant copy authorization from source resource # Grant authorization on the source client for copying to the target resource print(f"\n[INFO] Granting copy authorization from source resource") - + copy_auth = source_client.grant_copy_authorization( analyzer_id=source_analyzer_id, target_azure_resource_id=target_resource_id, target_region=target_region, ) - + print("[PASS] Copy authorization granted successfully!") - + # Verify copy authorization response assert copy_auth is not None, "Copy authorization response should not be null" - assert hasattr(copy_auth, 'target_azure_resource_id'), "Copy authorization should have target_azure_resource_id" + assert hasattr( + copy_auth, "target_azure_resource_id" + ), "Copy authorization should have target_azure_resource_id" assert copy_auth.target_azure_resource_id is not None, "Target Azure resource ID should not be null" assert copy_auth.target_azure_resource_id.strip(), "Target Azure resource ID should not be empty" # In playback mode, compare against the recorded response value # In live mode, compare against the environment variable if is_live(): - assert copy_auth.target_azure_resource_id == target_resource_id, \ - f"Target resource ID should match, but got '{copy_auth.target_azure_resource_id}' instead of '{target_resource_id}'" + assert ( + copy_auth.target_azure_resource_id == target_resource_id + ), f"Target resource ID should match, but got '{copy_auth.target_azure_resource_id}' instead of '{target_resource_id}'" print(f"[PASS] Target Azure Resource ID verified: {copy_auth.target_azure_resource_id}") print(f"[INFO] Target region (tracked): {target_region}") else: # In playback mode, just verify the response has a value (from recording) print(f"[INFO] Target Azure Resource ID (from recording): {copy_auth.target_azure_resource_id}") print(f"[INFO] Target region (from recording): {target_region}") - + # Verify expiration time - assert hasattr(copy_auth, 'expires_at'), "Copy authorization should have expires_at" + assert hasattr(copy_auth, "expires_at"), "Copy authorization should have expires_at" expires_at = copy_auth.expires_at # Only verify expiration time in live/record mode, not in playback mode # (recorded expiration times may be in the past during playback) if is_live(): now = datetime.now(timezone.utc) - - assert expires_at > now, \ - f"Expiration time should be in the future, but expires at {expires_at} (now: {now})" - + + assert ( + expires_at > now + ), f"Expiration time should be in the future, but expires at {expires_at} (now: {now})" + # Calculate time until expiration time_until_expiration = expires_at - now assert time_until_expiration.total_seconds() > 0, "Should have positive time until expiration" - + print(f"[PASS] Expiration time verified: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") print(f"[INFO] Time until expiration: {time_until_expiration.total_seconds() / 60:.2f} minutes") - + if time_until_expiration.total_seconds() / 3600 < 24: print("[WARN] Note: Authorization expires in less than 24 hours") else: - print(f"[INFO] Expiration time: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC (from recorded response)") - + print( + f"[INFO] Expiration time: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC (from recorded response)" + ) + print(f"[INFO] Copy authorization granted successfully:") print(f"[INFO] Source analyzer: {source_analyzer_id}") print(f"[INFO] Target resource: {copy_auth.target_azure_resource_id}") print(f"[INFO] Target region: {target_region}") print(f"[INFO] Expires: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") print("[INFO] Authorization ready for cross-resource copy") - + # Step 3: Copy analyzer using authorization # Copy is performed on the target client, copying from source to target print(f"\n[INFO] Copying analyzer from source to target") - + copy_poller = target_client.begin_copy_analyzer( analyzer_id=target_analyzer_id, source_analyzer_id=source_analyzer_id, @@ -315,35 +333,35 @@ def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, ) copy_result = copy_poller.result() print(f"[PASS] Target analyzer '{target_analyzer_id}' copied successfully to target resource!") - + # Verify copy result assert copy_result is not None, "Copy result should not be null" - if hasattr(copy_result, 'description'): + if hasattr(copy_result, "description"): print(f"[INFO] Target analyzer description: {copy_result.description}") - + # Step 4: Verify the copied analyzer copied_analyzer = target_client.get_analyzer(analyzer_id=target_analyzer_id) - + assert copied_analyzer is not None, "Copied analyzer should not be null" print("[PASS] Copied analyzer retrieved successfully") - + # Verify basic properties match - if hasattr(copied_analyzer, 'analyzer_id'): + if hasattr(copied_analyzer, "analyzer_id"): assert copied_analyzer.analyzer_id == target_analyzer_id, "Analyzer ID should match" print(f"[INFO] Target Analyzer ID: {copied_analyzer.analyzer_id}") - - copied_description = getattr(copied_analyzer, 'description', None) + + copied_description = getattr(copied_analyzer, "description", None) assert copied_description == "Source analyzer for cross-resource copying", "Description should match" print(f"[INFO] Description: {copied_description}") - - if hasattr(copied_analyzer, 'status'): + + if hasattr(copied_analyzer, "status"): print(f"[INFO] Status: {copied_analyzer.status}") - + print("[PASS] Copied analyzer properties verified") - + print("\n[SUCCESS] All test_sample_grant_copy_auth assertions passed") print("[INFO] Grant copy authorization functionality demonstrated") - + # Return variables to be recorded for playback mode return variables finally: @@ -354,7 +372,7 @@ def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, print(f"\n[INFO] Source analyzer '{source_analyzer_id}' deleted successfully.") except Exception as cleanup_error: print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") - + try: if target_analyzer_id and target_client: target_client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore[attr-defined] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py index 6e73c02e1a8a..056d2fdd55eb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py @@ -1,3 +1,4 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 # ------------------------------------------------------------------------- @@ -31,7 +32,7 @@ ContentFieldSchema, ContentFieldDefinition, ContentFieldType, - GenerationMethod + GenerationMethod, ) @@ -42,7 +43,7 @@ class TestSampleGrantCopyAuthAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_grant_copy_auth_async(self, azure_content_understanding_endpoint: str, **kwargs) -> None: """Test granting copy authorization for cross-resource analyzer copying (async version). - + This test validates: 1. Creating a source analyzer 2. Granting copy authorization from source resource @@ -54,43 +55,53 @@ async def test_sample_grant_copy_auth_async(self, azure_content_understanding_en target_analyzer_id: str = "" source_client: Optional[ContentUnderstandingClient] = None target_client: Optional[ContentUnderstandingClient] = None - + try: # Get source and target resource information from environment # For testing, we may use the same endpoint for both source and target # In production, these would be different resources source_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID") source_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION") - target_endpoint = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", azure_content_understanding_endpoint) + target_endpoint = os.environ.get( + "AZURE_CONTENT_UNDERSTANDING_TARGET_ENDPOINT", azure_content_understanding_endpoint + ) target_resource_id = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID") target_region = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION") target_key = os.environ.get("AZURE_CONTENT_UNDERSTANDING_TARGET_KEY") - + # Only require environment variables in live mode # In playback mode, the test proxy will replay recorded interactions if is_live(): if not source_resource_id: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID is required for cross-resource copy test in live mode") + raise ValueError( + "AZURE_CONTENT_UNDERSTANDING_SOURCE_RESOURCE_ID is required for cross-resource copy test in live mode" + ) if not source_region: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION is required for cross-resource copy test in live mode") + raise ValueError( + "AZURE_CONTENT_UNDERSTANDING_SOURCE_REGION is required for cross-resource copy test in live mode" + ) if not target_resource_id: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID is required for cross-resource copy test in live mode") + raise ValueError( + "AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID is required for cross-resource copy test in live mode" + ) if not target_region: - raise ValueError("AZURE_CONTENT_UNDERSTANDING_TARGET_REGION is required for cross-resource copy test in live mode") + raise ValueError( + "AZURE_CONTENT_UNDERSTANDING_TARGET_REGION is required for cross-resource copy test in live mode" + ) else: # In playback mode, use placeholder values - test proxy will use recorded values source_resource_id = source_resource_id or "placeholder-source-resource-id" source_region = source_region or "placeholder-source-region" target_resource_id = target_resource_id or "placeholder-target-resource-id" target_region = target_region or "placeholder-target-region" - + # Create clients source_client = self.create_async_client(endpoint=azure_content_understanding_endpoint) - + # Create target client (may use different endpoint and credential) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential - + if target_endpoint != azure_content_understanding_endpoint or target_key: # Create target client with different endpoint/credential target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() @@ -105,20 +116,20 @@ async def test_sample_grant_copy_auth_async(self, azure_content_understanding_en else: # Use same endpoint and credential as source target_client = self.create_async_client(endpoint=target_endpoint) - + # Get variables from test proxy (for playback mode) or use defaults (for record mode) variables = kwargs.pop("variables", {}) - + # Generate unique analyzer IDs for this test # Use variables from recording if available (playback mode), otherwise generate new ones (record mode) default_source_id = f"test_analyzer_source_{uuid.uuid4().hex[:16]}" default_target_id = f"test_analyzer_target_{uuid.uuid4().hex[:16]}" source_analyzer_id = variables.setdefault("grantCopySourceAnalyzerId", default_source_id) target_analyzer_id = variables.setdefault("grantCopyTargetAnalyzerId", default_target_id) - + print(f"[INFO] Source analyzer ID: {source_analyzer_id}") print(f"[INFO] Target analyzer ID: {target_analyzer_id}") - + # Verify IDs assert source_analyzer_id is not None, "Source analyzer ID should not be null" assert source_analyzer_id.strip(), "Source analyzer ID should not be empty" @@ -126,7 +137,7 @@ async def test_sample_grant_copy_auth_async(self, azure_content_understanding_en assert target_analyzer_id.strip(), "Target analyzer ID should not be empty" assert source_analyzer_id != target_analyzer_id, "Source and target IDs should be different" print("[PASS] Analyzer IDs verified") - + # Verify resource information (only in live mode) # In playback mode, the test proxy will replay recorded interactions if is_live(): @@ -138,97 +149,99 @@ async def test_sample_grant_copy_auth_async(self, azure_content_understanding_en assert target_resource_id.strip(), "Target resource ID should not be empty" assert target_region is not None, "Target region should not be null" assert target_region.strip(), "Target region should not be empty" - + assert target_endpoint is not None, "Target endpoint should not be null" assert target_endpoint.strip(), "Target endpoint should not be empty" - + if is_live(): print(f"[INFO] Source resource: {source_resource_id}") print(f"[INFO] Source region: {source_region}") print(f"[INFO] Target resource: {target_resource_id}") print(f"[INFO] Target region: {target_region}") print(f"[INFO] Target endpoint: {target_endpoint}") - + # Verify clients assert source_client is not None, "Source client should not be null" assert target_client is not None, "Target client should not be null" print("[PASS] Source and target clients created") - + # Step 1: Create the source analyzer source_config = ContentAnalyzerConfig( enable_formula=False, enable_layout=True, enable_ocr=True, estimate_field_source_and_confidence=True, - return_details=True + return_details=True, ) - + # Verify source config assert source_config is not None, "Source config should not be null" assert source_config.enable_formula is False, "EnableFormula should be false" assert source_config.enable_layout is True, "EnableLayout should be true" assert source_config.enable_ocr is True, "EnableOcr should be true" - assert source_config.estimate_field_source_and_confidence is True, "EstimateFieldSourceAndConfidence should be true" + assert ( + source_config.estimate_field_source_and_confidence is True + ), "EstimateFieldSourceAndConfidence should be true" assert source_config.return_details is True, "ReturnDetails should be true" print("[PASS] Source config verified") - + source_field_schema = ContentFieldSchema( name="company_schema", description="Schema for extracting company information", fields={ "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company" + type=ContentFieldType.STRING, method=GenerationMethod.EXTRACT, description="Name of the company" ), "total_amount": ContentFieldDefinition( type=ContentFieldType.NUMBER, method=GenerationMethod.EXTRACT, - description="Total amount on the document" - ) - } + description="Total amount on the document", + ), + }, ) - + # Verify source field schema assert source_field_schema is not None, "Source field schema should not be null" assert source_field_schema.name == "company_schema", "Field schema name should match" - assert source_field_schema.description == "Schema for extracting company information", "Field schema description should match" + assert ( + source_field_schema.description == "Schema for extracting company information" + ), "Field schema description should match" assert len(source_field_schema.fields) == 2, "Should have 2 fields" assert "company_name" in source_field_schema.fields, "Should contain company_name field" assert "total_amount" in source_field_schema.fields, "Should contain total_amount field" - print(f"[PASS] Source field schema verified: {source_field_schema.name} ({len(source_field_schema.fields)} fields)") - + print( + f"[PASS] Source field schema verified: {source_field_schema.name} ({len(source_field_schema.fields)} fields)" + ) + source_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Source analyzer for cross-resource copying", config=source_config, field_schema=source_field_schema, - models={ - "completion": "gpt-4.1" - } + models={"completion": "gpt-4.1"}, ) - + # Verify source analyzer object assert source_analyzer is not None, "Source analyzer object should not be null" assert source_analyzer.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" - assert source_analyzer.description == "Source analyzer for cross-resource copying", "Description should match" + assert ( + source_analyzer.description == "Source analyzer for cross-resource copying" + ), "Description should match" assert source_analyzer.models is not None, "Models should not be null" assert "completion" in source_analyzer.models, "Should have completion model" assert source_analyzer.models["completion"] == "gpt-4.1", "Completion model should be gpt-4.1" print("[PASS] Source analyzer object verified") - + # Create the source analyzer create_poller = await source_client.begin_create_analyzer( - analyzer_id=source_analyzer_id, - resource=source_analyzer, - allow_replace=True + analyzer_id=source_analyzer_id, resource=source_analyzer, allow_replace=True ) await create_poller.result() # Wait for creation to complete print(f"[PASS] Source analyzer '{source_analyzer_id}' created successfully") - + # Get the full analyzer details after creation (LRO result doesn't contain full details) source_result = await source_client.get_analyzer(analyzer_id=source_analyzer_id) - + # Verify create operation assert source_result is not None, "Source analyzer result should not be null" assert source_result.base_analyzer_id == "prebuilt-document", "Base analyzer ID should match" @@ -243,70 +256,76 @@ async def test_sample_grant_copy_auth_async(self, azure_content_understanding_en print(f"[INFO] Fields: {len(source_result.field_schema.fields)}") print(f"[INFO] Models: {len(source_result.models)}") print("[INFO] Ready for cross-resource copy") - + # Step 2: Grant copy authorization from source resource # Grant authorization on the source client for copying to the target resource print(f"\n[INFO] Granting copy authorization from source resource") - + copy_auth = await source_client.grant_copy_authorization( analyzer_id=source_analyzer_id, target_azure_resource_id=target_resource_id, target_region=target_region, ) - + print("[PASS] Copy authorization granted successfully!") - + # Verify copy authorization response assert copy_auth is not None, "Copy authorization response should not be null" - assert hasattr(copy_auth, 'target_azure_resource_id'), "Copy authorization should have target_azure_resource_id" + assert hasattr( + copy_auth, "target_azure_resource_id" + ), "Copy authorization should have target_azure_resource_id" assert copy_auth.target_azure_resource_id is not None, "Target Azure resource ID should not be null" assert copy_auth.target_azure_resource_id.strip(), "Target Azure resource ID should not be empty" # In playback mode, compare against the recorded response value # In live mode, compare against the environment variable if is_live(): - assert copy_auth.target_azure_resource_id == target_resource_id, \ - f"Target resource ID should match, but got '{copy_auth.target_azure_resource_id}' instead of '{target_resource_id}'" + assert ( + copy_auth.target_azure_resource_id == target_resource_id + ), f"Target resource ID should match, but got '{copy_auth.target_azure_resource_id}' instead of '{target_resource_id}'" print(f"[PASS] Target Azure Resource ID verified: {copy_auth.target_azure_resource_id}") print(f"[INFO] Target region (tracked): {target_region}") else: # In playback mode, just verify the response has a value (from recording) print(f"[INFO] Target Azure Resource ID (from recording): {copy_auth.target_azure_resource_id}") print(f"[INFO] Target region (from recording): {target_region}") - + # Verify expiration time - assert hasattr(copy_auth, 'expires_at'), "Copy authorization should have expires_at" + assert hasattr(copy_auth, "expires_at"), "Copy authorization should have expires_at" expires_at = copy_auth.expires_at # Only verify expiration time in live/record mode, not in playback mode # (recorded expiration times may be in the past during playback) if is_live(): now = datetime.now(timezone.utc) - - assert expires_at > now, \ - f"Expiration time should be in the future, but expires at {expires_at} (now: {now})" - + + assert ( + expires_at > now + ), f"Expiration time should be in the future, but expires at {expires_at} (now: {now})" + # Calculate time until expiration time_until_expiration = expires_at - now assert time_until_expiration.total_seconds() > 0, "Should have positive time until expiration" - + print(f"[PASS] Expiration time verified: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") print(f"[INFO] Time until expiration: {time_until_expiration.total_seconds() / 60:.2f} minutes") - + if time_until_expiration.total_seconds() / 3600 < 24: print("[WARN] Note: Authorization expires in less than 24 hours") else: - print(f"[INFO] Expiration time: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC (from recorded response)") - + print( + f"[INFO] Expiration time: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC (from recorded response)" + ) + print(f"[INFO] Copy authorization granted successfully:") print(f"[INFO] Source analyzer: {source_analyzer_id}") print(f"[INFO] Target resource: {copy_auth.target_azure_resource_id}") print(f"[INFO] Target region: {target_region}") print(f"[INFO] Expires: {expires_at.strftime('%Y-%m-%d %H:%M:%S')} UTC") print("[INFO] Authorization ready for cross-resource copy") - + # Step 3: Copy analyzer using authorization # Copy is performed on the target client, copying from source to target print(f"\n[INFO] Copying analyzer from source to target") - + copy_poller = await target_client.begin_copy_analyzer( analyzer_id=target_analyzer_id, source_analyzer_id=source_analyzer_id, @@ -315,35 +334,35 @@ async def test_sample_grant_copy_auth_async(self, azure_content_understanding_en ) copy_result = await copy_poller.result() print(f"[PASS] Target analyzer '{target_analyzer_id}' copied successfully to target resource!") - + # Verify copy result assert copy_result is not None, "Copy result should not be null" - if hasattr(copy_result, 'description'): + if hasattr(copy_result, "description"): print(f"[INFO] Target analyzer description: {copy_result.description}") - + # Step 4: Verify the copied analyzer copied_analyzer = await target_client.get_analyzer(analyzer_id=target_analyzer_id) - + assert copied_analyzer is not None, "Copied analyzer should not be null" print("[PASS] Copied analyzer retrieved successfully") - + # Verify basic properties match - if hasattr(copied_analyzer, 'analyzer_id'): + if hasattr(copied_analyzer, "analyzer_id"): assert copied_analyzer.analyzer_id == target_analyzer_id, "Analyzer ID should match" print(f"[INFO] Target Analyzer ID: {copied_analyzer.analyzer_id}") - - copied_description = getattr(copied_analyzer, 'description', None) + + copied_description = getattr(copied_analyzer, "description", None) assert copied_description == "Source analyzer for cross-resource copying", "Description should match" print(f"[INFO] Description: {copied_description}") - - if hasattr(copied_analyzer, 'status'): + + if hasattr(copied_analyzer, "status"): print(f"[INFO] Status: {copied_analyzer.status}") - + print("[PASS] Copied analyzer properties verified") - + print("\n[SUCCESS] All test_sample_grant_copy_auth_async assertions passed") print("[INFO] Grant copy authorization functionality demonstrated") - + # Return variables to be recorded for playback mode return variables finally: @@ -354,14 +373,14 @@ async def test_sample_grant_copy_auth_async(self, azure_content_understanding_en print(f"\n[INFO] Source analyzer '{source_analyzer_id}' deleted successfully.") except Exception as cleanup_error: print(f"\n[WARN] Could not delete source analyzer: {str(cleanup_error)[:100]}") - + try: if target_analyzer_id and target_client: await target_client.delete_analyzer(analyzer_id=target_analyzer_id) # type: ignore[attr-defined] print(f"[INFO] Target analyzer '{target_analyzer_id}' deleted successfully.") except Exception as cleanup_error: print(f"[WARN] Could not delete target analyzer: {str(cleanup_error)[:100]}") - + try: if source_client: await source_client.close() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py index 66545a5cd65c..7bd3f6f3f780 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py @@ -28,12 +28,12 @@ class TestSampleListAnalyzers(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_list_analyzers(self, azure_content_understanding_endpoint: str) -> None: """Test listing all available analyzers. - + This test validates: 1. Listing all analyzers using list_analyzers 2. Counting prebuilt vs custom analyzers 3. Displaying analyzer details - + 07_ListAnalyzers.ListAnalyzersAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -42,75 +42,77 @@ def test_sample_list_analyzers(self, azure_content_understanding_endpoint: str) analyzers = [] for analyzer in client.list_analyzers(): analyzers.append(analyzer) - + # Assertions assert analyzers is not None, "Analyzers list should not be null" assert len(analyzers) > 0, "Should have at least one analyzer" print(f"[PASS] Found {len(analyzers)} analyzer(s)") - + # Count prebuilt vs custom analyzers - prebuilt_count = sum(1 for a in analyzers - if hasattr(a, 'analyzer_id') and - getattr(a, 'analyzer_id', '').startswith('prebuilt-')) - custom_count = sum(1 for a in analyzers - if hasattr(a, 'analyzer_id') and - not getattr(a, 'analyzer_id', '').startswith('prebuilt-')) - + prebuilt_count = sum( + 1 for a in analyzers if hasattr(a, "analyzer_id") and getattr(a, "analyzer_id", "").startswith("prebuilt-") + ) + custom_count = sum( + 1 + for a in analyzers + if hasattr(a, "analyzer_id") and not getattr(a, "analyzer_id", "").startswith("prebuilt-") + ) + print(f"[INFO] Prebuilt analyzers: {prebuilt_count}") print(f"[INFO] Custom analyzers: {custom_count}") - + # Verify counts assert prebuilt_count >= 0, "Prebuilt count should be >= 0" assert custom_count >= 0, "Custom count should be >= 0" assert len(analyzers) == prebuilt_count + custom_count, "Total count should equal prebuilt + custom count" print(f"[PASS] Count breakdown: {prebuilt_count} prebuilt, {custom_count} custom") - + # Verify we have some prebuilt analyzers assert prebuilt_count > 0, "Should have at least one prebuilt analyzer" print(f"[PASS] Prebuilt analyzers found: {prebuilt_count}") - + # Display details for first 10 analyzers (for test output brevity) print("\n[INFO] Analyzer details (first 10):") for i, analyzer in enumerate(analyzers[:10]): - analyzer_id = getattr(analyzer, 'analyzer_id', 'unknown') - description = getattr(analyzer, 'description', '(none)') - status = getattr(analyzer, 'status', 'unknown') - + analyzer_id = getattr(analyzer, "analyzer_id", "unknown") + description = getattr(analyzer, "description", "(none)") + status = getattr(analyzer, "status", "unknown") + print(f"\n [{i+1}] ID: {analyzer_id}") - if description and description != '(none)': + if description and description != "(none)": print(f" Description: {description[:80]}{'...' if len(description) > 80 else ''}") else: print(f" Description: (none)") print(f" Status: {status}") - - if analyzer_id.startswith('prebuilt-'): + + if analyzer_id.startswith("prebuilt-"): print(" Type: Prebuilt analyzer") else: print(" Type: Custom analyzer") - + if len(analyzers) > 10: print(f"\n[INFO] ... and {len(analyzers) - 10} more analyzer(s)") - + # Verify each analyzer has required properties valid_analyzers = 0 analyzers_with_description = 0 - + for analyzer in analyzers: - assert hasattr(analyzer, 'analyzer_id'), "Analyzer should have analyzer_id property" - analyzer_id = getattr(analyzer, 'analyzer_id', None) + assert hasattr(analyzer, "analyzer_id"), "Analyzer should have analyzer_id property" + analyzer_id = getattr(analyzer, "analyzer_id", None) assert analyzer_id is not None, "Analyzer ID should not be null" assert len(analyzer_id) > 0, "Analyzer ID should not be empty" - + # Verify analyzer ID format (should not contain spaces) - assert ' ' not in analyzer_id, f"Analyzer ID should not contain spaces: {analyzer_id}" - + assert " " not in analyzer_id, f"Analyzer ID should not contain spaces: {analyzer_id}" + valid_analyzers += 1 - + # Track optional properties - description = getattr(analyzer, 'description', None) + description = getattr(analyzer, "description", None) if description and len(str(description).strip()) > 0: analyzers_with_description += 1 - + assert len(analyzers) == valid_analyzers, "All analyzers should have valid IDs" print(f"\n[PASS] All {valid_analyzers} analyzers have valid IDs") print(f"[INFO] Analyzers with description: {analyzers_with_description}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py index ebc51a0043e8..92158c7e5f5c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py @@ -28,12 +28,12 @@ class TestSampleListAnalyzersAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_list_analyzers_async(self, azure_content_understanding_endpoint: str) -> None: """Test listing all available analyzers (async version). - + This test validates: 1. Listing all analyzers using list_analyzers 2. Counting prebuilt vs custom analyzers 3. Displaying analyzer details - + 07_ListAnalyzers.ListAnalyzersAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -42,78 +42,80 @@ async def test_sample_list_analyzers_async(self, azure_content_understanding_end analyzers = [] async for analyzer in client.list_analyzers(): analyzers.append(analyzer) - + # Assertions assert analyzers is not None, "Analyzers list should not be null" assert len(analyzers) > 0, "Should have at least one analyzer" print(f"[PASS] Found {len(analyzers)} analyzer(s)") - + # Count prebuilt vs custom analyzers - prebuilt_count = sum(1 for a in analyzers - if hasattr(a, 'analyzer_id') and - getattr(a, 'analyzer_id', '').startswith('prebuilt-')) - custom_count = sum(1 for a in analyzers - if hasattr(a, 'analyzer_id') and - not getattr(a, 'analyzer_id', '').startswith('prebuilt-')) - + prebuilt_count = sum( + 1 for a in analyzers if hasattr(a, "analyzer_id") and getattr(a, "analyzer_id", "").startswith("prebuilt-") + ) + custom_count = sum( + 1 + for a in analyzers + if hasattr(a, "analyzer_id") and not getattr(a, "analyzer_id", "").startswith("prebuilt-") + ) + print(f"[INFO] Prebuilt analyzers: {prebuilt_count}") print(f"[INFO] Custom analyzers: {custom_count}") - + # Verify counts assert prebuilt_count >= 0, "Prebuilt count should be >= 0" assert custom_count >= 0, "Custom count should be >= 0" assert len(analyzers) == prebuilt_count + custom_count, "Total count should equal prebuilt + custom count" print(f"[PASS] Count breakdown: {prebuilt_count} prebuilt, {custom_count} custom") - + # Verify we have some prebuilt analyzers assert prebuilt_count > 0, "Should have at least one prebuilt analyzer" print(f"[PASS] Prebuilt analyzers found: {prebuilt_count}") - + # Display details for first 10 analyzers (for test output brevity) print("\n[INFO] Analyzer details (first 10):") for i, analyzer in enumerate(analyzers[:10]): - analyzer_id = getattr(analyzer, 'analyzer_id', 'unknown') - description = getattr(analyzer, 'description', '(none)') - status = getattr(analyzer, 'status', 'unknown') - + analyzer_id = getattr(analyzer, "analyzer_id", "unknown") + description = getattr(analyzer, "description", "(none)") + status = getattr(analyzer, "status", "unknown") + print(f"\n [{i+1}] ID: {analyzer_id}") - if description and description != '(none)': + if description and description != "(none)": print(f" Description: {description[:80]}{'...' if len(description) > 80 else ''}") else: print(f" Description: (none)") print(f" Status: {status}") - - if analyzer_id.startswith('prebuilt-'): + + if analyzer_id.startswith("prebuilt-"): print(" Type: Prebuilt analyzer") else: print(" Type: Custom analyzer") - + if len(analyzers) > 10: print(f"\n[INFO] ... and {len(analyzers) - 10} more analyzer(s)") - + # Verify each analyzer has required properties valid_analyzers = 0 analyzers_with_description = 0 - + for analyzer in analyzers: - assert hasattr(analyzer, 'analyzer_id'), "Analyzer should have analyzer_id property" - analyzer_id = getattr(analyzer, 'analyzer_id', None) + assert hasattr(analyzer, "analyzer_id"), "Analyzer should have analyzer_id property" + analyzer_id = getattr(analyzer, "analyzer_id", None) assert analyzer_id is not None, "Analyzer ID should not be null" assert len(analyzer_id) > 0, "Analyzer ID should not be empty" - + # Verify analyzer ID format (should not contain spaces) - assert ' ' not in analyzer_id, f"Analyzer ID should not contain spaces: {analyzer_id}" - + assert " " not in analyzer_id, f"Analyzer ID should not contain spaces: {analyzer_id}" + valid_analyzers += 1 - + # Track optional properties - description = getattr(analyzer, 'description', None) + description = getattr(analyzer, "description", None) if description and len(str(description).strip()) > 0: analyzers_with_description += 1 - + assert len(analyzers) == valid_analyzers, "All analyzers should have valid IDs" print(f"\n[PASS] All {valid_analyzers} analyzers have valid IDs") print(f"[INFO] Analyzers with description: {analyzers_with_description}") - + await client.close() print("\n[SUCCESS] All test_sample_list_analyzers_async assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py index f4cbbae86c42..13820623ee04 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py @@ -30,63 +30,54 @@ class TestSampleUpdateAnalyzer(ContentUnderstandingClientTestBase): @recorded_by_proxy def test_sample_update_analyzer(self, azure_content_understanding_endpoint: str) -> None: """Test updating an analyzer's properties. - + This test validates: 1. Creating an initial analyzer 2. Getting current analyzer state 3. Updating analyzer description and tags 4. Verifying updates were applied correctly - + 08_UpdateAnalyzer.UpdateAnalyzerAsync() """ # Skip this test if API is not available try: client = self.create_client(endpoint=azure_content_understanding_endpoint) - + # Generate unique analyzer ID for this test analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" print(f"[INFO] Creating test analyzer: {analyzer_id}") - + # Create initial analyzer initial_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Initial description", - config=ContentAnalyzerConfig( - return_details=True - ), - models={ - "completion": "gpt-4.1" - }, - tags={ - "tag1": "tag1_initial_value", - "tag2": "tag2_initial_value" - } + config=ContentAnalyzerConfig(return_details=True), + models={"completion": "gpt-4.1"}, + tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, ) - + # Create the analyzer create_poller = client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=initial_analyzer, - allow_replace=True + analyzer_id=analyzer_id, resource=initial_analyzer, allow_replace=True ) create_result = create_poller.result() assert create_result is not None, "Created analyzer should not be null" print("[PASS] Initial analyzer created successfully") - + # Get the current analyzer to preserve base analyzer ID current_analyzer = client.get_analyzer(analyzer_id=analyzer_id) - + # Assertions for initial retrieval assert current_analyzer is not None, "Current analyzer response should not be null" print("[PASS] Current analyzer retrieved successfully") - + # Display current analyzer information print("\n[INFO] Current analyzer information:") - current_description = getattr(current_analyzer, 'description', None) - current_tags = getattr(current_analyzer, 'tags', {}) + current_description = getattr(current_analyzer, "description", None) + current_tags = getattr(current_analyzer, "tags", {}) print(f" Description: {current_description}") print(f" Tags: {', '.join(f'{k}={v}' for k, v in current_tags.items())}") - + # Verify initial state assert current_description == "Initial description", "Initial description should match" assert "tag1" in current_tags, "tag1 should exist" @@ -94,60 +85,60 @@ def test_sample_update_analyzer(self, azure_content_understanding_endpoint: str) assert "tag2" in current_tags, "tag2 should exist" assert current_tags.get("tag2") == "tag2_initial_value", "tag2 value should match" print("[PASS] Initial analyzer state verified") - + # Create an updated analyzer with new description and tags - base_id = getattr(current_analyzer, 'base_analyzer_id', 'prebuilt-document') + base_id = getattr(current_analyzer, "base_analyzer_id", "prebuilt-document") updated_analyzer = ContentAnalyzer( base_analyzer_id=base_id, description="Updated description", tags={ "tag1": "tag1_updated_value", "tag2": "", # Remove tag2 (empty string) - "tag3": "tag3_value" # Add tag3 - } + "tag3": "tag3_value", # Add tag3 + }, ) - + # Update the analyzer client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) print("[PASS] Analyzer updated successfully") - + # Verify the update updated = client.get_analyzer(analyzer_id=analyzer_id) - + # Assertions for updated analyzer assert updated is not None, "Updated analyzer response should not be null" print("[PASS] Updated analyzer retrieved successfully") - + # Display updated analyzer information print("\n[INFO] Updated analyzer information:") - updated_description = getattr(updated, 'description', None) - updated_tags = getattr(updated, 'tags', {}) + updated_description = getattr(updated, "description", None) + updated_tags = getattr(updated, "tags", {}) print(f" Description: {updated_description}") print(f" Tags: {', '.join(f'{k}={v}' for k, v in updated_tags.items())}") - + # Verify description was updated assert updated_description == "Updated description", "Description should be updated" print("[PASS] Description updated correctly") - + # Verify tags were updated assert "tag1" in updated_tags, "tag1 should still exist" assert updated_tags.get("tag1") == "tag1_updated_value", "tag1 value should be updated" print("[PASS] tag1 updated correctly") - + # Verify tag2 was removed (or has empty value) if "tag2" in updated_tags: assert updated_tags.get("tag2") == "", "tag2 should have empty value" print("[PASS] tag2 set to empty value") else: print("[PASS] tag2 removed successfully") - + # Verify tag3 was added assert "tag3" in updated_tags, "tag3 should be added" assert updated_tags.get("tag3") == "tag3_value", "tag3 value should match" print("[PASS] tag3 added correctly") - + print("\n[SUCCESS] All test_sample_update_analyzer assertions passed") - + except Exception as e: error_msg = str(e).lower() if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: @@ -156,7 +147,7 @@ def test_sample_update_analyzer(self, azure_content_understanding_endpoint: str) finally: # Clean up: delete the test analyzer try: - if 'analyzer_id' in locals() and 'client' in locals(): + if "analyzer_id" in locals() and "client" in locals(): client.delete_analyzer(analyzer_id=analyzer_id) # type: ignore print(f"\n[INFO] Test analyzer deleted: {analyzer_id}") # type: ignore except Exception as cleanup_error: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py index 0c3d327c74f0..42bc6d1c83ad 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py @@ -30,63 +30,54 @@ class TestSampleUpdateAnalyzerAsync(ContentUnderstandingClientTestBaseAsync): @recorded_by_proxy_async async def test_sample_update_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """Test updating an analyzer's properties (async version). - + This test validates: 1. Creating an initial analyzer 2. Getting current analyzer state 3. Updating analyzer description and tags 4. Verifying updates were applied correctly - + 08_UpdateAnalyzer.UpdateAnalyzerAsync() """ # Skip this test if API is not available try: client = self.create_async_client(endpoint=azure_content_understanding_endpoint) - + # Generate unique analyzer ID for this test analyzer_id = f"test_analyzer_{uuid.uuid4().hex}" print(f"[INFO] Creating test analyzer: {analyzer_id}") - + # Create initial analyzer initial_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Initial description", - config=ContentAnalyzerConfig( - return_details=True - ), - models={ - "completion": "gpt-4.1" - }, - tags={ - "tag1": "tag1_initial_value", - "tag2": "tag2_initial_value" - } + config=ContentAnalyzerConfig(return_details=True), + models={"completion": "gpt-4.1"}, + tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, ) - + # Create the analyzer create_poller = await client.begin_create_analyzer( - analyzer_id=analyzer_id, - resource=initial_analyzer, - allow_replace=True + analyzer_id=analyzer_id, resource=initial_analyzer, allow_replace=True ) create_result = await create_poller.result() assert create_result is not None, "Created analyzer should not be null" print("[PASS] Initial analyzer created successfully") - + # Get the current analyzer to preserve base analyzer ID current_analyzer = await client.get_analyzer(analyzer_id=analyzer_id) - + # Assertions for initial retrieval assert current_analyzer is not None, "Current analyzer response should not be null" print("[PASS] Current analyzer retrieved successfully") - + # Display current analyzer information print("\n[INFO] Current analyzer information:") - current_description = getattr(current_analyzer, 'description', None) - current_tags = getattr(current_analyzer, 'tags', {}) + current_description = getattr(current_analyzer, "description", None) + current_tags = getattr(current_analyzer, "tags", {}) print(f" Description: {current_description}") print(f" Tags: {', '.join(f'{k}={v}' for k, v in current_tags.items())}") - + # Verify initial state assert current_description == "Initial description", "Initial description should match" assert "tag1" in current_tags, "tag1 should exist" @@ -94,60 +85,60 @@ async def test_sample_update_analyzer_async(self, azure_content_understanding_en assert "tag2" in current_tags, "tag2 should exist" assert current_tags.get("tag2") == "tag2_initial_value", "tag2 value should match" print("[PASS] Initial analyzer state verified") - + # Create an updated analyzer with new description and tags - base_id = getattr(current_analyzer, 'base_analyzer_id', 'prebuilt-document') + base_id = getattr(current_analyzer, "base_analyzer_id", "prebuilt-document") updated_analyzer = ContentAnalyzer( base_analyzer_id=base_id, description="Updated description", tags={ "tag1": "tag1_updated_value", "tag2": "", # Remove tag2 (empty string) - "tag3": "tag3_value" # Add tag3 - } + "tag3": "tag3_value", # Add tag3 + }, ) - + # Update the analyzer await client.update_analyzer(analyzer_id=analyzer_id, resource=updated_analyzer) print("[PASS] Analyzer updated successfully") - + # Verify the update updated = await client.get_analyzer(analyzer_id=analyzer_id) - + # Assertions for updated analyzer assert updated is not None, "Updated analyzer response should not be null" print("[PASS] Updated analyzer retrieved successfully") - + # Display updated analyzer information print("\n[INFO] Updated analyzer information:") - updated_description = getattr(updated, 'description', None) - updated_tags = getattr(updated, 'tags', {}) + updated_description = getattr(updated, "description", None) + updated_tags = getattr(updated, "tags", {}) print(f" Description: {updated_description}") print(f" Tags: {', '.join(f'{k}={v}' for k, v in updated_tags.items())}") - + # Verify description was updated assert updated_description == "Updated description", "Description should be updated" print("[PASS] Description updated correctly") - + # Verify tags were updated assert "tag1" in updated_tags, "tag1 should still exist" assert updated_tags.get("tag1") == "tag1_updated_value", "tag1 value should be updated" print("[PASS] tag1 updated correctly") - + # Verify tag2 was removed (or has empty value) if "tag2" in updated_tags: assert updated_tags.get("tag2") == "", "tag2 should have empty value" print("[PASS] tag2 set to empty value") else: print("[PASS] tag2 removed successfully") - + # Verify tag3 was added assert "tag3" in updated_tags, "tag3 should be added" assert updated_tags.get("tag3") == "tag3_value", "tag3 value should match" print("[PASS] tag3 added correctly") - + print("\n[SUCCESS] All test_sample_update_analyzer_async assertions passed") - + except Exception as e: error_msg = str(e).lower() if "not supported" in error_msg or "not available" in error_msg or "not implemented" in error_msg: @@ -156,14 +147,14 @@ async def test_sample_update_analyzer_async(self, azure_content_understanding_en finally: # Clean up: delete the test analyzer try: - if 'analyzer_id' in locals() and 'client' in locals(): + if "analyzer_id" in locals() and "client" in locals(): await client.delete_analyzer(analyzer_id=analyzer_id) # type: ignore print(f"\n[INFO] Test analyzer deleted: {analyzer_id}") # type: ignore except Exception as cleanup_error: print(f"\n[WARN] Could not delete test analyzer: {str(cleanup_error)[:100]}") - + try: - if 'client' in locals(): + if "client" in locals(): await client.close() except Exception: pass diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py index 0c020723c1f0..93ab72de5a85 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_analyzer_operation_id.py @@ -157,9 +157,7 @@ def test_analyze_operation_returns_custom_poller(self): mock_polling_method._initial_response = mock_initial_response # Create actual AnalyzeLROPoller instance - result = AnalyzeLROPoller( - mock_client, mock_initial_response, Mock(), mock_polling_method - ) + result = AnalyzeLROPoller(mock_client, mock_initial_response, Mock(), mock_polling_method) # Verify it has the operation_id property assert isinstance(result, AnalyzeLROPoller) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py index ab5fc91f46f2..4085c56cd5d6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations.py @@ -217,7 +217,9 @@ class TestContentUnderstandingContentAnalyzersOperations(ContentUnderstandingCli @ContentUnderstandingPreparer() @recorded_by_proxy - def test_content_analyzers_begin_create_with_content_analyzer(self, azure_content_understanding_endpoint: str) -> None: + def test_content_analyzers_begin_create_with_content_analyzer( + self, azure_content_understanding_endpoint: str + ) -> None: """ Test Summary: - Create analyzer using ContentAnalyzer object @@ -582,26 +584,26 @@ def test_content_analyzers_get_result_file(self, azure_content_understanding_end @recorded_by_proxy def test_content_analyzers_analyze_binary_extract_markdown(self, azure_content_understanding_endpoint: str) -> None: """Test extracting markdown content from analyzed binary documents. - + This test corresponds to .NET AnalyzeBinary_ExtractMarkdown. Verifies that markdown is successfully extracted and is non-empty. """ client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) - + print("\n=== Test: Extract Markdown from Binary Document ===") - + # Get test file path current_dir = os.path.dirname(os.path.abspath(__file__)) file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") assert os.path.exists(file_path), f"Sample file should exist at {file_path}" print(f"Test file: {file_path}") - + # Read file content with open(file_path, "rb") as f: file_bytes = f.read() assert len(file_bytes) > 0, "File should not be empty" print(f"File size: {len(file_bytes)} bytes") - + # Analyze the document print("\nAnalyzing document with prebuilt-documentSearch...") poller = client.begin_analyze_binary( @@ -609,11 +611,11 @@ def test_content_analyzers_analyze_binary_extract_markdown(self, azure_content_u binary_input=file_bytes, content_type="application/pdf", ) - + # Wait for completion result = poller.result() assert_poller_properties(poller) - + # Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" @@ -621,18 +623,18 @@ def test_content_analyzers_analyze_binary_extract_markdown(self, azure_content_u assert len(result.contents) > 0, "Result should contain at least one content element" assert len(result.contents) == 1, "PDF file should have exactly one content element" print(f"✓ Analysis completed with {len(result.contents)} content element(s)") - + # Extract markdown from first content content = result.contents[0] assert content is not None, "Content should not be null" - + # Verify markdown content assert hasattr(content, "markdown"), "Content should have markdown attribute" assert content.markdown is not None, "Markdown content should not be null" assert isinstance(content.markdown, str), "Markdown should be a string" assert len(content.markdown) > 0, "Markdown content should not be empty" assert content.markdown.strip(), "Markdown content should not be just whitespace" - + print(f"\n✓ Markdown extraction successful:") print(f" - Markdown length: {len(content.markdown)} characters") print(f" - First 100 chars: {content.markdown[:100]}...") @@ -642,18 +644,18 @@ def test_content_analyzers_analyze_binary_extract_markdown(self, azure_content_u @recorded_by_proxy def test_content_analyzers_create_classifier(self, azure_content_understanding_endpoint: str) -> None: """Test creating a classifier with content categories and document segmentation. - + This test corresponds to .NET CreateClassifier. - Verifies that the classifier is created successfully with the specified categories + Verifies that the classifier is created successfully with the specified categories and configuration, and can segment documents into different categories. """ client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) created_analyzer = False analyzer_id = generate_analyzer_id(client, "test_classifier", is_async=False) - + print(f"\n=== Test: Create Classifier with Segmentation ===") print(f"Analyzer ID: {analyzer_id}") - + try: # Define content categories for classification content_categories = { @@ -665,40 +667,34 @@ def test_content_analyzers_create_classifier(self, azure_content_understanding_e }, "Bank_Statement": { "description": "Official statements issued by banks that summarize account activity" - } + }, } - + # Create analyzer configuration with categories and segmentation enabled - config = { - "returnDetails": True, - "enableSegment": True, - "contentCategories": content_categories - } - + config = {"returnDetails": True, "enableSegment": True, "contentCategories": content_categories} + # Create the classifier analyzer classifier = { "baseAnalyzerId": "prebuilt-document", "description": "Custom classifier for financial document categorization", "config": config, - "models": { - "completion": "gpt-4.1" - } + "models": {"completion": "gpt-4.1"}, } - + print(f"\nCreating classifier with {len(content_categories)} categories...") print(f"Categories: {', '.join(content_categories.keys())}") - + # Create the classifier poller = create_analyzer_and_assert_sync(client, analyzer_id, classifier) created_analyzer = True - + # Get the created classifier to verify full details get_response = client.get_analyzer(analyzer_id=analyzer_id) assert get_response is not None, "Get analyzer response should not be null" - + result = get_response assert result is not None, "Classifier result should not be null" - + # Verify config if hasattr(result, "config") and result.config is not None: config_dict = result.config if isinstance(result.config, dict) else result.config.as_dict() @@ -711,9 +707,9 @@ def test_content_analyzers_create_classifier(self, azure_content_understanding_e print(" (Config exists but contentCategories not verified - may be service behavior)") else: print(" (Config verification skipped - result.config is None)") - + print(f"✓ Classifier test completed successfully") - + finally: # Always clean up the created analyzer delete_analyzer_and_assert_sync(client, analyzer_id, created_analyzer) @@ -722,27 +718,27 @@ def test_content_analyzers_create_classifier(self, azure_content_understanding_e @recorded_by_proxy def test_content_analyzers_analyze_configs(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document with specific configurations enabled. - + This test corresponds to .NET AnalyzeConfigs. Verifies that document features can be extracted with formulas, layout, and OCR enabled. """ client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) - + print("\n=== Test: Analyze with Specific Configurations ===") - + # Get test file path current_dir = os.path.dirname(os.path.abspath(__file__)) file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") - + assert os.path.exists(file_path), f"Test file should exist at {file_path}" print(f"Test file: {file_path}") - + # Read file content with open(file_path, "rb") as f: file_bytes = f.read() assert len(file_bytes) > 0, "File should not be empty" print(f"File size: {len(file_bytes)} bytes") - + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled print("\nAnalyzing document with prebuilt-documentSearch (formulas, layout, OCR enabled)...") poller = client.begin_analyze_binary( @@ -750,11 +746,11 @@ def test_content_analyzers_analyze_configs(self, azure_content_understanding_end binary_input=file_bytes, content_type="application/pdf", ) - + # Wait for completion result = poller.result() assert_poller_properties(poller) - + # Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" @@ -762,50 +758,49 @@ def test_content_analyzers_analyze_configs(self, azure_content_understanding_end assert len(result.contents) > 0, "Result should have at least one content" assert len(result.contents) == 1, "PDF file should have exactly one content element" print(f"✓ Analysis completed with {len(result.contents)} content element(s)") - + # Verify document content document_content = result.contents[0] assert document_content is not None, "Content should not be null" assert hasattr(document_content, "start_page_number"), "Should have start_page_number" start_page = getattr(document_content, "start_page_number", None) assert start_page is not None and start_page >= 1, "Start page should be >= 1" - + if hasattr(document_content, "end_page_number"): end_page = getattr(document_content, "end_page_number", None) - assert end_page is not None and end_page >= start_page, \ - "End page should be >= start page" + assert end_page is not None and end_page >= start_page, "End page should be >= start page" print(f"✓ Document page range: {start_page}-{end_page}") - + # Verify markdown was extracted (OCR/layout result) if hasattr(document_content, "markdown") and document_content.markdown: print(f"✓ Markdown extracted ({len(document_content.markdown)} characters)") - + print(f"✓ Configuration test completed successfully") @ContentUnderstandingPreparer() @recorded_by_proxy def test_content_analyzers_analyze_return_raw_json(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document and returning raw JSON response. - + This test corresponds to .NET AnalyzeReturnRawJson. Verifies that the raw JSON response can be retrieved and parsed. """ client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) - + print("\n=== Test: Analyze and Return Raw JSON ===") - + # Get test file path current_dir = os.path.dirname(os.path.abspath(__file__)) file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") assert os.path.exists(file_path), f"Sample file should exist at {file_path}" print(f"Test file: {file_path}") - + # Read file content with open(file_path, "rb") as f: file_bytes = f.read() assert len(file_bytes) > 0, "File should not be empty" print(f"File size: {len(file_bytes)} bytes") - + # Analyze the document print("\nAnalyzing document with prebuilt-documentSearch...") poller = client.begin_analyze_binary( @@ -813,25 +808,26 @@ def test_content_analyzers_analyze_return_raw_json(self, azure_content_understan binary_input=file_bytes, content_type="application/pdf", ) - + # Wait for completion result = poller.result() assert_poller_properties(poller) - + # Verify operation completed successfully assert result is not None, "Analysis result should not be null" - + # Verify response can be serialized to JSON import json - result_dict = result.as_dict() if hasattr(result, 'as_dict') else dict(result) + + result_dict = result.as_dict() if hasattr(result, "as_dict") else dict(result) json_str = json.dumps(result_dict, indent=2) assert len(json_str) > 0, "JSON string should not be empty" - + # Verify JSON can be parsed back parsed = json.loads(json_str) assert parsed is not None, "Parsed JSON should not be null" assert isinstance(parsed, dict), "Parsed JSON should be a dictionary" - + print(f"✓ JSON serialization successful:") print(f" - JSON length: {len(json_str)} characters") print(f" - Top-level keys: {', '.join(list(parsed.keys())[:5])}...") @@ -841,18 +837,18 @@ def test_content_analyzers_analyze_return_raw_json(self, azure_content_understan @recorded_by_proxy def test_content_analyzers_delete_result(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analysis result. - + This test corresponds to .NET DeleteResult. Verifies that an analysis result can be deleted using its operation ID. """ client: ContentUnderstandingClient = self.create_client(endpoint=azure_content_understanding_endpoint) - + print("\n=== Test: Delete Analysis Result ===") - + # Get test file URI document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" print(f"Document URL: {document_url}") - + # Start the analysis operation print("\nStarting analysis operation...") poller = client.begin_analyze( @@ -860,30 +856,30 @@ def test_content_analyzers_delete_result(self, azure_content_understanding_endpo inputs=[AnalyzeInput(url=document_url)], polling_interval=1, ) - + # Get the operation ID from the poller - operation_id = poller._polling_method._operation.get_polling_url().split('/')[-1] # type: ignore[attr-defined] - if '?' in operation_id: - operation_id = operation_id.split('?')[0] + operation_id = poller._polling_method._operation.get_polling_url().split("/")[-1] # type: ignore[attr-defined] + if "?" in operation_id: + operation_id = operation_id.split("?")[0] assert operation_id is not None, "Operation ID should not be null" assert len(operation_id) > 0, "Operation ID should not be empty" print(f"Operation ID: {operation_id}") - + # Wait for completion print("Waiting for analysis to complete...") result = poller.result() - + # Verify analysis completed successfully assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents" assert result.contents is not None, "Result should contain contents" assert len(result.contents) > 0, "Result should have at least one content" print(f"✓ Analysis completed successfully") - + # Delete the analysis result print(f"\nDeleting analysis result (operation ID: {operation_id})...") client.delete_result(operation_id=operation_id) - + print(f"✓ Delete result completed successfully") print("Note: Deletion success verified by no exception thrown") print(f"✓ Delete result test completed successfully") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py index 7be2c5b53212..f6cba960a851 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_content_understanding_content_analyzers_operations_async.py @@ -1,4 +1,4 @@ -# pylint: disable=line-too-long,useless-suppression +# pylint: disable=line-too-long,useless-suppression,too-many-lines # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. @@ -231,7 +231,9 @@ async def test_update_defaults_async(self, azure_content_understanding_endpoint: text_embedding_deployment = os.getenv("CONTENTUNDERSTANDING_TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") if not gpt41_deployment or not gpt41_mini_deployment or not text_embedding_deployment: - pytest.skip("Model deployments are not configured in test environment. Skipping test_update_defaults_async.") + pytest.skip( + "Model deployments are not configured in test environment. Skipping test_update_defaults_async." + ) return # Update defaults with configured deployments @@ -327,9 +329,7 @@ async def test_get_defaults_async(self, azure_content_understanding_endpoint: st @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_create_analyzer_async( - self, azure_content_understanding_endpoint: str - ) -> None: + async def test_create_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests creating a custom analyzer using ContentAnalyzer object. Verifies analyzer creation, poller properties, and proper cleanup. @@ -506,9 +506,7 @@ async def test_get_analyzer_async(self, azure_content_understanding_endpoint: st @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_delete_analyzer_async( - self, azure_content_understanding_endpoint: str - ) -> None: + async def test_delete_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests deleting an analyzer. Verifies that an analyzer can be successfully deleted. @@ -556,9 +554,7 @@ async def test_delete_analyzer_async( @pytest.mark.skip(reason="TEMPORARILY SKIPPED: List operation is too long - too many analyzers") @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_list_analyzers_async( - self, azure_content_understanding_endpoint: str - ) -> None: + async def test_list_analyzers_async(self, azure_content_understanding_endpoint: str) -> None: """ Tests listing all available analyzers. Verifies that prebuilt analyzers are included and have required properties. @@ -816,17 +812,19 @@ async def test_validate_document_properties_async(self, azure_content_understand # Additional specific validations assert analysis_result.contents is not None, "Should have contents" first_content = analysis_result.contents[0] - + # Verify markdown output exists (basic OCR result) - assert hasattr(first_content, 'markdown'), "Content should have markdown attribute" + assert hasattr(first_content, "markdown"), "Content should have markdown attribute" if first_content.markdown: - assert len(first_content.markdown) > 100, "Markdown content should contain substantial text from the document" + assert ( + len(first_content.markdown) > 100 + ), "Markdown content should contain substantial text from the document" print(f"✓ Markdown content length: {len(first_content.markdown)} characters") - + # Verify fields were extracted if field schema was defined - if hasattr(first_content, 'fields') and first_content.fields: - assert 'amount_due' in first_content.fields, "Should extract amount_due field" - amount_due = first_content.fields['amount_due'] + if hasattr(first_content, "fields") and first_content.fields: + assert "amount_due" in first_content.fields, "Should extract amount_due field" + amount_due = first_content.fields["amount_due"] assert amount_due is not None, "amount_due field should have a value" print(f"✓ Extracted amount_due: {amount_due}") @@ -891,42 +889,49 @@ async def test_analyze_invoice_with_fields_async(self, azure_content_understandi # Additional validation - verify at least amount_due is extracted (most critical field) first_content = analysis_result.contents[0] - assert hasattr(first_content, 'fields'), "Content should have fields" + assert hasattr(first_content, "fields"), "Content should have fields" assert first_content.fields is not None, "Fields should not be None" - + fields = first_content.fields - assert 'amount_due' in fields, "Should extract amount_due field (most critical invoice field)" - - amount_due_field = fields['amount_due'] + assert "amount_due" in fields, "Should extract amount_due field (most critical invoice field)" + + amount_due_field = fields["amount_due"] print(f"\n✓ Critical field verification:") print(f" - amount_due extracted successfully") - - if isinstance(amount_due_field, dict) and 'valueNumber' in amount_due_field: - amount_due_value = amount_due_field['valueNumber'] + + if isinstance(amount_due_field, dict) and "valueNumber" in amount_due_field: + amount_due_value = amount_due_field["valueNumber"] print(f" - Total amount value: {amount_due_value}") assert amount_due_value > 0, "Total amount should be positive" - + # Verify confidence if available - if 'confidence' in amount_due_field: - confidence = amount_due_field['confidence'] + if "confidence" in amount_due_field: + confidence = amount_due_field["confidence"] print(f" - Confidence: {confidence:.2%}") # Note: We don't enforce a minimum confidence as it depends on document quality - + # Verify source information if available - if 'spans' in amount_due_field: - spans = amount_due_field['spans'] + if "spans" in amount_due_field: + spans = amount_due_field["spans"] print(f" - Source locations: {len(spans)} span(s)") assert len(spans) > 0, "Should have source location for extracted field" - - if 'source' in amount_due_field: - source = amount_due_field['source'] + + if "source" in amount_due_field: + source = amount_due_field["source"] print(f" - Source: {source[:50]}..." if len(source) > 50 else f" - Source: {source}") # Count how many invoice fields were successfully extracted invoice_field_names = [ - 'invoice_number', 'invoice_date', 'due_date', - 'vendor_name', 'vendor_address', 'customer_name', 'customer_address', - 'subtotal', 'tax_amount', 'amount_due' + "invoice_number", + "invoice_date", + "due_date", + "vendor_name", + "vendor_address", + "customer_name", + "customer_address", + "subtotal", + "tax_amount", + "amount_due", ] extracted_count = sum(1 for field in invoice_field_names if field in fields) print(f"\n✓ Successfully extracted {extracted_count}/{len(invoice_field_names)} invoice fields") @@ -940,26 +945,26 @@ async def test_analyze_invoice_with_fields_async(self, azure_content_understandi @recorded_by_proxy_async async def test_analyze_binary_extract_markdown_async(self, azure_content_understanding_endpoint: str) -> None: """Test extracting markdown content from analyzed binary documents. - + This test corresponds to .NET AnalyzeBinaryAsync_ExtractMarkdown. Verifies that markdown is successfully extracted and is non-empty. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) - + print("\n=== Test: Extract Markdown from Binary Document ===") - + # Get test file path current_dir = os.path.dirname(os.path.abspath(__file__)) file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") assert os.path.exists(file_path), f"Sample file should exist at {file_path}" print(f"Test file: {file_path}") - + # Read file content with open(file_path, "rb") as f: file_bytes = f.read() assert len(file_bytes) > 0, "File should not be empty" print(f"File size: {len(file_bytes)} bytes") - + # Analyze the document print("\nAnalyzing document with prebuilt-documentSearch...") poller = await client.begin_analyze_binary( @@ -967,11 +972,11 @@ async def test_analyze_binary_extract_markdown_async(self, azure_content_underst binary_input=file_bytes, content_type="application/pdf", ) - + # Wait for completion result = await poller.result() assert_poller_properties(poller) - + # Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" @@ -979,18 +984,18 @@ async def test_analyze_binary_extract_markdown_async(self, azure_content_underst assert len(result.contents) > 0, "Result should contain at least one content element" assert len(result.contents) == 1, "PDF file should have exactly one content element" print(f"✓ Analysis completed with {len(result.contents)} content element(s)") - + # Extract markdown from first content content = result.contents[0] assert content is not None, "Content should not be null" - + # Verify markdown content assert hasattr(content, "markdown"), "Content should have markdown attribute" assert content.markdown is not None, "Markdown content should not be null" assert isinstance(content.markdown, str), "Markdown should be a string" assert len(content.markdown) > 0, "Markdown content should not be empty" assert content.markdown.strip(), "Markdown content should not be just whitespace" - + print(f"\n✓ Markdown extraction successful:") print(f" - Markdown length: {len(content.markdown)} characters") print(f" - First 100 chars: {content.markdown[:100]}...") @@ -1000,18 +1005,18 @@ async def test_analyze_binary_extract_markdown_async(self, azure_content_underst @recorded_by_proxy_async async def test_create_classifier_async(self, azure_content_understanding_endpoint: str) -> None: """Test creating a classifier with content categories and document segmentation. - + This test corresponds to .NET CreateClassifierAsync. - Verifies that the classifier is created successfully with the specified categories + Verifies that the classifier is created successfully with the specified categories and configuration, and can segment documents into different categories. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) created_analyzer = False analyzer_id = generate_analyzer_id(client, "test_classifier", is_async=True) - + print(f"\n=== Test: Create Classifier with Segmentation ===") print(f"Analyzer ID: {analyzer_id}") - + try: # Define content categories for classification content_categories = { @@ -1023,40 +1028,34 @@ async def test_create_classifier_async(self, azure_content_understanding_endpoin }, "Bank_Statement": { "description": "Official statements issued by banks that summarize account activity" - } + }, } - + # Create analyzer configuration with categories and segmentation enabled - config = { - "returnDetails": True, - "enableSegment": True, - "contentCategories": content_categories - } - + config = {"returnDetails": True, "enableSegment": True, "contentCategories": content_categories} + # Create the classifier analyzer classifier = { "baseAnalyzerId": "prebuilt-document", "description": "Custom classifier for financial document categorization", "config": config, - "models": { - "completion": "gpt-4.1" - } + "models": {"completion": "gpt-4.1"}, } - + print(f"\nCreating classifier with {len(content_categories)} categories...") print(f"Categories: {', '.join(content_categories.keys())}") - + # Create the classifier poller = await create_analyzer_and_assert_async(client, analyzer_id, classifier) created_analyzer = True - + # Get the created classifier to verify full details get_response = await client.get_analyzer(analyzer_id=analyzer_id) assert get_response is not None, "Get analyzer response should not be null" - + result = get_response assert result is not None, "Classifier result should not be null" - + # Verify config if hasattr(result, "config") and result.config is not None: config_dict = result.config if isinstance(result.config, dict) else result.config.as_dict() @@ -1069,9 +1068,9 @@ async def test_create_classifier_async(self, azure_content_understanding_endpoin print(" (Config exists but contentCategories not verified - may be service behavior)") else: print(" (Config verification skipped - result.config is None)") - + print(f"✓ Classifier test completed successfully") - + finally: # Always clean up the created analyzer await delete_analyzer_and_assert(client, analyzer_id, created_analyzer) @@ -1080,27 +1079,27 @@ async def test_create_classifier_async(self, azure_content_understanding_endpoin @recorded_by_proxy_async async def test_analyze_configs_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document with specific configurations enabled. - + This test corresponds to .NET AnalyzeConfigsAsync. Verifies that document features can be extracted with formulas, layout, and OCR enabled. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) - + print("\n=== Test: Analyze with Specific Configurations ===") - + # Get test file path current_dir = os.path.dirname(os.path.abspath(__file__)) file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") - + assert os.path.exists(file_path), f"Test file should exist at {file_path}" print(f"Test file: {file_path}") - + # Read file content with open(file_path, "rb") as f: file_bytes = f.read() assert len(file_bytes) > 0, "File should not be empty" print(f"File size: {len(file_bytes)} bytes") - + # Analyze with prebuilt-documentSearch which has formulas, layout, and OCR enabled print("\nAnalyzing document with prebuilt-documentSearch (formulas, layout, OCR enabled)...") poller = await client.begin_analyze_binary( @@ -1108,11 +1107,11 @@ async def test_analyze_configs_async(self, azure_content_understanding_endpoint: binary_input=file_bytes, content_type="application/pdf", ) - + # Wait for completion result = await poller.result() assert_poller_properties(poller) - + # Verify result assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents attribute" @@ -1120,50 +1119,49 @@ async def test_analyze_configs_async(self, azure_content_understanding_endpoint: assert len(result.contents) > 0, "Result should have at least one content" assert len(result.contents) == 1, "PDF file should have exactly one content element" print(f"✓ Analysis completed with {len(result.contents)} content element(s)") - + # Verify document content document_content = result.contents[0] assert document_content is not None, "Content should not be null" assert hasattr(document_content, "start_page_number"), "Should have start_page_number" start_page = getattr(document_content, "start_page_number", None) assert start_page is not None and start_page >= 1, "Start page should be >= 1" - + if hasattr(document_content, "end_page_number"): end_page = getattr(document_content, "end_page_number", None) - assert end_page is not None and end_page >= start_page, \ - "End page should be >= start page" + assert end_page is not None and end_page >= start_page, "End page should be >= start page" print(f"✓ Document page range: {start_page}-{end_page}") - + # Verify markdown was extracted (OCR/layout result) if hasattr(document_content, "markdown") and document_content.markdown: print(f"✓ Markdown extracted ({len(document_content.markdown)} characters)") - + print(f"✓ Configuration test completed successfully") @ContentUnderstandingPreparer() @recorded_by_proxy_async async def test_analyze_return_raw_json_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document and returning raw JSON response. - + This test corresponds to .NET AnalyzeReturnRawJsonAsync. Verifies that the raw JSON response can be retrieved and parsed. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) - + print("\n=== Test: Analyze and Return Raw JSON ===") - + # Get test file path current_dir = os.path.dirname(os.path.abspath(__file__)) file_path = os.path.join(current_dir, "test_data", "sample_invoice.pdf") assert os.path.exists(file_path), f"Sample file should exist at {file_path}" print(f"Test file: {file_path}") - + # Read file content with open(file_path, "rb") as f: file_bytes = f.read() assert len(file_bytes) > 0, "File should not be empty" print(f"File size: {len(file_bytes)} bytes") - + # Analyze the document print("\nAnalyzing document with prebuilt-documentSearch...") poller = await client.begin_analyze_binary( @@ -1171,25 +1169,26 @@ async def test_analyze_return_raw_json_async(self, azure_content_understanding_e binary_input=file_bytes, content_type="application/pdf", ) - + # Wait for completion result = await poller.result() assert_poller_properties(poller) - + # Verify operation completed successfully assert result is not None, "Analysis result should not be null" - + # Verify response can be serialized to JSON import json - result_dict = result.as_dict() if hasattr(result, 'as_dict') else dict(result) + + result_dict = result.as_dict() if hasattr(result, "as_dict") else dict(result) json_str = json.dumps(result_dict, indent=2) assert len(json_str) > 0, "JSON string should not be empty" - + # Verify JSON can be parsed back parsed = json.loads(json_str) assert parsed is not None, "Parsed JSON should not be null" assert isinstance(parsed, dict), "Parsed JSON should be a dictionary" - + print(f"✓ JSON serialization successful:") print(f" - JSON length: {len(json_str)} characters") print(f" - Top-level keys: {', '.join(list(parsed.keys())[:5])}...") @@ -1199,18 +1198,18 @@ async def test_analyze_return_raw_json_async(self, azure_content_understanding_e @recorded_by_proxy_async async def test_delete_result_async(self, azure_content_understanding_endpoint: str) -> None: """Test deleting an analysis result. - + This test corresponds to .NET DeleteResultAsync. Verifies that an analysis result can be deleted using its operation ID. """ client: ContentUnderstandingClient = self.create_async_client(endpoint=azure_content_understanding_endpoint) - + print("\n=== Test: Delete Analysis Result ===") - + # Get test file URI document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" print(f"Document URL: {document_url}") - + # Start the analysis operation print("\nStarting analysis operation...") poller = await client.begin_analyze( @@ -1218,30 +1217,30 @@ async def test_delete_result_async(self, azure_content_understanding_endpoint: s inputs=[AnalyzeInput(url=document_url)], polling_interval=1, ) - + # Get the operation ID from the poller - operation_id = poller._polling_method._operation.get_polling_url().split('/')[-1] # type: ignore[attr-defined] - if '?' in operation_id: - operation_id = operation_id.split('?')[0] + operation_id = poller._polling_method._operation.get_polling_url().split("/")[-1] # type: ignore[attr-defined] + if "?" in operation_id: + operation_id = operation_id.split("?")[0] assert operation_id is not None, "Operation ID should not be null" assert len(operation_id) > 0, "Operation ID should not be empty" print(f"Operation ID: {operation_id}") - + # Wait for completion print("Waiting for analysis to complete...") result = await poller.result() - + # Verify analysis completed successfully assert result is not None, "Analysis result should not be null" assert hasattr(result, "contents"), "Result should have contents" assert result.contents is not None, "Result should contain contents" assert len(result.contents) > 0, "Result should have at least one content" print(f"✓ Analysis completed successfully") - + # Delete the analysis result print(f"\nDeleting analysis result (operation ID: {operation_id})...") await client.delete_result(operation_id=operation_id) - + print(f"✓ Delete result completed successfully") print("Note: Deletion success verified by no exception thrown") print(f"✓ Delete result test completed successfully") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py index a8273eb532da..898ba4aa7958 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/test_helpers.py @@ -323,44 +323,44 @@ def assert_document_properties(analysis_result: Any, expected_min_pages: int = 1 AssertionError: If any document property assertion fails """ print(f"Validating document properties") - + assert analysis_result is not None, "Analysis result should not be None" assert analysis_result.contents is not None, "Analysis result should have contents" assert len(analysis_result.contents) > 0, "Analysis result should have at least one content item" - + # Verify the first content has expected structure first_content = analysis_result.contents[0] assert first_content is not None, "First content should not be None" - + # Check if markdown content is present (most common output format) - if hasattr(first_content, 'markdown') and first_content.markdown: + if hasattr(first_content, "markdown") and first_content.markdown: markdown_content = first_content.markdown assert isinstance(markdown_content, str), "Markdown content should be a string" assert len(markdown_content) > 0, "Markdown content should not be empty" print(f"✓ Markdown content found: {len(markdown_content)} characters") - + # Check pages information if available - if hasattr(first_content, 'pages') and first_content.pages: + if hasattr(first_content, "pages") and first_content.pages: pages = first_content.pages assert len(pages) >= expected_min_pages, f"Expected at least {expected_min_pages} page(s), got {len(pages)}" print(f"✓ Document has {len(pages)} page(s)") - + # Validate first page properties first_page = pages[0] - if hasattr(first_page, 'page_number'): + if hasattr(first_page, "page_number"): assert first_page.page_number >= 1, "Page number should be >= 1" print(f"✓ First page number: {first_page.page_number}") - + # Check if fields were extracted (if using field schema) - if hasattr(first_content, 'fields') and first_content.fields: + if hasattr(first_content, "fields") and first_content.fields: fields = first_content.fields assert isinstance(fields, dict), "Fields should be a dictionary" print(f"✓ Extracted {len(fields)} field(s): {list(fields.keys())}") - + # Validate each field has value for field_name, field_value in fields.items(): assert field_value is not None, f"Field '{field_name}' should have a value" - + print(f"✓ Document properties validation completed successfully") @@ -484,82 +484,88 @@ def assert_invoice_fields(analysis_result: Any, result_name: str = "Invoice anal AssertionError: If any invoice field assertion fails """ print(f"Validating {result_name} invoice fields") - + assert analysis_result is not None, f"{result_name} should not be None" assert analysis_result.contents is not None, f"{result_name} should have contents" assert len(analysis_result.contents) > 0, f"{result_name} should have at least one content item" - + first_content = analysis_result.contents[0] assert first_content is not None, "First content should not be None" - + # Verify fields were extracted - assert hasattr(first_content, 'fields'), "Content should have fields attribute" + assert hasattr(first_content, "fields"), "Content should have fields attribute" assert first_content.fields is not None, "Fields should not be None" fields = first_content.fields assert isinstance(fields, dict), "Fields should be a dictionary" assert len(fields) > 0, "Should have extracted at least one field" - + print(f"✓ Extracted {len(fields)} invoice field(s): {list(fields.keys())}") - + # Define expected invoice fields (at least some should be present) expected_fields = [ - 'invoice_number', 'invoice_date', 'due_date', - 'vendor_name', 'vendor_address', - 'customer_name', 'customer_address', - 'subtotal', 'tax_amount', 'amount_due' + "invoice_number", + "invoice_date", + "due_date", + "vendor_name", + "vendor_address", + "customer_name", + "customer_address", + "subtotal", + "tax_amount", + "amount_due", ] - + found_fields = [f for f in expected_fields if f in fields] print(f"✓ Found {len(found_fields)} expected invoice fields: {found_fields}") - + # Validate numeric fields if present - numeric_fields = ['amount_due', 'subtotal', 'tax_amount'] + numeric_fields = ["amount_due", "subtotal", "tax_amount"] for field_name in numeric_fields: if field_name in fields: field_value = fields[field_name] assert field_value is not None, f"Field '{field_name}' should have a value" - + # Check if it's a dict with 'valueNumber' (common response format) if isinstance(field_value, dict): - assert 'type' in field_value, f"Field '{field_name}' should have a type" - assert field_value['type'] == 'number', f"Field '{field_name}' should have type 'number'" - - if 'valueNumber' in field_value: - value = field_value['valueNumber'] + assert "type" in field_value, f"Field '{field_name}' should have a type" + assert field_value["type"] == "number", f"Field '{field_name}' should have type 'number'" + + if "valueNumber" in field_value: + value = field_value["valueNumber"] assert isinstance(value, (int, float)), f"Field '{field_name}' valueNumber should be numeric" assert value >= 0, f"Field '{field_name}' value should be non-negative" print(f"✓ {field_name}: {value}") - + # Check confidence if available - if 'confidence' in field_value: - confidence = field_value['confidence'] + if "confidence" in field_value: + confidence = field_value["confidence"] assert isinstance(confidence, (int, float)), f"Confidence should be numeric" assert 0 <= confidence <= 1, f"Confidence should be between 0 and 1" print(f" - Confidence: {confidence:.2%}") - + # Check spans/source if available - if 'spans' in field_value: - spans = field_value['spans'] + if "spans" in field_value: + spans = field_value["spans"] assert isinstance(spans, list), "Spans should be a list" assert len(spans) > 0, "Should have at least one span" print(f" - Source spans: {len(spans)} location(s)") - + # Validate string fields if present - string_fields = ['invoice_number', 'vendor_name', 'customer_name'] + string_fields = ["invoice_number", "vendor_name", "customer_name"] for field_name in string_fields: if field_name in fields: field_value = fields[field_name] assert field_value is not None, f"Field '{field_name}' should have a value" - + # Check if it's a dict with 'valueString' (common response format) if isinstance(field_value, dict): - assert 'type' in field_value, f"Field '{field_name}' should have a type" - assert field_value['type'] == 'string', f"Field '{field_name}' should have type 'string'" - - if 'valueString' in field_value: - value = field_value['valueString'] + assert "type" in field_value, f"Field '{field_name}' should have a type" + assert field_value["type"] == "string", f"Field '{field_name}' should have type 'string'" + + if "valueString" in field_value: + value = field_value["valueString"] assert isinstance(value, str), f"Field '{field_name}' valueString should be string" assert len(value) > 0, f"Field '{field_name}' value should not be empty" print(f"✓ {field_name}: {value}") - + print(f"✓ Invoice fields validation completed successfully") From a36ea8371baa816399529732ca41eb4ff172945b Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 16 Dec 2025 19:29:16 -0800 Subject: [PATCH 076/105] [SAMPLE-UPDATE] ContentCategory to ContentCategoryDefinition --- .../async_samples/sample_create_classifier_async.py | 8 ++++---- .../samples/sample_create_classifier.py | 8 ++++---- .../tests/samples/test_sample_create_classifier.py | 10 +++++----- .../samples/test_sample_create_classifier_async.py | 10 +++++----- 4 files changed, 18 insertions(+), 18 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index 5607026b766c..9d32460866af 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -37,7 +37,7 @@ from azure.ai.contentunderstanding.models import ( ContentAnalyzer, ContentAnalyzerConfig, - ContentCategory, + ContentCategoryDefinition, AnalyzeResult, DocumentContent, MediaContentKind, @@ -62,17 +62,17 @@ async def main() -> None: # Define content categories for classification categories = { - "Loan_Application": ContentCategory( + "Loan_Application": ContentCategoryDefinition( description="Documents submitted by individuals or businesses to request funding, " "typically including personal or business details, financial history, " "loan amount, purpose, and supporting documentation." ), - "Invoice": ContentCategory( + "Invoice": ContentCategoryDefinition( description="Billing documents issued by sellers or service providers to request " "payment for goods or services, detailing items, prices, taxes, totals, " "and payment terms." ), - "Bank_Statement": ContentCategory( + "Bank_Statement": ContentCategoryDefinition( description="Official statements issued by banks that summarize account activity " "over a period, including deposits, withdrawals, fees, and balances." ), diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index 22f2a3fddb30..edb076dd9891 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -36,7 +36,7 @@ from azure.ai.contentunderstanding.models import ( ContentAnalyzer, ContentAnalyzerConfig, - ContentCategory, + ContentCategoryDefinition, AnalyzeResult, DocumentContent, MediaContentKind, @@ -62,17 +62,17 @@ def main() -> None: # Define content categories for classification categories = { - "Loan_Application": ContentCategory( + "Loan_Application": ContentCategoryDefinition( description="Documents submitted by individuals or businesses to request funding, " "typically including personal or business details, financial history, " "loan amount, purpose, and supporting documentation." ), - "Invoice": ContentCategory( + "Invoice": ContentCategoryDefinition( description="Billing documents issued by sellers or service providers to request " "payment for goods or services, detailing items, prices, taxes, totals, " "and payment terms." ), - "Bank_Statement": ContentCategory( + "Bank_Statement": ContentCategoryDefinition( description="Official statements issued by banks that summarize account activity " "over a period, including deposits, withdrawals, fees, and balances." ), diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py index a4bca1bac261..6fb48a5af23b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py @@ -24,7 +24,7 @@ from azure.ai.contentunderstanding.models import ( ContentAnalyzer, ContentAnalyzerConfig, - ContentCategory, + ContentCategoryDefinition, ) @@ -50,15 +50,15 @@ def test_sample_create_classifier(self, azure_content_understanding_endpoint: st print(f"[PASS] Classifier ID generated: {analyzer_id}") - # Define content categories for classification using ContentCategory objects + # Define content categories for classification using ContentCategoryDefinition objects categories = { - "Loan_Application": ContentCategory( + "Loan_Application": ContentCategoryDefinition( description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." ), - "Invoice": ContentCategory( + "Invoice": ContentCategoryDefinition( description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." ), - "Bank_Statement": ContentCategory( + "Bank_Statement": ContentCategoryDefinition( description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." ), } diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py index 83002e7560b3..9982626bc2f3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py @@ -24,7 +24,7 @@ from azure.ai.contentunderstanding.models import ( ContentAnalyzer, ContentAnalyzerConfig, - ContentCategory, + ContentCategoryDefinition, ) @@ -50,15 +50,15 @@ async def test_sample_create_classifier_async(self, azure_content_understanding_ print(f"[PASS] Classifier ID generated: {analyzer_id}") - # Define content categories for classification using ContentCategory objects + # Define content categories for classification using ContentCategoryDefinition objects categories = { - "Loan_Application": ContentCategory( + "Loan_Application": ContentCategoryDefinition( description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." ), - "Invoice": ContentCategory( + "Invoice": ContentCategoryDefinition( description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." ), - "Bank_Statement": ContentCategory( + "Bank_Statement": ContentCategoryDefinition( description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." ), } From 4dc8c6592e16737d8ab53a4e7d169c05a988caab Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 16 Dec 2025 20:18:41 -0800 Subject: [PATCH 077/105] [TEST-INFRA] skip folders/files for pytest --- .../azure-ai-contentunderstanding/pyproject.toml | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml index cd660792b3c1..17c5938d2fad 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/pyproject.toml @@ -59,3 +59,13 @@ exclude = [ [tool.setuptools.package-data] pytyped = ["py.typed"] + +[tool.pytest.ini_options] +testpaths = ["tests"] +norecursedirs = [ + "TempTypeSpecFiles", + ".venv", + "node_modules", + ".git", + "__pycache__", +] From ca1936c208601eb9f0fcf7939bf5e5918c702e21 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 16 Dec 2025 20:30:18 -0800 Subject: [PATCH 078/105] [SDK-UPDATE] remove _patch.py functions --- .../_operations/_patch.py | 169 +----------------- .../aio/_operations/_patch.py | 147 +-------------- 2 files changed, 10 insertions(+), 306 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index ecf1d86b7b90..2c83f9d04d09 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -6,175 +6,16 @@ # -------------------------------------------------------------------------- """Customize generated code here. -SDK-FIX: Fix copy analyzer endpoint path and status code handling. -- URL path: Change from ":copyAnalyzer" to ":copy" (emitter generates wrong endpoint path) -- Status codes: Accept both 201 and 202 (service inconsistently returns both status codes) +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -import json -from collections.abc import MutableMapping -from io import IOBase -from typing import Any, IO, Iterator, Optional, Union - -from azure.core.exceptions import ( - ClientAuthenticationError, - HttpResponseError, - ResourceExistsError, - ResourceNotFoundError, - ResourceNotModifiedError, - StreamClosedError, - StreamConsumedError, - map_error, -) -from azure.core.pipeline import PipelineResponse -from azure.core.rest import HttpRequest -from azure.core.utils import case_insensitive_dict - __all__: list[str] = [] def patch_sdk(): - """Patch the SDK to fix copy analyzer operations. + """No patches currently required. - This function: - 1. Replaces build_content_understanding_copy_analyzer_request to fix URL path - 2. Wraps _copy_analyzer_initial method to accept both 201 and 202 status codes + Previous patches for copy_analyzer URL path and status codes have been + incorporated into the generated code. """ - from . import _operations # pylint: disable=protected-access - - # 1. SDK-FIX: Fix URL path from ":copyAnalyzer" to ":copy" - _original_build_request = _operations.build_content_understanding_copy_analyzer_request - - def _patched_build_content_understanding_copy_analyzer_request( - analyzer_id: str, *, allow_replace: Optional[bool] = None, **kwargs: Any - ) -> HttpRequest: - """Patched version that uses correct endpoint path :copy instead of :copyAnalyzer. - - :param analyzer_id: The analyzer ID for the copy operation. - :type analyzer_id: str - :keyword allow_replace: Whether to allow replacing an existing analyzer. - :paramtype allow_replace: Optional[bool] - :return: The HTTP request object with corrected URL path. - :rtype: HttpRequest - """ - request = _original_build_request(analyzer_id, allow_replace=allow_replace, **kwargs) - # Fix the URL path - if ":copyAnalyzer" in request.url: - request.url = request.url.replace(":copyAnalyzer", ":copy") - return request - - _operations.build_content_understanding_copy_analyzer_request = ( - _patched_build_content_understanding_copy_analyzer_request - ) - - # 2. SDK-FIX: Wrap _copy_analyzer_initial to accept both 201 and 202 status codes - _original_copy_initial = ( - _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial - ) # pylint: disable=protected-access - - def _patched_copy_analyzer_initial( # pylint: disable=protected-access - self, - analyzer_id: str, - body: Union[_operations.JSON, IO[bytes]] = _operations._Unset, - *, - source_analyzer_id: str = _operations._Unset, - allow_replace: Optional[bool] = None, - source_azure_resource_id: Optional[str] = None, - source_region: Optional[str] = None, - **kwargs: Any - ) -> Iterator[bytes]: - """Patched version that accepts both 201 and 202 status codes. - - :param analyzer_id: The analyzer ID for the copy operation. - :type analyzer_id: str - :param body: The request body. - :type body: Union[JSON, IO[bytes]] - :keyword source_analyzer_id: The source analyzer ID. - :paramtype source_analyzer_id: str - :keyword allow_replace: Whether to allow replacing an existing analyzer. - :paramtype allow_replace: Optional[bool] - :keyword source_azure_resource_id: The source Azure resource ID. - :paramtype source_azure_resource_id: Optional[str] - :keyword source_region: The source region. - :paramtype source_region: Optional[str] - :return: An iterator of bytes. - :rtype: Iterator[bytes] - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = kwargs.pop("params", {}) or {} - - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - cls: _operations.ClsType[Iterator[bytes]] = kwargs.pop("cls", None) - - if body is _operations._Unset: - if source_analyzer_id is _operations._Unset: - raise TypeError("missing required argument: source_analyzer_id") - body = { - "sourceAnalyzerId": source_analyzer_id, - "sourceAzureResourceId": source_azure_resource_id, - "sourceRegion": source_region, - } - body = {k: v for k, v in body.items() if v is not None} - content_type = content_type or "application/json" - _content = None - if isinstance(body, (IOBase, bytes)): - _content = body - else: - from .._utils.model_base import SdkJSONEncoder - - _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore - - _request = _operations.build_content_understanding_copy_analyzer_request( - analyzer_id=analyzer_id, - allow_replace=allow_replace, - content_type=content_type, - api_version=self._config.api_version, - content=_content, - headers=_headers, - params=_params, - ) - path_format_arguments = { - "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), - } - _request.url = self._client.format_url(_request.url, **path_format_arguments) - - _stream = True - pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - # SDK-FIX: Accept both 201 and 202 (service inconsistently returns both status codes) - if response.status_code not in [201, 202]: - try: - response.read() # Load the body in memory and close the socket - except (StreamConsumedError, StreamClosedError): - pass - map_error(status_code=response.status_code, response=response, error_map=error_map) - raise HttpResponseError(response=response) - - response_headers = {} - response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) - response_headers["x-ms-client-request-id"] = self._deserialize( - "str", response.headers.get("x-ms-client-request-id") - ) - - deserialized = response.iter_bytes() - - if cls: - return cls(pipeline_response, deserialized, response_headers) # type: ignore - - return deserialized # type: ignore - - _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = ( - _patched_copy_analyzer_initial # pylint: disable=protected-access - ) + pass diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index a180fb12e95f..2c83f9d04d09 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -6,153 +6,16 @@ # -------------------------------------------------------------------------- """Customize generated code here. -SDK-FIX: Fix copy analyzer endpoint path and status code handling for async operations. -- URL path: Change from ":copyAnalyzer" to ":copy" (emitter generates wrong endpoint path) -- Status codes: Accept both 201 and 202 (service inconsistently returns both status codes) +Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -import json -from collections.abc import MutableMapping -from io import IOBase -from typing import Any, AsyncIterator, IO, Optional, Union - -from azure.core.exceptions import ( - ClientAuthenticationError, - HttpResponseError, - ResourceExistsError, - ResourceNotFoundError, - ResourceNotModifiedError, - StreamClosedError, - StreamConsumedError, - map_error, -) -from azure.core.pipeline import PipelineResponse -from azure.core.utils import case_insensitive_dict - __all__: list[str] = [] def patch_sdk(): - """Patch the SDK to fix async copy analyzer operations. + """No patches currently required. - This function: - 1. Uses the patched build_content_understanding_copy_analyzer_request (from sync operations) - 2. Wraps _copy_analyzer_initial method to accept both 201 and 202 status codes + Previous patches for copy_analyzer URL path and status codes have been + incorporated into the generated code. """ - from ..._operations import _operations as sync_operations - from . import _operations # pylint: disable=protected-access - - # Note: The request builder is shared between sync and async, so it's already patched - # by the sync _patch.py. We just need to patch the async _copy_analyzer_initial method. - - # SDK-FIX: Wrap _copy_analyzer_initial to accept both 201 and 202 status codes - _original_copy_initial = ( - _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial - ) # pylint: disable=protected-access - - async def _patched_copy_analyzer_initial( # pylint: disable=protected-access - self, - analyzer_id: str, - body: Union[_operations.JSON, IO[bytes]] = _operations._Unset, - *, - source_analyzer_id: str = _operations._Unset, - allow_replace: Optional[bool] = None, - source_azure_resource_id: Optional[str] = None, - source_region: Optional[str] = None, - **kwargs: Any - ) -> AsyncIterator[bytes]: - """Patched version that accepts both 201 and 202 status codes. - - :param analyzer_id: The analyzer ID for the copy operation. - :type analyzer_id: str - :param body: The request body. - :type body: Union[JSON, IO[bytes]] - :keyword source_analyzer_id: The source analyzer ID. - :paramtype source_analyzer_id: str - :keyword allow_replace: Whether to allow replacing an existing analyzer. - :paramtype allow_replace: Optional[bool] - :keyword source_azure_resource_id: The source Azure resource ID. - :paramtype source_azure_resource_id: Optional[str] - :keyword source_region: The source region. - :paramtype source_region: Optional[str] - :return: An async iterator of bytes. - :rtype: AsyncIterator[bytes] - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = kwargs.pop("params", {}) or {} - - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - cls: _operations.ClsType[AsyncIterator[bytes]] = kwargs.pop("cls", None) - - if body is _operations._Unset: - if source_analyzer_id is _operations._Unset: - raise TypeError("missing required argument: source_analyzer_id") - body = { - "sourceAnalyzerId": source_analyzer_id, - "sourceAzureResourceId": source_azure_resource_id, - "sourceRegion": source_region, - } - body = {k: v for k, v in body.items() if v is not None} - content_type = content_type or "application/json" - _content = None - if isinstance(body, (IOBase, bytes)): - _content = body - else: - from ..._utils.model_base import SdkJSONEncoder - - _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore - - _request = sync_operations.build_content_understanding_copy_analyzer_request( - analyzer_id=analyzer_id, - allow_replace=allow_replace, - content_type=content_type, - api_version=self._config.api_version, - content=_content, - headers=_headers, - params=_params, - ) - path_format_arguments = { - "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True), - } - _request.url = self._client.format_url(_request.url, **path_format_arguments) - - _stream = True - pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - # SDK-FIX: Accept both 201 and 202 (service inconsistently returns both status codes) - if response.status_code not in [201, 202]: - try: - await response.read() # Load the body in memory and close the socket - except (StreamConsumedError, StreamClosedError): - pass - map_error(status_code=response.status_code, response=response, error_map=error_map) - raise HttpResponseError(response=response) - - response_headers = {} - response_headers["Operation-Location"] = self._deserialize("str", response.headers.get("Operation-Location")) - response_headers["x-ms-client-request-id"] = self._deserialize( - "str", response.headers.get("x-ms-client-request-id") - ) - - deserialized = response.iter_bytes() - - if cls: - return cls(pipeline_response, deserialized, response_headers) # type: ignore - - return deserialized # type: ignore - - _operations._ContentUnderstandingClientOperationsMixin._copy_analyzer_initial = ( - _patched_copy_analyzer_initial # pylint: disable=protected-access - ) + pass From dfa17f8b9fd2b3cb1493d5fa728c81bc67ffbf96 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Wed, 17 Dec 2025 14:44:18 -0800 Subject: [PATCH 079/105] [SAMPLE-UPDATE] update samples accroding to .NET samples --- .../sample_analyze_binary_async.py | 67 +++--- .../sample_analyze_configs_async.py | 149 +++++-------- .../sample_analyze_invoice_async.py | 195 +++++++++--------- .../sample_analyze_return_raw_json_async.py | 126 ++--------- .../async_samples/sample_analyze_url_async.py | 61 +++--- .../sample_configure_defaults_async.py | 6 +- .../sample_create_classifier_async.py | 29 ++- .../sample_delete_analyzer_async.py | 2 - .../sample_delete_result_async.py | 18 +- .../sample_get_analyzer_async.py | 13 +- .../sample_get_result_file_async.py | 87 ++++---- .../sample_update_analyzer_async.py | 7 +- .../samples/sample_analyze_binary.py | 67 +++--- .../samples/sample_analyze_configs.py | 148 +++++-------- .../samples/sample_analyze_invoice.py | 195 +++++++++--------- .../samples/sample_analyze_return_raw_json.py | 126 ++--------- .../samples/sample_analyze_url.py | 63 +++--- .../samples/sample_configure_defaults.py | 6 +- .../samples/sample_create_classifier.py | 29 ++- .../samples/sample_delete_analyzer.py | 2 - .../samples/sample_delete_result.py | 18 +- .../samples/sample_get_analyzer.py | 13 +- .../samples/sample_get_result_file.py | 87 ++++---- .../samples/sample_update_analyzer.py | 7 +- .../samples/test_sample_analyze_binary.py | 6 +- .../test_sample_analyze_binary_async.py | 6 +- .../samples/test_sample_analyze_configs.py | 14 +- .../test_sample_analyze_configs_async.py | 14 +- .../samples/test_sample_analyze_invoice.py | 2 + .../test_sample_analyze_invoice_async.py | 2 + .../test_sample_analyze_return_raw_json.py | 12 +- ...st_sample_analyze_return_raw_json_async.py | 12 +- .../tests/samples/test_sample_analyze_url.py | 3 + .../samples/test_sample_analyze_url_async.py | 3 + .../samples/test_sample_configure_defaults.py | 3 +- .../test_sample_configure_defaults_async.py | 3 +- .../samples/test_sample_copy_analyzer.py | 1 + .../test_sample_copy_analyzer_async.py | 1 + .../samples/test_sample_create_analyzer.py | 2 + .../test_sample_create_analyzer_async.py | 2 + .../samples/test_sample_create_classifier.py | 2 + .../test_sample_create_classifier_async.py | 2 + .../samples/test_sample_delete_analyzer.py | 1 + .../test_sample_delete_analyzer_async.py | 1 + .../samples/test_sample_delete_result.py | 1 + .../test_sample_delete_result_async.py | 1 + .../tests/samples/test_sample_get_analyzer.py | 1 + .../samples/test_sample_get_analyzer_async.py | 1 + .../samples/test_sample_get_result_file.py | 1 + .../test_sample_get_result_file_async.py | 1 + .../samples/test_sample_grant_copy_auth.py | 1 + .../test_sample_grant_copy_auth_async.py | 1 + .../samples/test_sample_list_analyzers.py | 1 + .../test_sample_list_analyzers_async.py | 1 + .../samples/test_sample_update_analyzer.py | 17 +- .../test_sample_update_analyzer_async.py | 17 +- 56 files changed, 702 insertions(+), 955 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py index 8f1c35c05848..a5c6333e391a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py @@ -9,14 +9,16 @@ DESCRIPTION: This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch - analyzer. The prebuilt-documentSearch analyzer transforms unstructured documents into structured, - machine-readable data optimized for RAG scenarios. + analyzer. - Content Understanding supports multiple content types: - - Documents: Extract text, tables, figures, layout information, and structured markdown - - Images: Analyze standalone images to generate descriptions and extract visual features - - Audio: Transcribe audio content with speaker diarization and timing information - - Video: Analyze video content with visual frame extraction and audio transcription + One of the key values of Content Understanding is taking a content file and extracting the content + for you in one call. The service returns an AnalyzeResult that contains an array of MediaContent + items in AnalyzeResult.contents. This sample starts with a document file, so each item is a + DocumentContent (a subtype of MediaContent) that exposes markdown plus detailed structure such + as pages, tables, figures, and paragraphs. + + This sample focuses on document analysis. For prebuilt RAG analyzers covering images, audio, and + video, see sample_analyze_url_async.py. USAGE: python sample_analyze_binary_async.py @@ -25,8 +27,7 @@ 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + See sample_configure_defaults_async.py for model deployment setup guidance. """ import asyncio @@ -37,7 +38,6 @@ from azure.ai.contentunderstanding.models import ( AnalyzeResult, DocumentContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential @@ -70,40 +70,27 @@ async def main() -> None: print("=" * 50) # A PDF file has only one content element even if it contains multiple pages - if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.markdown: - print(content.markdown) - else: - print("No markdown content available.") - else: - print("No content found in the analysis result.") + content = result.contents[0] + print(content.markdown) print("=" * 50) # [END extract_markdown] - # Extract document properties - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - # Check if this is document content to access document-specific properties - if content.kind == MediaContentKind.DOCUMENT: - # Type assertion: we know this is DocumentContent for PDF files - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f" Start page: {document_content.start_page_number}") - print(f" End page: {document_content.end_page_number}") - - if document_content.start_page_number and document_content.end_page_number: - total_pages = document_content.end_page_number - document_content.start_page_number + 1 - print(f" Total pages: {total_pages}") - - # Check for pages - if document_content.pages: - print(f"\nPages ({len(document_content.pages)}):") - for page in document_content.pages: - unit = document_content.unit or "units" - print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + # Access document properties + # Cast MediaContent to DocumentContent to access document-specific properties + # DocumentContent derives from MediaContent and provides additional properties + # to access full information about document, including pages, tables and many others + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f" Start page: {document_content.start_page_number}") + print(f" End page: {document_content.end_page_number}") + + # Check for pages + if document_content.pages and len(document_content.pages) > 0: + print(f"\nNumber of pages: {len(document_content.pages)}") + for page in document_content.pages: + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") if not isinstance(credential, AzureKeyCredential): await credential.close() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index 72717104ff22..dcc691e7ebf8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -12,15 +12,24 @@ hyperlinks, formulas, and annotations using the prebuilt-documentSearch analyzer. The prebuilt-documentSearch analyzer has the following configurations enabled by default: - - EnableFormula: Extracts mathematical formulas from documents - - EnableLayout: Extracts layout information (tables, figures, etc.) - - EnableOcr: Performs OCR on documents - - These configs enable extraction of: - - Charts: Chart figures with Chart.js configuration - - Hyperlinks: URLs and links found in the document - - Formulas: Mathematical formulas in LaTeX format - - Annotations: PDF annotations, comments, and markup + - ReturnDetails: true - Returns detailed information about document elements + - EnableOcr: true - Performs OCR on documents + - EnableLayout: true - Extracts layout information (tables, figures, hyperlinks, annotations) + - EnableFormula: true - Extracts mathematical formulas from documents + - EnableFigureDescription: true - Generates descriptions for figures + - EnableFigureAnalysis: true - Analyzes figures including charts + - ChartFormat: "chartjs" - Chart figures are returned in Chart.js format + - TableFormat: "html" - Tables are returned in HTML format + - AnnotationFormat: "markdown" - Annotations are returned in markdown format + + The following code snippets demonstrate extraction of features enabled by these configs: + - Charts: Enabled by EnableFigureAnalysis - Chart figures with Chart.js configuration + - Hyperlinks: Enabled by EnableLayout - URLs and links found in the document + - Formulas: Enabled by EnableFormula - Mathematical formulas in LaTeX format + - Annotations: Enabled by EnableLayout - PDF annotations, comments, and markup + + For custom analyzers, you can configure these options in ContentAnalyzerConfig when creating + the analyzer. USAGE: python sample_analyze_configs_async.py @@ -41,9 +50,7 @@ from azure.ai.contentunderstanding.models import ( AnalyzeResult, DocumentContent, - MediaContentKind, DocumentChartFigure, - DocumentFigureKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential @@ -75,97 +82,51 @@ async def main() -> None: # [END analyze_with_configs] # [START extract_charts] - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - if document_content.figures and len(document_content.figures) > 0: - # Filter for chart figures - chart_figures = [ - f - for f in document_content.figures - if isinstance(f, DocumentChartFigure) - or (hasattr(f, "kind") and f.kind == DocumentFigureKind.CHART) - ] - - print(f"\nFound {len(chart_figures)} chart(s)") - for chart in chart_figures: - print(f" Chart ID: {chart.id}") - if hasattr(chart, "description") and chart.description: - print(f" Description: {chart.description}") - if hasattr(chart, "caption") and chart.caption and chart.caption.content: - print(f" Caption: {chart.caption.content}") - else: - print("\nNo figures found in the document.") - else: - print("\nNo content found in the analysis result.") + # Extract charts from document content (enabled by EnableFigureAnalysis config) + document_content: DocumentContent = result.contents[0] # type: ignore + if document_content.figures: + for figure in document_content.figures: + if isinstance(figure, DocumentChartFigure): + print(f" Chart ID: {figure.id}") + print(f" Description: {figure.description or '(not available)'}") + print(f" Caption: {figure.caption.content if figure.caption else '(not available)'}") # [END extract_charts] # [START extract_hyperlinks] - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - if document_content.hyperlinks and len(document_content.hyperlinks) > 0: - print(f"\nFound {len(document_content.hyperlinks)} hyperlink(s)") - for hyperlink in document_content.hyperlinks: - print(f" URL: {hyperlink.url or '(not available)'}") - print(f" Content: {hyperlink.content or '(not available)'}") - else: - print("\nNo hyperlinks found in the document.") + # Extract hyperlinks from document content (enabled by EnableLayout config) + doc_content: DocumentContent = result.contents[0] # type: ignore + print(f"Found {len(doc_content.hyperlinks) if doc_content.hyperlinks else 0} hyperlink(s)") + for hyperlink in doc_content.hyperlinks or []: + print(f" URL: {hyperlink.url or '(not available)'}") + print(f" Content: {hyperlink.content or '(not available)'}") # [END extract_hyperlinks] # [START extract_formulas] - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - all_formulas = [] - if document_content.pages: - for page in document_content.pages: - if hasattr(page, "formulas") and page.formulas: - all_formulas.extend(page.formulas) - - if len(all_formulas) > 0: - print(f"\nFound {len(all_formulas)} formula(s)") - for formula in all_formulas: - print(f" Formula: {formula.value or '(no value)'}") - if hasattr(formula, "kind") and formula.kind: - print(f" Kind: {formula.kind}") - else: - print("\nNo formulas found in the document.") + # Extract formulas from document pages (enabled by EnableFormula config) + content: DocumentContent = result.contents[0] # type: ignore + all_formulas = [] + for page in content.pages or []: + all_formulas.extend(page.formulas or []) + + print(f"Found {len(all_formulas)} formula(s)") + for formula in all_formulas: + print(f" Formula Kind: {formula.kind}") + print(f" LaTeX: {formula.value or '(not available)'}") + print(f" Confidence: {f'{formula.confidence:.2f}' if formula.confidence else 'N/A'}") # [END extract_formulas] - # Extract annotations - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - if ( - hasattr(document_content, "annotations") - and document_content.annotations - and len(document_content.annotations) > 0 - ): - print(f"\nFound {len(document_content.annotations)} annotation(s)") - for annotation in document_content.annotations: - print(f" Annotation ID: {annotation.id}") - print(f" Kind: {annotation.kind}") - if hasattr(annotation, "author") and annotation.author: - print(f" Author: {annotation.author}") - if hasattr(annotation, "comments") and annotation.comments and len(annotation.comments) > 0: - print(f" Comments: {len(annotation.comments)}") - for comment in annotation.comments: - print(f" - {comment.message}") - else: - print("\nNo annotations found in the document.") + # [START extract_annotations] + # Extract annotations from document content (enabled by EnableLayout config) + document: DocumentContent = result.contents[0] # type: ignore + print(f"Found {len(document.annotations) if document.annotations else 0} annotation(s)") + for annotation in document.annotations or []: + print(f" Annotation ID: {annotation.id}") + print(f" Kind: {annotation.kind}") + print(f" Author: {annotation.author or '(not available)'}") + print(f" Comments: {len(annotation.comments) if annotation.comments else 0}") + for comment in annotation.comments or []: + print(f" - {comment.message}") + # [END extract_annotations] if not isinstance(credential, AzureKeyCredential): await credential.close() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index 40a3556abaaa..eed81efc4814 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -8,16 +8,9 @@ FILE: sample_analyze_invoice_async.py DESCRIPTION: + About extracting structured invoice fields: This sample demonstrates how to analyze an invoice from a URL using the prebuilt-invoice - analyzer and extract structured fields from the result. - - Content Understanding provides 70+ production-ready prebuilt analyzers that are ready to use - without any training or configuration. The prebuilt-invoice analyzer automatically extracts: - - Customer/Vendor information: Name, address, contact details - - Invoice metadata: Invoice number, date, due date, purchase order number - - Line items: Description, quantity, unit price, total for each item - - Financial totals: Subtotal, tax amount, shipping charges, total amount - - Payment information: Payment terms, payment method, remittance address + analyzer and extract structured fields (customer name, line items, totals, etc.) from the result. USAGE: python sample_analyze_invoice_async.py @@ -40,7 +33,6 @@ AnalyzeResult, DocumentContent, ContentField, - MediaContentKind, ArrayField, ObjectField, ) @@ -57,7 +49,7 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_invoice] - invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/docs/invoice.pdf" print(f"Analyzing invoice with prebuilt-invoice analyzer...") print(f" URL: {invoice_url}") @@ -74,99 +66,96 @@ async def main() -> None: print("No content found in the analysis result.") return - content = result.contents[0] - # Get the document content (invoices are documents) - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - # Print document unit information - # The unit indicates the measurement system used for coordinates in the source field - print(f"\nDocument unit: {document_content.unit or 'unknown'}") - print(f"Pages: {document_content.start_page_number} to {document_content.end_page_number}") - print() - - if not document_content.fields: - print("No fields found in the analysis result.") - return - - # Extract simple string fields - customer_name_field = document_content.fields.get("CustomerName") - invoice_date_field = document_content.fields.get("InvoiceDate") - - customer_name = customer_name_field.value if customer_name_field else None - invoice_date = invoice_date_field.value if invoice_date_field else None - - print(f"Customer Name: {customer_name or '(None)'}") - if customer_name_field: - print( - f" Confidence: {customer_name_field.confidence:.2f}" - if customer_name_field.confidence - else " Confidence: N/A" - ) - # Source is an encoded identifier containing bounding box coordinates - # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) - print(f" Source: {customer_name_field.source or 'N/A'}") - if customer_name_field.spans and len(customer_name_field.spans) > 0: - span = customer_name_field.spans[0] - print(f" Position in markdown: offset={span.offset}, length={span.length}") - - print(f"Invoice Date: {invoice_date or '(None)'}") - if invoice_date_field: - print( - f" Confidence: {invoice_date_field.confidence:.2f}" - if invoice_date_field.confidence - else " Confidence: N/A" - ) - - # Extract object field (TotalAmount contains Amount and CurrencyCode) - total_amount_field = document_content.fields.get("TotalAmount") - if total_amount_field and total_amount_field.value: - total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore - amount_field = total_amount_obj.get("Amount") - currency_field = total_amount_obj.get("CurrencyCode") - - amount = amount_field.value if amount_field else None - currency = currency_field.value if currency_field else None - - print(f"\nTotal Amount: {amount} {currency}") - if total_amount_field.confidence: - print(f" Confidence: {total_amount_field.confidence:.2f}") - - # Extract array field (LineItems - line items) - # Note: The field name is "LineItems" (not "Items") to match the service response - line_items_field = document_content.fields.get("LineItems") - if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: - items_array: list = line_items_field.value # type: ignore - print(f"\nLine Items ({len(items_array)}):") - for i, item in enumerate(items_array, 1): - # Each item in the array is a ContentField (ObjectField for line items) - if isinstance(item, ObjectField) and item.value: - item_dict: dict[str, ContentField] = item.value # type: ignore - description_field = item_dict.get("Description") - quantity_field = item_dict.get("Quantity") - # Try UnitPrice first, then Amount (matching .NET sample pattern) - unit_price_field = item_dict.get("UnitPrice") - amount_field = item_dict.get("Amount") - - description = description_field.value if description_field else "(no description)" - quantity = quantity_field.value if quantity_field else "N/A" - - # Display price information - prefer UnitPrice if available, otherwise Amount - # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) - price_info = "" - if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: - unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore - unit_price_amount_field = unit_price_obj.get("Amount") - unit_price_currency_field = unit_price_obj.get("CurrencyCode") - if unit_price_amount_field and unit_price_amount_field.value is not None: - currency = unit_price_currency_field.value if unit_price_currency_field else "" - price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() - elif amount_field and amount_field.value is not None: - price_info = f"Amount: {amount_field.value}" - - print(f" {i}. {description}") - print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) + document_content: DocumentContent = result.contents[0] # type: ignore + + # Print document unit information + # The unit indicates the measurement system used for coordinates in the source field + print(f"\nDocument unit: {document_content.unit or 'unknown'}") + print(f"Pages: {document_content.start_page_number} to {document_content.end_page_number}") + print() + + if not document_content.fields: + print("No fields found in the analysis result.") + return + + # Extract simple string fields + customer_name_field = document_content.fields.get("CustomerName") + invoice_date_field = document_content.fields.get("InvoiceDate") + + customer_name = customer_name_field.value if customer_name_field else None + invoice_date = invoice_date_field.value if invoice_date_field else None + + print(f"Customer Name: {customer_name or '(None)'}") + if customer_name_field: + print( + f" Confidence: {customer_name_field.confidence:.2f}" + if customer_name_field.confidence + else " Confidence: N/A" + ) + # Source is an encoded identifier containing bounding box coordinates + # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) + print(f" Source: {customer_name_field.source or 'N/A'}") + if customer_name_field.spans and len(customer_name_field.spans) > 0: + span = customer_name_field.spans[0] + print(f" Position in markdown: offset={span.offset}, length={span.length}") + + print(f"Invoice Date: {invoice_date or '(None)'}") + if invoice_date_field: + print( + f" Confidence: {invoice_date_field.confidence:.2f}" + if invoice_date_field.confidence + else " Confidence: N/A" + ) + + # Extract object field (TotalAmount contains Amount and CurrencyCode) + total_amount_field = document_content.fields.get("TotalAmount") + if total_amount_field and total_amount_field.value: + total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore + amount_field = total_amount_obj.get("Amount") + currency_field = total_amount_obj.get("CurrencyCode") + + amount = amount_field.value if amount_field else None + currency = currency_field.value if currency_field else None + + print(f"\nTotal Amount: {amount} {currency}") + if total_amount_field.confidence: + print(f" Confidence: {total_amount_field.confidence:.2f}") + + # Extract array field (LineItems - line items) + # Note: The field name is "LineItems" (not "Items") to match the service response + line_items_field = document_content.fields.get("LineItems") + if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: + items_array: list = line_items_field.value # type: ignore + print(f"\nLine Items ({len(items_array)}):") + for i, item in enumerate(items_array, 1): + # Each item in the array is a ContentField (ObjectField for line items) + if isinstance(item, ObjectField) and item.value: + item_dict: dict[str, ContentField] = item.value # type: ignore + description_field = item_dict.get("Description") + quantity_field = item_dict.get("Quantity") + # Try UnitPrice first, then Amount (matching .NET sample pattern) + unit_price_field = item_dict.get("UnitPrice") + amount_field = item_dict.get("Amount") + + description = description_field.value if description_field else "(no description)" + quantity = quantity_field.value if quantity_field else "N/A" + + # Display price information - prefer UnitPrice if available, otherwise Amount + # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) + price_info = "" + if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: + unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore + unit_price_amount_field = unit_price_obj.get("Amount") + unit_price_currency_field = unit_price_obj.get("CurrencyCode") + if unit_price_amount_field and unit_price_amount_field.value is not None: + currency = unit_price_currency_field.value if unit_price_currency_field else "" + price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() + elif amount_field and amount_field.value is not None: + price_info = f"Amount: {amount_field.value}" + + print(f" {i}. {description}") + print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) # [END extract_invoice_fields] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py index d190635c212c..88157cb32061 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py @@ -9,27 +9,25 @@ DESCRIPTION: This sample demonstrates how to access the raw JSON response from analysis operations - using the 'cls' callback parameter (async version). This is useful for advanced scenarios - where you need direct access to the JSON structure. - - The Content Understanding SDK provides two approaches for accessing analysis results: - - 1. Object model approach (recommended): Returns strongly-typed AnalyzeResult objects - that are easier to navigate and use. This is shown in sample_analyze_binary_async.py. - - 2. Protocol method approach: Returns raw HTTP response containing the JSON. This sample - demonstrates this approach for advanced scenarios. - - IMPORTANT: For production use, prefer the object model approach as it provides: - - Type safety - - IntelliSense support - - Easier navigation of results - - Better error handling - - Use raw JSON only when you need: - - Custom JSON processing - - Direct access to the raw response structure - - Integration with custom JSON parsers + using the 'cls' callback parameter (async version). This is useful for scenarios where + you need to inspect the full response structure exactly as returned by the service. + + The Content Understanding SDK provides a convenient object model approach (shown in + sample_analyze_binary_async.py) that returns AnalyzeResult objects with deeper navigation + through the object model. However, sometimes you may need access to the raw JSON + response for: + + - Easy inspection: View the complete response structure in the exact format returned + by the service, making it easier to understand the full data model and discover + available fields + - Debugging: Inspect the raw response to troubleshoot issues, verify service behavior, + or understand unexpected results + - Advanced scenarios: Work with response structures that may change or include + additional metadata not captured in the typed model + + NOTE: For most production scenarios, the object model approach is recommended as it + provides type safety, IntelliSense support, and easier navigation. Use raw JSON access + when you specifically need the benefits listed above. USAGE: python sample_analyze_return_raw_json_async.py @@ -45,8 +43,6 @@ import asyncio import json import os -from datetime import datetime -from pathlib import Path from dotenv import load_dotenv from azure.ai.contentunderstanding.aio import ContentUnderstandingClient @@ -71,14 +67,10 @@ async def main() -> None: print(f"Analyzing {file_path} with prebuilt-documentSearch...") # Use the 'cls' callback parameter to get the raw HTTP response - # The 'cls' parameter allows us to intercept the response and return custom data - # We return a tuple: (deserialized_object, raw_http_response) - # Note: For production use, prefer the object model approach (without cls parameter) - # which returns AnalyzeResult objects that are easier to work with + # This allows access to the complete response structure for easy inspection and debugging poller = await client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, - content_type="application/pdf", cls=lambda pipeline_response, deserialized_obj, response_headers: ( deserialized_obj, pipeline_response.http_response, @@ -90,86 +82,12 @@ async def main() -> None: # [END analyze_return_raw_json] # [START parse_raw_json] - # Parse the raw JSON response + # Pretty-print the raw JSON response response_json = raw_http_response.json() - - # Pretty-print the JSON pretty_json = json.dumps(response_json, indent=2, ensure_ascii=False) - - # Create output directory if it doesn't exist - output_dir = Path(__file__).parent.parent / "sample_output" - output_dir.mkdir(exist_ok=True) - - # Save to file - timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") - output_filename = f"analyze_result_{timestamp}.json" - output_path = output_dir / output_filename - - with open(output_path, "w", encoding="utf-8") as f: - f.write(pretty_json) - - print(f"Raw JSON response saved to: {output_path}") - print(f"File size: {len(pretty_json):,} characters") + print(pretty_json) # [END parse_raw_json] - # [START extract_from_raw_json] - # Extract key information from raw JSON - # This demonstrates accessing the same data that would be available via the object model - if "result" in response_json: - result_data = response_json["result"] - - if "analyzerId" in result_data: - print(f"\nAnalyzer ID: {result_data['analyzerId']}") - - if "contents" in result_data and isinstance(result_data["contents"], list): - print(f"Contents count: {len(result_data['contents'])}") - - if len(result_data["contents"]) > 0: - first_content = result_data["contents"][0] - - if "kind" in first_content: - print(f"Content kind: {first_content['kind']}") - if "mimeType" in first_content: - print(f"MIME type: {first_content['mimeType']}") - - # Extract markdown content from raw JSON - # Object model equivalent: content.markdown - print("\nMarkdown Content (from raw JSON):") - print("=" * 50) - if "markdown" in first_content and first_content["markdown"]: - print(first_content["markdown"]) - else: - print("No markdown content available.") - print("=" * 50) - - # Extract document properties from raw JSON - # Object model equivalent: document_content.start_page_number, etc. - if first_content.get("kind") == "document": - print("\nDocument Information (from raw JSON):") - if "startPageNumber" in first_content: - print(f" Start page: {first_content['startPageNumber']}") - if "endPageNumber" in first_content: - print(f" End page: {first_content['endPageNumber']}") - - start_page = first_content.get("startPageNumber") - end_page = first_content.get("endPageNumber") - if start_page and end_page: - total_pages = end_page - start_page + 1 - print(f" Total pages: {total_pages}") - - # Extract pages information - # Object model equivalent: document_content.pages - if "pages" in first_content and first_content["pages"]: - pages = first_content["pages"] - unit = first_content.get("unit", "units") - print(f"\nPages ({len(pages)}):") - for page in pages: - page_num = page.get("pageNumber") - width = page.get("width") - height = page.get("height") - print(f" Page {page_num}: {width} x {height} {unit}") - # [END extract_from_raw_json] - if not isinstance(credential, AzureKeyCredential): await credential.close() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py index 97b375c04231..652722c70a3f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py @@ -8,11 +8,19 @@ FILE: sample_analyze_url_async.py DESCRIPTION: - This sample demonstrates how to analyze a document from a URL using the prebuilt-documentSearch - analyzer. This shows how to analyze a document from a publicly accessible URL instead of a local file. + Another great value of Content Understanding is its rich set of prebuilt analyzers. Great examples + of these are the RAG analyzers that work for all modalities (prebuilt-documentSearch, prebuilt-imageSearch, + prebuilt-audioSearch, and prebuilt-videoSearch). - For understanding basic analysis concepts, authentication, and result processing, - see sample_analyze_binary_async.py first. + This sample demonstrates these RAG analyzers with URL inputs. Content Understanding supports both + local binary inputs (see sample_analyze_binary_async.py) and URL inputs across all modalities. + + Important: For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. + For binary data (local files), use begin_analyze_binary() instead. + + Documents, HTML, and images with text are returned as DocumentContent (derived from MediaContent), + while audio and video are returned as AudioVisualContent (also derived from MediaContent). These + prebuilt RAG analyzers return markdown and a one-paragraph Summary for each content item. USAGE: python sample_analyze_url_async.py @@ -21,8 +29,7 @@ 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + See sample_configure_defaults_async.py for model deployment setup guidance. """ import asyncio @@ -34,7 +41,6 @@ AnalyzeInput, AnalyzeResult, DocumentContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential @@ -49,7 +55,8 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_document_from_url] - document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + # You can replace this URL with your own publicly accessible document URL. + document_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" print(f"Analyzing document from URL with prebuilt-documentSearch...") print(f" URL: {document_url}") @@ -61,28 +68,22 @@ async def main() -> None: result: AnalyzeResult = await poller.result() # Extract markdown content - print("\nMarkdown Content:") - print("=" * 50) - - if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.markdown: - print(content.markdown) - else: - print("No markdown content available.") - else: - print("No content found in the analysis result.") - - print("=" * 50) - - # Display document properties - if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f" Start page: {document_content.start_page_number}") - print(f" End page: {document_content.end_page_number}") + print("\nMarkdown:") + content = result.contents[0] + print(content.markdown) + + # Cast MediaContent to DocumentContent to access document-specific properties + # DocumentContent derives from MediaContent and provides additional properties + # to access full information about document, including Pages, Tables and many others + document_content: DocumentContent = content # type: ignore + print(f"\nPages: {document_content.start_page_number} - {document_content.end_page_number}") + + # Check for pages + if document_content.pages and len(document_content.pages) > 0: + print(f"Number of pages: {len(document_content.pages)}") + for page in document_content.pages: + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") # [END analyze_document_from_url] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py index b770a70b7b35..0e4d22e8c836 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py @@ -14,7 +14,7 @@ Content Understanding prebuilt analyzers require specific GPT model deployments to function: - GPT-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt) - - GPT-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-audioSearch) + - GPT-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch) - text-embedding-3-large: Used for semantic search and embeddings USAGE: @@ -84,7 +84,7 @@ async def main() -> None: print("Model deployments configured successfully!") if updated_defaults.model_deployments: for model_name, deployment_name in updated_defaults.model_deployments.items(): - print(f" {model_name} -> {deployment_name}") + print(f" {model_name}: {deployment_name}") # [END update_defaults] # [START get_defaults] @@ -94,7 +94,7 @@ async def main() -> None: print("\nCurrent model deployment mappings:") if defaults.model_deployments and len(defaults.model_deployments) > 0: for model_name, deployment_name in defaults.model_deployments.items(): - print(f" {model_name} -> {deployment_name}") + print(f" {model_name}: {deployment_name}") else: print(" No model deployments configured yet.") # [END get_defaults] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index 9d32460866af..c09ba229c4b8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -40,7 +40,6 @@ ContentCategoryDefinition, AnalyzeResult, DocumentContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential @@ -118,28 +117,24 @@ async def main() -> None: analyze_poller = await client.begin_analyze_binary( analyzer_id=analyzer_id, - content_type="application/pdf", binary_input=file_bytes, ) analyze_result: AnalyzeResult = await analyze_poller.result() # Display classification results if analyze_result.contents and len(analyze_result.contents) > 0: - content = analyze_result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - print(f"Pages: {document_content.start_page_number}-{document_content.end_page_number}") - - # Display segments (classification results) - if document_content.segments and len(document_content.segments) > 0: - print(f"\nFound {len(document_content.segments)} segment(s):") - for segment in document_content.segments: - print(f" Category: {segment.category or '(unknown)'}") - print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") - print() - else: - print("No segments found (document classified as a single unit).") + document_content: DocumentContent = analyze_result.contents[0] # type: ignore + print(f"Pages: {document_content.start_page_number}-{document_content.end_page_number}") + + # Display segments (classification results) + if document_content.segments and len(document_content.segments) > 0: + print(f"\nFound {len(document_content.segments)} segment(s):") + for segment in document_content.segments: + print(f" Category: {segment.category or '(unknown)'}") + print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + print() + else: + print("No segments found (document classified as a single unit).") else: print("No content found in the analysis result.") # [END analyze_with_classifier] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_analyzer_async.py index a5c4b0edd864..fbb932c7cbff 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_analyzer_async.py @@ -15,8 +15,6 @@ Important notes: - Only custom analyzers can be deleted. Prebuilt analyzers cannot be deleted. - - Deleting an analyzer does not delete analysis results that were created using that analyzer. - - Once deleted, the analyzer ID cannot be reused immediately. USAGE: python sample_delete_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py index 1083fdc0a58e..c24dc4355ffe 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py @@ -40,7 +40,6 @@ AnalyzeInput, AnalyzeResult, DocumentContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.core.exceptions import ResourceNotFoundError @@ -56,7 +55,7 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_and_delete_result] - document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/docs/invoice.pdf" print("Document Analysis Workflow") print("=" * 60) @@ -87,15 +86,12 @@ async def main() -> None: # Display some sample results if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.kind == MediaContentKind.DOCUMENT: - doc_content: DocumentContent = content # type: ignore - if doc_content.fields: - print(f" Total fields extracted: {len(doc_content.fields)}") - customer_name_field = doc_content.fields.get("CustomerName") - if customer_name_field: - print(f" Customer Name: {customer_name_field.value or '(not found)'}") - + doc_content: DocumentContent = result.contents[0] # type: ignore + if doc_content.fields: + print(f" Total fields extracted: {len(doc_content.fields)}") + customer_name_field = doc_content.fields.get("CustomerName") + if customer_name_field: + print(f" Customer Name: {customer_name_field.value or '(not found)'}") # Step 2: Delete the analysis result print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") await client.delete_result(operation_id=operation_id) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py index a5e9c763b645..bd716baec568 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py @@ -59,9 +59,20 @@ async def main() -> None: print("Retrieving prebuilt-documentSearch analyzer...") analyzer = await client.get_analyzer(analyzer_id="prebuilt-documentSearch") + # Print a few properties from the analyzer + print(f"Analyzer ID: {analyzer.analyzer_id}") + print(f"Base Analyzer ID: {analyzer.base_analyzer_id}") + print(f"Description: {analyzer.description}") + if analyzer.config: + print(f"Enable OCR: {analyzer.config.enable_ocr}") + print(f"Enable Layout: {analyzer.config.enable_layout}") + if analyzer.models: + models_str = ", ".join(f"{k}={v}" for k, v in analyzer.models.items()) + print(f"Models: {models_str}") + # Display full analyzer JSON print("\n" + "=" * 80) - print("Prebuilt-documentSearch Analyzer:") + print("Prebuilt-documentSearch Analyzer (Raw JSON):") print("=" * 80) analyzer_json = json.dumps(analyzer.as_dict(), indent=2, default=str) print(analyzer_json) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py index bcb4310d4570..b2ab4407dd96 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py @@ -40,7 +40,6 @@ AnalyzeInput, AnalyzeResult, AudioVisualContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential @@ -84,52 +83,48 @@ async def main() -> None: content = result.contents[0] # For video analysis, keyframes would be found in AudioVisualContent.KeyFrameTimesMs - if content.kind == MediaContentKind.AUDIO_VISUAL: - video_content: AudioVisualContent = content # type: ignore - - if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: - total_keyframes = len(video_content.key_frame_times_ms) - first_frame_time_ms = video_content.key_frame_times_ms[0] - - print(f"\nTotal keyframes: {total_keyframes}") - print(f"First keyframe time: {first_frame_time_ms} ms") - - # Get the first keyframe as an example - frame_path = f"keyframes/{first_frame_time_ms}" - - print(f"Getting result file: {frame_path}") - - # Get the result file (keyframe image) - file_response = await client.get_result_file( - operation_id=operation_id, - path=frame_path, - ) - - image_bytes = b"".join([chunk async for chunk in file_response]) - print(f"Retrieved keyframe image ({len(image_bytes):,} bytes)") - - # Save the keyframe image to sample_output directory - output_dir = Path(__file__).parent.parent / "sample_output" - output_dir.mkdir(exist_ok=True) - output_filename = f"keyframe_{first_frame_time_ms}.jpg" - output_path = output_dir / output_filename - - with open(output_path, "wb") as f: - f.write(image_bytes) - - print(f"Keyframe image saved to: {output_path}") - else: - print("\nNote: This sample demonstrates GetResultFile API usage.") - print(" For video analysis with keyframes, use prebuilt-videoSearch analyzer.") - print(" Keyframes are available in AudioVisualContent.key_frame_times_ms.") - print() - print(f"Example usage with operation ID '{operation_id}':") - print(" file_response = await client.get_result_file(") - print(" operation_id=operation_id,") - print(' path="keyframes/1000")') + video_content: AudioVisualContent = result.contents[0] # type: ignore + + if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: + total_keyframes = len(video_content.key_frame_times_ms) + first_frame_time_ms = video_content.key_frame_times_ms[0] + + print(f"\nTotal keyframes: {total_keyframes}") + print(f"First keyframe time: {first_frame_time_ms} ms") + + # Get the first keyframe as an example + frame_path = f"keyframes/{first_frame_time_ms}" + + print(f"Getting result file: {frame_path}") + + # Get the result file (keyframe image) + file_response = await client.get_result_file( + operation_id=operation_id, + path=frame_path, + ) + + image_bytes = b"".join([chunk async for chunk in file_response]) + print(f"Retrieved keyframe image ({len(image_bytes):,} bytes)") + + # Save the keyframe image to sample_output directory + output_dir = Path(__file__).parent.parent / "sample_output" + output_dir.mkdir(exist_ok=True) + output_filename = f"keyframe_{first_frame_time_ms}.jpg" + output_path = output_dir / output_filename + + with open(output_path, "wb") as f: + f.write(image_bytes) + + print(f"Keyframe image saved to: {output_path}") else: - print("\nNote: This sample is designed for video analysis.") - print(" The analyzed content is not a video.") + print("\nNote: This sample demonstrates GetResultFile API usage.") + print(" For video analysis with keyframes, use prebuilt-videoSearch analyzer.") + print(" Keyframes are available in AudioVisualContent.key_frame_times_ms.") + print() + print(f"Example usage with operation ID '{operation_id}':") + print(" file_response = await client.get_result_file(") + print(" operation_id=operation_id,") + print(' path="keyframes/1000")') # [END get_result_file] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py index 20b2c4d0bac6..c081a9f64c1d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py @@ -13,11 +13,7 @@ The update_analyzer method allows you to modify certain properties of an existing analyzer: - Description: Update the analyzer's description - - Tags: Add, update, or remove tags (set tag value to empty string to remove) - - Note: Not all analyzer properties can be updated. Field schemas, models, and configuration - typically cannot be changed after creation. To change these, you may need to delete and - recreate the analyzer. + - Tags: Add or update tags USAGE: python sample_update_analyzer_async.py @@ -101,7 +97,6 @@ async def main() -> None: description="Updated description", tags={ "tag1": "tag1_updated_value", # Update existing tag - "tag2": "", # Remove tag2 (empty string removes the tag) "tag3": "tag3_value", # Add new tag }, ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py index 41c5593dbc05..ee206f2f0ddf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py @@ -9,14 +9,16 @@ DESCRIPTION: This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch - analyzer. The prebuilt-documentSearch analyzer transforms unstructured documents into structured, - machine-readable data optimized for RAG scenarios. + analyzer. - Content Understanding supports multiple content types: - - Documents: Extract text, tables, figures, layout information, and structured markdown - - Images: Analyze standalone images to generate descriptions and extract visual features - - Audio: Transcribe audio content with speaker diarization and timing information - - Video: Analyze video content with visual frame extraction and audio transcription + One of the key values of Content Understanding is taking a content file and extracting the content + for you in one call. The service returns an AnalyzeResult that contains an array of MediaContent + items in AnalyzeResult.contents. This sample starts with a document file, so each item is a + DocumentContent (a subtype of MediaContent) that exposes markdown plus detailed structure such + as pages, tables, figures, and paragraphs. + + This sample focuses on document analysis. For prebuilt RAG analyzers covering images, audio, and + video, see sample_analyze_url.py. USAGE: python sample_analyze_binary.py @@ -25,8 +27,7 @@ 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + See sample_configure_defaults.py for model deployment setup guidance. """ import os @@ -36,7 +37,6 @@ from azure.ai.contentunderstanding.models import ( AnalyzeResult, DocumentContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential @@ -70,40 +70,27 @@ def main() -> None: print("=" * 50) # A PDF file has only one content element even if it contains multiple pages - if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.markdown: - print(content.markdown) - else: - print("No markdown content available.") - else: - print("No content found in the analysis result.") + content = result.contents[0] + print(content.markdown) print("=" * 50) # [END extract_markdown] - # Extract document properties - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - # Check if this is document content to access document-specific properties - if content.kind == MediaContentKind.DOCUMENT: - # Type assertion: we know this is DocumentContent for PDF files - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f" Start page: {document_content.start_page_number}") - print(f" End page: {document_content.end_page_number}") - - if document_content.start_page_number and document_content.end_page_number: - total_pages = document_content.end_page_number - document_content.start_page_number + 1 - print(f" Total pages: {total_pages}") - - # Check for pages - if document_content.pages: - print(f"\nPages ({len(document_content.pages)}):") - for page in document_content.pages: - unit = document_content.unit or "units" - print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + # Access document properties + # Cast MediaContent to DocumentContent to access document-specific properties + # DocumentContent derives from MediaContent and provides additional properties + # to access full information about document, including pages, tables and many others + document_content: DocumentContent = content # type: ignore + print(f"\nDocument Information:") + print(f" Start page: {document_content.start_page_number}") + print(f" End page: {document_content.end_page_number}") + + # Check for pages + if document_content.pages and len(document_content.pages) > 0: + print(f"\nNumber of pages: {len(document_content.pages)}") + for page in document_content.pages: + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index faf0204c8f2d..aef1be62832c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -12,15 +12,24 @@ hyperlinks, formulas, and annotations using the prebuilt-documentSearch analyzer. The prebuilt-documentSearch analyzer has the following configurations enabled by default: - - EnableFormula: Extracts mathematical formulas from documents - - EnableLayout: Extracts layout information (tables, figures, etc.) - - EnableOcr: Performs OCR on documents - - These configs enable extraction of: - - Charts: Chart figures with Chart.js configuration - - Hyperlinks: URLs and links found in the document - - Formulas: Mathematical formulas in LaTeX format - - Annotations: PDF annotations, comments, and markup + - ReturnDetails: true - Returns detailed information about document elements + - EnableOcr: true - Performs OCR on documents + - EnableLayout: true - Extracts layout information (tables, figures, hyperlinks, annotations) + - EnableFormula: true - Extracts mathematical formulas from documents + - EnableFigureDescription: true - Generates descriptions for figures + - EnableFigureAnalysis: true - Analyzes figures including charts + - ChartFormat: "chartjs" - Chart figures are returned in Chart.js format + - TableFormat: "html" - Tables are returned in HTML format + - AnnotationFormat: "markdown" - Annotations are returned in markdown format + + The following code snippets demonstrate extraction of features enabled by these configs: + - Charts: Enabled by EnableFigureAnalysis - Chart figures with Chart.js configuration + - Hyperlinks: Enabled by EnableLayout - URLs and links found in the document + - Formulas: Enabled by EnableFormula - Mathematical formulas in LaTeX format + - Annotations: Enabled by EnableLayout - PDF annotations, comments, and markup + + For custom analyzers, you can configure these options in ContentAnalyzerConfig when creating + the analyzer. USAGE: python sample_analyze_configs.py @@ -40,9 +49,7 @@ from azure.ai.contentunderstanding.models import ( AnalyzeResult, DocumentContent, - MediaContentKind, DocumentChartFigure, - DocumentFigureKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential @@ -75,96 +82,51 @@ def main() -> None: # [END analyze_with_configs] # [START extract_charts] - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - if document_content.figures and len(document_content.figures) > 0: - # Filter for chart figures - chart_figures = [ - f - for f in document_content.figures - if isinstance(f, DocumentChartFigure) or (hasattr(f, "kind") and f.kind == DocumentFigureKind.CHART) - ] - - print(f"\nFound {len(chart_figures)} chart(s)") - for chart in chart_figures: - print(f" Chart ID: {chart.id}") - if hasattr(chart, "description") and chart.description: - print(f" Description: {chart.description}") - if hasattr(chart, "caption") and chart.caption and chart.caption.content: - print(f" Caption: {chart.caption.content}") - else: - print("\nNo figures found in the document.") - else: - print("\nNo content found in the analysis result.") + # Extract charts from document content (enabled by EnableFigureAnalysis config) + document_content: DocumentContent = result.contents[0] # type: ignore + if document_content.figures: + for figure in document_content.figures: + if isinstance(figure, DocumentChartFigure): + print(f" Chart ID: {figure.id}") + print(f" Description: {figure.description or '(not available)'}") + print(f" Caption: {figure.caption.content if figure.caption else '(not available)'}") # [END extract_charts] # [START extract_hyperlinks] - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - if document_content.hyperlinks and len(document_content.hyperlinks) > 0: - print(f"\nFound {len(document_content.hyperlinks)} hyperlink(s)") - for hyperlink in document_content.hyperlinks: - print(f" URL: {hyperlink.url or '(not available)'}") - print(f" Content: {hyperlink.content or '(not available)'}") - else: - print("\nNo hyperlinks found in the document.") + # Extract hyperlinks from document content (enabled by EnableLayout config) + doc_content: DocumentContent = result.contents[0] # type: ignore + print(f"Found {len(doc_content.hyperlinks) if doc_content.hyperlinks else 0} hyperlink(s)") + for hyperlink in doc_content.hyperlinks or []: + print(f" URL: {hyperlink.url or '(not available)'}") + print(f" Content: {hyperlink.content or '(not available)'}") # [END extract_hyperlinks] # [START extract_formulas] - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - all_formulas = [] - if document_content.pages: - for page in document_content.pages: - if hasattr(page, "formulas") and page.formulas: - all_formulas.extend(page.formulas) - - if len(all_formulas) > 0: - print(f"\nFound {len(all_formulas)} formula(s)") - for formula in all_formulas: - print(f" Formula: {formula.value or '(no value)'}") - if hasattr(formula, "kind") and formula.kind: - print(f" Kind: {formula.kind}") - else: - print("\nNo formulas found in the document.") + # Extract formulas from document pages (enabled by EnableFormula config) + content: DocumentContent = result.contents[0] # type: ignore + all_formulas = [] + for page in content.pages or []: + all_formulas.extend(page.formulas or []) + + print(f"Found {len(all_formulas)} formula(s)") + for formula in all_formulas: + print(f" Formula Kind: {formula.kind}") + print(f" LaTeX: {formula.value or '(not available)'}") + print(f" Confidence: {f'{formula.confidence:.2f}' if formula.confidence else 'N/A'}") # [END extract_formulas] - # Extract annotations - if result.contents and len(result.contents) > 0: - content = result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - if ( - hasattr(document_content, "annotations") - and document_content.annotations - and len(document_content.annotations) > 0 - ): - print(f"\nFound {len(document_content.annotations)} annotation(s)") - for annotation in document_content.annotations: - print(f" Annotation ID: {annotation.id}") - print(f" Kind: {annotation.kind}") - if hasattr(annotation, "author") and annotation.author: - print(f" Author: {annotation.author}") - if hasattr(annotation, "comments") and annotation.comments and len(annotation.comments) > 0: - print(f" Comments: {len(annotation.comments)}") - for comment in annotation.comments: - print(f" - {comment.message}") - else: - print("\nNo annotations found in the document.") + # [START extract_annotations] + # Extract annotations from document content (enabled by EnableLayout config) + document: DocumentContent = result.contents[0] # type: ignore + print(f"Found {len(document.annotations) if document.annotations else 0} annotation(s)") + for annotation in document.annotations or []: + print(f" Annotation ID: {annotation.id}") + print(f" Kind: {annotation.kind}") + print(f" Author: {annotation.author or '(not available)'}") + print(f" Comments: {len(annotation.comments) if annotation.comments else 0}") + for comment in annotation.comments or []: + print(f" - {comment.message}") + # [END extract_annotations] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index 84cb7ad6754f..baae65838585 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -8,16 +8,9 @@ FILE: sample_analyze_invoice.py DESCRIPTION: + About extracting structured invoice fields: This sample demonstrates how to analyze an invoice from a URL using the prebuilt-invoice - analyzer and extract structured fields from the result. - - Content Understanding provides 70+ production-ready prebuilt analyzers that are ready to use - without any training or configuration. The prebuilt-invoice analyzer automatically extracts: - - Customer/Vendor information: Name, address, contact details - - Invoice metadata: Invoice number, date, due date, purchase order number - - Line items: Description, quantity, unit price, total for each item - - Financial totals: Subtotal, tax amount, shipping charges, total amount - - Payment information: Payment terms, payment method, remittance address + analyzer and extract structured fields (customer name, line items, totals, etc.) from the result. USAGE: python sample_analyze_invoice.py @@ -39,7 +32,6 @@ AnalyzeResult, DocumentContent, ContentField, - MediaContentKind, ArrayField, ObjectField, ) @@ -58,7 +50,7 @@ def main() -> None: # [START analyze_invoice] invoice_url = ( - "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/docs/invoice.pdf" ) print(f"Analyzing invoice with prebuilt-invoice analyzer...") @@ -76,99 +68,96 @@ def main() -> None: print("No content found in the analysis result.") return - content = result.contents[0] - # Get the document content (invoices are documents) - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - - # Print document unit information - # The unit indicates the measurement system used for coordinates in the source field - print(f"\nDocument unit: {document_content.unit or 'unknown'}") - print(f"Pages: {document_content.start_page_number} to {document_content.end_page_number}") - print() - - if not document_content.fields: - print("No fields found in the analysis result.") - return - - # Extract simple string fields - customer_name_field = document_content.fields.get("CustomerName") - invoice_date_field = document_content.fields.get("InvoiceDate") - - customer_name = customer_name_field.value if customer_name_field else None - invoice_date = invoice_date_field.value if invoice_date_field else None - - print(f"Customer Name: {customer_name or '(None)'}") - if customer_name_field: - print( - f" Confidence: {customer_name_field.confidence:.2f}" - if customer_name_field.confidence - else " Confidence: N/A" - ) - # Source is an encoded identifier containing bounding box coordinates - # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) - print(f" Source: {customer_name_field.source or 'N/A'}") - if customer_name_field.spans and len(customer_name_field.spans) > 0: - span = customer_name_field.spans[0] - print(f" Position in markdown: offset={span.offset}, length={span.length}") - - print(f"Invoice Date: {invoice_date or '(None)'}") - if invoice_date_field: - print( - f" Confidence: {invoice_date_field.confidence:.2f}" - if invoice_date_field.confidence - else " Confidence: N/A" - ) - - # Extract object field (TotalAmount contains Amount and CurrencyCode) - total_amount_field = document_content.fields.get("TotalAmount") - if total_amount_field and total_amount_field.value: - total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore - amount_field = total_amount_obj.get("Amount") - currency_field = total_amount_obj.get("CurrencyCode") - - amount = amount_field.value if amount_field else None - currency = currency_field.value if currency_field else None - - print(f"\nTotal Amount: {amount} {currency}") - if total_amount_field.confidence: - print(f" Confidence: {total_amount_field.confidence:.2f}") - - # Extract array field (LineItems - line items) - # Note: The field name is "LineItems" (not "Items") to match the service response - line_items_field = document_content.fields.get("LineItems") - if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: - items_array: list = line_items_field.value # type: ignore - print(f"\nLine Items ({len(items_array)}):") - for i, item in enumerate(items_array, 1): - # Each item in the array is a ContentField (ObjectField for line items) - if isinstance(item, ObjectField) and item.value: - item_dict: dict[str, ContentField] = item.value # type: ignore - description_field = item_dict.get("Description") - quantity_field = item_dict.get("Quantity") - # Try UnitPrice first, then Amount (matching .NET sample pattern) - unit_price_field = item_dict.get("UnitPrice") - amount_field = item_dict.get("Amount") - - description = description_field.value if description_field else "(no description)" - quantity = quantity_field.value if quantity_field else "N/A" - - # Display price information - prefer UnitPrice if available, otherwise Amount - # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) - price_info = "" - if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: - unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore - unit_price_amount_field = unit_price_obj.get("Amount") - unit_price_currency_field = unit_price_obj.get("CurrencyCode") - if unit_price_amount_field and unit_price_amount_field.value is not None: - currency = unit_price_currency_field.value if unit_price_currency_field else "" - price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() - elif amount_field and amount_field.value is not None: - price_info = f"Amount: {amount_field.value}" - - print(f" {i}. {description}") - print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) + document_content: DocumentContent = result.contents[0] # type: ignore + + # Print document unit information + # The unit indicates the measurement system used for coordinates in the source field + print(f"\nDocument unit: {document_content.unit or 'unknown'}") + print(f"Pages: {document_content.start_page_number} to {document_content.end_page_number}") + print() + + if not document_content.fields: + print("No fields found in the analysis result.") + return + + # Extract simple string fields + customer_name_field = document_content.fields.get("CustomerName") + invoice_date_field = document_content.fields.get("InvoiceDate") + + customer_name = customer_name_field.value if customer_name_field else None + invoice_date = invoice_date_field.value if invoice_date_field else None + + print(f"Customer Name: {customer_name or '(None)'}") + if customer_name_field: + print( + f" Confidence: {customer_name_field.confidence:.2f}" + if customer_name_field.confidence + else " Confidence: N/A" + ) + # Source is an encoded identifier containing bounding box coordinates + # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) + print(f" Source: {customer_name_field.source or 'N/A'}") + if customer_name_field.spans and len(customer_name_field.spans) > 0: + span = customer_name_field.spans[0] + print(f" Position in markdown: offset={span.offset}, length={span.length}") + + print(f"Invoice Date: {invoice_date or '(None)'}") + if invoice_date_field: + print( + f" Confidence: {invoice_date_field.confidence:.2f}" + if invoice_date_field.confidence + else " Confidence: N/A" + ) + + # Extract object field (TotalAmount contains Amount and CurrencyCode) + total_amount_field = document_content.fields.get("TotalAmount") + if total_amount_field and total_amount_field.value: + total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore + amount_field = total_amount_obj.get("Amount") + currency_field = total_amount_obj.get("CurrencyCode") + + amount = amount_field.value if amount_field else None + currency = currency_field.value if currency_field else None + + print(f"\nTotal Amount: {amount} {currency}") + if total_amount_field.confidence: + print(f" Confidence: {total_amount_field.confidence:.2f}") + + # Extract array field (LineItems - line items) + # Note: The field name is "LineItems" (not "Items") to match the service response + line_items_field = document_content.fields.get("LineItems") + if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: + items_array: list = line_items_field.value # type: ignore + print(f"\nLine Items ({len(items_array)}):") + for i, item in enumerate(items_array, 1): + # Each item in the array is a ContentField (ObjectField for line items) + if isinstance(item, ObjectField) and item.value: + item_dict: dict[str, ContentField] = item.value # type: ignore + description_field = item_dict.get("Description") + quantity_field = item_dict.get("Quantity") + # Try UnitPrice first, then Amount (matching .NET sample pattern) + unit_price_field = item_dict.get("UnitPrice") + amount_field = item_dict.get("Amount") + + description = description_field.value if description_field else "(no description)" + quantity = quantity_field.value if quantity_field else "N/A" + + # Display price information - prefer UnitPrice if available, otherwise Amount + # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) + price_info = "" + if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: + unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore + unit_price_amount_field = unit_price_obj.get("Amount") + unit_price_currency_field = unit_price_obj.get("CurrencyCode") + if unit_price_amount_field and unit_price_amount_field.value is not None: + currency = unit_price_currency_field.value if unit_price_currency_field else "" + price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() + elif amount_field and amount_field.value is not None: + price_info = f"Amount: {amount_field.value}" + + print(f" {i}. {description}") + print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) # [END extract_invoice_fields] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py index d8af896d59af..72aeba67bd7f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py @@ -9,27 +9,25 @@ DESCRIPTION: This sample demonstrates how to access the raw JSON response from analysis operations - using the 'cls' callback parameter. This is useful for advanced scenarios where you need - direct access to the JSON structure. - - The Content Understanding SDK provides two approaches for accessing analysis results: - - 1. Object model approach (recommended): Returns strongly-typed AnalyzeResult objects - that are easier to navigate and use. This is shown in sample_analyze_binary.py. - - 2. Protocol method approach: Returns raw HTTP response containing the JSON. This sample - demonstrates this approach for advanced scenarios. - - IMPORTANT: For production use, prefer the object model approach as it provides: - - Type safety - - IntelliSense support - - Easier navigation of results - - Better error handling - - Use raw JSON only when you need: - - Custom JSON processing - - Direct access to the raw response structure - - Integration with custom JSON parsers + using the 'cls' callback parameter. This is useful for scenarios where you need to + inspect the full response structure exactly as returned by the service. + + The Content Understanding SDK provides a convenient object model approach (shown in + sample_analyze_binary.py) that returns AnalyzeResult objects with deeper navigation + through the object model. However, sometimes you may need access to the raw JSON + response for: + + - Easy inspection: View the complete response structure in the exact format returned + by the service, making it easier to understand the full data model and discover + available fields + - Debugging: Inspect the raw response to troubleshoot issues, verify service behavior, + or understand unexpected results + - Advanced scenarios: Work with response structures that may change or include + additional metadata not captured in the typed model + + NOTE: For most production scenarios, the object model approach is recommended as it + provides type safety, IntelliSense support, and easier navigation. Use raw JSON access + when you specifically need the benefits listed above. USAGE: python sample_analyze_return_raw_json.py @@ -44,8 +42,6 @@ import json import os -from datetime import datetime -from pathlib import Path from dotenv import load_dotenv from azure.ai.contentunderstanding import ContentUnderstandingClient @@ -71,14 +67,10 @@ def main() -> None: print(f"Analyzing {file_path} with prebuilt-documentSearch...") # Use the 'cls' callback parameter to get the raw HTTP response - # The 'cls' parameter allows us to intercept the response and return custom data - # We return a tuple: (deserialized_object, raw_http_response) - # Note: For production use, prefer the object model approach (without cls parameter) - # which returns AnalyzeResult objects that are easier to work with + # This allows access to the complete response structure for easy inspection and debugging poller = client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, - content_type="application/pdf", cls=lambda pipeline_response, deserialized_obj, response_headers: ( deserialized_obj, pipeline_response.http_response, @@ -90,86 +82,12 @@ def main() -> None: # [END analyze_return_raw_json] # [START parse_raw_json] - # Parse the raw JSON response + # Pretty-print the raw JSON response response_json = raw_http_response.json() - - # Pretty-print the JSON pretty_json = json.dumps(response_json, indent=2, ensure_ascii=False) - - # Create output directory if it doesn't exist - output_dir = Path(__file__).parent / "sample_output" - output_dir.mkdir(exist_ok=True) - - # Save to file - timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") - output_filename = f"analyze_result_{timestamp}.json" - output_path = output_dir / output_filename - - with open(output_path, "w", encoding="utf-8") as f: - f.write(pretty_json) - - print(f"Raw JSON response saved to: {output_path}") - print(f"File size: {len(pretty_json):,} characters") + print(pretty_json) # [END parse_raw_json] - # [START extract_from_raw_json] - # Extract key information from raw JSON - # This demonstrates accessing the same data that would be available via the object model - if "result" in response_json: - result_data = response_json["result"] - - if "analyzerId" in result_data: - print(f"\nAnalyzer ID: {result_data['analyzerId']}") - - if "contents" in result_data and isinstance(result_data["contents"], list): - print(f"Contents count: {len(result_data['contents'])}") - - if len(result_data["contents"]) > 0: - first_content = result_data["contents"][0] - - if "kind" in first_content: - print(f"Content kind: {first_content['kind']}") - if "mimeType" in first_content: - print(f"MIME type: {first_content['mimeType']}") - - # Extract markdown content from raw JSON - # Object model equivalent: content.markdown - print("\nMarkdown Content (from raw JSON):") - print("=" * 50) - if "markdown" in first_content and first_content["markdown"]: - print(first_content["markdown"]) - else: - print("No markdown content available.") - print("=" * 50) - - # Extract document properties from raw JSON - # Object model equivalent: document_content.start_page_number, etc. - if first_content.get("kind") == "document": - print("\nDocument Information (from raw JSON):") - if "startPageNumber" in first_content: - print(f" Start page: {first_content['startPageNumber']}") - if "endPageNumber" in first_content: - print(f" End page: {first_content['endPageNumber']}") - - start_page = first_content.get("startPageNumber") - end_page = first_content.get("endPageNumber") - if start_page and end_page: - total_pages = end_page - start_page + 1 - print(f" Total pages: {total_pages}") - - # Extract pages information - # Object model equivalent: document_content.pages - if "pages" in first_content and first_content["pages"]: - pages = first_content["pages"] - unit = first_content.get("unit", "units") - print(f"\nPages ({len(pages)}):") - for page in pages: - page_num = page.get("pageNumber") - width = page.get("width") - height = page.get("height") - print(f" Page {page_num}: {width} x {height} {unit}") - # [END extract_from_raw_json] - if __name__ == "__main__": main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py index 28a46db9cccd..0a7af806ed56 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py @@ -8,11 +8,19 @@ FILE: sample_analyze_url.py DESCRIPTION: - This sample demonstrates how to analyze a document from a URL using the prebuilt-documentSearch - analyzer. This shows how to analyze a document from a publicly accessible URL instead of a local file. + Another great value of Content Understanding is its rich set of prebuilt analyzers. Great examples + of these are the RAG analyzers that work for all modalities (prebuilt-documentSearch, prebuilt-imageSearch, + prebuilt-audioSearch, and prebuilt-videoSearch). - For understanding basic analysis concepts, authentication, and result processing, - see sample_analyze_binary.py first. + This sample demonstrates these RAG analyzers with URL inputs. Content Understanding supports both + local binary inputs (see sample_analyze_binary.py) and URL inputs across all modalities. + + Important: For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. + For binary data (local files), use begin_analyze_binary() instead. + + Documents, HTML, and images with text are returned as DocumentContent (derived from MediaContent), + while audio and video are returned as AudioVisualContent (also derived from MediaContent). These + prebuilt RAG analyzers return markdown and a one-paragraph Summary for each content item. USAGE: python sample_analyze_url.py @@ -21,8 +29,7 @@ 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + See sample_configure_defaults.py for model deployment setup guidance. """ import os @@ -33,7 +40,6 @@ AnalyzeInput, AnalyzeResult, DocumentContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential @@ -49,9 +55,8 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_document_from_url] - document_url = ( - "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" - ) + # You can replace this URL with your own publicly accessible document URL. + document_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" print(f"Analyzing document from URL with prebuilt-documentSearch...") print(f" URL: {document_url}") @@ -63,28 +68,22 @@ def main() -> None: result: AnalyzeResult = poller.result() # Extract markdown content - print("\nMarkdown Content:") - print("=" * 50) - - if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.markdown: - print(content.markdown) - else: - print("No markdown content available.") - else: - print("No content found in the analysis result.") - - print("=" * 50) - - # Display document properties - if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f" Start page: {document_content.start_page_number}") - print(f" End page: {document_content.end_page_number}") + print("\nMarkdown:") + content = result.contents[0] + print(content.markdown) + + # Cast MediaContent to DocumentContent to access document-specific properties + # DocumentContent derives from MediaContent and provides additional properties + # to access full information about document, including Pages, Tables and many others + document_content: DocumentContent = content # type: ignore + print(f"\nPages: {document_content.start_page_number} - {document_content.end_page_number}") + + # Check for pages + if document_content.pages and len(document_content.pages) > 0: + print(f"Number of pages: {len(document_content.pages)}") + for page in document_content.pages: + unit = document_content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") # [END analyze_document_from_url] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py index 2e063b26bb4e..f8db9dbc73e5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py @@ -14,7 +14,7 @@ Content Understanding prebuilt analyzers require specific GPT model deployments to function: - GPT-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt) - - GPT-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-audioSearch) + - GPT-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch) - text-embedding-3-large: Used for semantic search and embeddings USAGE: @@ -84,7 +84,7 @@ def main() -> None: print("Model deployments configured successfully!") if updated_defaults.model_deployments: for model_name, deployment_name in updated_defaults.model_deployments.items(): - print(f" {model_name} -> {deployment_name}") + print(f" {model_name}: {deployment_name}") # [END update_defaults] # [START get_defaults] @@ -94,7 +94,7 @@ def main() -> None: print("\nCurrent model deployment mappings:") if defaults.model_deployments and len(defaults.model_deployments) > 0: for model_name, deployment_name in defaults.model_deployments.items(): - print(f" {model_name} -> {deployment_name}") + print(f" {model_name}: {deployment_name}") else: print(" No model deployments configured yet.") # [END get_defaults] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index edb076dd9891..77947ec7f6b7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -39,7 +39,6 @@ ContentCategoryDefinition, AnalyzeResult, DocumentContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential @@ -118,28 +117,24 @@ def main() -> None: analyze_poller = client.begin_analyze_binary( analyzer_id=analyzer_id, - content_type="application/pdf", binary_input=file_bytes, ) analyze_result: AnalyzeResult = analyze_poller.result() # Display classification results if analyze_result.contents and len(analyze_result.contents) > 0: - content = analyze_result.contents[0] - - if content.kind == MediaContentKind.DOCUMENT: - document_content: DocumentContent = content # type: ignore - print(f"Pages: {document_content.start_page_number}-{document_content.end_page_number}") - - # Display segments (classification results) - if document_content.segments and len(document_content.segments) > 0: - print(f"\nFound {len(document_content.segments)} segment(s):") - for segment in document_content.segments: - print(f" Category: {segment.category or '(unknown)'}") - print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") - print() - else: - print("No segments found (document classified as a single unit).") + document_content: DocumentContent = analyze_result.contents[0] # type: ignore + print(f"Pages: {document_content.start_page_number}-{document_content.end_page_number}") + + # Display segments (classification results) + if document_content.segments and len(document_content.segments) > 0: + print(f"\nFound {len(document_content.segments)} segment(s):") + for segment in document_content.segments: + print(f" Category: {segment.category or '(unknown)'}") + print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + print() + else: + print("No segments found (document classified as a single unit).") else: print("No content found in the analysis result.") # [END analyze_with_classifier] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py index a6435bc90a24..ab3dcbf480ae 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_analyzer.py @@ -15,8 +15,6 @@ Important notes: - Only custom analyzers can be deleted. Prebuilt analyzers cannot be deleted. - - Deleting an analyzer does not delete analysis results that were created using that analyzer. - - Once deleted, the analyzer ID cannot be reused immediately. USAGE: python sample_delete_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index b5e0f1a79cea..49224f6452ed 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -39,7 +39,6 @@ AnalyzeInput, AnalyzeResult, DocumentContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.core.exceptions import ResourceNotFoundError @@ -57,7 +56,7 @@ def main() -> None: # [START analyze_and_delete_result] document_url = ( - "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf" + "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/docs/invoice.pdf" ) print("Document Analysis Workflow") @@ -89,15 +88,12 @@ def main() -> None: # Display some sample results if result.contents and len(result.contents) > 0: - content = result.contents[0] - if content.kind == MediaContentKind.DOCUMENT: - doc_content: DocumentContent = content # type: ignore - if doc_content.fields: - print(f" Total fields extracted: {len(doc_content.fields)}") - customer_name_field = doc_content.fields.get("CustomerName") - if customer_name_field: - print(f" Customer Name: {customer_name_field.value or '(not found)'}") - + doc_content: DocumentContent = result.contents[0] # type: ignore + if doc_content.fields: + print(f" Total fields extracted: {len(doc_content.fields)}") + customer_name_field = doc_content.fields.get("CustomerName") + if customer_name_field: + print(f" Customer Name: {customer_name_field.value or '(not found)'}") # Step 2: Delete the analysis result print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") client.delete_result(operation_id=operation_id) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py index fd07aab844a7..a7f0e640b088 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py @@ -59,9 +59,20 @@ def main() -> None: print("Retrieving prebuilt-documentSearch analyzer...") analyzer = client.get_analyzer(analyzer_id="prebuilt-documentSearch") + # Print a few properties from the analyzer + print(f"Analyzer ID: {analyzer.analyzer_id}") + print(f"Base Analyzer ID: {analyzer.base_analyzer_id}") + print(f"Description: {analyzer.description}") + if analyzer.config: + print(f"Enable OCR: {analyzer.config.enable_ocr}") + print(f"Enable Layout: {analyzer.config.enable_layout}") + if analyzer.models: + models_str = ", ".join(f"{k}={v}" for k, v in analyzer.models.items()) + print(f"Models: {models_str}") + # Display full analyzer JSON print("\n" + "=" * 80) - print("Prebuilt-documentSearch Analyzer:") + print("Prebuilt-documentSearch Analyzer (Raw JSON):") print("=" * 80) analyzer_json = json.dumps(analyzer.as_dict(), indent=2, default=str) print(analyzer_json) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py index 2482a314d07f..5fe9ceb297a5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py @@ -39,7 +39,6 @@ AnalyzeInput, AnalyzeResult, AudioVisualContent, - MediaContentKind, ) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential @@ -84,52 +83,48 @@ def main() -> None: content = result.contents[0] # For video analysis, keyframes would be found in AudioVisualContent.KeyFrameTimesMs - if content.kind == MediaContentKind.AUDIO_VISUAL: - video_content: AudioVisualContent = content # type: ignore - - if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: - total_keyframes = len(video_content.key_frame_times_ms) - first_frame_time_ms = video_content.key_frame_times_ms[0] - - print(f"\nTotal keyframes: {total_keyframes}") - print(f"First keyframe time: {first_frame_time_ms} ms") - - # Get the first keyframe as an example - frame_path = f"keyframes/{first_frame_time_ms}" - - print(f"Getting result file: {frame_path}") - - # Get the result file (keyframe image) - file_response = client.get_result_file( - operation_id=operation_id, - path=frame_path, - ) - - image_bytes = b"".join(file_response) - print(f"Retrieved keyframe image ({len(image_bytes):,} bytes)") - - # Save the keyframe image to sample_output directory - output_dir = Path(__file__).parent / "sample_output" - output_dir.mkdir(exist_ok=True) - output_filename = f"keyframe_{first_frame_time_ms}.jpg" - output_path = output_dir / output_filename - - with open(output_path, "wb") as f: - f.write(image_bytes) - - print(f"Keyframe image saved to: {output_path}") - else: - print("\nNote: This sample demonstrates GetResultFile API usage.") - print(" For video analysis with keyframes, use prebuilt-videoSearch analyzer.") - print(" Keyframes are available in AudioVisualContent.key_frame_times_ms.") - print() - print(f"Example usage with operation ID '{operation_id}':") - print(" file_response = client.get_result_file(") - print(" operation_id=operation_id,") - print(' path="keyframes/1000")') + video_content: AudioVisualContent = result.contents[0] # type: ignore + + if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: + total_keyframes = len(video_content.key_frame_times_ms) + first_frame_time_ms = video_content.key_frame_times_ms[0] + + print(f"\nTotal keyframes: {total_keyframes}") + print(f"First keyframe time: {first_frame_time_ms} ms") + + # Get the first keyframe as an example + frame_path = f"keyframes/{first_frame_time_ms}" + + print(f"Getting result file: {frame_path}") + + # Get the result file (keyframe image) + file_response = client.get_result_file( + operation_id=operation_id, + path=frame_path, + ) + + image_bytes = b"".join(file_response) + print(f"Retrieved keyframe image ({len(image_bytes):,} bytes)") + + # Save the keyframe image to sample_output directory + output_dir = Path(__file__).parent / "sample_output" + output_dir.mkdir(exist_ok=True) + output_filename = f"keyframe_{first_frame_time_ms}.jpg" + output_path = output_dir / output_filename + + with open(output_path, "wb") as f: + f.write(image_bytes) + + print(f"Keyframe image saved to: {output_path}") else: - print("\nNote: This sample is designed for video analysis.") - print(" The analyzed content is not a video.") + print("\nNote: This sample demonstrates GetResultFile API usage.") + print(" For video analysis with keyframes, use prebuilt-videoSearch analyzer.") + print(" Keyframes are available in AudioVisualContent.key_frame_times_ms.") + print() + print(f"Example usage with operation ID '{operation_id}':") + print(" file_response = client.get_result_file(") + print(" operation_id=operation_id,") + print(' path="keyframes/1000")') # [END get_result_file] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py index 10ccad6a18ba..70959bb3f7f4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py @@ -13,11 +13,7 @@ The update_analyzer method allows you to modify certain properties of an existing analyzer: - Description: Update the analyzer's description - - Tags: Add, update, or remove tags (set tag value to empty string to remove) - - Note: Not all analyzer properties can be updated. Field schemas, models, and configuration - typically cannot be changed after creation. To change these, you may need to delete and - recreate the analyzer. + - Tags: Add or update tags USAGE: python sample_update_analyzer.py @@ -101,7 +97,6 @@ def main() -> None: description="Updated description", tags={ "tag1": "tag1_updated_value", # Update existing tag - "tag2": "", # Remove tag2 (empty string removes the tag) "tag3": "tag3_value", # Add new tag }, ) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py index abfb8c30e5b6..0fc224c9c2dd 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py @@ -12,6 +12,10 @@ DESCRIPTION: These tests validate the sample_analyze_binary.py sample code. + This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + analyzer. The service returns an AnalyzeResult that contains an array of MediaContent items + in AnalyzeResult.contents. For documents, each item is a DocumentContent that exposes markdown + plus detailed structure such as pages, tables, figures, and paragraphs. USAGE: pytest test_sample_analyze_binary.py @@ -62,7 +66,7 @@ def test_sample_analyze_binary(self, azure_content_understanding_endpoint: str) # Analyze the document poller = client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" + analyzer_id="prebuilt-documentSearch", binary_input=file_bytes ) result = poller.result() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py index c3a10f46d921..78695cc4abb3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py @@ -12,6 +12,10 @@ DESCRIPTION: These tests validate the sample_analyze_binary.py sample code (async version). + This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + analyzer. The service returns an AnalyzeResult that contains an array of MediaContent items + in AnalyzeResult.contents. For documents, each item is a DocumentContent that exposes markdown + plus detailed structure such as pages, tables, figures, and paragraphs. USAGE: pytest test_sample_analyze_binary_async.py @@ -62,7 +66,7 @@ async def test_sample_analyze_binary_async(self, azure_content_understanding_end # Analyze the document poller = await client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" + analyzer_id="prebuilt-documentSearch", binary_input=file_bytes ) result = await poller.result() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py index 437e7fd4c775..0408e64922ad 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py @@ -12,6 +12,17 @@ DESCRIPTION: These tests validate the sample_analyze_configs.py sample code. + The prebuilt-documentSearch analyzer has the following configurations enabled by default: + - ReturnDetails: true - Returns detailed information about document elements + - EnableOcr: true - Performs OCR on documents + - EnableLayout: true - Extracts layout information (tables, figures, hyperlinks, annotations) + - EnableFormula: true - Extracts mathematical formulas from documents + - EnableFigureDescription: true - Generates descriptions for figures + - EnableFigureAnalysis: true - Analyzes figures including charts + - ChartFormat: "chartjs" - Chart figures are returned in Chart.js format + - TableFormat: "html" - Tables are returned in HTML format + - AnnotationFormat: "markdown" - Annotations are returned in markdown format + USAGE: pytest test_sample_analyze_configs.py """ @@ -32,7 +43,8 @@ def test_sample_analyze_configs(self, azure_content_understanding_endpoint: str) This test validates: 1. Document analysis with prebuilt-documentSearch analyzer - 2. Configuration options (formulas, layout, OCR enabled) + 2. Configuration options (ReturnDetails, EnableOcr, EnableLayout, EnableFormula, + EnableFigureDescription, EnableFigureAnalysis enabled by default) 3. Document features extraction (charts, annotations, hyperlinks, formulas) 10_AnalyzeConfigs.AnalyzeConfigsAsync() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py index 8844e83fd895..97776a2ff0bc 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py @@ -12,6 +12,17 @@ DESCRIPTION: These tests validate the sample_analyze_configs.py sample code (async version). + The prebuilt-documentSearch analyzer has the following configurations enabled by default: + - ReturnDetails: true - Returns detailed information about document elements + - EnableOcr: true - Performs OCR on documents + - EnableLayout: true - Extracts layout information (tables, figures, hyperlinks, annotations) + - EnableFormula: true - Extracts mathematical formulas from documents + - EnableFigureDescription: true - Generates descriptions for figures + - EnableFigureAnalysis: true - Analyzes figures including charts + - ChartFormat: "chartjs" - Chart figures are returned in Chart.js format + - TableFormat: "html" - Tables are returned in HTML format + - AnnotationFormat: "markdown" - Annotations are returned in markdown format + USAGE: pytest test_sample_analyze_configs_async.py """ @@ -32,7 +43,8 @@ async def test_sample_analyze_configs_async(self, azure_content_understanding_en This test validates: 1. Document analysis with prebuilt-documentSearch analyzer - 2. Configuration options (formulas, layout, OCR enabled) + 2. Configuration options (ReturnDetails, EnableOcr, EnableLayout, EnableFormula, + EnableFigureDescription, EnableFigureAnalysis enabled by default) 3. Document features extraction (charts, annotations, hyperlinks, formulas) 10_AnalyzeConfigs.AnalyzeConfigsAsync() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py index 4f8bc284531a..4a1dd1fd6da7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py @@ -11,6 +11,8 @@ DESCRIPTION: These tests validate the sample_analyze_invoice.py sample code. + This sample demonstrates extracting structured invoice fields (customer name, line items, + totals, etc.) using the prebuilt-invoice analyzer. USAGE: pytest test_sample_analyze_invoice.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py index d9130e092640..bac768283778 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py @@ -11,6 +11,8 @@ DESCRIPTION: These tests validate the sample_analyze_invoice.py sample code (async version). + This sample demonstrates extracting structured invoice fields (customer name, line items, + totals, etc.) using the prebuilt-invoice analyzer. USAGE: pytest test_sample_analyze_invoice_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py index 50287f6a4133..d719ab153134 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py @@ -12,6 +12,12 @@ DESCRIPTION: These tests validate the sample_analyze_return_raw_json.py sample code. + This sample demonstrates how to access the raw JSON response from analysis operations. + This is useful for: + - Easy inspection: View the complete response structure in the exact format returned by the service + - Debugging: Inspect the raw response to troubleshoot issues or verify service behavior + - Advanced scenarios: Work with response structures that may include additional metadata + USAGE: pytest test_sample_analyze_return_raw_json.py """ @@ -32,7 +38,7 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi This test validates: 1. Document analysis using 'cls' callback to get raw HTTP response - 2. Raw JSON response format + 2. Raw JSON response format for easy inspection and debugging 3. JSON structure validation 11_AnalyzeReturnRawJson.AnalyzeReturnRawJson() @@ -55,12 +61,10 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi print(f"[PASS] File loaded: {len(file_bytes)} bytes") # Use 'cls' callback to get raw HTTP response - # The 'cls' parameter allows us to intercept the response before it gets deserialized as an object model - # We return a tuple: (deserialized_object, raw_http_response) + # This allows access to the complete response structure for easy inspection and debugging poller = client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, - content_type="application/pdf", cls=lambda pipeline_response, deserialized_obj, response_headers: ( deserialized_obj, pipeline_response.http_response, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py index 2aec2c6e1b33..603f3712933f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py @@ -12,6 +12,12 @@ DESCRIPTION: These tests validate the sample_analyze_return_raw_json.py sample code (async version). + This sample demonstrates how to access the raw JSON response from analysis operations. + This is useful for: + - Easy inspection: View the complete response structure in the exact format returned by the service + - Debugging: Inspect the raw response to troubleshoot issues or verify service behavior + - Advanced scenarios: Work with response structures that may include additional metadata + USAGE: pytest test_sample_analyze_return_raw_json_async.py """ @@ -32,7 +38,7 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa This test validates: 1. Document analysis using 'cls' callback to get raw HTTP response - 2. Raw JSON response format + 2. Raw JSON response format for easy inspection and debugging 3. JSON structure validation 11_AnalyzeReturnRawJson.AnalyzeReturnRawJsonAsync() @@ -55,12 +61,10 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa print(f"[PASS] File loaded: {len(file_bytes)} bytes") # Use 'cls' callback to get raw HTTP response - # The 'cls' parameter allows us to intercept the response before it gets deserialized as an object model - # We return a tuple: (deserialized_object, raw_http_response) + # This allows access to the complete response structure for easy inspection and debugging poller = await client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, - content_type="application/pdf", cls=lambda pipeline_response, deserialized_obj, response_headers: ( deserialized_obj, pipeline_response.http_response, diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py index 9681fae5a71a..4aebcba6cd80 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py @@ -12,6 +12,9 @@ DESCRIPTION: These tests validate the sample_analyze_url.py sample code. + This sample demonstrates prebuilt RAG analyzers with URL inputs. Content Understanding supports + both local binary inputs (see sample_analyze_binary.py) and URL inputs across all modalities. + For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. USAGE: pytest test_sample_analyze_url.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py index 49580552cea4..67fb61bd9e48 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py @@ -12,6 +12,9 @@ DESCRIPTION: These tests validate the sample_analyze_url.py sample code (async version). + This sample demonstrates prebuilt RAG analyzers with URL inputs. Content Understanding supports + both local binary inputs (see sample_analyze_binary_async.py) and URL inputs across all modalities. + For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. USAGE: pytest test_sample_analyze_url_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py index 8007337033d5..caff8e8735f2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_configure_defaults.py sample code. + This sample demonstrates configuring model deployment settings for prebuilt analyzers. USAGE: pytest test_sample_configure_defaults.py @@ -34,7 +35,7 @@ def test_sample_configure_defaults(self, azure_content_understanding_endpoint: s 2. Getting current defaults (GetDefaults) 3. Model deployment mappings structure - 00_ConfigureDefaults.ConfigureDefaultsAsync() + 00_UpdateDefaults.UpdateDefaultsAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py index 01f5cb77a391..a4722953bce5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_configure_defaults.py sample code (async version). + This sample demonstrates configuring model deployment settings for prebuilt analyzers. USAGE: pytest test_sample_configure_defaults_async.py @@ -34,7 +35,7 @@ async def test_sample_configure_defaults_async(self, azure_content_understanding 2. Getting current defaults (GetDefaults) 3. Model deployment mappings structure - 00_ConfigureDefaults.ConfigureDefaultsAsync() + 00_UpdateDefaults.UpdateDefaultsAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py index ee5306a131c8..482ac22e2e36 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_copy_analyzer.py sample code. + This sample demonstrates copying an analyzer within the same resource. USAGE: pytest test_sample_copy_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py index 8cb593e6cdda..db16facd90d2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_copy_analyzer.py sample code (async version). + This sample demonstrates copying an analyzer within the same resource. USAGE: pytest test_sample_copy_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py index 309beb0ed212..1a924bd14e27 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py @@ -11,6 +11,8 @@ DESCRIPTION: These tests validate the sample_create_analyzer.py sample code. + This sample demonstrates creating a custom analyzer with a field schema to extract + structured data from documents. USAGE: pytest test_sample_create_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py index ae6cb1501483..307ec9fbb507 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py @@ -11,6 +11,8 @@ DESCRIPTION: These tests validate the sample_create_analyzer.py sample code (async version). + This sample demonstrates creating a custom analyzer with a field schema to extract + structured data from documents. USAGE: pytest test_sample_create_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py index 6fb48a5af23b..6da726eec417 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py @@ -12,6 +12,8 @@ DESCRIPTION: These tests validate the sample_create_classifier.py sample code. + This sample demonstrates creating a classifier analyzer to categorize documents + into predefined categories with optional automatic segmentation. USAGE: pytest test_sample_create_classifier.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py index 9982626bc2f3..2f87fb105d5a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py @@ -12,6 +12,8 @@ DESCRIPTION: These tests validate the sample_create_classifier.py sample code (async version). + This sample demonstrates creating a classifier analyzer to categorize documents + into predefined categories with optional automatic segmentation. USAGE: pytest test_sample_create_classifier_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py index f10b191b4146..09a0b285816a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_delete_analyzer.py sample code. + This sample demonstrates permanently deleting a custom analyzer. USAGE: pytest test_sample_delete_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py index 53e2d72d2d89..d36451bfb13f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_delete_analyzer.py sample code (async version). + This sample demonstrates permanently deleting a custom analyzer. USAGE: pytest test_sample_delete_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py index bf6e2b5e4352..3405305c2f00 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_delete_result.py sample code. + This sample demonstrates deleting analysis results for immediate cleanup. USAGE: pytest test_sample_delete_result.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py index 95c3c2d6daf6..f74fdfd554c6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_delete_result.py sample code (async version). + This sample demonstrates deleting analysis results for immediate cleanup. USAGE: pytest test_sample_delete_result_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py index d745b2b9dd10..4b73127917c7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_get_analyzer.py sample code. + This sample demonstrates retrieving information about prebuilt and custom analyzers. USAGE: pytest test_sample_get_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py index 1da82e16d627..27aa63638c6a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_get_analyzer.py sample code (async version). + This sample demonstrates retrieving information about prebuilt and custom analyzers. USAGE: pytest test_sample_get_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py index 87970ea92280..b5f3dfcb2225 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_get_result_file.py sample code. + This sample demonstrates retrieving result files (like keyframe images) from video analysis. USAGE: pytest test_sample_get_result_file.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py index 763f7160fa29..7c80716f11ba 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_get_result_file.py sample code (async version). + This sample demonstrates retrieving result files (like keyframe images) from video analysis. USAGE: pytest test_sample_get_result_file_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py index 4f78dcab6b26..1382f4a85b72 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py @@ -12,6 +12,7 @@ DESCRIPTION: These tests validate the sample_grant_copy_auth.py sample code. + This sample demonstrates cross-resource analyzer copying with authorization. USAGE: pytest test_sample_grant_copy_auth.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py index 056d2fdd55eb..cd63412d041c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py @@ -12,6 +12,7 @@ DESCRIPTION: These tests validate the sample_grant_copy_auth.py sample code (async version). + This sample demonstrates cross-resource analyzer copying with authorization. USAGE: pytest test_sample_grant_copy_auth_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py index 7bd3f6f3f780..a3ad2ca66c79 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_list_analyzers.py sample code. + This sample demonstrates listing all available analyzers (prebuilt and custom). USAGE: pytest test_sample_list_analyzers.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py index 92158c7e5f5c..99e51109719e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_list_analyzers.py sample code (async version). + This sample demonstrates listing all available analyzers (prebuilt and custom). USAGE: pytest test_sample_list_analyzers_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py index 13820623ee04..a55a9366c8ee 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_update_analyzer.py sample code. + This sample demonstrates updating an existing custom analyzer's description and tags. USAGE: pytest test_sample_update_analyzer.py @@ -53,7 +54,7 @@ def test_sample_update_analyzer(self, azure_content_understanding_endpoint: str) description="Initial description", config=ContentAnalyzerConfig(return_details=True), models={"completion": "gpt-4.1"}, - tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, + tags={"tag1": "tag1_initial_value"}, ) # Create the analyzer @@ -82,8 +83,6 @@ def test_sample_update_analyzer(self, azure_content_understanding_endpoint: str) assert current_description == "Initial description", "Initial description should match" assert "tag1" in current_tags, "tag1 should exist" assert current_tags.get("tag1") == "tag1_initial_value", "tag1 value should match" - assert "tag2" in current_tags, "tag2 should exist" - assert current_tags.get("tag2") == "tag2_initial_value", "tag2 value should match" print("[PASS] Initial analyzer state verified") # Create an updated analyzer with new description and tags @@ -92,9 +91,8 @@ def test_sample_update_analyzer(self, azure_content_understanding_endpoint: str) base_analyzer_id=base_id, description="Updated description", tags={ - "tag1": "tag1_updated_value", - "tag2": "", # Remove tag2 (empty string) - "tag3": "tag3_value", # Add tag3 + "tag1": "tag1_updated_value", # Update existing tag + "tag3": "tag3_value", # Add new tag }, ) @@ -125,13 +123,6 @@ def test_sample_update_analyzer(self, azure_content_understanding_endpoint: str) assert updated_tags.get("tag1") == "tag1_updated_value", "tag1 value should be updated" print("[PASS] tag1 updated correctly") - # Verify tag2 was removed (or has empty value) - if "tag2" in updated_tags: - assert updated_tags.get("tag2") == "", "tag2 should have empty value" - print("[PASS] tag2 set to empty value") - else: - print("[PASS] tag2 removed successfully") - # Verify tag3 was added assert "tag3" in updated_tags, "tag3 should be added" assert updated_tags.get("tag3") == "tag3_value", "tag3 value should match" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py index 42bc6d1c83ad..93ff309d593a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py @@ -11,6 +11,7 @@ DESCRIPTION: These tests validate the sample_update_analyzer.py sample code (async version). + This sample demonstrates updating an existing custom analyzer's description and tags. USAGE: pytest test_sample_update_analyzer_async.py @@ -53,7 +54,7 @@ async def test_sample_update_analyzer_async(self, azure_content_understanding_en description="Initial description", config=ContentAnalyzerConfig(return_details=True), models={"completion": "gpt-4.1"}, - tags={"tag1": "tag1_initial_value", "tag2": "tag2_initial_value"}, + tags={"tag1": "tag1_initial_value"}, ) # Create the analyzer @@ -82,8 +83,6 @@ async def test_sample_update_analyzer_async(self, azure_content_understanding_en assert current_description == "Initial description", "Initial description should match" assert "tag1" in current_tags, "tag1 should exist" assert current_tags.get("tag1") == "tag1_initial_value", "tag1 value should match" - assert "tag2" in current_tags, "tag2 should exist" - assert current_tags.get("tag2") == "tag2_initial_value", "tag2 value should match" print("[PASS] Initial analyzer state verified") # Create an updated analyzer with new description and tags @@ -92,9 +91,8 @@ async def test_sample_update_analyzer_async(self, azure_content_understanding_en base_analyzer_id=base_id, description="Updated description", tags={ - "tag1": "tag1_updated_value", - "tag2": "", # Remove tag2 (empty string) - "tag3": "tag3_value", # Add tag3 + "tag1": "tag1_updated_value", # Update existing tag + "tag3": "tag3_value", # Add new tag }, ) @@ -125,13 +123,6 @@ async def test_sample_update_analyzer_async(self, azure_content_understanding_en assert updated_tags.get("tag1") == "tag1_updated_value", "tag1 value should be updated" print("[PASS] tag1 updated correctly") - # Verify tag2 was removed (or has empty value) - if "tag2" in updated_tags: - assert updated_tags.get("tag2") == "", "tag2 should have empty value" - print("[PASS] tag2 set to empty value") - else: - print("[PASS] tag2 removed successfully") - # Verify tag3 was added assert "tag3" in updated_tags, "tag3 should be added" assert updated_tags.get("tag3") == "tag3_value", "tag3 value should match" From 9aa2a4e253cd159f9f93d788973b60001b8da6ec Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 16:43:33 -0800 Subject: [PATCH 080/105] [SAMPLE-UPDATE] rename sample_update_defaults_async to sample_update_defaults_async --- ...s_async.py => sample_update_defaults_async.py} | 15 ++++++++------- ...gure_defaults.py => sample_update_defaults.py} | 15 ++++++++------- ...defaults.py => test_sample_update_defaults.py} | 14 +++++++------- ...nc.py => test_sample_update_defaults_async.py} | 14 +++++++------- 4 files changed, 30 insertions(+), 28 deletions(-) rename sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/{sample_configure_defaults_async.py => sample_update_defaults_async.py} (87%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/samples/{sample_configure_defaults.py => sample_update_defaults.py} (87%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_configure_defaults.py => test_sample_update_defaults.py} (92%) rename sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/{test_sample_configure_defaults_async.py => test_sample_update_defaults_async.py} (91%) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py similarity index 87% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py index 0e4d22e8c836..12da0b399e32 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_configure_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py @@ -5,20 +5,21 @@ # Licensed under the MIT License. See License.txt in the project root for license information. # -------------------------------------------------------------------------- """ -FILE: sample_configure_defaults_async.py +FILE: sample_update_defaults_async.py DESCRIPTION: This sample demonstrates how to configure and retrieve default model deployment settings - for your Microsoft Foundry resource. This is a required one-time setup before using - prebuilt analyzers. + for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry + resource before using prebuilt or custom analyzers. - Content Understanding prebuilt analyzers require specific GPT model deployments to function: - - GPT-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt) - - GPT-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch) + Content Understanding prebuilt analyzers and custom analyzers require specific large language + model deployments to function. Currently, Content Understanding uses OpenAI GPT models: + - gpt-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument) + - gpt-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch, prebuilt-videoSearch) - text-embedding-3-large: Used for semantic search and embeddings USAGE: - python sample_configure_defaults_async.py + python sample_update_defaults_async.py Set the environment variables with your own values before running the sample: 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py similarity index 87% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py index f8db9dbc73e5..f28959154cd4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py @@ -5,20 +5,21 @@ # Licensed under the MIT License. See License.txt in the project root for license information. # -------------------------------------------------------------------------- """ -FILE: sample_configure_defaults.py +FILE: sample_update_defaults.py DESCRIPTION: This sample demonstrates how to configure and retrieve default model deployment settings - for your Microsoft Foundry resource. This is a required one-time setup before using - prebuilt analyzers. + for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry + resource before using prebuilt or custom analyzers. - Content Understanding prebuilt analyzers require specific GPT model deployments to function: - - GPT-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt) - - GPT-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch) + Content Understanding prebuilt analyzers and custom analyzers require specific large language + model deployments to function. Currently, Content Understanding uses OpenAI GPT models: + - gpt-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument) + - gpt-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch, prebuilt-videoSearch) - text-embedding-3-large: Used for semantic search and embeddings USAGE: - python sample_configure_defaults.py + python sample_update_defaults.py Set the environment variables with your own values before running the sample: 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py similarity index 92% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py index caff8e8735f2..0b3544f57f5e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py @@ -7,14 +7,14 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_configure_defaults.py +TEST FILE: test_sample_update_defaults.py DESCRIPTION: - These tests validate the sample_configure_defaults.py sample code. + These tests validate the sample_update_defaults.py sample code. This sample demonstrates configuring model deployment settings for prebuilt analyzers. USAGE: - pytest test_sample_configure_defaults.py + pytest test_sample_update_defaults.py """ import pytest @@ -22,12 +22,12 @@ from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -class TestSampleConfigureDefaults(ContentUnderstandingClientTestBase): - """Tests for sample_configure_defaults.py""" +class TestSampleUpdateDefaults(ContentUnderstandingClientTestBase): + """Tests for sample_update_defaults.py""" @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_configure_defaults(self, azure_content_understanding_endpoint: str) -> None: + def test_sample_update_defaults(self, azure_content_understanding_endpoint: str) -> None: """Test configuring and getting model deployment defaults. This test validates: @@ -45,7 +45,7 @@ def test_sample_configure_defaults(self, azure_content_understanding_endpoint: s # Test GetDefaults - always run self._test_get_defaults(client) - print("\n[SUCCESS] All test_sample_configure_defaults assertions passed") + print("\n[SUCCESS] All test_sample_update_defaults assertions passed") def _test_update_defaults(self, client): """Test updating model deployment defaults.""" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py similarity index 91% rename from sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py rename to sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py index a4722953bce5..85e419afedd8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_configure_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py @@ -7,14 +7,14 @@ # -------------------------------------------------------------------------- """ -TEST FILE: test_sample_configure_defaults_async.py +TEST FILE: test_sample_update_defaults_async.py DESCRIPTION: - These tests validate the sample_configure_defaults.py sample code (async version). + These tests validate the sample_update_defaults.py sample code (async version). This sample demonstrates configuring model deployment settings for prebuilt analyzers. USAGE: - pytest test_sample_configure_defaults_async.py + pytest test_sample_update_defaults_async.py """ import pytest @@ -22,12 +22,12 @@ from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync -class TestSampleConfigureDefaultsAsync(ContentUnderstandingClientTestBaseAsync): - """Tests for sample_configure_defaults.py (async version)""" +class TestSampleUpdateDefaultsAsync(ContentUnderstandingClientTestBaseAsync): + """Tests for sample_update_defaults.py (async version)""" @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_sample_configure_defaults_async(self, azure_content_understanding_endpoint: str) -> None: + async def test_sample_update_defaults_async(self, azure_content_understanding_endpoint: str) -> None: """Test configuring and getting model deployment defaults (async version). This test validates: @@ -46,7 +46,7 @@ async def test_sample_configure_defaults_async(self, azure_content_understanding await self._test_get_defaults(client) await client.close() - print("\n[SUCCESS] All test_sample_configure_defaults_async assertions passed") + print("\n[SUCCESS] All test_sample_update_defaults_async assertions passed") async def _test_update_defaults(self, client): """Test updating model deployment defaults.""" From dd26e9acb38c121f3b91e06817bdd98a508fcc32 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 17:33:50 -0800 Subject: [PATCH 081/105] [SAMPLE-UPDATE] sample_update_defaults --- .../sample_update_defaults_async.py | 63 +++++++++++-- .../samples/sample_update_defaults.py | 63 +++++++++++-- .../samples/test_sample_update_defaults.py | 89 +++++++++++------- .../test_sample_update_defaults_async.py | 93 +++++++++++-------- 4 files changed, 224 insertions(+), 84 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py index 12da0b399e32..03f4283cca04 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py @@ -9,21 +9,62 @@ DESCRIPTION: This sample demonstrates how to configure and retrieve default model deployment settings - for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry - resource before using prebuilt or custom analyzers. + for your Microsoft Foundry resource. This is a **required one-time setup per Microsoft Foundry + resource** before using prebuilt or custom analyzers. + + ## About model deployment configuration Content Understanding prebuilt analyzers and custom analyzers require specific large language model deployments to function. Currently, Content Understanding uses OpenAI GPT models: - - gpt-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument) - - gpt-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch, prebuilt-videoSearch) - - text-embedding-3-large: Used for semantic search and embeddings + + - **gpt-4.1** - Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, + prebuilt-idDocument) + - **gpt-4.1-mini** - Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, + prebuilt-audioSearch, prebuilt-videoSearch) + - **text-embedding-3-large** - Used for semantic search and embeddings + + This configuration is **per Microsoft Foundry resource** and persists across sessions. + You only need to configure it once per Microsoft Foundry resource (or when you change + deployment names). + + ## Prerequisites + + To get started you'll need: + + 1. An Azure subscription and a **Microsoft Foundry resource**. To create a Microsoft Foundry + resource, follow the steps in the Azure Content Understanding quickstart. + You must create your Microsoft Foundry resource in a region that supports Content Understanding. + + 2. After creating your Microsoft Foundry resource, you must grant yourself the **Cognitive Services + User** role to enable API calls for setting default model deployments. This role assignment + is required even if you are the owner of the resource. + + 3. Take note of your Microsoft Foundry resource **endpoint** and, if you plan to use key-based + authentication, the **API key**. A typical endpoint looks like: + https://your-foundry.services.ai.azure.com + + 4. If you plan to use `DefaultAzureCredential` for authentication, you will need to log in to + Azure first. Typically, you can do this by running `az login` (Azure CLI) or `azd login` + (Azure Developer CLI) in your terminal. + + 5. Deploy the following models in Microsoft Foundry: + - gpt-4.1 + - gpt-4.1-mini + - text-embedding-3-large + + 6. Take note of the **deployment names** used for each model. The convention is to use the model + names (e.g., "gpt-4.1", "gpt-4.1-mini", "text-embedding-3-large"), but you can change these + during deployment. USAGE: python sample_update_defaults_async.py Set the environment variables with your own values before running the sample: 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. - 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + Example: https://your-foundry.services.ai.azure.com + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using + DefaultAzureCredential). Use key-based authentication for testing only; use + DefaultAzureCredential (recommended) for production. 3) GPT_4_1_DEPLOYMENT - your GPT-4.1 deployment name in Microsoft Foundry. 4) GPT_4_1_MINI_DEPLOYMENT - your GPT-4.1-mini deployment name in Microsoft Foundry. 5) TEXT_EMBEDDING_3_LARGE_DEPLOYMENT - your text-embedding-3-large deployment name in Microsoft Foundry. @@ -41,6 +82,13 @@ async def main() -> None: + # Create a ContentUnderstandingClient + # You can authenticate using either DefaultAzureCredential (recommended) or an API key. + # DefaultAzureCredential will look for credentials in the following order: + # 1. Environment variables (AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID) + # 2. Managed identity (for Azure-hosted applications) + # 3. Azure CLI (az login) + # 4. Azure Developer CLI (azd login) endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") credential = AzureKeyCredential(key) if key else DefaultAzureCredential() @@ -66,9 +114,12 @@ async def main() -> None: for deployment in missing_deployments: print(f" - {deployment}") print("\nPlease set these environment variables and try again.") + print("The deployment names should match the models you deployed in Microsoft Foundry.") return # Map your deployed models to the models required by prebuilt analyzers + # The dictionary keys are the model names required by the analyzers, and the values are + # your actual deployment names. You can use the same name for both if you prefer. # At this point, all deployments are guaranteed to be non-None due to the check above assert gpt_4_1_deployment is not None assert gpt_4_1_mini_deployment is not None diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py index f28959154cd4..7e1e359e69c2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py @@ -9,21 +9,62 @@ DESCRIPTION: This sample demonstrates how to configure and retrieve default model deployment settings - for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry - resource before using prebuilt or custom analyzers. + for your Microsoft Foundry resource. This is a **required one-time setup per Microsoft Foundry + resource** before using prebuilt or custom analyzers. + + ## About model deployment configuration Content Understanding prebuilt analyzers and custom analyzers require specific large language model deployments to function. Currently, Content Understanding uses OpenAI GPT models: - - gpt-4.1: Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument) - - gpt-4.1-mini: Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch, prebuilt-videoSearch) - - text-embedding-3-large: Used for semantic search and embeddings + + - **gpt-4.1** - Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, + prebuilt-idDocument) + - **gpt-4.1-mini** - Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, + prebuilt-audioSearch, prebuilt-videoSearch) + - **text-embedding-3-large** - Used for semantic search and embeddings + + This configuration is **per Microsoft Foundry resource** and persists across sessions. + You only need to configure it once per Microsoft Foundry resource (or when you change + deployment names). + + ## Prerequisites + + To get started you'll need: + + 1. An Azure subscription and a **Microsoft Foundry resource**. To create a Microsoft Foundry + resource, follow the steps in the Azure Content Understanding quickstart. + You must create your Microsoft Foundry resource in a region that supports Content Understanding. + + 2. After creating your Microsoft Foundry resource, you must grant yourself the **Cognitive Services + User** role to enable API calls for setting default model deployments. This role assignment + is required even if you are the owner of the resource. + + 3. Take note of your Microsoft Foundry resource **endpoint** and, if you plan to use key-based + authentication, the **API key**. A typical endpoint looks like: + https://your-foundry.services.ai.azure.com + + 4. If you plan to use `DefaultAzureCredential` for authentication, you will need to log in to + Azure first. Typically, you can do this by running `az login` (Azure CLI) or `azd login` + (Azure Developer CLI) in your terminal. + + 5. Deploy the following models in Microsoft Foundry: + - gpt-4.1 + - gpt-4.1-mini + - text-embedding-3-large + + 6. Take note of the **deployment names** used for each model. The convention is to use the model + names (e.g., "gpt-4.1", "gpt-4.1-mini", "text-embedding-3-large"), but you can change these + during deployment. USAGE: python sample_update_defaults.py Set the environment variables with your own values before running the sample: 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. - 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). + Example: https://your-foundry.services.ai.azure.com + 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using + DefaultAzureCredential). Use key-based authentication for testing only; use + DefaultAzureCredential (recommended) for production. 3) GPT_4_1_DEPLOYMENT - your GPT-4.1 deployment name in Microsoft Foundry. 4) GPT_4_1_MINI_DEPLOYMENT - your GPT-4.1-mini deployment name in Microsoft Foundry. 5) TEXT_EMBEDDING_3_LARGE_DEPLOYMENT - your text-embedding-3-large deployment name in Microsoft Foundry. @@ -40,6 +81,13 @@ def main() -> None: + # Create a ContentUnderstandingClient + # You can authenticate using either DefaultAzureCredential (recommended) or an API key. + # DefaultAzureCredential will look for credentials in the following order: + # 1. Environment variables (AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID) + # 2. Managed identity (for Azure-hosted applications) + # 3. Azure CLI (az login) + # 4. Azure Developer CLI (azd login) endpoint = os.environ["AZURE_CONTENT_UNDERSTANDING_ENDPOINT"] key = os.getenv("AZURE_CONTENT_UNDERSTANDING_KEY") credential = AzureKeyCredential(key) if key else DefaultAzureCredential() @@ -66,9 +114,12 @@ def main() -> None: for deployment in missing_deployments: print(f" - {deployment}") print("\nPlease set these environment variables and try again.") + print("The deployment names should match the models you deployed in Microsoft Foundry.") return # Map your deployed models to the models required by prebuilt analyzers + # The dictionary keys are the model names required by the analyzers, and the values are + # your actual deployment names. You can use the same name for both if you prefer. # At this point, all deployments are guaranteed to be non-None due to the check above assert gpt_4_1_deployment is not None assert gpt_4_1_mini_deployment is not None diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py index 0b3544f57f5e..7682ab81b6a9 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py @@ -13,6 +13,11 @@ These tests validate the sample_update_defaults.py sample code. This sample demonstrates configuring model deployment settings for prebuilt analyzers. + The tests validate: + 1. UpdateDefaults: Configuring model deployment mappings (optional, requires env vars) + 2. GetDefaults: Retrieving current model deployment configuration + 3. Model deployment mappings structure and data types + USAGE: pytest test_sample_update_defaults.py """ @@ -48,45 +53,59 @@ def test_sample_update_defaults(self, azure_content_understanding_endpoint: str) print("\n[SUCCESS] All test_sample_update_defaults assertions passed") def _test_update_defaults(self, client): - """Test updating model deployment defaults.""" - # Check if deployment names are configured in environment - # In Python tests, these would come from environment variables or test configuration - # For now, we'll check if the deployments are configured - - try: - # Get current defaults to check structure - response = client.get_defaults() - current_defaults = response - - # Verify the response structure exists - assert current_defaults is not None, "GetDefaults response should not be null" - - # Check if model_deployments attribute exists - model_deployments = getattr(current_defaults, "model_deployments", None) - - if model_deployments and len(model_deployments) > 0: - print(f"[PASS] UpdateDefaults: Model deployments already configured ({len(model_deployments)} models)") - - # Validate structure of existing deployments - assert isinstance(model_deployments, dict), "Model deployments should be a dictionary" + """Test updating model deployment defaults. - for key, value in model_deployments.items(): - assert isinstance(key, str) and key.strip(), f"Model key should be non-empty string, got {key}" - assert ( - isinstance(value, str) and value.strip() - ), f"Deployment value should be non-empty string for key {key}" - print(f" {key} → {value}") - else: - print("[WARN] UpdateDefaults: No model deployments configured (this is optional)") - - except Exception as e: - # If update_defaults is not available or fails, that's okay - print(f"[WARN] UpdateDefaults: Skipping - {str(e)}") + This test attempts to update model deployments if deployment names are provided + via environment variables. If not provided, it checks if defaults are already + configured. This is a best-effort test. + """ + import os + + gpt_4_1_deployment = os.getenv("GPT_4_1_DEPLOYMENT") + gpt_4_1_mini_deployment = os.getenv("GPT_4_1_MINI_DEPLOYMENT") + text_embedding_3_large_deployment = os.getenv("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + if gpt_4_1_deployment and gpt_4_1_mini_deployment and text_embedding_3_large_deployment: + # All deployment names are provided, attempt to update defaults + model_deployments = { + "gpt-4.1": gpt_4_1_deployment, + "gpt-4.1-mini": gpt_4_1_mini_deployment, + "text-embedding-3-large": text_embedding_3_large_deployment, + } + print("Configuring model deployments...") + updated_defaults = client.update_defaults(model_deployments=model_deployments) + assert updated_defaults is not None, "UpdateDefaults should return a valid response" + if updated_defaults.model_deployments: + print( + f"[PASS] UpdateDefaults: Model deployments configured ({len(updated_defaults.model_deployments)} models)" + ) + else: + # Deployment names not provided, check if defaults are already configured + print("[INFO] UpdateDefaults: Deployment names not set in environment variables.") + print(" Checking if defaults are already configured...") + + # Fallback: Check if defaults are already configured (read-only check) + try: + response = client.get_defaults() + current_defaults = response + model_deployments = getattr(current_defaults, "model_deployments", None) + + if model_deployments and len(model_deployments) > 0: + print( + f"[PASS] UpdateDefaults: Model deployments already configured ({len(model_deployments)} models)" + ) + else: + print("[INFO] UpdateDefaults: No model deployments configured (valid state)") + except Exception as e: + print(f"[INFO] UpdateDefaults: Could not check if defaults are configured - {str(e)}") def _test_get_defaults(self, client): """Test getting current model deployment defaults. - and assertions + This test validates that: + 1. The GetDefaults call returns a valid response + 2. The response contains the expected structure (model_deployments dict) + 3. If deployments are configured, they have valid string keys and values """ # Get current defaults get_response = client.get_defaults() @@ -117,7 +136,7 @@ def _test_get_defaults(self, client): assert key.strip(), "Model key should not be empty or whitespace" assert isinstance(value, str), f"Deployment value should be string for key {key}, got {type(value)}" assert value.strip(), f"Deployment value should not be empty for key {key}" - print(f" {key} → {value}") + print(f" {key}: {value}") # Assertion: Check for expected model keys (if any configured) # Common models: gpt-4.1, gpt-4.1-mini, text-embedding-3-large diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py index 85e419afedd8..afced35a05da 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py @@ -10,9 +10,14 @@ TEST FILE: test_sample_update_defaults_async.py DESCRIPTION: - These tests validate the sample_update_defaults.py sample code (async version). + These tests validate the sample_update_defaults_async.py sample code (async version). This sample demonstrates configuring model deployment settings for prebuilt analyzers. + The tests validate: + 1. UpdateDefaults: Configuring model deployment mappings (optional, requires env vars) + 2. GetDefaults: Retrieving current model deployment configuration (async) + 3. Model deployment mappings structure and data types + USAGE: pytest test_sample_update_defaults_async.py """ @@ -49,45 +54,59 @@ async def test_sample_update_defaults_async(self, azure_content_understanding_en print("\n[SUCCESS] All test_sample_update_defaults_async assertions passed") async def _test_update_defaults(self, client): - """Test updating model deployment defaults.""" - # Check if deployment names are configured in environment - # In Python tests, these would come from environment variables or test configuration - # For now, we'll check if the deployments are configured - - try: - # Get current defaults to check structure - response = await client.get_defaults() - current_defaults = response - - # Verify the response structure exists - assert current_defaults is not None, "GetDefaults response should not be null" - - # Check if model_deployments attribute exists - model_deployments = getattr(current_defaults, "model_deployments", None) - - if model_deployments and len(model_deployments) > 0: - print(f"[PASS] UpdateDefaults: Model deployments already configured ({len(model_deployments)} models)") - - # Validate structure of existing deployments - assert isinstance(model_deployments, dict), "Model deployments should be a dictionary" + """Test updating model deployment defaults (async). - for key, value in model_deployments.items(): - assert isinstance(key, str) and key.strip(), f"Model key should be non-empty string, got {key}" - assert ( - isinstance(value, str) and value.strip() - ), f"Deployment value should be non-empty string for key {key}" - print(f" {key} → {value}") - else: - print("[WARN] UpdateDefaults: No model deployments configured (this is optional)") - - except Exception as e: - # If update_defaults is not available or fails, that's okay - print(f"[WARN] UpdateDefaults: Skipping - {str(e)}") + This test attempts to update model deployments if deployment names are provided + via environment variables. If not provided, it checks if defaults are already + configured. This is a best-effort test. + """ + import os + + gpt_4_1_deployment = os.getenv("GPT_4_1_DEPLOYMENT") + gpt_4_1_mini_deployment = os.getenv("GPT_4_1_MINI_DEPLOYMENT") + text_embedding_3_large_deployment = os.getenv("TEXT_EMBEDDING_3_LARGE_DEPLOYMENT") + + if gpt_4_1_deployment and gpt_4_1_mini_deployment and text_embedding_3_large_deployment: + # All deployment names are provided, attempt to update defaults + model_deployments = { + "gpt-4.1": gpt_4_1_deployment, + "gpt-4.1-mini": gpt_4_1_mini_deployment, + "text-embedding-3-large": text_embedding_3_large_deployment, + } + print("Configuring model deployments...") + updated_defaults = await client.update_defaults(model_deployments=model_deployments) + assert updated_defaults is not None, "UpdateDefaults should return a valid response" + if updated_defaults.model_deployments: + print( + f"[PASS] UpdateDefaults: Model deployments configured ({len(updated_defaults.model_deployments)} models)" + ) + else: + # Deployment names not provided, check if defaults are already configured + print("[INFO] UpdateDefaults: Deployment names not set in environment variables.") + print(" Checking if defaults are already configured...") + + # Fallback: Check if defaults are already configured (read-only check) + try: + response = await client.get_defaults() + current_defaults = response + model_deployments = getattr(current_defaults, "model_deployments", None) + + if model_deployments and len(model_deployments) > 0: + print( + f"[PASS] UpdateDefaults: Model deployments already configured ({len(model_deployments)} models)" + ) + else: + print("[INFO] UpdateDefaults: No model deployments configured (valid state)") + except Exception as e: + print(f"[INFO] UpdateDefaults: Could not check if defaults are configured - {str(e)}") async def _test_get_defaults(self, client): - """Test getting current model deployment defaults. + """Test getting current model deployment defaults (async). - and assertions + This test validates that: + 1. The GetDefaults call returns a valid response (async) + 2. The response contains the expected structure (model_deployments dict) + 3. If deployments are configured, they have valid string keys and values """ # Get current defaults get_response = await client.get_defaults() @@ -118,7 +137,7 @@ async def _test_get_defaults(self, client): assert key.strip(), "Model key should not be empty or whitespace" assert isinstance(value, str), f"Deployment value should be string for key {key}, got {type(value)}" assert value.strip(), f"Deployment value should not be empty for key {key}" - print(f" {key} → {value}") + print(f" {key}: {value}") # Assertion: Check for expected model keys (if any configured) # Common models: gpt-4.1, gpt-4.1-mini, text-embedding-3-large From 2f82dd05d7dd35c8e6b2713a04ab80abf1817dda Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 18:00:57 -0800 Subject: [PATCH 082/105] [SAMPLE-UPDATE] sample_analyze_binary_async.py --- .../sample_analyze_binary_async.py | 54 ++++++++++++------- .../samples/sample_analyze_binary.py | 52 +++++++++++------- .../samples/test_sample_analyze_binary.py | 11 +++- .../test_sample_analyze_binary_async.py | 11 +++- 4 files changed, 89 insertions(+), 39 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py index a5c6333e391a..07aa6fd3461c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py @@ -8,8 +8,8 @@ FILE: sample_analyze_binary_async.py DESCRIPTION: - This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch - analyzer. + This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` + analyzer (async version). One of the key values of Content Understanding is taking a content file and extracting the content for you in one call. The service returns an AnalyzeResult that contains an array of MediaContent @@ -20,6 +20,14 @@ This sample focuses on document analysis. For prebuilt RAG analyzers covering images, audio, and video, see sample_analyze_url_async.py. + The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- + readable data optimized for RAG scenarios. It generates rich GitHub Flavored Markdown that preserves + document structure and can include structured text, tables (in HTML format), charts and diagrams, + mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. + + For documents that contain images with hand-written text, the prebuilt-documentSearch analyzer + includes OCR capabilities by default. + USAGE: python sample_analyze_binary_async.py @@ -52,15 +60,16 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_document_from_binary] + # Replace with the path to your local document file. file_path = "sample_files/sample_invoice.pdf" with open(file_path, "rb") as f: - pdf_bytes = f.read() + file_bytes = f.read() print(f"Analyzing {file_path} with prebuilt-documentSearch...") poller = await client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", - binary_input=pdf_bytes, + binary_input=file_bytes, ) result: AnalyzeResult = await poller.result() # [END analyze_document_from_binary] @@ -76,21 +85,28 @@ async def main() -> None: print("=" * 50) # [END extract_markdown] - # Access document properties - # Cast MediaContent to DocumentContent to access document-specific properties - # DocumentContent derives from MediaContent and provides additional properties - # to access full information about document, including pages, tables and many others - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f" Start page: {document_content.start_page_number}") - print(f" End page: {document_content.end_page_number}") - - # Check for pages - if document_content.pages and len(document_content.pages) > 0: - print(f"\nNumber of pages: {len(document_content.pages)}") - for page in document_content.pages: - unit = document_content.unit or "units" - print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + # [START access_document_properties] + # Check if this is document content to access document-specific properties + if isinstance(content, DocumentContent): + print(f"\nDocument type: {content.mime_type or '(unknown)'}") + print(f"Start page: {content.start_page_number}") + print(f"End page: {content.end_page_number}") + + # Check for pages + if content.pages and len(content.pages) > 0: + print(f"\nNumber of pages: {len(content.pages)}") + for page in content.pages: + unit = content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + + # Check for tables + if content.tables and len(content.tables) > 0: + print(f"\nNumber of tables: {len(content.tables)}") + table_counter = 1 + for table in content.tables: + print(f" Table {table_counter}: {table.row_count} rows x {table.column_count} columns") + table_counter += 1 + # [END access_document_properties] if not isinstance(credential, AzureKeyCredential): await credential.close() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py index ee206f2f0ddf..75d9f489ad72 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py @@ -8,7 +8,7 @@ FILE: sample_analyze_binary.py DESCRIPTION: - This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` analyzer. One of the key values of Content Understanding is taking a content file and extracting the content @@ -20,6 +20,14 @@ This sample focuses on document analysis. For prebuilt RAG analyzers covering images, audio, and video, see sample_analyze_url.py. + The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- + readable data optimized for RAG scenarios. It generates rich GitHub Flavored Markdown that preserves + document structure and can include structured text, tables (in HTML format), charts and diagrams, + mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. + + For documents that contain images with hand-written text, the prebuilt-documentSearch analyzer + includes OCR capabilities by default. + USAGE: python sample_analyze_binary.py @@ -52,15 +60,16 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_document_from_binary] + # Replace with the path to your local document file. file_path = "sample_files/sample_invoice.pdf" with open(file_path, "rb") as f: - pdf_bytes = f.read() + file_bytes = f.read() print(f"Analyzing {file_path} with prebuilt-documentSearch...") poller = client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", - binary_input=pdf_bytes, + binary_input=file_bytes, ) result: AnalyzeResult = poller.result() # [END analyze_document_from_binary] @@ -76,21 +85,28 @@ def main() -> None: print("=" * 50) # [END extract_markdown] - # Access document properties - # Cast MediaContent to DocumentContent to access document-specific properties - # DocumentContent derives from MediaContent and provides additional properties - # to access full information about document, including pages, tables and many others - document_content: DocumentContent = content # type: ignore - print(f"\nDocument Information:") - print(f" Start page: {document_content.start_page_number}") - print(f" End page: {document_content.end_page_number}") - - # Check for pages - if document_content.pages and len(document_content.pages) > 0: - print(f"\nNumber of pages: {len(document_content.pages)}") - for page in document_content.pages: - unit = document_content.unit or "units" - print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + # [START access_document_properties] + # Check if this is document content to access document-specific properties + if isinstance(content, DocumentContent): + print(f"\nDocument type: {content.mime_type or '(unknown)'}") + print(f"Start page: {content.start_page_number}") + print(f"End page: {content.end_page_number}") + + # Check for pages + if content.pages and len(content.pages) > 0: + print(f"\nNumber of pages: {len(content.pages)}") + for page in content.pages: + unit = content.unit or "units" + print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") + + # Check for tables + if content.tables and len(content.tables) > 0: + print(f"\nNumber of tables: {len(content.tables)}") + table_counter = 1 + for table in content.tables: + print(f" Table {table_counter}: {table.row_count} rows x {table.column_count} columns") + table_counter += 1 + # [END access_document_properties] if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py index 0fc224c9c2dd..1fc7e8695c10 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py @@ -12,10 +12,19 @@ DESCRIPTION: These tests validate the sample_analyze_binary.py sample code. - This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + + This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` analyzer. The service returns an AnalyzeResult that contains an array of MediaContent items in AnalyzeResult.contents. For documents, each item is a DocumentContent that exposes markdown plus detailed structure such as pages, tables, figures, and paragraphs. + + The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- + readable data optimized for RAG scenarios. It extracts rich GitHub Flavored Markdown that preserves + document structure and can include: structured text, tables (in HTML format), charts and diagrams, + mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. + + Content Understanding supports many document types including PDF, Word, Excel, PowerPoint, images + (including scanned image files with hand-written text), and more. USAGE: pytest test_sample_analyze_binary.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py index 78695cc4abb3..a2714cea394b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py @@ -12,10 +12,19 @@ DESCRIPTION: These tests validate the sample_analyze_binary.py sample code (async version). - This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + + This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` analyzer. The service returns an AnalyzeResult that contains an array of MediaContent items in AnalyzeResult.contents. For documents, each item is a DocumentContent that exposes markdown plus detailed structure such as pages, tables, figures, and paragraphs. + + The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- + readable data optimized for RAG scenarios. It extracts rich GitHub Flavored Markdown that preserves + document structure and can include: structured text, tables (in HTML format), charts and diagrams, + mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. + + Content Understanding supports many document types including PDF, Word, Excel, PowerPoint, images + (including scanned image files with hand-written text), and more. USAGE: pytest test_sample_analyze_binary_async.py From 31837a9b7548ff301683108e312acce48684c30a Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 18:10:41 -0800 Subject: [PATCH 083/105] [SAMPLE-UPDATE] sample_analyze_url --- .../async_samples/sample_analyze_url_async.py | 99 +++++++ .../samples/sample_analyze_url.py | 99 +++++++ .../tests/samples/test_sample_analyze_url.py | 259 +++++++++++++++- .../samples/test_sample_analyze_url_async.py | 276 +++++++++++++++++- 4 files changed, 724 insertions(+), 9 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py index 652722c70a3f..4270bb2ad006 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py @@ -40,7 +40,9 @@ from azure.ai.contentunderstanding.models import ( AnalyzeInput, AnalyzeResult, + AudioVisualContent, DocumentContent, + MediaContent, ) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential @@ -55,6 +57,9 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_document_from_url] + print("=" * 60) + print("DOCUMENT ANALYSIS FROM URL") + print("=" * 60) # You can replace this URL with your own publicly accessible document URL. document_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" @@ -86,6 +91,100 @@ async def main() -> None: print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") # [END analyze_document_from_url] + # [START analyze_video_from_url] + print("\n" + "=" * 60) + print("VIDEO ANALYSIS FROM URL") + print("=" * 60) + video_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/videos/sdk_samples/FlightSimulator.mp4" + + print(f"Analyzing video from URL with prebuilt-videoSearch...") + print(f" URL: {video_url}") + + poller = await client.begin_analyze( + analyzer_id="prebuilt-videoSearch", + inputs=[AnalyzeInput(url=video_url)], + ) + result = await poller.result() + + # prebuilt-videoSearch can detect video segments, so we should iterate through all segments + segment_index = 1 + for media in result.contents: + # Cast MediaContent to AudioVisualContent to access audio/visual-specific properties + # AudioVisualContent derives from MediaContent and provides additional properties + # to access full information about audio/video, including timing, transcript phrases, and many others + video_content: AudioVisualContent = media # type: ignore + print(f"\n--- Segment {segment_index} ---") + print("Markdown:") + print(video_content.markdown) + + summary = video_content.fields.get("Summary") + if summary and hasattr(summary, "value"): + print(f"Summary: {summary.value}") + + print(f"Start: {video_content.start_time_ms} ms, End: {video_content.end_time_ms} ms") + print(f"Frame size: {video_content.width} x {video_content.height}") + + print("---------------------") + segment_index += 1 + # [END analyze_video_from_url] + + # [START analyze_audio_from_url] + print("\n" + "=" * 60) + print("AUDIO ANALYSIS FROM URL") + print("=" * 60) + audio_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/audio/callCenterRecording.mp3" + + print(f"Analyzing audio from URL with prebuilt-audioSearch...") + print(f" URL: {audio_url}") + + poller = await client.begin_analyze( + analyzer_id="prebuilt-audioSearch", + inputs=[AnalyzeInput(url=audio_url)], + ) + result = await poller.result() + + # Cast MediaContent to AudioVisualContent to access audio/visual-specific properties + # AudioVisualContent derives from MediaContent and provides additional properties + # to access full information about audio/video, including timing, transcript phrases, and many others + audio_content: AudioVisualContent = result.contents[0] # type: ignore + print("Markdown:") + print(audio_content.markdown) + + summary = audio_content.fields.get("Summary") + if summary and hasattr(summary, "value"): + print(f"Summary: {summary.value}") + + # Example: Access an additional field in AudioVisualContent (transcript phrases) + if audio_content.transcript_phrases and len(audio_content.transcript_phrases) > 0: + print("Transcript (first two phrases):") + for phrase in audio_content.transcript_phrases[:2]: + print(f" [{phrase.speaker}] {phrase.start_time_ms} ms: {phrase.text}") + # [END analyze_audio_from_url] + + # [START analyze_image_from_url] + print("\n" + "=" * 60) + print("IMAGE ANALYSIS FROM URL") + print("=" * 60) + image_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/image/pieChart.jpg" + + print(f"Analyzing image from URL with prebuilt-imageSearch...") + print(f" URL: {image_url}") + + poller = await client.begin_analyze( + analyzer_id="prebuilt-imageSearch", + inputs=[AnalyzeInput(url=image_url)], + ) + result = await poller.result() + + content = result.contents[0] + print("Markdown:") + print(content.markdown) + + summary = content.fields.get("Summary") + if summary and hasattr(summary, "value"): + print(f"Summary: {summary.value}") + # [END analyze_image_from_url] + if not isinstance(credential, AzureKeyCredential): await credential.close() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py index 0a7af806ed56..f53ed3931183 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py @@ -39,7 +39,9 @@ from azure.ai.contentunderstanding.models import ( AnalyzeInput, AnalyzeResult, + AudioVisualContent, DocumentContent, + MediaContent, ) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential @@ -55,6 +57,9 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_document_from_url] + print("=" * 60) + print("DOCUMENT ANALYSIS FROM URL") + print("=" * 60) # You can replace this URL with your own publicly accessible document URL. document_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" @@ -86,6 +91,100 @@ def main() -> None: print(f" Page {page.page_number}: {page.width} x {page.height} {unit}") # [END analyze_document_from_url] + # [START analyze_video_from_url] + print("\n" + "=" * 60) + print("VIDEO ANALYSIS FROM URL") + print("=" * 60) + video_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/videos/sdk_samples/FlightSimulator.mp4" + + print(f"Analyzing video from URL with prebuilt-videoSearch...") + print(f" URL: {video_url}") + + poller = client.begin_analyze( + analyzer_id="prebuilt-videoSearch", + inputs=[AnalyzeInput(url=video_url)], + ) + result = poller.result() + + # prebuilt-videoSearch can detect video segments, so we should iterate through all segments + segment_index = 1 + for media in result.contents: + # Cast MediaContent to AudioVisualContent to access audio/visual-specific properties + # AudioVisualContent derives from MediaContent and provides additional properties + # to access full information about audio/video, including timing, transcript phrases, and many others + video_content: AudioVisualContent = media # type: ignore + print(f"\n--- Segment {segment_index} ---") + print("Markdown:") + print(video_content.markdown) + + summary = video_content.fields.get("Summary") + if summary and hasattr(summary, "value"): + print(f"Summary: {summary.value}") + + print(f"Start: {video_content.start_time_ms} ms, End: {video_content.end_time_ms} ms") + print(f"Frame size: {video_content.width} x {video_content.height}") + + print("---------------------") + segment_index += 1 + # [END analyze_video_from_url] + + # [START analyze_audio_from_url] + print("\n" + "=" * 60) + print("AUDIO ANALYSIS FROM URL") + print("=" * 60) + audio_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/audio/callCenterRecording.mp3" + + print(f"Analyzing audio from URL with prebuilt-audioSearch...") + print(f" URL: {audio_url}") + + poller = client.begin_analyze( + analyzer_id="prebuilt-audioSearch", + inputs=[AnalyzeInput(url=audio_url)], + ) + result = poller.result() + + # Cast MediaContent to AudioVisualContent to access audio/visual-specific properties + # AudioVisualContent derives from MediaContent and provides additional properties + # to access full information about audio/video, including timing, transcript phrases, and many others + audio_content: AudioVisualContent = result.contents[0] # type: ignore + print("Markdown:") + print(audio_content.markdown) + + summary = audio_content.fields.get("Summary") + if summary and hasattr(summary, "value"): + print(f"Summary: {summary.value}") + + # Example: Access an additional field in AudioVisualContent (transcript phrases) + if audio_content.transcript_phrases and len(audio_content.transcript_phrases) > 0: + print("Transcript (first two phrases):") + for phrase in audio_content.transcript_phrases[:2]: + print(f" [{phrase.speaker}] {phrase.start_time_ms} ms: {phrase.text}") + # [END analyze_audio_from_url] + + # [START analyze_image_from_url] + print("\n" + "=" * 60) + print("IMAGE ANALYSIS FROM URL") + print("=" * 60) + image_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/image/pieChart.jpg" + + print(f"Analyzing image from URL with prebuilt-imageSearch...") + print(f" URL: {image_url}") + + poller = client.begin_analyze( + analyzer_id="prebuilt-imageSearch", + inputs=[AnalyzeInput(url=image_url)], + ) + result = poller.result() + + content = result.contents[0] + print("Markdown:") + print(content.markdown) + + summary = content.fields.get("Summary") + if summary and hasattr(summary, "value"): + print(f"Summary: {summary.value}") + # [END analyze_image_from_url] + if __name__ == "__main__": main() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py index 4aebcba6cd80..d8709bfe9280 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py @@ -24,7 +24,7 @@ import pytest from devtools_testutils import recorded_by_proxy from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase -from azure.ai.contentunderstanding.models import AnalyzeInput +from azure.ai.contentunderstanding.models import AnalyzeInput, AudioVisualContent, DocumentContent class TestSampleAnalyzeUrl(ContentUnderstandingClientTestBase): @@ -32,7 +32,7 @@ class TestSampleAnalyzeUrl(ContentUnderstandingClientTestBase): @ContentUnderstandingPreparer() @recorded_by_proxy - def test_sample_analyze_url(self, azure_content_understanding_endpoint: str) -> None: + def test_sample_analyze_document_from_url(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document from URL. This test validates: @@ -41,7 +41,7 @@ def test_sample_analyze_url(self, azure_content_understanding_endpoint: str) -> 3. Markdown content extraction 4. Document properties (MIME type, pages, tables) - 02_AnalyzeUrl.AnalyzeUrlAsync() + 02_AnalyzeUrl.AnalyzeDocumentUrlAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -100,7 +100,153 @@ def test_sample_analyze_url(self, azure_content_understanding_endpoint: str) -> # Test document properties access self._test_document_properties(result) - print("\n[SUCCESS] All test_sample_analyze_url assertions passed") + print("\n[SUCCESS] All test_sample_analyze_document_from_url assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_analyze_video_from_url(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing a video from URL. + + This test validates: + 1. Video analysis using begin_analyze with URL input + 2. Markdown content extraction + 3. Audio/visual properties (timing, frame size) + 4. Multiple segments handling + + 02_AnalyzeUrl.AnalyzeVideoUrlAsync() + """ + client = self.create_client(endpoint=azure_content_understanding_endpoint) + + # For testing purposes, use binary data + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_video.mp4") + + if not os.path.exists(file_path): + pytest.skip(f"Video test file not found at {file_path}") + + with open(file_path, "rb") as f: + file_data = f.read() + + print(f"[PASS] Video loaded from: {file_path}") + + # Analyze the video + poller = client.begin_analyze(analyzer_id="prebuilt-videoSearch", inputs=[AnalyzeInput(data=file_data)]) + + result = poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should contain at least one content" + print(f"[PASS] Analysis result contains {len(result.contents)} segment(s)") + + # Test audio/visual properties + self._test_audiovisual_properties(result) + + print("\n[SUCCESS] All test_sample_analyze_video_from_url assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_analyze_audio_from_url(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing audio from URL. + + This test validates: + 1. Audio analysis using begin_analyze with URL input + 2. Markdown content extraction + 3. Transcript phrases access + 4. Summary field access + + 02_AnalyzeUrl.AnalyzeAudioUrlAsync() + """ + client = self.create_client(endpoint=azure_content_understanding_endpoint) + + # For testing purposes, use binary data + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_audio.mp3") + + if not os.path.exists(file_path): + pytest.skip(f"Audio test file not found at {file_path}") + + with open(file_path, "rb") as f: + file_data = f.read() + + print(f"[PASS] Audio loaded from: {file_path}") + + # Analyze the audio + poller = client.begin_analyze(analyzer_id="prebuilt-audioSearch", inputs=[AnalyzeInput(data=file_data)]) + + result = poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should contain at least one content" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Test audio properties including transcript phrases + self._test_audio_properties(result) + + print("\n[SUCCESS] All test_sample_analyze_audio_from_url assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_analyze_image_from_url(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing an image from URL. + + This test validates: + 1. Image analysis using begin_analyze with URL input + 2. Markdown content extraction + 3. Summary field access + + 02_AnalyzeUrl.AnalyzeImageUrlAsync() + """ + client = self.create_client(endpoint=azure_content_understanding_endpoint) + + # For testing purposes, use binary data + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_image.jpg") + + if not os.path.exists(file_path): + pytest.skip(f"Image test file not found at {file_path}") + + with open(file_path, "rb") as f: + file_data = f.read() + + print(f"[PASS] Image loaded from: {file_path}") + + # Analyze the image + poller = client.begin_analyze(analyzer_id="prebuilt-imageSearch", inputs=[AnalyzeInput(data=file_data)]) + + result = poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should contain at least one content" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Test image properties + self._test_image_properties(result) + + print("\n[SUCCESS] All test_sample_analyze_image_from_url assertions passed") def _test_markdown_extraction(self, result): """Test markdown content extraction.""" @@ -172,6 +318,111 @@ def _test_document_properties(self, result): print("[PASS] All document properties validated successfully") + def _test_audiovisual_properties(self, result): + """Test audio/visual content properties for video.""" + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Verify markdown + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + print(f"[PASS] Video markdown content extracted ({len(markdown)} characters)") + + # Verify timing properties + start_time = getattr(content, "start_time_ms", None) + if start_time is not None: + assert start_time >= 0, f"Start time should be >= 0, but was {start_time}" + print(f"[PASS] Video start time verified: {start_time} ms") + + end_time = getattr(content, "end_time_ms", None) + if end_time is not None: + assert end_time >= 0, f"End time should be >= 0, but was {end_time}" + print(f"[PASS] Video end time verified: {end_time} ms") + + # Verify frame size + width = getattr(content, "width", None) + height = getattr(content, "height", None) + if width is not None and height is not None: + assert width > 0, f"Video width should be > 0, but was {width}" + assert height > 0, f"Video height should be > 0, but was {height}" + print(f"[PASS] Video frame size verified: {width} x {height}") + + # Verify summary field + fields = getattr(content, "fields", None) + if fields: + summary = fields.get("Summary") + if summary: + print("[PASS] Summary field available in video content") + + print("[PASS] All audio/visual properties validated successfully") + + def _test_audio_properties(self, result): + """Test audio content properties including transcript phrases.""" + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Verify markdown + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + print(f"[PASS] Audio markdown content extracted ({len(markdown)} characters)") + + # Verify timing properties + start_time = getattr(content, "start_time_ms", None) + if start_time is not None: + assert start_time >= 0, f"Start time should be >= 0, but was {start_time}" + print(f"[PASS] Audio start time verified: {start_time} ms") + + # Verify summary field + fields = getattr(content, "fields", None) + if fields: + summary = fields.get("Summary") + if summary: + print("[PASS] Summary field available in audio content") + + # Verify transcript phrases + transcript_phrases = getattr(content, "transcript_phrases", None) + if transcript_phrases and len(transcript_phrases) > 0: + print(f"[PASS] Transcript phrases found: {len(transcript_phrases)} phrases") + for phrase in transcript_phrases[:2]: + speaker = getattr(phrase, "speaker", None) + text = getattr(phrase, "text", None) + start_ms = getattr(phrase, "start_time_ms", None) + if speaker and text: + print(f" [{speaker}] {start_ms} ms: {text}") + else: + print("[WARN] No transcript phrases available") + + print("[PASS] All audio properties validated successfully") + + def _test_image_properties(self, result): + """Test image content properties.""" + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Verify markdown + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + print(f"[PASS] Image markdown content extracted ({len(markdown)} characters)") + + # Verify summary field + fields = getattr(content, "fields", None) + if fields: + summary = fields.get("Summary") + if summary and hasattr(summary, "value"): + summary_value = summary.value + if summary_value: + assert isinstance(summary_value, str), "Summary should be a string" + assert len(summary_value) > 0, "Summary should not be empty" + print(f"[PASS] Image summary verified ({len(summary_value)} characters)") + + print("[PASS] All image properties validated successfully") + def _validate_pages(self, pages, start_page, end_page, content=None): """Validate pages collection details.""" page_numbers = set() diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py index 67fb61bd9e48..5a84724f7131 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py @@ -24,15 +24,15 @@ import pytest from devtools_testutils.aio import recorded_by_proxy_async from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync -from azure.ai.contentunderstanding.models import AnalyzeInput +from azure.ai.contentunderstanding.models import AnalyzeInput, AudioVisualContent, DocumentContent class TestSampleAnalyzeUrlAsync(ContentUnderstandingClientTestBaseAsync): - """Tests for sample_analyze_url.py (async version)""" + """Tests for sample_analyze_url_async.py""" @ContentUnderstandingPreparer() @recorded_by_proxy_async - async def test_sample_analyze_url_async(self, azure_content_understanding_endpoint: str) -> None: + async def test_sample_analyze_document_from_url_async(self, azure_content_understanding_endpoint: str) -> None: """Test analyzing a document from URL (async version). This test validates: @@ -41,7 +41,7 @@ async def test_sample_analyze_url_async(self, azure_content_understanding_endpoi 3. Markdown content extraction 4. Document properties (MIME type, pages, tables) - 02_AnalyzeUrl.AnalyzeUrlAsync() + 02_AnalyzeUrl.AnalyzeDocumentUrlAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -103,7 +103,168 @@ async def test_sample_analyze_url_async(self, azure_content_understanding_endpoi self._test_document_properties(result) await client.close() - print("\n[SUCCESS] All test_sample_analyze_url_async assertions passed") + print("\n[SUCCESS] All test_sample_analyze_document_from_url_async assertions passed") + + # Test document properties access + self._test_document_properties(result) + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_document_from_url_async assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_video_from_url_async(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing a video from URL (async version). + + This test validates: + 1. Video analysis using begin_analyze with URL input + 2. Markdown content extraction + 3. Audio/visual properties (timing, frame size) + 4. Multiple segments handling + + 02_AnalyzeUrl.AnalyzeVideoUrlAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # For testing purposes, use binary data + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_video.mp4") + + if not os.path.exists(file_path): + pytest.skip(f"Video test file not found at {file_path}") + + with open(file_path, "rb") as f: + file_data = f.read() + + print(f"[PASS] Video loaded from: {file_path}") + + # Analyze the video + poller = await client.begin_analyze( + analyzer_id="prebuilt-videoSearch", inputs=[AnalyzeInput(data=file_data)] + ) + + result = await poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should contain at least one content" + print(f"[PASS] Analysis result contains {len(result.contents)} segment(s)") + + # Test audio/visual properties + self._test_audiovisual_properties(result) + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_video_from_url_async assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_audio_from_url_async(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing audio from URL (async version). + + This test validates: + 1. Audio analysis using begin_analyze with URL input + 2. Markdown content extraction + 3. Transcript phrases access + 4. Summary field access + + 02_AnalyzeUrl.AnalyzeAudioUrlAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # For testing purposes, use binary data + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_audio.mp3") + + if not os.path.exists(file_path): + pytest.skip(f"Audio test file not found at {file_path}") + + with open(file_path, "rb") as f: + file_data = f.read() + + print(f"[PASS] Audio loaded from: {file_path}") + + # Analyze the audio + poller = await client.begin_analyze( + analyzer_id="prebuilt-audioSearch", inputs=[AnalyzeInput(data=file_data)] + ) + + result = await poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should contain at least one content" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Test audio properties including transcript phrases + self._test_audio_properties(result) + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_audio_from_url_async assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_image_from_url_async(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing an image from URL (async version). + + This test validates: + 1. Image analysis using begin_analyze with URL input + 2. Markdown content extraction + 3. Summary field access + + 02_AnalyzeUrl.AnalyzeImageUrlAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # For testing purposes, use binary data + tests_dir = os.path.dirname(os.path.dirname(__file__)) + file_path = os.path.join(tests_dir, "test_data", "sample_image.jpg") + + if not os.path.exists(file_path): + pytest.skip(f"Image test file not found at {file_path}") + + with open(file_path, "rb") as f: + file_data = f.read() + + print(f"[PASS] Image loaded from: {file_path}") + + # Analyze the image + poller = await client.begin_analyze( + analyzer_id="prebuilt-imageSearch", inputs=[AnalyzeInput(data=file_data)] + ) + + result = await poller.result() + + # Assertion: Verify analysis operation completed + assert poller is not None, "Analysis operation should not be null" + assert poller.done(), "Operation should be completed" + assert poller.status() == "Succeeded", f"Operation status should be Succeeded, but was {poller.status()}" + print("[PASS] Analysis operation completed successfully") + + # Assertion: Verify result + assert result is not None, "Analysis result should not be null" + assert result.contents is not None, "Result contents should not be null" + assert len(result.contents) > 0, "Result should contain at least one content" + print(f"[PASS] Analysis result contains {len(result.contents)} content(s)") + + # Test image properties + self._test_image_properties(result) + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_image_from_url_async assertions passed") def _test_markdown_extraction(self, result): """Test markdown content extraction.""" @@ -239,3 +400,108 @@ def _validate_tables(self, tables): ) else: print(f"[PASS] Table {i} validated: {table.row_count} rows x {table.column_count} columns") + + def _test_audiovisual_properties(self, result): + """Test audio/visual content properties for video.""" + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Verify markdown + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + print(f"[PASS] Video markdown content extracted ({len(markdown)} characters)") + + # Verify timing properties + start_time = getattr(content, "start_time_ms", None) + if start_time is not None: + assert start_time >= 0, f"Start time should be >= 0, but was {start_time}" + print(f"[PASS] Video start time verified: {start_time} ms") + + end_time = getattr(content, "end_time_ms", None) + if end_time is not None: + assert end_time >= 0, f"End time should be >= 0, but was {end_time}" + print(f"[PASS] Video end time verified: {end_time} ms") + + # Verify frame size + width = getattr(content, "width", None) + height = getattr(content, "height", None) + if width is not None and height is not None: + assert width > 0, f"Video width should be > 0, but was {width}" + assert height > 0, f"Video height should be > 0, but was {height}" + print(f"[PASS] Video frame size verified: {width} x {height}") + + # Verify summary field + fields = getattr(content, "fields", None) + if fields: + summary = fields.get("Summary") + if summary: + print("[PASS] Summary field available in video content") + + print("[PASS] All audio/visual properties validated successfully") + + def _test_audio_properties(self, result): + """Test audio content properties including transcript phrases.""" + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Verify markdown + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + print(f"[PASS] Audio markdown content extracted ({len(markdown)} characters)") + + # Verify timing properties + start_time = getattr(content, "start_time_ms", None) + if start_time is not None: + assert start_time >= 0, f"Start time should be >= 0, but was {start_time}" + print(f"[PASS] Audio start time verified: {start_time} ms") + + # Verify summary field + fields = getattr(content, "fields", None) + if fields: + summary = fields.get("Summary") + if summary: + print("[PASS] Summary field available in audio content") + + # Verify transcript phrases + transcript_phrases = getattr(content, "transcript_phrases", None) + if transcript_phrases and len(transcript_phrases) > 0: + print(f"[PASS] Transcript phrases found: {len(transcript_phrases)} phrases") + for phrase in transcript_phrases[:2]: + speaker = getattr(phrase, "speaker", None) + text = getattr(phrase, "text", None) + start_ms = getattr(phrase, "start_time_ms", None) + if speaker and text: + print(f" [{speaker}] {start_ms} ms: {text}") + else: + print("[WARN] No transcript phrases available") + + print("[PASS] All audio properties validated successfully") + + def _test_image_properties(self, result): + """Test image content properties.""" + content = result.contents[0] + assert content is not None, "Content should not be null" + + # Verify markdown + markdown = getattr(content, "markdown", None) + if markdown: + assert isinstance(markdown, str), "Markdown should be a string" + assert len(markdown) > 0, "Markdown content should not be empty" + print(f"[PASS] Image markdown content extracted ({len(markdown)} characters)") + + # Verify summary field + fields = getattr(content, "fields", None) + if fields: + summary = fields.get("Summary") + if summary and hasattr(summary, "value"): + summary_value = summary.value + if summary_value: + assert isinstance(summary_value, str), "Summary should be a string" + assert len(summary_value) > 0, "Summary should not be empty" + print(f"[PASS] Image summary verified ({len(summary_value)} characters)") + + print("[PASS] All image properties validated successfully") From dd786e17a480caaa6178a8d6e53087da13842af9 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 18:40:05 -0800 Subject: [PATCH 084/105] [SAMPLE-UPDATE] sample_analyze_invoice --- .../sample_analyze_invoice_async.py | 17 ++++------------- .../samples/sample_analyze_invoice.py | 17 ++++------------- 2 files changed, 8 insertions(+), 26 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index eed81efc4814..5324bfd4d336 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -49,7 +49,7 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_invoice] - invoice_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/docs/invoice.pdf" + invoice_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" print(f"Analyzing invoice with prebuilt-invoice analyzer...") print(f" URL: {invoice_url}") @@ -134,28 +134,19 @@ async def main() -> None: item_dict: dict[str, ContentField] = item.value # type: ignore description_field = item_dict.get("Description") quantity_field = item_dict.get("Quantity") - # Try UnitPrice first, then Amount (matching .NET sample pattern) unit_price_field = item_dict.get("UnitPrice") - amount_field = item_dict.get("Amount") - description = description_field.value if description_field else "(no description)" + description = description_field.value if description_field else "N/A" quantity = quantity_field.value if quantity_field else "N/A" - # Display price information - prefer UnitPrice if available, otherwise Amount - # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) - price_info = "" + print(f" Item {i}: {description} (Qty: {quantity})") if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore unit_price_amount_field = unit_price_obj.get("Amount") unit_price_currency_field = unit_price_obj.get("CurrencyCode") if unit_price_amount_field and unit_price_amount_field.value is not None: currency = unit_price_currency_field.value if unit_price_currency_field else "" - price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() - elif amount_field and amount_field.value is not None: - price_info = f"Amount: {amount_field.value}" - - print(f" {i}. {description}") - print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) + print(f" Unit Price: {unit_price_amount_field.value} {currency}".strip()) # [END extract_invoice_fields] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index baae65838585..1d09aa6c87a6 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -50,7 +50,7 @@ def main() -> None: # [START analyze_invoice] invoice_url = ( - "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/docs/invoice.pdf" + "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" ) print(f"Analyzing invoice with prebuilt-invoice analyzer...") @@ -136,28 +136,19 @@ def main() -> None: item_dict: dict[str, ContentField] = item.value # type: ignore description_field = item_dict.get("Description") quantity_field = item_dict.get("Quantity") - # Try UnitPrice first, then Amount (matching .NET sample pattern) unit_price_field = item_dict.get("UnitPrice") - amount_field = item_dict.get("Amount") - description = description_field.value if description_field else "(no description)" + description = description_field.value if description_field else "N/A" quantity = quantity_field.value if quantity_field else "N/A" - # Display price information - prefer UnitPrice if available, otherwise Amount - # UnitPrice is an ObjectField with Amount and CurrencyCode sub-fields (like TotalAmount) - price_info = "" + print(f" Item {i}: {description} (Qty: {quantity})") if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore unit_price_amount_field = unit_price_obj.get("Amount") unit_price_currency_field = unit_price_obj.get("CurrencyCode") if unit_price_amount_field and unit_price_amount_field.value is not None: currency = unit_price_currency_field.value if unit_price_currency_field else "" - price_info = f"Unit Price: {unit_price_amount_field.value} {currency}".strip() - elif amount_field and amount_field.value is not None: - price_info = f"Amount: {amount_field.value}" - - print(f" {i}. {description}") - print(f" Quantity: {quantity}" + (f", {price_info}" if price_info else "")) + print(f" Unit Price: {unit_price_amount_field.value} {currency}".strip()) # [END extract_invoice_fields] From 0aa5cc07968ed2a39310def1332986be0be41b57 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 19:17:08 -0800 Subject: [PATCH 085/105] [SAMPLE-UPDATE] sample_analyze_invoice --- .../sample_analyze_invoice_async.py | 109 ++++++++---------- .../samples/sample_analyze_invoice.py | 109 ++++++++---------- .../samples/test_sample_analyze_invoice.py | 42 ++++--- .../test_sample_analyze_invoice_async.py | 42 ++++--- 4 files changed, 157 insertions(+), 145 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index 5324bfd4d336..0149dedff5f3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -8,9 +8,18 @@ FILE: sample_analyze_invoice_async.py DESCRIPTION: - About extracting structured invoice fields: - This sample demonstrates how to analyze an invoice from a URL using the prebuilt-invoice - analyzer and extract structured fields (customer name, line items, totals, etc.) from the result. + Analyze an invoice using prebuilt analyzer (async version) + + This sample demonstrates how to analyze an invoice from a URL using the `prebuilt-invoice` analyzer + and extract structured fields from the result. The prebuilt-invoice analyzer automatically extracts + structured fields including: + - Customer/Vendor information: Name, address, contact details + - Invoice metadata: Invoice number, date, due date, purchase order number + - Line items: Description, quantity, unit price, total for each item + - Financial totals: Subtotal, tax amount, shipping charges, total amount + - Payment information: Payment terms, payment method, remittance address + + The analyzer works out of the box with various invoice formats and requires no configuration. USAGE: python sample_analyze_invoice_async.py @@ -20,7 +29,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import asyncio @@ -49,10 +58,11 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_invoice] + # You can replace this URL with your own invoice file URL invoice_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" - print(f"Analyzing invoice with prebuilt-invoice analyzer...") - print(f" URL: {invoice_url}") + print("Analyzing invoice with prebuilt-invoice analyzer...") + print(f" URL: {invoice_url}\n") poller = await client.begin_analyze( analyzer_id="prebuilt-invoice", @@ -71,8 +81,14 @@ async def main() -> None: # Print document unit information # The unit indicates the measurement system used for coordinates in the source field - print(f"\nDocument unit: {document_content.unit or 'unknown'}") + print(f"Document unit: {document_content.unit or 'unknown'}") print(f"Pages: {document_content.start_page_number} to {document_content.end_page_number}") + + # Print page dimensions if available + if document_content.pages and len(document_content.pages) > 0: + page = document_content.pages[0] + unit = document_content.unit or "units" + print(f"Page dimensions: {page.width} x {page.height} {unit}") print() if not document_content.fields: @@ -81,76 +97,51 @@ async def main() -> None: # Extract simple string fields customer_name_field = document_content.fields.get("CustomerName") - invoice_date_field = document_content.fields.get("InvoiceDate") - - customer_name = customer_name_field.value if customer_name_field else None - invoice_date = invoice_date_field.value if invoice_date_field else None - - print(f"Customer Name: {customer_name or '(None)'}") + print(f"Customer Name: {customer_name_field.value or '(None)' if customer_name_field else '(None)'}") if customer_name_field: - print( - f" Confidence: {customer_name_field.confidence:.2f}" - if customer_name_field.confidence - else " Confidence: N/A" - ) - # Source is an encoded identifier containing bounding box coordinates - # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) + print(f" Confidence: {customer_name_field.confidence:.2f}" if customer_name_field.confidence else " Confidence: N/A") print(f" Source: {customer_name_field.source or 'N/A'}") if customer_name_field.spans and len(customer_name_field.spans) > 0: span = customer_name_field.spans[0] print(f" Position in markdown: offset={span.offset}, length={span.length}") - print(f"Invoice Date: {invoice_date or '(None)'}") + # Extract simple date field + invoice_date_field = document_content.fields.get("InvoiceDate") + print(f"Invoice Date: {invoice_date_field.value or '(None)' if invoice_date_field else '(None)'}") if invoice_date_field: - print( - f" Confidence: {invoice_date_field.confidence:.2f}" - if invoice_date_field.confidence - else " Confidence: N/A" - ) + print(f" Confidence: {invoice_date_field.confidence:.2f}" if invoice_date_field.confidence else " Confidence: N/A") + print(f" Source: {invoice_date_field.source or 'N/A'}") + if invoice_date_field.spans and len(invoice_date_field.spans) > 0: + span = invoice_date_field.spans[0] + print(f" Position in markdown: offset={span.offset}, length={span.length}") - # Extract object field (TotalAmount contains Amount and CurrencyCode) + # Extract object fields (nested structures) total_amount_field = document_content.fields.get("TotalAmount") - if total_amount_field and total_amount_field.value: - total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore - amount_field = total_amount_obj.get("Amount") - currency_field = total_amount_obj.get("CurrencyCode") - + if isinstance(total_amount_field, ObjectField) and total_amount_field.value: + amount_field = total_amount_field.value.get("Amount") + currency_field = total_amount_field.value.get("CurrencyCode") amount = amount_field.value if amount_field else None - currency = currency_field.value if currency_field else None + currency = currency_field.value if currency_field else "$" + print(f"\nTotal: {currency}{amount:.2f}" if isinstance(amount, (int, float)) else f"\nTotal: {currency}{amount}") + print(f" Confidence: {total_amount_field.confidence:.2f}" if total_amount_field.confidence else " Confidence: N/A") + print(f" Source: {total_amount_field.source or 'N/A'}") - print(f"\nTotal Amount: {amount} {currency}") - if total_amount_field.confidence: - print(f" Confidence: {total_amount_field.confidence:.2f}") - - # Extract array field (LineItems - line items) - # Note: The field name is "LineItems" (not "Items") to match the service response + # Extract array fields (collections like line items) line_items_field = document_content.fields.get("LineItems") - if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: - items_array: list = line_items_field.value # type: ignore - print(f"\nLine Items ({len(items_array)}):") - for i, item in enumerate(items_array, 1): - # Each item in the array is a ContentField (ObjectField for line items) + if isinstance(line_items_field, ArrayField) and line_items_field.value: + print(f"\nLine Items ({len(line_items_field.value)}):") + for i, item in enumerate(line_items_field.value, 1): if isinstance(item, ObjectField) and item.value: - item_dict: dict[str, ContentField] = item.value # type: ignore - description_field = item_dict.get("Description") - quantity_field = item_dict.get("Quantity") - unit_price_field = item_dict.get("UnitPrice") - + description_field = item.value.get("Description") + quantity_field = item.value.get("Quantity") description = description_field.value if description_field else "N/A" quantity = quantity_field.value if quantity_field else "N/A" - print(f" Item {i}: {description} (Qty: {quantity})") - if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: - unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore - unit_price_amount_field = unit_price_obj.get("Amount") - unit_price_currency_field = unit_price_obj.get("CurrencyCode") - if unit_price_amount_field and unit_price_amount_field.value is not None: - currency = unit_price_currency_field.value if unit_price_currency_field else "" - print(f" Unit Price: {unit_price_amount_field.value} {currency}".strip()) + print(f" Confidence: {item.confidence:.2f}" if item.confidence else " Confidence: N/A") # [END extract_invoice_fields] - if not isinstance(credential, AzureKeyCredential): - await credential.close() + if not isinstance(credential, AzureKeyCredential): + await credential.close() if __name__ == "__main__": diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index 1d09aa6c87a6..61b9ea610572 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -8,9 +8,18 @@ FILE: sample_analyze_invoice.py DESCRIPTION: - About extracting structured invoice fields: - This sample demonstrates how to analyze an invoice from a URL using the prebuilt-invoice - analyzer and extract structured fields (customer name, line items, totals, etc.) from the result. + Analyze an invoice using prebuilt analyzer + + This sample demonstrates how to analyze an invoice from a URL using the `prebuilt-invoice` analyzer + and extract structured fields from the result. The prebuilt-invoice analyzer automatically extracts + structured fields including: + - Customer/Vendor information: Name, address, contact details + - Invoice metadata: Invoice number, date, due date, purchase order number + - Line items: Description, quantity, unit price, total for each item + - Financial totals: Subtotal, tax amount, shipping charges, total amount + - Payment information: Payment terms, payment method, remittance address + + The analyzer works out of the box with various invoice formats and requires no configuration. USAGE: python sample_analyze_invoice.py @@ -20,7 +29,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import os @@ -49,12 +58,11 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_invoice] - invoice_url = ( - "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" - ) + # You can replace this URL with your own invoice file URL + invoice_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" - print(f"Analyzing invoice with prebuilt-invoice analyzer...") - print(f" URL: {invoice_url}") + print("Analyzing invoice with prebuilt-invoice analyzer...") + print(f" URL: {invoice_url}\n") poller = client.begin_analyze( analyzer_id="prebuilt-invoice", @@ -73,8 +81,14 @@ def main() -> None: # Print document unit information # The unit indicates the measurement system used for coordinates in the source field - print(f"\nDocument unit: {document_content.unit or 'unknown'}") + print(f"Document unit: {document_content.unit or 'unknown'}") print(f"Pages: {document_content.start_page_number} to {document_content.end_page_number}") + + # Print page dimensions if available + if document_content.pages and len(document_content.pages) > 0: + page = document_content.pages[0] + unit = document_content.unit or "units" + print(f"Page dimensions: {page.width} x {page.height} {unit}") print() if not document_content.fields: @@ -83,72 +97,47 @@ def main() -> None: # Extract simple string fields customer_name_field = document_content.fields.get("CustomerName") - invoice_date_field = document_content.fields.get("InvoiceDate") - - customer_name = customer_name_field.value if customer_name_field else None - invoice_date = invoice_date_field.value if invoice_date_field else None - - print(f"Customer Name: {customer_name or '(None)'}") + print(f"Customer Name: {customer_name_field.value or '(None)' if customer_name_field else '(None)'}") if customer_name_field: - print( - f" Confidence: {customer_name_field.confidence:.2f}" - if customer_name_field.confidence - else " Confidence: N/A" - ) - # Source is an encoded identifier containing bounding box coordinates - # Format: D(pageNumber, x1, y1, x2, y2, x3, y3, x4, y4) + print(f" Confidence: {customer_name_field.confidence:.2f}" if customer_name_field.confidence else " Confidence: N/A") print(f" Source: {customer_name_field.source or 'N/A'}") if customer_name_field.spans and len(customer_name_field.spans) > 0: span = customer_name_field.spans[0] print(f" Position in markdown: offset={span.offset}, length={span.length}") - print(f"Invoice Date: {invoice_date or '(None)'}") + # Extract simple date field + invoice_date_field = document_content.fields.get("InvoiceDate") + print(f"Invoice Date: {invoice_date_field.value or '(None)' if invoice_date_field else '(None)'}") if invoice_date_field: - print( - f" Confidence: {invoice_date_field.confidence:.2f}" - if invoice_date_field.confidence - else " Confidence: N/A" - ) + print(f" Confidence: {invoice_date_field.confidence:.2f}" if invoice_date_field.confidence else " Confidence: N/A") + print(f" Source: {invoice_date_field.source or 'N/A'}") + if invoice_date_field.spans and len(invoice_date_field.spans) > 0: + span = invoice_date_field.spans[0] + print(f" Position in markdown: offset={span.offset}, length={span.length}") - # Extract object field (TotalAmount contains Amount and CurrencyCode) + # Extract object fields (nested structures) total_amount_field = document_content.fields.get("TotalAmount") - if total_amount_field and total_amount_field.value: - total_amount_obj: dict[str, ContentField] = total_amount_field.value # type: ignore - amount_field = total_amount_obj.get("Amount") - currency_field = total_amount_obj.get("CurrencyCode") - + if isinstance(total_amount_field, ObjectField) and total_amount_field.value: + amount_field = total_amount_field.value.get("Amount") + currency_field = total_amount_field.value.get("CurrencyCode") amount = amount_field.value if amount_field else None - currency = currency_field.value if currency_field else None + currency = currency_field.value if currency_field else "$" + print(f"\nTotal: {currency}{amount:.2f}" if isinstance(amount, (int, float)) else f"\nTotal: {currency}{amount}") + print(f" Confidence: {total_amount_field.confidence:.2f}" if total_amount_field.confidence else " Confidence: N/A") + print(f" Source: {total_amount_field.source or 'N/A'}") - print(f"\nTotal Amount: {amount} {currency}") - if total_amount_field.confidence: - print(f" Confidence: {total_amount_field.confidence:.2f}") - - # Extract array field (LineItems - line items) - # Note: The field name is "LineItems" (not "Items") to match the service response + # Extract array fields (collections like line items) line_items_field = document_content.fields.get("LineItems") - if line_items_field and isinstance(line_items_field, ArrayField) and line_items_field.value: - items_array: list = line_items_field.value # type: ignore - print(f"\nLine Items ({len(items_array)}):") - for i, item in enumerate(items_array, 1): - # Each item in the array is a ContentField (ObjectField for line items) + if isinstance(line_items_field, ArrayField) and line_items_field.value: + print(f"\nLine Items ({len(line_items_field.value)}):") + for i, item in enumerate(line_items_field.value, 1): if isinstance(item, ObjectField) and item.value: - item_dict: dict[str, ContentField] = item.value # type: ignore - description_field = item_dict.get("Description") - quantity_field = item_dict.get("Quantity") - unit_price_field = item_dict.get("UnitPrice") - + description_field = item.value.get("Description") + quantity_field = item.value.get("Quantity") description = description_field.value if description_field else "N/A" quantity = quantity_field.value if quantity_field else "N/A" - print(f" Item {i}: {description} (Qty: {quantity})") - if unit_price_field and isinstance(unit_price_field, ObjectField) and unit_price_field.value: - unit_price_obj: dict[str, ContentField] = unit_price_field.value # type: ignore - unit_price_amount_field = unit_price_obj.get("Amount") - unit_price_currency_field = unit_price_obj.get("CurrencyCode") - if unit_price_amount_field and unit_price_amount_field.value is not None: - currency = unit_price_currency_field.value if unit_price_currency_field else "" - print(f" Unit Price: {unit_price_amount_field.value} {currency}".strip()) + print(f" Confidence: {item.confidence:.2f}" if item.confidence else " Confidence: N/A") # [END extract_invoice_fields] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py index 4a1dd1fd6da7..2ffad9aa239b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py @@ -37,8 +37,6 @@ def test_sample_analyze_invoice(self, azure_content_understanding_endpoint: str, 1. Analyzing an invoice using prebuilt-invoice analyzer 2. Extracting invoice-specific fields (CustomerName, InvoiceDate, TotalAmount, LineItems) 3. Field confidence scores and source locations - - 03_AnalyzeInvoice.AnalyzeInvoiceAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) @@ -106,6 +104,16 @@ def test_sample_analyze_invoice(self, azure_content_understanding_endpoint: str, else: print("[INFO] Document unit: unknown") + # Print page dimensions if available + pages = getattr(document_content, "pages", None) + if pages and len(pages) > 0: + page = pages[0] + width = getattr(page, "width", None) + height = getattr(page, "height", None) + if width is not None and height is not None: + unit_str = unit or "units" + print(f"[INFO] Page dimensions: {width} x {height} {unit_str}") + # Extract and verify fields fields = getattr(document_content, "fields", {}) @@ -167,22 +175,24 @@ def test_sample_analyze_invoice(self, azure_content_understanding_endpoint: str, if hasattr(total_amount_field, "value") and isinstance(total_amount_field.value, dict): amount_obj = total_amount_field.value amount = amount_obj.get("Amount") - currency = amount_obj.get("CurrencyCode", "$") + currency = amount_obj.get("CurrencyCode") if amount: + amount_value = amount.value if hasattr(amount, "value") else amount + currency_value = currency.value if hasattr(currency, "value") else (currency or "$") print( - f"[INFO] Total: {currency}{amount:.2f}" - if isinstance(amount, (int, float)) - else f"[INFO] Total: {currency}{amount}" + f"[INFO] Total: {currency_value}{amount_value:.2f}" + if isinstance(amount_value, (int, float)) + else f"[INFO] Total: {currency_value}{amount_value}" ) - else: - value = getattr(total_amount_field, "value", None) - if value: - print(f"[INFO] Total Amount: {value}") confidence = getattr(total_amount_field, "confidence", None) if confidence is not None: print(f"[INFO] TotalAmount confidence: {confidence:.2f}") + + source = getattr(total_amount_field, "source", None) + if source: + print(f"[INFO] TotalAmount source: {source}") else: print("[INFO] TotalAmount field not found in this document") @@ -198,9 +208,15 @@ def test_sample_analyze_invoice(self, azure_content_understanding_endpoint: str, for i, item in enumerate(items[:5]): # Show first 5 items if isinstance(item, dict): - description = item.get("Description", "N/A") - quantity = item.get("Quantity", "N/A") - print(f"[INFO] Item {i + 1}: {description} (Qty: {quantity})") + description = item.get("Description") + quantity = item.get("Quantity") + description_value = description.value if hasattr(description, "value") else description + quantity_value = quantity.value if hasattr(quantity, "value") else quantity + print(f"[INFO] Item {i + 1}: {description_value or 'N/A'} (Qty: {quantity_value or 'N/A'})") + + confidence = getattr(item, "confidence", None) + if confidence is not None: + print(f"[INFO] Confidence: {confidence:.2f}") if len(items) > 5: print(f"[INFO] ... and {len(items) - 5} more items") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py index bac768283778..8c828cf695d8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py @@ -37,8 +37,6 @@ async def test_sample_analyze_invoice_async(self, azure_content_understanding_en 1. Analyzing an invoice using prebuilt-invoice analyzer 2. Extracting invoice-specific fields (CustomerName, InvoiceDate, TotalAmount, LineItems) 3. Field confidence scores and source locations - - 03_AnalyzeInvoice.AnalyzeInvoiceAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) @@ -106,6 +104,16 @@ async def test_sample_analyze_invoice_async(self, azure_content_understanding_en else: print("[INFO] Document unit: unknown") + # Print page dimensions if available + pages = getattr(document_content, "pages", None) + if pages and len(pages) > 0: + page = pages[0] + width = getattr(page, "width", None) + height = getattr(page, "height", None) + if width is not None and height is not None: + unit_str = unit or "units" + print(f"[INFO] Page dimensions: {width} x {height} {unit_str}") + # Extract and verify fields fields = getattr(document_content, "fields", {}) @@ -167,22 +175,24 @@ async def test_sample_analyze_invoice_async(self, azure_content_understanding_en if hasattr(total_amount_field, "value") and isinstance(total_amount_field.value, dict): amount_obj = total_amount_field.value amount = amount_obj.get("Amount") - currency = amount_obj.get("CurrencyCode", "$") + currency = amount_obj.get("CurrencyCode") if amount: + amount_value = amount.value if hasattr(amount, "value") else amount + currency_value = currency.value if hasattr(currency, "value") else (currency or "$") print( - f"[INFO] Total: {currency}{amount:.2f}" - if isinstance(amount, (int, float)) - else f"[INFO] Total: {currency}{amount}" + f"[INFO] Total: {currency_value}{amount_value:.2f}" + if isinstance(amount_value, (int, float)) + else f"[INFO] Total: {currency_value}{amount_value}" ) - else: - value = getattr(total_amount_field, "value", None) - if value: - print(f"[INFO] Total Amount: {value}") confidence = getattr(total_amount_field, "confidence", None) if confidence is not None: print(f"[INFO] TotalAmount confidence: {confidence:.2f}") + + source = getattr(total_amount_field, "source", None) + if source: + print(f"[INFO] TotalAmount source: {source}") else: print("[INFO] TotalAmount field not found in this document") @@ -198,9 +208,15 @@ async def test_sample_analyze_invoice_async(self, azure_content_understanding_en for i, item in enumerate(items[:5]): # Show first 5 items if isinstance(item, dict): - description = item.get("Description", "N/A") - quantity = item.get("Quantity", "N/A") - print(f"[INFO] Item {i + 1}: {description} (Qty: {quantity})") + description = item.get("Description") + quantity = item.get("Quantity") + description_value = description.value if hasattr(description, "value") else description + quantity_value = quantity.value if hasattr(quantity, "value") else quantity + print(f"[INFO] Item {i + 1}: {description_value or 'N/A'} (Qty: {quantity_value or 'N/A'})") + + confidence = getattr(item, "confidence", None) + if confidence is not None: + print(f"[INFO] Confidence: {confidence:.2f}") if len(items) > 5: print(f"[INFO] ... and {len(items) - 5} more items") From 8bdf14ea0b79fe8229b20113ea4943a0579780fd Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 19:23:17 -0800 Subject: [PATCH 086/105] [SAMPLE-UPDATE] update terms for sample_update_defaults --- .../azure-ai-contentunderstanding/README.md | 6 +++--- .../samples/README.md | 14 +++++++------- .../async_samples/sample_analyze_binary_async.py | 2 +- .../async_samples/sample_analyze_configs_async.py | 2 +- .../sample_analyze_return_raw_json_async.py | 2 +- .../async_samples/sample_analyze_url_async.py | 2 +- .../async_samples/sample_create_analyzer_async.py | 2 +- .../sample_create_classifier_async.py | 2 +- .../async_samples/sample_delete_result_async.py | 2 +- .../async_samples/sample_get_result_file_async.py | 2 +- .../samples/sample_analyze_binary.py | 2 +- .../samples/sample_analyze_configs.py | 2 +- .../samples/sample_analyze_return_raw_json.py | 2 +- .../samples/sample_analyze_url.py | 2 +- .../samples/sample_create_analyzer.py | 2 +- .../samples/sample_create_classifier.py | 2 +- .../samples/sample_delete_result.py | 2 +- .../samples/sample_get_result_file.py | 2 +- 18 files changed, 26 insertions(+), 26 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index d8439587513a..999f684ce64a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -545,19 +545,19 @@ After setting the environment variables, you can run the code examples shown in **Alternatively, use the prepared sample script:** -For a complete, ready-to-use example, see `sample_configure_defaults.py` in the [samples directory][sample_readme]. This sample includes error handling and additional features: +For a complete, ready-to-use example, see `sample_update_defaults.py` in the [samples directory][sample_readme]. This sample includes error handling and additional features: ```bash # Navigate to samples directory cd samples # Run the prepared sample -python sample_configure_defaults.py +python sample_update_defaults.py ``` For async version: ```bash -python async_samples/sample_configure_defaults_async.py +python async_samples/sample_update_defaults_async.py ``` For comprehensive documentation on all available samples, see the [samples README][sample_readme]. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index 7754ab349cd2..b470a693d25b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -20,7 +20,7 @@ These code samples demonstrate common scenarios with the Azure AI Content Unders * Python 3.9 or later is required to use this package * You need an [Azure subscription][azure_sub] and a [Microsoft Foundry resource][contentunderstanding_quickstart] to use this package. * The Microsoft Foundry resource must be created in a [supported region][contentunderstanding_regions]. -* **Required setup:** GPT-4.1, GPT-4.1-mini, and text-embedding-3-large models must be deployed in your Microsoft Foundry project and configured using `sample_configure_defaults.py` before using prebuilt analyzers. +* **Required setup:** GPT-4.1, GPT-4.1-mini, and text-embedding-3-large models must be deployed in your Microsoft Foundry project and configured using `sample_update_defaults.py` before using prebuilt analyzers. ## Setup @@ -44,7 +44,7 @@ cp ../env.sample .env # Edit .env with your credentials # 5. Configure model deployments (required for prebuilt analyzers) -python sample_configure_defaults.py +python sample_update_defaults.py # 6. Run a sync sample python sample_analyze_url.py @@ -104,9 +104,9 @@ cp ../env.sample .env Set the following in `.env`: * `AZURE_CONTENT_UNDERSTANDING_ENDPOINT` (required) - Your Microsoft Foundry resource endpoint * `AZURE_CONTENT_UNDERSTANDING_KEY` (optional) - Your API key. If not set, `DefaultAzureCredential` will be used. -* `GPT_4_1_DEPLOYMENT` (required for sample_configure_defaults.py) - Your GPT-4.1 deployment name in Microsoft Foundry -* `GPT_4_1_MINI_DEPLOYMENT` (required for sample_configure_defaults.py) - Your GPT-4.1-mini deployment name in Microsoft Foundry -* `TEXT_EMBEDDING_3_LARGE_DEPLOYMENT` (required for sample_configure_defaults.py) - Your text-embedding-3-large deployment name in Microsoft Foundry +* `GPT_4_1_DEPLOYMENT` (required for sample_update_defaults.py) - Your GPT-4.1 deployment name in Microsoft Foundry +* `GPT_4_1_MINI_DEPLOYMENT` (required for sample_update_defaults.py) - Your GPT-4.1-mini deployment name in Microsoft Foundry +* `TEXT_EMBEDDING_3_LARGE_DEPLOYMENT` (required for sample_update_defaults.py) - Your text-embedding-3-large deployment name in Microsoft Foundry **Example `.env` file:** ```bash @@ -188,7 +188,7 @@ python sample_analyze_binary_async.py ### Sample 00: Configure Defaults -#### `sample_configure_defaults.py` / `sample_configure_defaults_async.py` +#### `sample_update_defaults.py` / `sample_update_defaults_async.py` **Required setup!** Configures and retrieves default model deployment settings for your Content Understanding resource. This is a one-time setup before using prebuilt analyzers. **Key concepts:** @@ -453,7 +453,7 @@ pip install -e . --force-reinstall ```bash source .venv/bin/activate cd samples -python sample_configure_defaults.py + python sample_update_defaults.py ``` This configures the required GPT-4.1, GPT-4.1-mini, and text-embedding-3-large model deployments that prebuilt analyzers depend on. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py index 07aa6fd3461c..e5f245695056 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py @@ -35,7 +35,7 @@ 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - See sample_configure_defaults_async.py for model deployment setup guidance. + See sample_update_defaults_async.py for model deployment setup guidance. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index dcc691e7ebf8..1e4cf363f127 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -39,7 +39,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py index 88157cb32061..df3316c7f0f2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py @@ -37,7 +37,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py index 4270bb2ad006..637cc0bd9c59 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py @@ -29,7 +29,7 @@ 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - See sample_configure_defaults_async.py for model deployment setup guidance. + See sample_update_defaults_async.py for model deployment setup guidance. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py index 771d33685813..d99929323ec0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py @@ -29,7 +29,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using custom analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index c09ba229c4b8..5d2da84979bf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -25,7 +25,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using classifiers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py index c24dc4355ffe..abf4fb5ee76a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py @@ -28,7 +28,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py index b2ab4407dd96..d71e3d466df3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py @@ -27,7 +27,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import asyncio diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py index 75d9f489ad72..2386d4d9b634 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py @@ -35,7 +35,7 @@ 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - See sample_configure_defaults.py for model deployment setup guidance. + See sample_update_defaults.py for model deployment setup guidance. """ import os diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index aef1be62832c..8fbd7b64ffb0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -39,7 +39,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import os diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py index 72aeba67bd7f..57a51aad8355 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py @@ -37,7 +37,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import json diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py index f53ed3931183..8f3234e7c6a7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py @@ -29,7 +29,7 @@ 1) AZURE_CONTENT_UNDERSTANDING_ENDPOINT - the endpoint to your Content Understanding resource. 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). - See sample_configure_defaults.py for model deployment setup guidance. + See sample_update_defaults.py for model deployment setup guidance. """ import os diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py index dfed78da4797..205422391e45 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py @@ -29,7 +29,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using custom analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import os diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index 77947ec7f6b7..a9cbf56b5c48 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -25,7 +25,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using classifiers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import os diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index 49224f6452ed..f47647ea890b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -28,7 +28,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import os diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py index 5fe9ceb297a5..bd287e8cb3f8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py @@ -27,7 +27,7 @@ 2) AZURE_CONTENT_UNDERSTANDING_KEY - your Content Understanding API key (optional if using DefaultAzureCredential). Before using prebuilt analyzers, you MUST configure model deployments for your Microsoft Foundry - resource. See sample_configure_defaults.py for setup instructions. + resource. See sample_update_defaults.py for setup instructions. """ import os From 67614b707a168b26b5e273145217fcc86b25b447 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 19:50:13 -0800 Subject: [PATCH 087/105] [SAMPLE-UPDATE] sample_create_analyzer --- .../async_samples/sample_create_analyzer_async.py | 7 ++++++- .../samples/sample_create_analyzer.py | 7 ++++++- .../tests/samples/test_sample_create_analyzer.py | 10 ++++++++-- .../tests/samples/test_sample_create_analyzer_async.py | 10 ++++++++-- 4 files changed, 28 insertions(+), 6 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py index d99929323ec0..c42df525fc1a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py @@ -77,11 +77,13 @@ async def main() -> None: type=ContentFieldType.STRING, method=GenerationMethod.EXTRACT, description="Name of the company", + estimate_source_and_confidence=True, ), "total_amount": ContentFieldDefinition( type=ContentFieldType.NUMBER, method=GenerationMethod.EXTRACT, description="Total amount on the document", + estimate_source_and_confidence=True, ), "document_summary": ContentFieldDefinition( type=ContentFieldType.STRING, @@ -112,7 +114,10 @@ async def main() -> None: description="Custom analyzer for extracting company information", config=config, field_schema=field_schema, - models={"completion": "gpt-4.1"}, # Required when using field_schema + models={ + "completion": "gpt-4.1", + "embedding": "text-embedding-3-large", + }, # Required when using field_schema ) # Create the analyzer diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py index 205422391e45..284c5d01655a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py @@ -77,11 +77,13 @@ def main() -> None: type=ContentFieldType.STRING, method=GenerationMethod.EXTRACT, description="Name of the company", + estimate_source_and_confidence=True, ), "total_amount": ContentFieldDefinition( type=ContentFieldType.NUMBER, method=GenerationMethod.EXTRACT, description="Total amount on the document", + estimate_source_and_confidence=True, ), "document_summary": ContentFieldDefinition( type=ContentFieldType.STRING, @@ -112,7 +114,10 @@ def main() -> None: description="Custom analyzer for extracting company information", config=config, field_schema=field_schema, - models={"completion": "gpt-4.1"}, # Required when using field_schema + models={ + "completion": "gpt-4.1", + "embedding": "text-embedding-3-large", + }, # Required when using field_schema ) # Create the analyzer diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py index 1a924bd14e27..ae9f20dc5a4b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py @@ -64,10 +64,16 @@ def test_sample_create_analyzer(self, azure_content_understanding_endpoint: str) description="Schema for extracting company information", fields={ "company_name": ContentFieldDefinition( - type="string", method="extract", description="Name of the company" + type="string", + method="extract", + description="Name of the company", + estimate_source_and_confidence=True, ), "total_amount": ContentFieldDefinition( - type="number", method="extract", description="Total amount on the document" + type="number", + method="extract", + description="Total amount on the document", + estimate_source_and_confidence=True, ), "document_summary": ContentFieldDefinition( type="string", method="generate", description="A brief summary of the document content" diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py index 307ec9fbb507..0c3b82aee151 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py @@ -64,10 +64,16 @@ async def test_sample_create_analyzer_async(self, azure_content_understanding_en description="Schema for extracting company information", fields={ "company_name": ContentFieldDefinition( - type="string", method="extract", description="Name of the company" + type="string", + method="extract", + description="Name of the company", + estimate_source_and_confidence=True, ), "total_amount": ContentFieldDefinition( - type="number", method="extract", description="Total amount on the document" + type="number", + method="extract", + description="Total amount on the document", + estimate_source_and_confidence=True, ), "document_summary": ContentFieldDefinition( type="string", method="generate", description="A brief summary of the document content" From 31c93de65762b49c58414a5a786a55ddc1efc977 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Thu, 18 Dec 2025 20:00:27 -0800 Subject: [PATCH 088/105] [SAMPLE-UPDATE] sample_create_classifier --- .../sample_create_classifier_async.py | 1 + .../samples/sample_create_classifier.py | 1 + .../samples/test_sample_create_classifier.py | 121 +++++++++++++++++ .../test_sample_create_classifier_async.py | 122 ++++++++++++++++++ 4 files changed, 245 insertions(+) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index 5d2da84979bf..51d602454369 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -132,6 +132,7 @@ async def main() -> None: for segment in document_content.segments: print(f" Category: {segment.category or '(unknown)'}") print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + print(f" Segment ID: {segment.segment_id or '(not available)'}") print() else: print("No segments found (document classified as a single unit).") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index a9cbf56b5c48..c3dece6b01e9 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -132,6 +132,7 @@ def main() -> None: for segment in document_content.segments: print(f" Category: {segment.category or '(unknown)'}") print(f" Pages: {segment.start_page_number}-{segment.end_page_number}") + print(f" Segment ID: {segment.segment_id or '(not available)'}") print() else: print("No segments found (document classified as a single unit).") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py index 6da726eec417..c602d5665ff3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py @@ -19,6 +19,7 @@ pytest test_sample_create_classifier.py """ +import os import pytest import uuid from devtools_testutils import recorded_by_proxy @@ -27,6 +28,7 @@ ContentAnalyzer, ContentAnalyzerConfig, ContentCategoryDefinition, + DocumentContent, ) @@ -132,3 +134,122 @@ def test_sample_create_classifier(self, azure_content_understanding_endpoint: st pytest.skip(f"Classifier creation not available or failed: {error_msg[:100]}") print("\n[SUCCESS] All test_sample_create_classifier assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_analyze_with_classifier(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing a document with a classifier to categorize content into segments. + + This test validates: + 1. Create a classifier with segmentation enabled + 2. Analyze a document with the classifier + 3. Verify segments are returned with category information + + Demonstrates: Analyze documents with segmentation + """ + client = self.create_client(endpoint=azure_content_understanding_endpoint) + + # Generate a unique analyzer ID + analyzer_id = f"test_classifier_{uuid.uuid4().hex[:16]}" + + print(f"[PASS] Classifier ID generated: {analyzer_id}") + + # Define content categories for classification + categories = { + "Loan_Application": ContentCategoryDefinition( + description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." + ), + "Invoice": ContentCategoryDefinition( + description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." + ), + "Bank_Statement": ContentCategoryDefinition( + description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." + ), + } + + # Create analyzer configuration with segmentation enabled + config = ContentAnalyzerConfig( + return_details=True, + enable_segment=True, # Enable automatic segmentation by category + content_categories=categories, + ) + + # Create the classifier analyzer + classifier = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom classifier for financial document categorization", + config=config, + models={"completion": "gpt-4.1"}, + ) + + # Create the classifier + try: + poller = client.begin_create_analyzer(analyzer_id=analyzer_id, resource=classifier) + result = poller.result() + print(f"[PASS] Classifier '{analyzer_id}' created successfully") + + # Analyze a document with the classifier + current_dir = os.path.dirname(os.path.abspath(__file__)) + test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") + file_path = os.path.join(test_data_dir, "mixed_financial_docs.pdf") + + # Check if file exists, if not skip this test + if not os.path.exists(file_path): + print(f"[INFO] Test file not found: {file_path}") + pytest.skip(f"Test data file not available: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + # Analyze the document + analyze_poller = client.begin_analyze_binary( + analyzer_id=analyzer_id, + binary_input=file_bytes, + ) + analyze_result = analyze_poller.result() + + # Assertions for analyze result + assert analyze_result is not None, "Analysis result should not be null" + print("[PASS] Analysis result received") + + assert analyze_result.contents is not None, "Analysis result contents should not be null" + assert len(analyze_result.contents) > 0, "Analysis result should have at least one content" + print(f"[PASS] Analysis result contains {len(analyze_result.contents)} content(s)") + + # Verify document content + document_content = analyze_result.contents[0] + assert isinstance(document_content, DocumentContent), "Content should be of type DocumentContent" + print("[PASS] Content is of type DocumentContent") + + # Verify segments (classification results) + segments = getattr(document_content, "segments", None) + if segments and len(segments) > 0: + print(f"[PASS] Document has {len(segments)} segment(s)") + for idx, segment in enumerate(segments): + category = getattr(segment, "category", None) + start_page = getattr(segment, "start_page_number", None) + end_page = getattr(segment, "end_page_number", None) + segment_id = getattr(segment, "segment_id", None) + + assert category is not None, f"Segment {idx} should have category" + assert start_page is not None, f"Segment {idx} should have start_page_number" + assert end_page is not None, f"Segment {idx} should have end_page_number" + + print(f" Segment {idx}: Category={category}, Pages {start_page}-{end_page}, ID={segment_id}") + print("[PASS] All segments have required properties") + else: + print("[INFO] No segments found (document classified as single unit)") + + # Cleanup + try: + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"[PASS] Cleanup: Classifier '{analyzer_id}' deleted") + except Exception as e: + print(f"[WARN] Cleanup failed: {str(e)}") + + except Exception as e: + error_msg = str(e) + print(f"\n[ERROR] Full error message:\n{error_msg}") + pytest.skip(f"Classifier analysis not available or failed: {error_msg[:100]}") + + print("\n[SUCCESS] All test_sample_analyze_with_classifier assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py index 2f87fb105d5a..14c2736415cc 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py @@ -19,6 +19,7 @@ pytest test_sample_create_classifier_async.py """ +import os import pytest import uuid from devtools_testutils.aio import recorded_by_proxy_async @@ -27,6 +28,7 @@ ContentAnalyzer, ContentAnalyzerConfig, ContentCategoryDefinition, + DocumentContent, ) @@ -133,3 +135,123 @@ async def test_sample_create_classifier_async(self, azure_content_understanding_ await client.close() print("\n[SUCCESS] All test_sample_create_classifier_async assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_analyze_with_classifier_async(self, azure_content_understanding_endpoint: str) -> None: + """Test analyzing a document with a classifier to categorize content into segments (async version). + + This test validates: + 1. Create a classifier with segmentation enabled + 2. Analyze a document with the classifier + 3. Verify segments are returned with category information + + Demonstrates: Analyze documents with segmentation (async) + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Generate a unique analyzer ID + analyzer_id = f"test_classifier_{uuid.uuid4().hex[:16]}" + + print(f"[PASS] Classifier ID generated: {analyzer_id}") + + # Define content categories for classification + categories = { + "Loan_Application": ContentCategoryDefinition( + description="Documents submitted by individuals or businesses to request funding, typically including personal or business details, financial history, loan amount, purpose, and supporting documentation." + ), + "Invoice": ContentCategoryDefinition( + description="Billing documents issued by sellers or service providers to request payment for goods or services, detailing items, prices, taxes, totals, and payment terms." + ), + "Bank_Statement": ContentCategoryDefinition( + description="Official statements issued by banks that summarize account activity over a period, including deposits, withdrawals, fees, and balances." + ), + } + + # Create analyzer configuration with segmentation enabled + config = ContentAnalyzerConfig( + return_details=True, + enable_segment=True, # Enable automatic segmentation by category + content_categories=categories, + ) + + # Create the classifier analyzer + classifier = ContentAnalyzer( + base_analyzer_id="prebuilt-document", + description="Custom classifier for financial document categorization", + config=config, + models={"completion": "gpt-4.1"}, + ) + + # Create the classifier + try: + poller = await client.begin_create_analyzer(analyzer_id=analyzer_id, resource=classifier) + result = await poller.result() + print(f"[PASS] Classifier '{analyzer_id}' created successfully") + + # Analyze a document with the classifier + current_dir = os.path.dirname(os.path.abspath(__file__)) + test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") + file_path = os.path.join(test_data_dir, "mixed_financial_docs.pdf") + + # Check if file exists, if not skip this test + if not os.path.exists(file_path): + print(f"[INFO] Test file not found: {file_path}") + pytest.skip(f"Test data file not available: {file_path}") + + with open(file_path, "rb") as f: + file_bytes = f.read() + + # Analyze the document + analyze_poller = await client.begin_analyze_binary( + analyzer_id=analyzer_id, + binary_input=file_bytes, + ) + analyze_result = await analyze_poller.result() + + # Assertions for analyze result + assert analyze_result is not None, "Analysis result should not be null" + print("[PASS] Analysis result received") + + assert analyze_result.contents is not None, "Analysis result contents should not be null" + assert len(analyze_result.contents) > 0, "Analysis result should have at least one content" + print(f"[PASS] Analysis result contains {len(analyze_result.contents)} content(s)") + + # Verify document content + document_content = analyze_result.contents[0] + assert isinstance(document_content, DocumentContent), "Content should be of type DocumentContent" + print("[PASS] Content is of type DocumentContent") + + # Verify segments (classification results) + segments = getattr(document_content, "segments", None) + if segments and len(segments) > 0: + print(f"[PASS] Document has {len(segments)} segment(s)") + for idx, segment in enumerate(segments): + category = getattr(segment, "category", None) + start_page = getattr(segment, "start_page_number", None) + end_page = getattr(segment, "end_page_number", None) + segment_id = getattr(segment, "segment_id", None) + + assert category is not None, f"Segment {idx} should have category" + assert start_page is not None, f"Segment {idx} should have start_page_number" + assert end_page is not None, f"Segment {idx} should have end_page_number" + + print(f" Segment {idx}: Category={category}, Pages {start_page}-{end_page}, ID={segment_id}") + print("[PASS] All segments have required properties") + else: + print("[INFO] No segments found (document classified as single unit)") + + # Cleanup + try: + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"[PASS] Cleanup: Classifier '{analyzer_id}' deleted") + except Exception as e: + print(f"[WARN] Cleanup failed: {str(e)}") + + except Exception as e: + error_msg = str(e) + print(f"\n[ERROR] Full error message:\n{error_msg}") + pytest.skip(f"Classifier analysis not available or failed: {error_msg[:100]}") + + await client.close() + print("\n[SUCCESS] All test_sample_analyze_with_classifier_async assertions passed") From 1b752b6dcef6e476558060d30e1cf62b3f45f949 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 19 Dec 2025 12:06:16 -0800 Subject: [PATCH 089/105] [SAMPLE-UPDATE] sample_get_analyzer --- .../sample_get_analyzer_async.py | 67 ++++++++++------ .../samples/sample_get_analyzer.py | 67 ++++++++++------ .../tests/samples/test_sample_get_analyzer.py | 75 ++++++++++++++++-- .../samples/test_sample_get_analyzer_async.py | 77 +++++++++++++++++-- 4 files changed, 226 insertions(+), 60 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py index bd716baec568..9e97f7c35895 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py @@ -79,37 +79,53 @@ async def main() -> None: print("=" * 80) # [END get_prebuilt_analyzer] + # [START get_prebuilt_invoice] + print("\nRetrieving prebuilt-invoice analyzer...") + invoice_analyzer = await client.get_analyzer(analyzer_id="prebuilt-invoice") + + # Display full analyzer JSON for prebuilt-invoice + print("\n" + "=" * 80) + print("Prebuilt-invoice Analyzer (Raw JSON):") + print("=" * 80) + invoice_json = json.dumps(invoice_analyzer.as_dict(), indent=2, default=str) + print(invoice_json) + print("=" * 80) + # [END get_prebuilt_invoice] + # [START get_custom_analyzer] # First, create a custom analyzer analyzer_id = f"my_custom_analyzer_{int(time.time())}" print(f"\nCreating custom analyzer '{analyzer_id}'...") + # Define field schema with custom fields field_schema = ContentFieldSchema( - name="company_schema", - description="Schema for extracting company information", + name="test_schema", + description="Test schema for GetAnalyzer sample", fields={ "company_name": ContentFieldDefinition( type=ContentFieldType.STRING, method=GenerationMethod.EXTRACT, description="Name of the company", ), - "total_amount": ContentFieldDefinition( - type=ContentFieldType.NUMBER, - method=GenerationMethod.EXTRACT, - description="Total amount on the document", - ), }, ) + # Create analyzer configuration + config = ContentAnalyzerConfig( + return_details=True + ) + + # Create the custom analyzer custom_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", - description="Custom analyzer for extracting company information", - config=ContentAnalyzerConfig(return_details=True), + description="Test analyzer for GetAnalyzer sample", + config=config, field_schema=field_schema, models={"completion": "gpt-4.1"}, ) + # Create the analyzer poller = await client.begin_create_analyzer( analyzer_id=analyzer_id, resource=custom_analyzer, @@ -117,22 +133,23 @@ async def main() -> None: await poller.result() print(f"Custom analyzer '{analyzer_id}' created successfully!") - # Now retrieve the custom analyzer - print(f"\nRetrieving custom analyzer '{analyzer_id}'...") - retrieved_analyzer = await client.get_analyzer(analyzer_id=analyzer_id) - - # Display full analyzer JSON - print("\n" + "=" * 80) - print(f"Custom Analyzer '{analyzer_id}':") - print("=" * 80) - retrieved_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) - print(retrieved_json) - print("=" * 80) - - # Clean up - delete the analyzer - print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") - await client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully.") + try: + # Get information about the custom analyzer + retrieved_analyzer = await client.get_analyzer(analyzer_id=analyzer_id) + + # Get raw response JSON and format it for nice printing + # Display full analyzer JSON + print("\n" + "=" * 80) + print(f"Custom Analyzer '{analyzer_id}':") + print("=" * 80) + retrieved_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) + print(retrieved_json) + print("=" * 80) + finally: + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + await client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") # [END get_custom_analyzer] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py index a7f0e640b088..b88a835b0276 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py @@ -79,37 +79,53 @@ def main() -> None: print("=" * 80) # [END get_prebuilt_analyzer] + # [START get_prebuilt_invoice] + print("\nRetrieving prebuilt-invoice analyzer...") + invoice_analyzer = client.get_analyzer(analyzer_id="prebuilt-invoice") + + # Display full analyzer JSON for prebuilt-invoice + print("\n" + "=" * 80) + print("Prebuilt-invoice Analyzer (Raw JSON):") + print("=" * 80) + invoice_json = json.dumps(invoice_analyzer.as_dict(), indent=2, default=str) + print(invoice_json) + print("=" * 80) + # [END get_prebuilt_invoice] + # [START get_custom_analyzer] # First, create a custom analyzer analyzer_id = f"my_custom_analyzer_{int(time.time())}" print(f"\nCreating custom analyzer '{analyzer_id}'...") + # Define field schema with custom fields field_schema = ContentFieldSchema( - name="company_schema", - description="Schema for extracting company information", + name="test_schema", + description="Test schema for GetAnalyzer sample", fields={ "company_name": ContentFieldDefinition( type=ContentFieldType.STRING, method=GenerationMethod.EXTRACT, description="Name of the company", ), - "total_amount": ContentFieldDefinition( - type=ContentFieldType.NUMBER, - method=GenerationMethod.EXTRACT, - description="Total amount on the document", - ), }, ) + # Create analyzer configuration + config = ContentAnalyzerConfig( + return_details=True + ) + + # Create the custom analyzer custom_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", - description="Custom analyzer for extracting company information", - config=ContentAnalyzerConfig(return_details=True), + description="Test analyzer for GetAnalyzer sample", + config=config, field_schema=field_schema, models={"completion": "gpt-4.1"}, ) + # Create the analyzer poller = client.begin_create_analyzer( analyzer_id=analyzer_id, resource=custom_analyzer, @@ -117,22 +133,23 @@ def main() -> None: poller.result() print(f"Custom analyzer '{analyzer_id}' created successfully!") - # Now retrieve the custom analyzer - print(f"\nRetrieving custom analyzer '{analyzer_id}'...") - retrieved_analyzer = client.get_analyzer(analyzer_id=analyzer_id) - - # Display full analyzer JSON - print("\n" + "=" * 80) - print(f"Custom Analyzer '{analyzer_id}':") - print("=" * 80) - retrieved_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) - print(retrieved_json) - print("=" * 80) - - # Clean up - delete the analyzer - print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") - client.delete_analyzer(analyzer_id=analyzer_id) - print(f"Analyzer '{analyzer_id}' deleted successfully.") + try: + # Get information about the custom analyzer + retrieved_analyzer = client.get_analyzer(analyzer_id=analyzer_id) + + # Get raw response JSON and format it for nice printing + # Display full analyzer JSON + print("\n" + "=" * 80) + print(f"Custom Analyzer '{analyzer_id}':") + print("=" * 80) + retrieved_json = json.dumps(retrieved_analyzer.as_dict(), indent=2, default=str) + print(retrieved_json) + print("=" * 80) + finally: + # Clean up - delete the analyzer + print(f"\nCleaning up: deleting analyzer '{analyzer_id}'...") + client.delete_analyzer(analyzer_id=analyzer_id) + print(f"Analyzer '{analyzer_id}' deleted successfully.") # [END get_custom_analyzer] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py index 4b73127917c7..a4bb8e1e08ea 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py @@ -41,14 +41,11 @@ def test_sample_get_analyzer(self, azure_content_understanding_endpoint: str) -> client = self.create_client(endpoint=azure_content_understanding_endpoint) # Get information about a prebuilt analyzer - response = client.get_analyzer(analyzer_id="prebuilt-documentSearch") + analyzer = client.get_analyzer(analyzer_id="prebuilt-documentSearch") # Assertions - assert response is not None, "Response should not be null" + assert analyzer is not None, "Analyzer response should not be null" print("[PASS] Get analyzer response received") - - analyzer = response - assert analyzer is not None, "Analyzer should not be null" print("[PASS] Analyzer object is not null") # Verify basic analyzer properties for prebuilt-documentSearch @@ -118,3 +115,71 @@ def test_sample_get_analyzer(self, azure_content_understanding_endpoint: str) -> print("\n[PASS] All prebuilt analyzer properties validated successfully") print("\n[SUCCESS] All test_sample_get_analyzer assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy + def test_sample_get_prebuilt_invoice_analyzer(self, azure_content_understanding_endpoint: str) -> None: + """Test getting information about the prebuilt-invoice analyzer. + + This test validates: + 1. Getting prebuilt-invoice analyzer information + 2. Analyzer response structure + 3. Analyzer JSON serialization + + 06_GetAnalyzer.GetPrebuiltInvoiceAsync() + """ + client = self.create_client(endpoint=azure_content_understanding_endpoint) + + # Get information about prebuilt-invoice analyzer + analyzer = client.get_analyzer(analyzer_id="prebuilt-invoice") + + # Assertions + assert analyzer is not None, "Analyzer response should not be null" + print("[PASS] Get prebuilt-invoice analyzer response received") + print("[PASS] Invoice analyzer object is not null") + + # Verify basic analyzer properties for prebuilt-invoice + if hasattr(analyzer, "base_analyzer_id"): + base_id = getattr(analyzer, "base_analyzer_id", None) + if base_id: + print(f"[INFO] Base analyzer ID: {base_id}") + + if hasattr(analyzer, "description"): + description = getattr(analyzer, "description", None) + if description: + print(f"[INFO] Description: {description[:100]}{'...' if len(description) > 100 else ''}") + + # Verify analyzer can be serialized to JSON + try: + # Convert analyzer to dict and then to JSON + if hasattr(analyzer, "__dict__"): + analyzer_dict = analyzer.__dict__ + elif hasattr(analyzer, "as_dict"): + analyzer_dict = analyzer.as_dict() # type: ignore + else: + analyzer_dict = {"analyzer": str(analyzer)} + + analyzer_json = json.dumps(analyzer_dict, indent=2, default=str) + + assert analyzer_json is not None, "Analyzer JSON should not be null" + assert len(analyzer_json) > 0, "Analyzer JSON should not be empty" + assert len(analyzer_json) > 0, "Analyzer JSON should not be empty" + print(f"[PASS] Invoice analyzer JSON serialized successfully ({len(analyzer_json)} characters)") + + # Verify JSON contains analyzer identifier + assert ( + "invoice" in analyzer_json.lower() or "prebuilt" in analyzer_json.lower() + ), "Analyzer JSON should contain analyzer identifier" + print("[PASS] Invoice analyzer JSON contains expected identifiers") + + # Display formatted JSON (first 500 chars for brevity) + print("\n[INFO] Prebuilt-invoice Analyzer (preview):") + print(analyzer_json[:500] + "..." if len(analyzer_json) > 500 else analyzer_json) + + except Exception as e: + print(f"[WARN] Could not fully serialize analyzer to JSON: {str(e)[:100]}") + # Still verify basic properties + assert analyzer is not None, "Analyzer should not be null" + + print("\n[PASS] All prebuilt-invoice analyzer properties validated successfully") + print("\n[SUCCESS] All test_sample_get_prebuilt_invoice_analyzer assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py index 27aa63638c6a..cc5dfd9613b8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py @@ -41,14 +41,11 @@ async def test_sample_get_analyzer_async(self, azure_content_understanding_endpo client = self.create_async_client(endpoint=azure_content_understanding_endpoint) # Get information about a prebuilt analyzer - response = await client.get_analyzer(analyzer_id="prebuilt-documentSearch") + analyzer = await client.get_analyzer(analyzer_id="prebuilt-documentSearch") # Assertions - assert response is not None, "Response should not be null" + assert analyzer is not None, "Analyzer response should not be null" print("[PASS] Get analyzer response received") - - analyzer = response - assert analyzer is not None, "Analyzer should not be null" print("[PASS] Analyzer object is not null") # Verify basic analyzer properties for prebuilt-documentSearch @@ -120,3 +117,73 @@ async def test_sample_get_analyzer_async(self, azure_content_understanding_endpo await client.close() print("\n[SUCCESS] All test_sample_get_analyzer_async assertions passed") + + @ContentUnderstandingPreparer() + @recorded_by_proxy_async + async def test_sample_get_prebuilt_invoice_analyzer_async(self, azure_content_understanding_endpoint: str) -> None: + """Test getting information about the prebuilt-invoice analyzer (async version). + + This test validates: + 1. Getting prebuilt-invoice analyzer information + 2. Analyzer response structure + 3. Analyzer JSON serialization + + 06_GetAnalyzer.GetPrebuiltInvoiceAsync() + """ + client = self.create_async_client(endpoint=azure_content_understanding_endpoint) + + # Get information about prebuilt-invoice analyzer + analyzer = await client.get_analyzer(analyzer_id="prebuilt-invoice") + + # Assertions + assert analyzer is not None, "Analyzer response should not be null" + print("[PASS] Get prebuilt-invoice analyzer response received") + print("[PASS] Invoice analyzer object is not null") + + # Verify basic analyzer properties for prebuilt-invoice + if hasattr(analyzer, "base_analyzer_id"): + base_id = getattr(analyzer, "base_analyzer_id", None) + if base_id: + print(f"[INFO] Base analyzer ID: {base_id}") + + if hasattr(analyzer, "description"): + description = getattr(analyzer, "description", None) + if description: + print(f"[INFO] Description: {description[:100]}{'...' if len(description) > 100 else ''}") + + # Verify analyzer can be serialized to JSON + try: + # Convert analyzer to dict and then to JSON + if hasattr(analyzer, "__dict__"): + analyzer_dict = analyzer.__dict__ + elif hasattr(analyzer, "as_dict"): + analyzer_dict = analyzer.as_dict() # type: ignore + else: + analyzer_dict = {"analyzer": str(analyzer)} + + analyzer_json = json.dumps(analyzer_dict, indent=2, default=str) + + assert analyzer_json is not None, "Analyzer JSON should not be null" + assert len(analyzer_json) > 0, "Analyzer JSON should not be empty" + assert len(analyzer_json) > 0, "Analyzer JSON should not be empty" + print(f"[PASS] Invoice analyzer JSON serialized successfully ({len(analyzer_json)} characters)") + + # Verify JSON contains analyzer identifier + assert ( + "invoice" in analyzer_json.lower() or "prebuilt" in analyzer_json.lower() + ), "Analyzer JSON should contain analyzer identifier" + print("[PASS] Invoice analyzer JSON contains expected identifiers") + + # Display formatted JSON (first 500 chars for brevity) + print("\n[INFO] Prebuilt-invoice Analyzer (preview):") + print(analyzer_json[:500] + "..." if len(analyzer_json) > 500 else analyzer_json) + + except Exception as e: + print(f"[WARN] Could not fully serialize analyzer to JSON: {str(e)[:100]}") + # Still verify basic properties + assert analyzer is not None, "Analyzer should not be null" + + print("\n[PASS] All prebuilt-invoice analyzer properties validated successfully") + + await client.close() + print("\n[SUCCESS] All test_sample_get_prebuilt_invoice_analyzer_async assertions passed") From bfc268c23b48d899c956f678fc0aa5b2b1d3fb95 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 19 Dec 2025 12:34:19 -0800 Subject: [PATCH 090/105] [SAMPLE-UPDATE] sample_list_analyzers --- .../sample_list_analyzers_async.py | 5 ++- .../samples/sample_list_analyzers.py | 5 ++- .../samples/test_sample_list_analyzers.py | 33 +++++++------------ .../test_sample_list_analyzers_async.py | 33 +++++++------------ 4 files changed, 26 insertions(+), 50 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py index 43622ff0d625..c8d38f52825b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py @@ -51,7 +51,7 @@ async def main() -> None: # List all analyzers analyzers = [analyzer async for analyzer in client.list_analyzers()] - print(f"\nFound {len(analyzers)} analyzer(s)") + print(f"Found {len(analyzers)} analyzer(s)") # Display summary prebuilt_count = sum(1 for a in analyzers if a.analyzer_id and a.analyzer_id.startswith("prebuilt-")) @@ -60,9 +60,8 @@ async def main() -> None: print(f" Custom analyzers: {custom_count}") # Display details for each analyzer - print("\n" + "=" * 60) for analyzer in analyzers: - print(f"ID: {analyzer.analyzer_id}") + print(f" ID: {analyzer.analyzer_id}") print(f" Description: {analyzer.description or '(none)'}") print(f" Status: {analyzer.status}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py index 92a044a761ce..9562d334f1d5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py @@ -51,7 +51,7 @@ def main() -> None: # List all analyzers analyzers = list(client.list_analyzers()) - print(f"\nFound {len(analyzers)} analyzer(s)") + print(f"Found {len(analyzers)} analyzer(s)") # Display summary prebuilt_count = sum(1 for a in analyzers if a.analyzer_id and a.analyzer_id.startswith("prebuilt-")) @@ -60,9 +60,8 @@ def main() -> None: print(f" Custom analyzers: {custom_count}") # Display details for each analyzer - print("\n" + "=" * 60) for analyzer in analyzers: - print(f"ID: {analyzer.analyzer_id}") + print(f" ID: {analyzer.analyzer_id}") print(f" Description: {analyzer.description or '(none)'}") print(f" Status: {analyzer.status}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py index a3ad2ca66c79..3902053641e8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py @@ -34,15 +34,11 @@ def test_sample_list_analyzers(self, azure_content_understanding_endpoint: str) 1. Listing all analyzers using list_analyzers 2. Counting prebuilt vs custom analyzers 3. Displaying analyzer details - - 07_ListAnalyzers.ListAnalyzersAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) # List all analyzers - analyzers = [] - for analyzer in client.list_analyzers(): - analyzers.append(analyzer) + analyzers = list(client.list_analyzers()) # Assertions assert analyzers is not None, "Analyzers list should not be null" @@ -53,11 +49,7 @@ def test_sample_list_analyzers(self, azure_content_understanding_endpoint: str) prebuilt_count = sum( 1 for a in analyzers if hasattr(a, "analyzer_id") and getattr(a, "analyzer_id", "").startswith("prebuilt-") ) - custom_count = sum( - 1 - for a in analyzers - if hasattr(a, "analyzer_id") and not getattr(a, "analyzer_id", "").startswith("prebuilt-") - ) + custom_count = len(analyzers) - prebuilt_count print(f"[INFO] Prebuilt analyzers: {prebuilt_count}") print(f"[INFO] Custom analyzers: {custom_count}") @@ -72,27 +64,24 @@ def test_sample_list_analyzers(self, azure_content_understanding_endpoint: str) assert prebuilt_count > 0, "Should have at least one prebuilt analyzer" print(f"[PASS] Prebuilt analyzers found: {prebuilt_count}") - # Display details for first 10 analyzers (for test output brevity) - print("\n[INFO] Analyzer details (first 10):") - for i, analyzer in enumerate(analyzers[:10]): + # Display details for each analyzer + print("\n[INFO] Analyzer details:") + for analyzer in analyzers: analyzer_id = getattr(analyzer, "analyzer_id", "unknown") description = getattr(analyzer, "description", "(none)") status = getattr(analyzer, "status", "unknown") - print(f"\n [{i+1}] ID: {analyzer_id}") + print(f" ID: {analyzer_id}") if description and description != "(none)": - print(f" Description: {description[:80]}{'...' if len(description) > 80 else ''}") + print(f" Description: {description[:80]}{'...' if len(description) > 80 else ''}") else: - print(f" Description: (none)") - print(f" Status: {status}") + print(f" Description: (none)") + print(f" Status: {status}") if analyzer_id.startswith("prebuilt-"): - print(" Type: Prebuilt analyzer") + print(" Type: Prebuilt analyzer") else: - print(" Type: Custom analyzer") - - if len(analyzers) > 10: - print(f"\n[INFO] ... and {len(analyzers) - 10} more analyzer(s)") + print(" Type: Custom analyzer") # Verify each analyzer has required properties valid_analyzers = 0 diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py index 99e51109719e..e248993d5b3e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py @@ -34,15 +34,11 @@ async def test_sample_list_analyzers_async(self, azure_content_understanding_end 1. Listing all analyzers using list_analyzers 2. Counting prebuilt vs custom analyzers 3. Displaying analyzer details - - 07_ListAnalyzers.ListAnalyzersAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) # List all analyzers - analyzers = [] - async for analyzer in client.list_analyzers(): - analyzers.append(analyzer) + analyzers = [analyzer async for analyzer in client.list_analyzers()] # Assertions assert analyzers is not None, "Analyzers list should not be null" @@ -53,11 +49,7 @@ async def test_sample_list_analyzers_async(self, azure_content_understanding_end prebuilt_count = sum( 1 for a in analyzers if hasattr(a, "analyzer_id") and getattr(a, "analyzer_id", "").startswith("prebuilt-") ) - custom_count = sum( - 1 - for a in analyzers - if hasattr(a, "analyzer_id") and not getattr(a, "analyzer_id", "").startswith("prebuilt-") - ) + custom_count = len(analyzers) - prebuilt_count print(f"[INFO] Prebuilt analyzers: {prebuilt_count}") print(f"[INFO] Custom analyzers: {custom_count}") @@ -72,27 +64,24 @@ async def test_sample_list_analyzers_async(self, azure_content_understanding_end assert prebuilt_count > 0, "Should have at least one prebuilt analyzer" print(f"[PASS] Prebuilt analyzers found: {prebuilt_count}") - # Display details for first 10 analyzers (for test output brevity) - print("\n[INFO] Analyzer details (first 10):") - for i, analyzer in enumerate(analyzers[:10]): + # Display details for each analyzer + print("\n[INFO] Analyzer details:") + for analyzer in analyzers: analyzer_id = getattr(analyzer, "analyzer_id", "unknown") description = getattr(analyzer, "description", "(none)") status = getattr(analyzer, "status", "unknown") - print(f"\n [{i+1}] ID: {analyzer_id}") + print(f" ID: {analyzer_id}") if description and description != "(none)": - print(f" Description: {description[:80]}{'...' if len(description) > 80 else ''}") + print(f" Description: {description[:80]}{'...' if len(description) > 80 else ''}") else: - print(f" Description: (none)") - print(f" Status: {status}") + print(f" Description: (none)") + print(f" Status: {status}") if analyzer_id.startswith("prebuilt-"): - print(" Type: Prebuilt analyzer") + print(" Type: Prebuilt analyzer") else: - print(" Type: Custom analyzer") - - if len(analyzers) > 10: - print(f"\n[INFO] ... and {len(analyzers) - 10} more analyzer(s)") + print(" Type: Custom analyzer") # Verify each analyzer has required properties valid_analyzers = 0 From 77a485caf14f892e06c194e965979bd7ecb2dde7 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 19 Dec 2025 14:21:04 -0800 Subject: [PATCH 091/105] [SAMPLE-UPDATE] sample_analyze_configs --- .../sample_analyze_configs_async.py | 12 +++++-- .../samples/sample_analyze_configs.py | 12 +++++-- .../samples/test_sample_analyze_configs.py | 33 +++++++++++-------- .../test_sample_analyze_configs_async.py | 33 +++++++++++-------- 4 files changed, 60 insertions(+), 30 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index 1e4cf363f127..012d1036eb3b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -9,9 +9,11 @@ DESCRIPTION: This sample demonstrates how to extract additional features from documents such as charts, - hyperlinks, formulas, and annotations using the prebuilt-documentSearch analyzer. + hyperlinks, formulas, and annotations using the `prebuilt-documentSearch` analyzer, which has + formulas, layout, and OCR enabled by default. - The prebuilt-documentSearch analyzer has the following configurations enabled by default: +ABOUT ANALYSIS CONFIGS: + The `prebuilt-documentSearch` analyzer has the following configurations enabled by default: - ReturnDetails: true - Returns detailed information about document elements - EnableOcr: true - Performs OCR on documents - EnableLayout: true - Extracts layout information (tables, figures, hyperlinks, annotations) @@ -31,6 +33,10 @@ For custom analyzers, you can configure these options in ContentAnalyzerConfig when creating the analyzer. +PREREQUISITES: + To get started you'll need a **Microsoft Foundry resource**. See sample_update_defaults.py + for setup guidance. + USAGE: python sample_analyze_configs_async.py @@ -51,6 +57,8 @@ AnalyzeResult, DocumentContent, DocumentChartFigure, + DocumentAnnotation, + DocumentFormula, ) from azure.core.credentials import AzureKeyCredential from azure.identity.aio import DefaultAzureCredential diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index 8fbd7b64ffb0..6a93ea9dfff3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -9,9 +9,11 @@ DESCRIPTION: This sample demonstrates how to extract additional features from documents such as charts, - hyperlinks, formulas, and annotations using the prebuilt-documentSearch analyzer. + hyperlinks, formulas, and annotations using the `prebuilt-documentSearch` analyzer, which has + formulas, layout, and OCR enabled by default. - The prebuilt-documentSearch analyzer has the following configurations enabled by default: +ABOUT ANALYSIS CONFIGS: + The `prebuilt-documentSearch` analyzer has the following configurations enabled by default: - ReturnDetails: true - Returns detailed information about document elements - EnableOcr: true - Performs OCR on documents - EnableLayout: true - Extracts layout information (tables, figures, hyperlinks, annotations) @@ -31,6 +33,10 @@ For custom analyzers, you can configure these options in ContentAnalyzerConfig when creating the analyzer. +PREREQUISITES: + To get started you'll need a **Microsoft Foundry resource**. See sample_update_defaults.py + for setup guidance. + USAGE: python sample_analyze_configs.py @@ -50,6 +56,8 @@ AnalyzeResult, DocumentContent, DocumentChartFigure, + DocumentAnnotation, + DocumentFormula, ) from azure.core.credentials import AzureKeyCredential from azure.identity import DefaultAzureCredential diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py index 0408e64922ad..9e175c323323 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs.py @@ -139,15 +139,15 @@ def test_sample_analyze_configs(self, azure_content_understanding_endpoint: str) def _test_document_features(self, content): """Test extraction of document features like charts, annotations, hyperlinks.""" - # Check for charts - charts = getattr(content, "charts", None) - if charts and len(charts) > 0: - print(f"[PASS] Found {len(charts)} chart(s) in document") - for i, chart in enumerate(charts, 1): - assert chart is not None, f"Chart {i} should not be null" - print(f" Chart {i} detected") + # Check for figures + figures = getattr(content, "figures", None) + if figures and len(figures) > 0: + print(f"[PASS] Found {len(figures)} figure(s) in document") + for i, figure in enumerate(figures, 1): + assert figure is not None, f"Figure {i} should not be null" + print(f" Figure {i} detected") else: - print("[INFO] No charts found in document") + print("[INFO] No figures found in document") # Check for annotations annotations = getattr(content, "annotations", None) @@ -163,9 +163,16 @@ def _test_document_features(self, content): else: print("[INFO] No hyperlinks found in document") - # Check for formulas - formulas = getattr(content, "formulas", None) - if formulas and len(formulas) > 0: - print(f"[PASS] Found {len(formulas)} formula(s) in document") + # Check for formulas in pages + formulas_count = 0 + pages = getattr(content, "pages", None) + if pages: + for page in pages: + formulas = getattr(page, "formulas", None) + if formulas: + formulas_count += len(formulas) + + if formulas_count > 0: + print(f"[PASS] Found {formulas_count} formula(s) in document pages") else: - print("[INFO] No formulas found in document") + print("[INFO] No formulas found in document pages") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py index 97776a2ff0bc..ba2070524e76 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_configs_async.py @@ -140,15 +140,15 @@ async def test_sample_analyze_configs_async(self, azure_content_understanding_en def _test_document_features(self, content): """Test extraction of document features like charts, annotations, hyperlinks.""" - # Check for charts - charts = getattr(content, "charts", None) - if charts and len(charts) > 0: - print(f"[PASS] Found {len(charts)} chart(s) in document") - for i, chart in enumerate(charts, 1): - assert chart is not None, f"Chart {i} should not be null" - print(f" Chart {i} detected") + # Check for figures + figures = getattr(content, "figures", None) + if figures and len(figures) > 0: + print(f"[PASS] Found {len(figures)} figure(s) in document") + for i, figure in enumerate(figures, 1): + assert figure is not None, f"Figure {i} should not be null" + print(f" Figure {i} detected") else: - print("[INFO] No charts found in document") + print("[INFO] No figures found in document") # Check for annotations annotations = getattr(content, "annotations", None) @@ -164,9 +164,16 @@ def _test_document_features(self, content): else: print("[INFO] No hyperlinks found in document") - # Check for formulas - formulas = getattr(content, "formulas", None) - if formulas and len(formulas) > 0: - print(f"[PASS] Found {len(formulas)} formula(s) in document") + # Check for formulas in pages + formulas_count = 0 + pages = getattr(content, "pages", None) + if pages: + for page in pages: + formulas = getattr(page, "formulas", None) + if formulas: + formulas_count += len(formulas) + + if formulas_count > 0: + print(f"[PASS] Found {formulas_count} formula(s) in document pages") else: - print("[INFO] No formulas found in document") + print("[INFO] No formulas found in document pages") From 4985ecfdd2eba87a1d6952f2ecbe5a55f3f71ad5 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 19 Dec 2025 16:56:39 -0800 Subject: [PATCH 092/105] [SAMPLE-UPDATE] sample_analyze_return_raw_json --- .../sample_analyze_return_raw_json_async.py | 13 ++++++++----- .../samples/sample_analyze_return_raw_json.py | 13 ++++++++----- .../samples/test_sample_analyze_return_raw_json.py | 12 ++++++------ .../test_sample_analyze_return_raw_json_async.py | 14 +++++++------- 4 files changed, 29 insertions(+), 23 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py index df3316c7f0f2..a9d1e40049c4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_return_raw_json_async.py @@ -9,8 +9,9 @@ DESCRIPTION: This sample demonstrates how to access the raw JSON response from analysis operations - using the 'cls' callback parameter (async version). This is useful for scenarios where - you need to inspect the full response structure exactly as returned by the service. + using the convenience method and then accessing the raw response (async version). + This is useful for scenarios where you need to inspect the full response structure + exactly as returned by the service. The Content Understanding SDK provides a convenient object model approach (shown in sample_analyze_binary_async.py) that returns AnalyzeResult objects with deeper navigation @@ -66,8 +67,8 @@ async def main() -> None: print(f"Analyzing {file_path} with prebuilt-documentSearch...") - # Use the 'cls' callback parameter to get the raw HTTP response - # This allows access to the complete response structure for easy inspection and debugging + # Use the convenience method to analyze the document + # The cls callback allows access to the complete response structure for easy inspection and debugging poller = await client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, @@ -82,8 +83,10 @@ async def main() -> None: # [END analyze_return_raw_json] # [START parse_raw_json] - # Pretty-print the raw JSON response + # Get the raw JSON response response_json = raw_http_response.json() + + # Pretty-print the raw JSON response pretty_json = json.dumps(response_json, indent=2, ensure_ascii=False) print(pretty_json) # [END parse_raw_json] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py index 57a51aad8355..e08955b4eb3f 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_return_raw_json.py @@ -9,8 +9,9 @@ DESCRIPTION: This sample demonstrates how to access the raw JSON response from analysis operations - using the 'cls' callback parameter. This is useful for scenarios where you need to - inspect the full response structure exactly as returned by the service. + using the convenience method and then accessing the raw response. This is useful for + scenarios where you need to inspect the full response structure exactly as returned by + the service. The Content Understanding SDK provides a convenient object model approach (shown in sample_analyze_binary.py) that returns AnalyzeResult objects with deeper navigation @@ -66,8 +67,8 @@ def main() -> None: print(f"Analyzing {file_path} with prebuilt-documentSearch...") - # Use the 'cls' callback parameter to get the raw HTTP response - # This allows access to the complete response structure for easy inspection and debugging + # Use the convenience method to analyze the document + # The cls callback allows access to the complete response structure for easy inspection and debugging poller = client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, @@ -82,8 +83,10 @@ def main() -> None: # [END analyze_return_raw_json] # [START parse_raw_json] - # Pretty-print the raw JSON response + # Get the raw JSON response response_json = raw_http_response.json() + + # Pretty-print the raw JSON response pretty_json = json.dumps(response_json, indent=2, ensure_ascii=False) print(pretty_json) # [END parse_raw_json] diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py index d719ab153134..28591be1894e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json.py @@ -12,8 +12,8 @@ DESCRIPTION: These tests validate the sample_analyze_return_raw_json.py sample code. - This sample demonstrates how to access the raw JSON response from analysis operations. - This is useful for: + This sample demonstrates how to access the raw JSON response from analysis operations + using the convenience method and then accessing the raw response. This is useful for: - Easy inspection: View the complete response structure in the exact format returned by the service - Debugging: Inspect the raw response to troubleshoot issues or verify service behavior - Advanced scenarios: Work with response structures that may include additional metadata @@ -37,7 +37,7 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi """Test analyzing a document and getting raw JSON response. This test validates: - 1. Document analysis using 'cls' callback to get raw HTTP response + 1. Document analysis using convenience method to get raw HTTP response 2. Raw JSON response format for easy inspection and debugging 3. JSON structure validation @@ -60,8 +60,8 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - # Use 'cls' callback to get raw HTTP response - # This allows access to the complete response structure for easy inspection and debugging + # Use convenience method to analyze the document + # The cls callback allows access to the complete response structure for easy inspection and debugging poller = client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, @@ -84,7 +84,7 @@ def test_sample_analyze_return_raw_json(self, azure_content_understanding_endpoi assert raw_http_response is not None, "Raw HTTP response should not be null" print("[PASS] Raw HTTP response is not null") - # Parse the raw JSON response + # Get the raw JSON response response_json = raw_http_response.json() # Assertion: Verify JSON is not empty diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py index 603f3712933f..e56a18b6d660 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_return_raw_json_async.py @@ -10,10 +10,10 @@ TEST FILE: test_sample_analyze_return_raw_json_async.py DESCRIPTION: - These tests validate the sample_analyze_return_raw_json.py sample code (async version). + These tests validate the sample_analyze_return_raw_json_async.py sample code (async version). - This sample demonstrates how to access the raw JSON response from analysis operations. - This is useful for: + This sample demonstrates how to access the raw JSON response from analysis operations + using the convenience method and then accessing the raw response. This is useful for: - Easy inspection: View the complete response structure in the exact format returned by the service - Debugging: Inspect the raw response to troubleshoot issues or verify service behavior - Advanced scenarios: Work with response structures that may include additional metadata @@ -37,7 +37,7 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa """Test analyzing a document and getting raw JSON response (async version). This test validates: - 1. Document analysis using 'cls' callback to get raw HTTP response + 1. Document analysis using convenience method to get raw HTTP response 2. Raw JSON response format for easy inspection and debugging 3. JSON structure validation @@ -60,8 +60,8 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - # Use 'cls' callback to get raw HTTP response - # This allows access to the complete response structure for easy inspection and debugging + # Use convenience method to analyze the document + # The cls callback allows access to the complete response structure for easy inspection and debugging poller = await client.begin_analyze_binary( analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, @@ -84,7 +84,7 @@ async def test_sample_analyze_return_raw_json_async(self, azure_content_understa assert raw_http_response is not None, "Raw HTTP response should not be null" print("[PASS] Raw HTTP response is not null") - # Parse the raw JSON response + # Get the raw JSON response response_json = raw_http_response.json() # Assertion: Verify JSON is not empty From 9ba055733c2e4188c6b78c779abeac39fdc2cf7b Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 19 Dec 2025 17:12:26 -0800 Subject: [PATCH 093/105] [SAMPLE-UPDATE] sample_get_result_file --- .../sample_get_result_file_async.py | 42 +++++++++---------- .../samples/sample_get_result_file.py | 42 +++++++++---------- 2 files changed, 40 insertions(+), 44 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py index d71e3d466df3..58adcc3d244b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py @@ -9,15 +9,18 @@ DESCRIPTION: This sample demonstrates how to retrieve result files (such as keyframe images) from a - video analysis operation using the get_result_file API. + video analysis operation using the `get_result_file` API. - When analyzing video content, the Content Understanding service can generate result files: + About result files: + When analyzing video content, the Content Understanding service can generate result files such as: - Keyframe images: Extracted frames from the video at specific timestamps - Other result files: Additional files generated during analysis - The get_result_file API allows you to retrieve these files using: + The `get_result_file` API allows you to retrieve these files using: - Operation ID: Extracted from the analysis operation - - File path: The path to the specific result file (e.g., "keyframes/{frameTimeMs}") + - File path: The path to the specific result file. In the recording, keyframes were accessed + with paths like `keyframes/733` and `keyframes/9000`, following the + `keyframes/{frameTimeMs}` pattern. USAGE: python sample_get_result_file_async.py @@ -54,25 +57,25 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_video_for_result_files] - # Use a sample video URL + # Use a sample video URL to get keyframes for GetResultFile testing + # You can replace this with your own video file URL video_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/videos/sdk_samples/FlightSimulator.mp4" - print(f"Analyzing video with prebuilt-videoSearch...") + print("Analyzing video with prebuilt-videoSearch...") print(f" URL: {video_url}") - # Start the analysis operation (using begin_analyze which returns a poller) - poller = await client.begin_analyze( + # Analyze and wait for completion + analyze_operation = await client.begin_analyze( analyzer_id="prebuilt-videoSearch", inputs=[AnalyzeInput(url=video_url)], ) - # Get the operation ID from the poller - operation_id = poller.operation_id + # Get the operation ID - this is needed to retrieve result files later + operation_id = analyze_operation.operation_id print(f" Operation ID: {operation_id}") - # Wait for completion print(" Waiting for analysis to complete...") - result: AnalyzeResult = await poller.result() + result: AnalyzeResult = await analyze_operation.result() # [END analyze_video_for_result_files] # [START get_result_file] @@ -80,16 +83,16 @@ async def main() -> None: print("No content found in the analysis result.") return - content = result.contents[0] - - # For video analysis, keyframes would be found in AudioVisualContent.KeyFrameTimesMs + # For video analysis, keyframes would be found in AudioVisualContent.key_frame_times_ms + # Cast MediaContent to AudioVisualContent to access video-specific properties video_content: AudioVisualContent = result.contents[0] # type: ignore + # Print keyframe information if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: total_keyframes = len(video_content.key_frame_times_ms) first_frame_time_ms = video_content.key_frame_times_ms[0] - print(f"\nTotal keyframes: {total_keyframes}") + print(f"Total keyframes: {total_keyframes}") print(f"First keyframe time: {first_frame_time_ms} ms") # Get the first keyframe as an example @@ -97,7 +100,7 @@ async def main() -> None: print(f"Getting result file: {frame_path}") - # Get the result file (keyframe image) + # Get the result file (keyframe image) using the operation ID obtained from Operation.id file_response = await client.get_result_file( operation_id=operation_id, path=frame_path, @@ -120,11 +123,6 @@ async def main() -> None: print("\nNote: This sample demonstrates GetResultFile API usage.") print(" For video analysis with keyframes, use prebuilt-videoSearch analyzer.") print(" Keyframes are available in AudioVisualContent.key_frame_times_ms.") - print() - print(f"Example usage with operation ID '{operation_id}':") - print(" file_response = await client.get_result_file(") - print(" operation_id=operation_id,") - print(' path="keyframes/1000")') # [END get_result_file] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py index bd287e8cb3f8..5c8100a86e67 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py @@ -9,15 +9,18 @@ DESCRIPTION: This sample demonstrates how to retrieve result files (such as keyframe images) from a - video analysis operation using the get_result_file API. + video analysis operation using the `get_result_file` API. - When analyzing video content, the Content Understanding service can generate result files: + About result files: + When analyzing video content, the Content Understanding service can generate result files such as: - Keyframe images: Extracted frames from the video at specific timestamps - Other result files: Additional files generated during analysis - The get_result_file API allows you to retrieve these files using: + The `get_result_file` API allows you to retrieve these files using: - Operation ID: Extracted from the analysis operation - - File path: The path to the specific result file (e.g., "keyframes/{frameTimeMs}") + - File path: The path to the specific result file. In the recording, keyframes were accessed + with paths like `keyframes/733` and `keyframes/9000`, following the + `keyframes/{frameTimeMs}` pattern. USAGE: python sample_get_result_file.py @@ -54,25 +57,25 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_video_for_result_files] - # Use a sample video URL + # Use a sample video URL to get keyframes for GetResultFile testing + # You can replace this with your own video file URL video_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/videos/sdk_samples/FlightSimulator.mp4" - print(f"Analyzing video with prebuilt-videoSearch...") + print("Analyzing video with prebuilt-videoSearch...") print(f" URL: {video_url}") - # Start the analysis operation (using begin_analyze which returns a poller) - poller = client.begin_analyze( + # Analyze and wait for completion + analyze_operation = client.begin_analyze( analyzer_id="prebuilt-videoSearch", inputs=[AnalyzeInput(url=video_url)], ) - # Get the operation ID from the poller - operation_id = poller.operation_id + # Get the operation ID - this is needed to retrieve result files later + operation_id = analyze_operation.operation_id print(f" Operation ID: {operation_id}") - # Wait for completion print(" Waiting for analysis to complete...") - result: AnalyzeResult = poller.result() + result: AnalyzeResult = analyze_operation.result() # [END analyze_video_for_result_files] # [START get_result_file] @@ -80,16 +83,16 @@ def main() -> None: print("No content found in the analysis result.") return - content = result.contents[0] - - # For video analysis, keyframes would be found in AudioVisualContent.KeyFrameTimesMs + # For video analysis, keyframes would be found in AudioVisualContent.key_frame_times_ms + # Cast MediaContent to AudioVisualContent to access video-specific properties video_content: AudioVisualContent = result.contents[0] # type: ignore + # Print keyframe information if video_content.key_frame_times_ms and len(video_content.key_frame_times_ms) > 0: total_keyframes = len(video_content.key_frame_times_ms) first_frame_time_ms = video_content.key_frame_times_ms[0] - print(f"\nTotal keyframes: {total_keyframes}") + print(f"Total keyframes: {total_keyframes}") print(f"First keyframe time: {first_frame_time_ms} ms") # Get the first keyframe as an example @@ -97,7 +100,7 @@ def main() -> None: print(f"Getting result file: {frame_path}") - # Get the result file (keyframe image) + # Get the result file (keyframe image) using the operation ID obtained from Operation.id file_response = client.get_result_file( operation_id=operation_id, path=frame_path, @@ -120,11 +123,6 @@ def main() -> None: print("\nNote: This sample demonstrates GetResultFile API usage.") print(" For video analysis with keyframes, use prebuilt-videoSearch analyzer.") print(" Keyframes are available in AudioVisualContent.key_frame_times_ms.") - print() - print(f"Example usage with operation ID '{operation_id}':") - print(" file_response = client.get_result_file(") - print(" operation_id=operation_id,") - print(' path="keyframes/1000")') # [END get_result_file] From 0cb07eafe27e428aecb369a328b21238a0c9cd61 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 19 Dec 2025 18:37:27 -0800 Subject: [PATCH 094/105] [SAMPLE-UPDATE] sample_delete_result --- .../sample_delete_result_async.py | 42 +++------ .../samples/sample_delete_result.py | 42 +++------ .../samples/test_sample_delete_result.py | 86 ++++++++---------- .../test_sample_delete_result_async.py | 88 ++++++++----------- 4 files changed, 101 insertions(+), 157 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py index abf4fb5ee76a..d7fb2239a4cf 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py @@ -55,45 +55,29 @@ async def main() -> None: async with ContentUnderstandingClient(endpoint=endpoint, credential=credential) as client: # [START analyze_and_delete_result] - document_url = "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/docs/invoice.pdf" + # You can replace this URL with your own invoice file URL + document_url = "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" - print("Document Analysis Workflow") - print("=" * 60) - print(f" Document URL: {document_url}") - print(f" Analyzer: prebuilt-invoice") - print("=" * 60) - - # Step 1: Start the analysis operation - print("\nStep 1: Starting document analysis...") - poller = await client.begin_analyze( + # Step 1: Analyze and wait for completion + analyze_operation = await client.begin_analyze( analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(url=document_url)], ) - # Get the operation ID from the poller - operation_id = poller.operation_id - - if not operation_id: - print("Error: Could not extract operation ID from response") - return - - print(f" Operation ID: {operation_id}") - - # Wait for completion - print(" Waiting for analysis to complete...") - result: AnalyzeResult = await poller.result() + # Get the operation ID - this is needed to delete the result later + operation_id = analyze_operation.operation_id + print(f"Operation ID: {operation_id}") + result: AnalyzeResult = await analyze_operation.result() print("Analysis completed successfully!") # Display some sample results if result.contents and len(result.contents) > 0: - doc_content: DocumentContent = result.contents[0] # type: ignore - if doc_content.fields: - print(f" Total fields extracted: {len(doc_content.fields)}") - customer_name_field = doc_content.fields.get("CustomerName") - if customer_name_field: - print(f" Customer Name: {customer_name_field.value or '(not found)'}") + document_content: DocumentContent = result.contents[0] # type: ignore + if document_content.fields: + print(f"Total fields extracted: {len(document_content.fields)}") + # Step 2: Delete the analysis result - print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") + print(f"Deleting analysis result (Operation ID: {operation_id})...") await client.delete_result(operation_id=operation_id) print("Analysis result deleted successfully!") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index f47647ea890b..401ae82b7ca2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -55,47 +55,31 @@ def main() -> None: client = ContentUnderstandingClient(endpoint=endpoint, credential=credential) # [START analyze_and_delete_result] + # You can replace this URL with your own invoice file URL document_url = ( - "https://github.com/Azure-Samples/azure-ai-content-understanding-assets/raw/refs/heads/main/docs/invoice.pdf" + "https://raw.githubusercontent.com/Azure-Samples/azure-ai-content-understanding-assets/main/document/invoice.pdf" ) - print("Document Analysis Workflow") - print("=" * 60) - print(f" Document URL: {document_url}") - print(f" Analyzer: prebuilt-invoice") - print("=" * 60) - - # Step 1: Start the analysis operation - print("\nStep 1: Starting document analysis...") - poller = client.begin_analyze( + # Step 1: Analyze and wait for completion + analyze_operation = client.begin_analyze( analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(url=document_url)], ) - # Get the operation ID from the poller - operation_id = poller.operation_id - - if not operation_id: - print("Error: Could not extract operation ID from response") - return - - print(f" Operation ID: {operation_id}") - - # Wait for completion - print(" Waiting for analysis to complete...") - result: AnalyzeResult = poller.result() + # Get the operation ID - this is needed to delete the result later + operation_id = analyze_operation.operation_id + print(f"Operation ID: {operation_id}") + result: AnalyzeResult = analyze_operation.result() print("Analysis completed successfully!") # Display some sample results if result.contents and len(result.contents) > 0: - doc_content: DocumentContent = result.contents[0] # type: ignore - if doc_content.fields: - print(f" Total fields extracted: {len(doc_content.fields)}") - customer_name_field = doc_content.fields.get("CustomerName") - if customer_name_field: - print(f" Customer Name: {customer_name_field.value or '(not found)'}") + document_content: DocumentContent = result.contents[0] # type: ignore + if document_content.fields: + print(f"Total fields extracted: {len(document_content.fields)}") + # Step 2: Delete the analysis result - print(f"\nStep 2: Deleting analysis result (Operation ID: {operation_id})...") + print(f"Deleting analysis result (Operation ID: {operation_id})...") client.delete_result(operation_id=operation_id) print("Analysis result deleted successfully!") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py index 3405305c2f00..3575650f657a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py @@ -21,6 +21,7 @@ import pytest from devtools_testutils import recorded_by_proxy from testpreparer import ContentUnderstandingPreparer, ContentUnderstandingClientTestBase +from azure.ai.contentunderstanding.models import AnalyzeInput, AnalyzeResult, DocumentContent class TestSampleDeleteResult(ContentUnderstandingClientTestBase): @@ -33,16 +34,17 @@ def test_sample_delete_result(self, azure_content_understanding_endpoint: str) - This test validates: 1. Document analysis to create a result - 2. Extracting result ID - 3. Deleting the result + 2. Extracting operation ID + 3. Deleting the result using operation ID - 13_DeleteResult.DeleteResultAsync() + Equivalent to: Sample13_DeleteResult.DeleteResultAsync() """ client = self.create_client(endpoint=azure_content_understanding_endpoint) # First, analyze a document to create a result - tests_dir = os.path.dirname(os.path.dirname(__file__)) - file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + current_dir = os.path.dirname(os.path.abspath(__file__)) + test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") + file_path = os.path.join(test_data_dir, "sample_invoice.pdf") assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") @@ -53,58 +55,44 @@ def test_sample_delete_result(self, azure_content_understanding_endpoint: str) - assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - # Analyze to get a result ID - poller = client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" + # Analyze to get an operation ID + analyze_operation = client.begin_analyze( + analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(data=file_bytes)] ) - result = poller.result() + result: AnalyzeResult = analyze_operation.result() # Assertions for analysis - assert poller is not None, "Analysis operation should not be null" - assert poller.done(), "Operation should be completed" + assert analyze_operation is not None, "Analysis operation should not be null" + assert analyze_operation.done(), "Operation should be completed" assert result is not None, "Analysis result should not be null" print("[PASS] Analysis completed successfully") - # Extract operation ID from the poller - # The operation ID is needed to delete the result - operation_id = None + # Get operation ID - this is needed to delete the result + operation_id = analyze_operation.operation_id + assert operation_id is not None, "Operation ID should not be null" + assert isinstance(operation_id, str), "Operation ID should be a string" + assert operation_id.strip(), "Operation ID should not be empty" + print(f"[PASS] Operation ID extracted: {operation_id[:50]}...") + + # Verify we have analysis content + assert hasattr(result, "contents"), "Result should contain contents" + contents = getattr(result, "contents", None) + assert contents is not None, "Result contents should not be null" + assert len(contents) > 0, "Result should have at least one content" + print(f"[PASS] Analysis result contains {len(contents)} content item(s)") + + # Delete the result try: - # Extract operation ID from polling URL - if hasattr(poller, "_polling_method"): - polling_method = getattr(poller, "_polling_method", None) - if polling_method and hasattr(polling_method, "_operation"): - operation = getattr(polling_method, "_operation", None) # type: ignore - if operation and hasattr(operation, "get_polling_url"): - polling_url = operation.get_polling_url() # type: ignore - # Extract operation ID from URL (last segment before query string) - operation_id = polling_url.split("/")[-1] - if "?" in operation_id: - operation_id = operation_id.split("?")[0] + client.delete_result(operation_id=operation_id) + print(f"[PASS] Result deleted successfully (operation ID: {operation_id[:50]}...)") + print("[INFO] Deletion success verified by no exception thrown") except Exception as e: - print(f"[WARN] Could not extract operation ID: {str(e)[:100]}") - - # Assertion: Verify we have an operation ID - if operation_id: - assert operation_id is not None, "Operation ID should not be null" - assert isinstance(operation_id, str), "Operation ID should be a string" - assert operation_id.strip(), "Operation ID should not be empty" - print(f"[PASS] Operation ID extracted: {operation_id[:50]}...") - - # Delete the result - try: - client.delete_result(operation_id=operation_id) - print(f"[PASS] Result deleted successfully (operation ID: {operation_id[:50]}...)") - print("[INFO] Deletion success verified by no exception thrown") - except Exception as e: - error_msg = str(e) - # Some implementations might not support result deletion or result might auto-expire - if "not found" in error_msg.lower() or "404" in error_msg: - print(f"[INFO] Result already deleted or not found: {error_msg[:100]}") - else: - print(f"[WARN] Delete result failed: {error_msg[:100]}") - else: - print("[INFO] Operation ID not available in response") - print("[INFO] Delete result operation skipped - operation ID extraction not supported") + error_msg = str(e) + # Some implementations might not support result deletion or result might auto-expire + if "not found" in error_msg.lower() or "404" in error_msg: + print(f"[INFO] Result already deleted or not found: {error_msg[:100]}") + else: + raise print("\n[SUCCESS] All test_sample_delete_result assertions passed") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py index f74fdfd554c6..29630c9301e2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py @@ -10,7 +10,7 @@ TEST FILE: test_sample_delete_result_async.py DESCRIPTION: - These tests validate the sample_delete_result.py sample code (async version). + These tests validate the sample_delete_result_async.py sample code (async version). This sample demonstrates deleting analysis results for immediate cleanup. USAGE: @@ -21,6 +21,7 @@ import pytest from devtools_testutils.aio import recorded_by_proxy_async from testpreparer_async import ContentUnderstandingPreparer, ContentUnderstandingClientTestBaseAsync +from azure.ai.contentunderstanding.models import AnalyzeInput, AnalyzeResult class TestSampleDeleteResultAsync(ContentUnderstandingClientTestBaseAsync): @@ -33,16 +34,17 @@ async def test_sample_delete_result_async(self, azure_content_understanding_endp This test validates: 1. Document analysis to create a result - 2. Extracting result ID - 3. Deleting the result + 2. Extracting operation ID + 3. Deleting the result using operation ID - 13_DeleteResult.DeleteResultAsync() + Equivalent to: Sample13_DeleteResult.DeleteResultAsync() """ client = self.create_async_client(endpoint=azure_content_understanding_endpoint) # First, analyze a document to create a result - tests_dir = os.path.dirname(os.path.dirname(__file__)) - file_path = os.path.join(tests_dir, "test_data", "sample_invoice.pdf") + current_dir = os.path.dirname(os.path.abspath(__file__)) + test_data_dir = os.path.join(os.path.dirname(current_dir), "test_data") + file_path = os.path.join(test_data_dir, "sample_invoice.pdf") assert os.path.exists(file_path), f"Sample file not found at {file_path}" print(f"[PASS] Sample file exists: {file_path}") @@ -53,59 +55,45 @@ async def test_sample_delete_result_async(self, azure_content_understanding_endp assert len(file_bytes) > 0, "File should not be empty" print(f"[PASS] File loaded: {len(file_bytes)} bytes") - # Analyze to get a result ID - poller = await client.begin_analyze_binary( - analyzer_id="prebuilt-documentSearch", binary_input=file_bytes, content_type="application/pdf" + # Analyze to get an operation ID + analyze_operation = await client.begin_analyze( + analyzer_id="prebuilt-invoice", inputs=[AnalyzeInput(data=file_bytes)] ) - result = await poller.result() + result: AnalyzeResult = await analyze_operation.result() # Assertions for analysis - assert poller is not None, "Analysis operation should not be null" - assert poller.done(), "Operation should be completed" + assert analyze_operation is not None, "Analysis operation should not be null" + assert analyze_operation.done(), "Operation should be completed" assert result is not None, "Analysis result should not be null" print("[PASS] Analysis completed successfully") - # Extract operation ID from the poller - # The operation ID is needed to delete the result - operation_id = None + # Get operation ID - this is needed to delete the result + operation_id = analyze_operation.operation_id + assert operation_id is not None, "Operation ID should not be null" + assert isinstance(operation_id, str), "Operation ID should be a string" + assert operation_id.strip(), "Operation ID should not be empty" + print(f"[PASS] Operation ID extracted: {operation_id[:50]}...") + + # Verify we have analysis content + assert hasattr(result, "contents"), "Result should contain contents" + contents = getattr(result, "contents", None) + assert contents is not None, "Result contents should not be null" + assert len(contents) > 0, "Result should have at least one content" + print(f"[PASS] Analysis result contains {len(contents)} content item(s)") + + # Delete the result try: - # Extract operation ID from polling URL - if hasattr(poller, "_polling_method"): - polling_method = getattr(poller, "_polling_method", None) - if polling_method and hasattr(polling_method, "_operation"): - operation = getattr(polling_method, "_operation", None) # type: ignore - if operation and hasattr(operation, "get_polling_url"): - polling_url = operation.get_polling_url() # type: ignore - # Extract operation ID from URL (last segment before query string) - operation_id = polling_url.split("/")[-1] - if "?" in operation_id: - operation_id = operation_id.split("?")[0] + await client.delete_result(operation_id=operation_id) + print(f"[PASS] Result deleted successfully (operation ID: {operation_id[:50]}...)") + print("[INFO] Deletion success verified by no exception thrown") except Exception as e: - print(f"[WARN] Could not extract operation ID: {str(e)[:100]}") - - # Assertion: Verify we have an operation ID - if operation_id: - assert operation_id is not None, "Operation ID should not be null" - assert isinstance(operation_id, str), "Operation ID should be a string" - assert operation_id.strip(), "Operation ID should not be empty" - print(f"[PASS] Operation ID extracted: {operation_id[:50]}...") - - # Delete the result - try: - await client.delete_result(operation_id=operation_id) - print(f"[PASS] Result deleted successfully (operation ID: {operation_id[:50]}...)") - print("[INFO] Deletion success verified by no exception thrown") - except Exception as e: - error_msg = str(e) - # Some implementations might not support result deletion or result might auto-expire - if "not found" in error_msg.lower() or "404" in error_msg: - print(f"[INFO] Result already deleted or not found: {error_msg[:100]}") - else: - print(f"[WARN] Delete result failed: {error_msg[:100]}") - else: - print("[INFO] Operation ID not available in response") - print("[INFO] Delete result operation skipped - operation ID extraction not supported") + error_msg = str(e) + # Some implementations might not support result deletion or result might auto-expire + if "not found" in error_msg.lower() or "404" in error_msg: + print(f"[INFO] Result already deleted or not found: {error_msg[:100]}") + else: + raise await client.close() print("\n[SUCCESS] All test_sample_delete_result_async assertions passed") From 39bc27b4053c01120a7066a25dda46595500be50 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Fri, 19 Dec 2025 19:59:34 -0800 Subject: [PATCH 095/105] [SAMPLE-UPDATE] sample_grant_copy_auth --- .../sample_grant_copy_auth_async.py | 124 +++++++++++------ .../samples/sample_grant_copy_auth.py | 126 ++++++++++++------ 2 files changed, 173 insertions(+), 77 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py index aabffab9f2a4..c43404a12871 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py @@ -9,17 +9,45 @@ DESCRIPTION: This sample demonstrates how to grant copy authorization and copy an analyzer from a source - resource to a target resource (cross-resource copying). This is useful for copying analyzers - between different Azure resources or subscriptions. + Microsoft Foundry resource to a target Microsoft Foundry resource (cross-resource copying). + This is useful for copying analyzers between different Azure resources or subscriptions. - The grant_copy_authorization and copy_analyzer APIs allow you to copy an analyzer between - different Azure resources: +ABOUT CROSS-RESOURCE COPYING: + The `grant_copy_authorization` and `copy_analyzer` APIs allow you to copy an analyzer + between different Azure resources: - Cross-resource copy: Copies an analyzer from one Azure resource to another - Authorization required: You must grant copy authorization before copying - - Use cases: Cross-subscription copying, resource migration, multi-region deployment - Note: For same-resource copying (copying within the same Azure resource), use the - sample_copy_analyzer_async.py sample instead. + When to use cross-resource copying: + - Copy between subscriptions: Move analyzers between different Azure subscriptions + - Multi-region deployment: Deploy the same analyzer to multiple regions + - Resource migration: Migrate analyzers from one resource to another + - Environment promotion: Promote analyzers from development to production across resources + + Note: For same-resource copying (copying within the same Microsoft Foundry resource), + use the sample_copy_analyzer_async.py sample instead. + +PREREQUISITES: + To get started you'll need a **Microsoft Foundry resource**. For this cross-resource scenario, + you'll also need: + - Source Microsoft Foundry resource with model deployments configured + - Target Microsoft Foundry resource with model deployments configured + + Important: Both the source and target resources require the 'Cognitive Services User' role + to be granted to the credential used to run the code. This role is required for cross-resource + copying operations. Without this role, the grant_copy_authorization and copy_analyzer + operations will fail with authorization errors. + +HOW AUTHORIZATION WORKS: + The grant_copy_authorization method must be called on the source Microsoft Foundry resource + (where the analyzer currently exists). This is because the source resource needs to explicitly + grant permission for its analyzer to be copied. The method creates a time-limited authorization + record that grants permission to a specific target resource. + + Where copy is performed: The copy_analyzer method must be called on the target Microsoft Foundry + resource (where the analyzer will be copied to). This is because the target resource is the one + receiving and creating the copy. When the target resource calls copy_analyzer, the service + validates that authorization was previously granted by the source resource. USAGE: python sample_grant_copy_auth_async.py @@ -37,7 +65,8 @@ Example resource ID format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name} - Note: Both source and target AI Foundry Resources require 'Cognitive Services User' role for cross-subscription copy. + Important: Cross-resource copying requires credential-based authentication (such as DefaultAzureCredential). + API keys cannot be used for cross-resource operations. """ import asyncio @@ -100,7 +129,7 @@ async def main() -> None: target_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID"] target_region = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_REGION"] - # Create clients + # Create source and target clients using DefaultAzureCredential source_client = ContentUnderstandingClient(endpoint=source_endpoint, credential=source_credential) target_client = ContentUnderstandingClient(endpoint=target_endpoint, credential=target_credential) @@ -120,34 +149,39 @@ async def main() -> None: try: async with source_client, target_client: # Step 1: Create the source analyzer + # The analyzer must exist in the source resource before it can be copied print(f"\nStep 1: Creating source analyzer '{source_analyzer_id}'...") + source_config = ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ) + + source_field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + }, + ) + source_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Source analyzer for cross-resource copying", - config=ContentAnalyzerConfig( - enable_formula=False, - enable_layout=True, - enable_ocr=True, - estimate_field_source_and_confidence=True, - return_details=True, - ), - field_schema=ContentFieldSchema( - name="company_schema", - description="Schema for extracting company information", - fields={ - "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company", - ), - "total_amount": ContentFieldDefinition( - type=ContentFieldType.NUMBER, - method=GenerationMethod.EXTRACT, - description="Total amount on the document", - ), - }, - ), + config=source_config, + field_schema=source_field_schema, models={"completion": "gpt-4.1"}, ) @@ -158,9 +192,15 @@ async def main() -> None: await poller.result() print(f" Source analyzer created successfully!") - # Step 2: Grant copy authorization from source - # Grant authorization on the source client for copying to the target resource + # Step 2: Grant copy authorization + # Authorization must be granted by the source resource before the target resource can copy + # The grant_copy_authorization method takes: + # - The source analyzer ID to be copied + # - The target Azure resource ID that is allowed to receive the copy + # - The target region where the copy will be performed (optional, defaults to current region) print(f"\nStep 2: Granting copy authorization from source resource...") + print(f" Target Azure Resource ID: {target_resource_id}") + print(f" Target Region: {target_region}") copy_auth = await source_client.grant_copy_authorization( analyzer_id=source_analyzer_id, @@ -168,14 +208,20 @@ async def main() -> None: target_region=target_region, ) - print(f" Authorization granted!") + print(f" Authorization granted successfully!") print(f" Target Azure Resource ID: {copy_auth.target_azure_resource_id}") print(f" Target Region: {target_region}") print(f" Expires at: {copy_auth.expires_at}") - # Step 3: Copy analyzer using authorization - # Copy is performed on the target client, copying from source to target + # Step 3: Copy analyzer to target resource + # The copy_analyzer method must be called on the target client because the target + # resource is the one receiving and creating the copy. The target resource validates + # that authorization was previously granted by the source resource. print(f"\nStep 3: Copying analyzer from source to target...") + print(f" Source Analyzer ID: {source_analyzer_id}") + print(f" Source Azure Resource ID: {source_resource_id}") + print(f" Source Region: {source_region}") + print(f" Target Analyzer ID: {target_analyzer_id}") copy_poller = await target_client.begin_copy_analyzer( analyzer_id=target_analyzer_id, @@ -184,14 +230,16 @@ async def main() -> None: source_region=source_region, ) await copy_poller.result() - print(f" Analyzer copied successfully!") + print(f" Analyzer copied successfully to target resource!") # Step 4: Verify the copy + # Retrieve the analyzer from the target resource to verify the copy was successful print(f"\nStep 4: Verifying the copied analyzer...") copied_analyzer = await target_client.get_analyzer(analyzer_id=target_analyzer_id) print(f" Target Analyzer ID: {copied_analyzer.analyzer_id}") print(f" Description: {copied_analyzer.description}") print(f" Status: {copied_analyzer.status}") + print(f"\nCross-resource copy completed successfully!") finally: # Clean up - create new client instances for cleanup since the original ones are closed diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py index 78b71abd1c8b..8f86dc65b751 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py @@ -9,17 +9,45 @@ DESCRIPTION: This sample demonstrates how to grant copy authorization and copy an analyzer from a source - resource to a target resource (cross-resource copying). This is useful for copying analyzers - between different Azure resources or subscriptions. + Microsoft Foundry resource to a target Microsoft Foundry resource (cross-resource copying). + This is useful for copying analyzers between different Azure resources or subscriptions. - The grant_copy_authorization and copy_analyzer APIs allow you to copy an analyzer between - different Azure resources: +ABOUT CROSS-RESOURCE COPYING: + The `grant_copy_authorization` and `copy_analyzer` APIs allow you to copy an analyzer + between different Azure resources: - Cross-resource copy: Copies an analyzer from one Azure resource to another - Authorization required: You must grant copy authorization before copying - - Use cases: Cross-subscription copying, resource migration, multi-region deployment - Note: For same-resource copying (copying within the same Azure resource), use the - sample_copy_analyzer.py sample instead. + When to use cross-resource copying: + - Copy between subscriptions: Move analyzers between different Azure subscriptions + - Multi-region deployment: Deploy the same analyzer to multiple regions + - Resource migration: Migrate analyzers from one resource to another + - Environment promotion: Promote analyzers from development to production across resources + + Note: For same-resource copying (copying within the same Microsoft Foundry resource), + use the sample_copy_analyzer.py sample instead. + +PREREQUISITES: + To get started you'll need a **Microsoft Foundry resource**. For this cross-resource scenario, + you'll also need: + - Source Microsoft Foundry resource with model deployments configured + - Target Microsoft Foundry resource with model deployments configured + + Important: Both the source and target resources require the 'Cognitive Services User' role + to be granted to the credential used to run the code. This role is required for cross-resource + copying operations. Without this role, the grant_copy_authorization and copy_analyzer + operations will fail with authorization errors. + +HOW AUTHORIZATION WORKS: + The grant_copy_authorization method must be called on the source Microsoft Foundry resource + (where the analyzer currently exists). This is because the source resource needs to explicitly + grant permission for its analyzer to be copied. The method creates a time-limited authorization + record that grants permission to a specific target resource. + + Where copy is performed: The copy_analyzer method must be called on the target Microsoft Foundry + resource (where the analyzer will be copied to). This is because the target resource is the one + receiving and creating the copy. When the target resource calls copy_analyzer, the service + validates that authorization was previously granted by the source resource. USAGE: python sample_grant_copy_auth.py @@ -37,7 +65,8 @@ Example resource ID format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{name} - Note: Both source and target AI Foundry Resources require 'Cognitive Services User' role for cross-subscription copy. + Important: Cross-resource copying requires credential-based authentication (such as DefaultAzureCredential). + API keys cannot be used for cross-resource operations. """ import os @@ -99,7 +128,7 @@ def main() -> None: target_resource_id = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_RESOURCE_ID"] target_region = os.environ["AZURE_CONTENT_UNDERSTANDING_TARGET_REGION"] - # Create clients + # Create source and target clients using DefaultAzureCredential source_client = ContentUnderstandingClient(endpoint=source_endpoint, credential=source_credential) target_client = ContentUnderstandingClient(endpoint=target_endpoint, credential=target_credential) @@ -118,34 +147,39 @@ def main() -> None: try: # Step 1: Create the source analyzer + # The analyzer must exist in the source resource before it can be copied print(f"\nStep 1: Creating source analyzer '{source_analyzer_id}'...") + source_config = ContentAnalyzerConfig( + enable_formula=False, + enable_layout=True, + enable_ocr=True, + estimate_field_source_and_confidence=True, + return_details=True, + ) + + source_field_schema = ContentFieldSchema( + name="company_schema", + description="Schema for extracting company information", + fields={ + "company_name": ContentFieldDefinition( + type=ContentFieldType.STRING, + method=GenerationMethod.EXTRACT, + description="Name of the company", + ), + "total_amount": ContentFieldDefinition( + type=ContentFieldType.NUMBER, + method=GenerationMethod.EXTRACT, + description="Total amount on the document", + ), + }, + ) + source_analyzer = ContentAnalyzer( base_analyzer_id="prebuilt-document", description="Source analyzer for cross-resource copying", - config=ContentAnalyzerConfig( - enable_formula=False, - enable_layout=True, - enable_ocr=True, - estimate_field_source_and_confidence=True, - return_details=True, - ), - field_schema=ContentFieldSchema( - name="company_schema", - description="Schema for extracting company information", - fields={ - "company_name": ContentFieldDefinition( - type=ContentFieldType.STRING, - method=GenerationMethod.EXTRACT, - description="Name of the company", - ), - "total_amount": ContentFieldDefinition( - type=ContentFieldType.NUMBER, - method=GenerationMethod.EXTRACT, - description="Total amount on the document", - ), - }, - ), + config=source_config, + field_schema=source_field_schema, models={"completion": "gpt-4.1"}, ) @@ -156,9 +190,15 @@ def main() -> None: poller.result() print(f" Source analyzer created successfully!") - # Step 2: Grant copy authorization from source - # Grant authorization on the source client for copying to the target resource + # Step 2: Grant copy authorization + # Authorization must be granted by the source resource before the target resource can copy + # The grant_copy_authorization method takes: + # - The source analyzer ID to be copied + # - The target Azure resource ID that is allowed to receive the copy + # - The target region where the copy will be performed (optional, defaults to current region) print(f"\nStep 2: Granting copy authorization from source resource...") + print(f" Target Azure Resource ID: {target_resource_id}") + print(f" Target Region: {target_region}") copy_auth = source_client.grant_copy_authorization( analyzer_id=source_analyzer_id, @@ -166,14 +206,20 @@ def main() -> None: target_region=target_region, ) - print(f" Authorization granted!") + print(f" Authorization granted successfully!") print(f" Target Azure Resource ID: {copy_auth.target_azure_resource_id}") print(f" Target Region: {target_region}") print(f" Expires at: {copy_auth.expires_at}") - # Step 3: Copy analyzer using authorization - # Copy is performed on the target client, copying from source to target + # Step 3: Copy analyzer to target resource + # The copy_analyzer method must be called on the target client because the target + # resource is the one receiving and creating the copy. The target resource validates + # that authorization was previously granted by the source resource. print(f"\nStep 3: Copying analyzer from source to target...") + print(f" Source Analyzer ID: {source_analyzer_id}") + print(f" Source Azure Resource ID: {source_resource_id}") + print(f" Source Region: {source_region}") + print(f" Target Analyzer ID: {target_analyzer_id}") copy_poller = target_client.begin_copy_analyzer( analyzer_id=target_analyzer_id, @@ -182,17 +228,19 @@ def main() -> None: source_region=source_region, ) copy_poller.result() - print(f" Analyzer copied successfully!") + print(f" Analyzer copied successfully to target resource!") # Step 4: Verify the copy + # Retrieve the analyzer from the target resource to verify the copy was successful print(f"\nStep 4: Verifying the copied analyzer...") copied_analyzer = target_client.get_analyzer(analyzer_id=target_analyzer_id) print(f" Target Analyzer ID: {copied_analyzer.analyzer_id}") print(f" Description: {copied_analyzer.description}") print(f" Status: {copied_analyzer.status}") + print(f"\nCross-resource copy completed successfully!") finally: - # Clean up + # Clean up: Delete both source and target analyzers print(f"\nCleaning up...") try: source_client.delete_analyzer(analyzer_id=source_analyzer_id) From 9dc93d7fb073587e32b40073bf7a697dfbb6c68f Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 22 Dec 2025 10:58:02 -0800 Subject: [PATCH 096/105] [SAMPLE-DOC] update sample description --- .../sample_analyze_binary_async.py | 29 +++++++++++---- .../sample_analyze_configs_async.py | 6 +-- .../sample_analyze_invoice_async.py | 30 +++++++++++++-- .../async_samples/sample_analyze_url_async.py | 20 +++++++--- .../sample_copy_analyzer_async.py | 8 ++-- .../sample_create_analyzer_async.py | 37 +++++++++++++++---- .../sample_create_classifier_async.py | 33 +++++++++++++---- .../sample_delete_result_async.py | 12 ++++-- .../sample_get_analyzer_async.py | 14 ++++--- .../sample_get_result_file_async.py | 8 ++-- .../sample_grant_copy_auth_async.py | 34 +++++++++++------ .../sample_list_analyzers_async.py | 2 +- .../sample_update_analyzer_async.py | 3 +- .../sample_update_defaults_async.py | 30 +++++++-------- .../samples/sample_analyze_binary.py | 27 ++++++++++---- .../samples/sample_analyze_configs.py | 6 +-- .../samples/sample_analyze_invoice.py | 30 +++++++++++++-- .../samples/sample_analyze_url.py | 20 +++++++--- .../samples/sample_copy_analyzer.py | 8 ++-- .../samples/sample_create_analyzer.py | 37 +++++++++++++++---- .../samples/sample_create_classifier.py | 33 +++++++++++++---- .../samples/sample_delete_result.py | 12 ++++-- .../samples/sample_get_analyzer.py | 14 ++++--- .../samples/sample_get_result_file.py | 8 ++-- .../samples/sample_grant_copy_auth.py | 34 +++++++++++------ .../samples/sample_list_analyzers.py | 2 +- .../samples/sample_update_analyzer.py | 3 +- .../samples/sample_update_defaults.py | 30 +++++++-------- .../samples/test_sample_analyze_binary.py | 15 +------- .../test_sample_analyze_binary_async.py | 17 ++------- .../samples/test_sample_analyze_invoice.py | 3 +- .../test_sample_analyze_invoice_async.py | 5 +-- .../tests/samples/test_sample_analyze_url.py | 5 +-- .../samples/test_sample_analyze_url_async.py | 7 ++-- .../samples/test_sample_copy_analyzer.py | 3 +- .../test_sample_copy_analyzer_async.py | 3 +- .../samples/test_sample_create_analyzer.py | 2 +- .../test_sample_create_analyzer_async.py | 4 +- .../samples/test_sample_create_classifier.py | 4 +- .../test_sample_create_classifier_async.py | 6 +-- .../samples/test_sample_delete_analyzer.py | 8 +++- .../test_sample_delete_analyzer_async.py | 8 +++- .../samples/test_sample_delete_result.py | 2 +- .../test_sample_delete_result_async.py | 2 +- .../tests/samples/test_sample_get_analyzer.py | 3 +- .../samples/test_sample_get_analyzer_async.py | 5 ++- .../samples/test_sample_get_result_file.py | 3 +- .../test_sample_get_result_file_async.py | 3 +- .../samples/test_sample_grant_copy_auth.py | 3 +- .../test_sample_grant_copy_auth_async.py | 3 +- .../samples/test_sample_list_analyzers.py | 12 +++++- .../test_sample_list_analyzers_async.py | 12 +++++- .../samples/test_sample_update_analyzer.py | 8 +++- .../test_sample_update_analyzer_async.py | 8 +++- .../samples/test_sample_update_defaults.py | 4 +- .../test_sample_update_defaults_async.py | 6 ++- 56 files changed, 462 insertions(+), 232 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py index e5f245695056..371ed0f10417 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_binary_async.py @@ -8,8 +8,10 @@ FILE: sample_analyze_binary_async.py DESCRIPTION: - This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` - analyzer (async version). + This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + analyzer. + + ## About analyzing documents from binary data One of the key values of Content Understanding is taking a content file and extracting the content for you in one call. The service returns an AnalyzeResult that contains an array of MediaContent @@ -20,13 +22,24 @@ This sample focuses on document analysis. For prebuilt RAG analyzers covering images, audio, and video, see sample_analyze_url_async.py. - The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- - readable data optimized for RAG scenarios. It generates rich GitHub Flavored Markdown that preserves - document structure and can include structured text, tables (in HTML format), charts and diagrams, - mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. + ## Prebuilt analyzers + + Content Understanding provides prebuilt RAG analyzers (the prebuilt-*Search analyzers, such as + prebuilt-documentSearch) that return markdown and a one-paragraph Summary for each content item, + making them useful for retrieval-augmented generation (RAG) and other downstream applications: + + - prebuilt-documentSearch - Extracts content from documents (PDF, images, Office documents) with + layout preservation, table detection, figure analysis, and structured markdown output. + Optimized for RAG scenarios. + - prebuilt-audioSearch - Transcribes audio content with speaker diarization, timing information, + and conversation summaries. Supports multilingual transcription. + - prebuilt-videoSearch - Analyzes video content with visual frame extraction, audio transcription, + and structured summaries. Provides temporal alignment of visual and audio content. + - prebuilt-imageSearch - Analyzes standalone images and returns a one-paragraph Summary of the + image content. For images that contain text (including hand-written text), use + prebuilt-documentSearch. - For documents that contain images with hand-written text, the prebuilt-documentSearch analyzer - includes OCR capabilities by default. + This sample uses prebuilt-documentSearch to extract structured content from PDF documents. USAGE: python sample_analyze_binary_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index 012d1036eb3b..895857f93dca 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -9,11 +9,11 @@ DESCRIPTION: This sample demonstrates how to extract additional features from documents such as charts, - hyperlinks, formulas, and annotations using the `prebuilt-documentSearch` analyzer, which has + hyperlinks, formulas, and annotations using the prebuilt-documentSearch analyzer, which has formulas, layout, and OCR enabled by default. ABOUT ANALYSIS CONFIGS: - The `prebuilt-documentSearch` analyzer has the following configurations enabled by default: + The prebuilt-documentSearch analyzer has the following configurations enabled by default: - ReturnDetails: true - Returns detailed information about document elements - EnableOcr: true - Performs OCR on documents - EnableLayout: true - Extracts layout information (tables, figures, hyperlinks, annotations) @@ -34,7 +34,7 @@ the analyzer. PREREQUISITES: - To get started you'll need a **Microsoft Foundry resource**. See sample_update_defaults.py + To get started you'll need a Microsoft Foundry resource. See sample_update_defaults.py for setup guidance. USAGE: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index 0149dedff5f3..238d21090146 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -8,11 +8,27 @@ FILE: sample_analyze_invoice_async.py DESCRIPTION: - Analyze an invoice using prebuilt analyzer (async version) + This sample demonstrates how to analyze an invoice from a URL using the prebuilt-invoice analyzer + and extract structured fields from the result. + + ## About analyzing invoices + + Content Understanding provides a rich set of prebuilt analyzers that are ready to use without any + configuration. These analyzers are powered by knowledge bases of thousands of real-world document + examples, enabling them to understand document structure and adapt to variations in format and + content. + + Prebuilt analyzers are ideal for: + - Content ingestion in search and retrieval-augmented generation (RAG) workflows + - Intelligent document processing (IDP) to extract structured data from common document types + - Agentic flows as tools for extracting structured representations from input files + + ### The prebuilt-invoice analyzer + + The prebuilt-invoice analyzer is a domain-specific analyzer optimized for processing invoices, + utility bills, sales orders, and purchase orders. It automatically extracts structured fields + including: - This sample demonstrates how to analyze an invoice from a URL using the `prebuilt-invoice` analyzer - and extract structured fields from the result. The prebuilt-invoice analyzer automatically extracts - structured fields including: - Customer/Vendor information: Name, address, contact details - Invoice metadata: Invoice number, date, due date, purchase order number - Line items: Description, quantity, unit price, total for each item @@ -20,6 +36,12 @@ - Payment information: Payment terms, payment method, remittance address The analyzer works out of the box with various invoice formats and requires no configuration. + It's part of the financial documents category of prebuilt analyzers, which also includes: + - prebuilt-receipt - Sales receipts from retail and dining establishments + - prebuilt-creditCard - Credit card statements + - prebuilt-bankStatement.us - US bank statements + - prebuilt-check.us - US bank checks + - prebuilt-creditMemo - Credit memos and refund documents USAGE: python sample_analyze_invoice_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py index 637cc0bd9c59..78f8d6e91a16 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_url_async.py @@ -9,18 +9,26 @@ DESCRIPTION: Another great value of Content Understanding is its rich set of prebuilt analyzers. Great examples - of these are the RAG analyzers that work for all modalities (prebuilt-documentSearch, prebuilt-imageSearch, - prebuilt-audioSearch, and prebuilt-videoSearch). + of these are the RAG analyzers that work for all modalities (prebuilt-documentSearch, + prebuilt-imageSearch, prebuilt-audioSearch, and prebuilt-videoSearch). This sample demonstrates + these RAG analyzers. Many more prebuilt analyzers are available (for example, prebuilt-invoice); + see the invoice sample or the prebuilt analyzer documentation to explore the full list. - This sample demonstrates these RAG analyzers with URL inputs. Content Understanding supports both - local binary inputs (see sample_analyze_binary_async.py) and URL inputs across all modalities. + ## About analyzing URLs across modalities + + Content Understanding supports both local binary inputs (see sample_analyze_binary_async.py) and URL + inputs across all modalities. This sample focuses on prebuilt RAG analyzers (the prebuilt-*Search + analyzers, such as prebuilt-documentSearch) with URL inputs. Important: For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. - For binary data (local files), use begin_analyze_binary() instead. + For binary data (local files), use begin_analyze_binary() instead. This sample demonstrates + begin_analyze() with URL inputs. Documents, HTML, and images with text are returned as DocumentContent (derived from MediaContent), while audio and video are returned as AudioVisualContent (also derived from MediaContent). These - prebuilt RAG analyzers return markdown and a one-paragraph Summary for each content item. + prebuilt RAG analyzers return markdown and a one-paragraph Summary for each content item; + prebuilt-videoSearch can return multiple segments, so iterate over all contents rather than just + the first. USAGE: python sample_analyze_url_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_copy_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_copy_analyzer_async.py index c2e85a9f4610..d1aa8546be5d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_copy_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_copy_analyzer_async.py @@ -9,13 +9,13 @@ DESCRIPTION: This sample demonstrates how to copy an analyzer from source to target within the same - resource using the copy_analyzer API. This is useful for creating copies of analyzers - for testing, staging, or production deployment. + Microsoft Foundry resource using the begin_copy_analyzer API. This is useful for + creating copies of analyzers for testing, staging, or production deployment. - The copy_analyzer API allows you to copy an analyzer within the same Azure resource: + About copying analyzers + The begin_copy_analyzer API allows you to copy an analyzer within the same Azure resource: - Same-resource copy: Copies an analyzer from one ID to another within the same resource - Exact copy: The target analyzer is an exact copy of the source analyzer - - Use cases: Testing, staging, production deployment, versioning Note: For cross-resource copying (copying between different Azure resources or subscriptions), use the grant_copy_auth sample instead. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py index c42df525fc1a..1e98d7d72739 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_analyzer_async.py @@ -9,17 +9,38 @@ DESCRIPTION: This sample demonstrates how to create a custom analyzer with a field schema to extract - structured data from documents. + structured data from documents. While this sample shows document modalities, custom analyzers + can also be created for video, audio, and image content. The same concepts apply across all + modalities. - Custom analyzers allow you to: + ## About custom analyzers + + Custom analyzers allow you to define a field schema that specifies what structured data to + extract from documents. You can: - Define custom fields (string, number, date, object, array) - - Specify extraction methods: - - extract: Values are extracted as they appear in the content (literal text extraction) - - generate: Values are generated freely based on the content using AI models - - classify: Values are classified against a predefined set of categories - - Use prebuilt analyzers as a base (prebuilt-document, prebuilt-audio, prebuilt-video, prebuilt-image) + - Specify extraction methods to control how field values are extracted: + - generate - Values are generated freely based on the content using AI models (best for + complex or variable fields requiring interpretation) + - classify - Values are classified against a predefined set of categories (best when using + enum with a fixed set of possible values) + - extract - Values are extracted as they appear in the content (best for literal text + extraction from specific locations). Note: This method is only available for document + content. Requires estimateSourceAndConfidence to be set to true for the field. + + When not specified, the system automatically determines the best method based on the field + type and description. + - Use prebuilt analyzers as a base. Supported base analyzers include: + - prebuilt-document - for document-based custom analyzers + - prebuilt-audio - for audio-based custom analyzers + - prebuilt-video - for video-based custom analyzers + - prebuilt-image - for image-based custom analyzers - Configure analysis options (OCR, layout, formulas) - - Enable source and confidence tracking for extracted field values + - Enable source and confidence tracking: Set estimateFieldSourceAndConfidence to true at the + analyzer level (in ContentAnalyzerConfig) or estimateSourceAndConfidence to true at the field + level to get source location (page number, bounding box) and confidence scores for extracted + field values. This is required for fields with method = extract and is useful for validation, + quality assurance, debugging, and highlighting source text in user interfaces. Field-level + settings override analyzer-level settings. USAGE: python sample_create_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py index 51d602454369..1ba711f4c9e4 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_create_classifier_async.py @@ -8,14 +8,31 @@ FILE: sample_create_classifier_async.py DESCRIPTION: - This sample demonstrates how to create a classifier analyzer to categorize documents and - use it to analyze documents with and without automatic segmentation. - - Classifiers are a type of custom analyzer that categorize documents into predefined categories. - They're useful for: - - Document routing: Automatically route documents to the right processing pipeline - - Content organization: Organize large document collections by type - - Multi-document processing: Process files containing multiple document types by segmenting them + This sample demonstrates how to create a classifier analyzer to categorize documents and use it + to analyze documents with and without automatic segmentation. + + ## About classifiers + + Classifiers are a type of custom analyzer that create classification workflows to categorize + documents into predefined custom categories using ContentCategories. They allow you to perform + classification and content extraction as part of a single API call. Classifiers are useful for: + - Content organization: Organize large document collections by type through categorization + - Data routing (optional): Optionally route your data to specific custom analyzers based on + category, ensuring your data is routed to the best analyzer for processing when needed + - Multi-document processing: Process files containing multiple document types by automatically + segmenting them + + Classifiers use custom categories to define the types of documents they can identify. Each + category has a Description that helps the AI model understand what documents belong to that + category. You can define up to 200 category names and descriptions. You can include an "other" + category to handle unmatched content; otherwise, all files are forced to be classified into one + of your defined categories. + + The enable_segment property in the analyzer configuration controls whether multi-document files + are split into segments: + - enable_segment = False: Classifies the entire file as a single category (classify only) + - enable_segment = True: Automatically splits the file into segments by category (classify and + segment) USAGE: python sample_create_classifier_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py index d7fb2239a4cf..3a1118ace362 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_delete_result_async.py @@ -12,10 +12,14 @@ This is useful for removing temporary or sensitive analysis results immediately, rather than waiting for automatic deletion after 24 hours. - Analysis results are stored temporarily and can be deleted using the delete_result API: - - Immediate deletion: Results are marked for deletion and permanently removed - - Automatic deletion: Results are automatically deleted after 24 hours if not manually deleted - - Operation ID required: You need the operation ID from the analysis operation to delete + About deleting results: + Analysis results from analyze or begin_analyze are automatically deleted after 24 hours. + However, you may want to delete results earlier in certain cases: + - Remove sensitive data immediately: Ensure sensitive information is not retained longer than necessary + - Comply with data retention policies: Meet requirements for data deletion + + To delete results earlier than the 24-hour automatic deletion, use delete_result. + This method requires the operation ID from the analysis operation. Important: Once deleted, results cannot be recovered. Make sure you have saved any data you need before deleting. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py index 9e97f7c35895..6f5336e10341 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_analyzer_async.py @@ -11,14 +11,18 @@ This sample demonstrates how to retrieve information about analyzers, including prebuilt analyzers and custom analyzers. - The get_analyzer method allows you to retrieve detailed information about any analyzer: - - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice + ## About getting analyzer information + + The get_analyzer method allows you to retrieve detailed information about any analyzer, + including: + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice, + etc. - Custom analyzers: Analyzers you've created with custom field schemas or classifiers This is useful for: - - Verifying analyzer configuration - - Inspecting prebuilt analyzers to learn about their capabilities - - Debugging analyzer behavior + - Verifying analyzer configuration: Check the current state of an analyzer + - Inspecting prebuilt analyzers: Learn about available prebuilt analyzers and their capabilities + - Debugging: Understand why an analyzer behaves a certain way USAGE: python sample_get_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py index 58adcc3d244b..fdbf1fddf422 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_get_result_file_async.py @@ -9,18 +9,18 @@ DESCRIPTION: This sample demonstrates how to retrieve result files (such as keyframe images) from a - video analysis operation using the `get_result_file` API. + video analysis operation using the get_result_file API. About result files: When analyzing video content, the Content Understanding service can generate result files such as: - Keyframe images: Extracted frames from the video at specific timestamps - Other result files: Additional files generated during analysis - The `get_result_file` API allows you to retrieve these files using: + The get_result_file API allows you to retrieve these files using: - Operation ID: Extracted from the analysis operation - File path: The path to the specific result file. In the recording, keyframes were accessed - with paths like `keyframes/733` and `keyframes/9000`, following the - `keyframes/{frameTimeMs}` pattern. + with paths like keyframes/733 and keyframes/9000, following the + keyframes/{frameTimeMs} pattern. USAGE: python sample_get_result_file_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py index c43404a12871..26b9d31af06b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_grant_copy_auth_async.py @@ -12,8 +12,8 @@ Microsoft Foundry resource to a target Microsoft Foundry resource (cross-resource copying). This is useful for copying analyzers between different Azure resources or subscriptions. -ABOUT CROSS-RESOURCE COPYING: - The `grant_copy_authorization` and `copy_analyzer` APIs allow you to copy an analyzer + About cross-resource copying + The grant_copy_authorization and begin_copy_analyzer APIs allow you to copy an analyzer between different Azure resources: - Cross-resource copy: Copies an analyzer from one Azure resource to another - Authorization required: You must grant copy authorization before copying @@ -28,26 +28,36 @@ use the sample_copy_analyzer_async.py sample instead. PREREQUISITES: - To get started you'll need a **Microsoft Foundry resource**. For this cross-resource scenario, - you'll also need: + To get started you'll need a Microsoft Foundry resource. See Sample 00: Configure model + deployment defaults for setup guidance. For this cross-resource scenario, you'll also need: - Source Microsoft Foundry resource with model deployments configured - Target Microsoft Foundry resource with model deployments configured - + Important: Both the source and target resources require the 'Cognitive Services User' role to be granted to the credential used to run the code. This role is required for cross-resource - copying operations. Without this role, the grant_copy_authorization and copy_analyzer + copying operations. Without this role, the grant_copy_authorization and begin_copy_analyzer operations will fail with authorization errors. HOW AUTHORIZATION WORKS: The grant_copy_authorization method must be called on the source Microsoft Foundry resource (where the analyzer currently exists). This is because the source resource needs to explicitly grant permission for its analyzer to be copied. The method creates a time-limited authorization - record that grants permission to a specific target resource. - - Where copy is performed: The copy_analyzer method must be called on the target Microsoft Foundry - resource (where the analyzer will be copied to). This is because the target resource is the one - receiving and creating the copy. When the target resource calls copy_analyzer, the service - validates that authorization was previously granted by the source resource. + record that grants permission to a specific target resource. The method takes: + - The source analyzer ID to be copied + - The target Azure resource ID that is allowed to receive the copy + - The target region where the copy will be performed (optional, defaults to current region) + + The method returns a CopyAuthorization object containing: + - The full path of the source analyzer + - The target Azure resource ID + - An expiration timestamp for the authorization + + Where copy is performed: The begin_copy_analyzer method must be called on the target Microsoft + Foundry resource (where the analyzer will be copied to). This is because the target resource + is the one receiving and creating the copy. When the target resource calls begin_copy_analyzer, + the service validates that authorization was previously granted by the source resource. The + authorization must be active (not expired) and match the target resource ID and region + specified in the copy request. USAGE: python sample_grant_copy_auth_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py index c8d38f52825b..007e4620afc8 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_list_analyzers_async.py @@ -12,7 +12,7 @@ resource, including both prebuilt and custom analyzers. The list_analyzers method returns all analyzers in your resource, including: - - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice, etc. - Custom analyzers: Analyzers you've created This is useful for: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py index c081a9f64c1d..ad2a19d65669 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_analyzer_async.py @@ -11,7 +11,8 @@ This sample demonstrates how to update an existing custom analyzer, including updating its description and tags. - The update_analyzer method allows you to modify certain properties of an existing analyzer: + The update_analyzer method allows you to modify certain properties of an existing analyzer. + The following properties can be updated: - Description: Update the analyzer's description - Tags: Add or update tags diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py index 03f4283cca04..7e2322539e7c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_update_defaults_async.py @@ -9,21 +9,21 @@ DESCRIPTION: This sample demonstrates how to configure and retrieve default model deployment settings - for your Microsoft Foundry resource. This is a **required one-time setup per Microsoft Foundry - resource** before using prebuilt or custom analyzers. + for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry + resource before using prebuilt or custom analyzers. ## About model deployment configuration Content Understanding prebuilt analyzers and custom analyzers require specific large language model deployments to function. Currently, Content Understanding uses OpenAI GPT models: - - **gpt-4.1** - Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, + - gpt-4.1 - Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument) - - **gpt-4.1-mini** - Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, + - gpt-4.1-mini - Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch, prebuilt-videoSearch) - - **text-embedding-3-large** - Used for semantic search and embeddings + - text-embedding-3-large - Used for semantic search and embeddings - This configuration is **per Microsoft Foundry resource** and persists across sessions. + This configuration is per Microsoft Foundry resource and persists across sessions. You only need to configure it once per Microsoft Foundry resource (or when you change deployment names). @@ -31,20 +31,20 @@ To get started you'll need: - 1. An Azure subscription and a **Microsoft Foundry resource**. To create a Microsoft Foundry + 1. An Azure subscription and a Microsoft Foundry resource. To create a Microsoft Foundry resource, follow the steps in the Azure Content Understanding quickstart. You must create your Microsoft Foundry resource in a region that supports Content Understanding. - 2. After creating your Microsoft Foundry resource, you must grant yourself the **Cognitive Services - User** role to enable API calls for setting default model deployments. This role assignment + 2. After creating your Microsoft Foundry resource, you must grant yourself the Cognitive Services + User role to enable API calls for setting default model deployments. This role assignment is required even if you are the owner of the resource. - 3. Take note of your Microsoft Foundry resource **endpoint** and, if you plan to use key-based - authentication, the **API key**. A typical endpoint looks like: + 3. Take note of your Microsoft Foundry resource endpoint and, if you plan to use key-based + authentication, the API key. A typical endpoint looks like: https://your-foundry.services.ai.azure.com - 4. If you plan to use `DefaultAzureCredential` for authentication, you will need to log in to - Azure first. Typically, you can do this by running `az login` (Azure CLI) or `azd login` + 4. If you plan to use DefaultAzureCredential for authentication, you will need to log in to + Azure first. Typically, you can do this by running az login (Azure CLI) or azd login (Azure Developer CLI) in your terminal. 5. Deploy the following models in Microsoft Foundry: @@ -52,9 +52,9 @@ - gpt-4.1-mini - text-embedding-3-large - 6. Take note of the **deployment names** used for each model. The convention is to use the model + 6. Take note of the deployment names used for each model. The convention is to use the model names (e.g., "gpt-4.1", "gpt-4.1-mini", "text-embedding-3-large"), but you can change these - during deployment. + during deployment. You'll use these deployment names when configuring defaults. USAGE: python sample_update_defaults_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py index 2386d4d9b634..0c94d38b9715 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py @@ -8,9 +8,11 @@ FILE: sample_analyze_binary.py DESCRIPTION: - This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` + This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch analyzer. + ## About analyzing documents from binary data + One of the key values of Content Understanding is taking a content file and extracting the content for you in one call. The service returns an AnalyzeResult that contains an array of MediaContent items in AnalyzeResult.contents. This sample starts with a document file, so each item is a @@ -20,13 +22,24 @@ This sample focuses on document analysis. For prebuilt RAG analyzers covering images, audio, and video, see sample_analyze_url.py. - The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- - readable data optimized for RAG scenarios. It generates rich GitHub Flavored Markdown that preserves - document structure and can include structured text, tables (in HTML format), charts and diagrams, - mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. + ## Prebuilt analyzers + + Content Understanding provides prebuilt RAG analyzers (the prebuilt-*Search analyzers, such as + prebuilt-documentSearch) that return markdown and a one-paragraph Summary for each content item, + making them useful for retrieval-augmented generation (RAG) and other downstream applications: + + - prebuilt-documentSearch - Extracts content from documents (PDF, images, Office documents) with + layout preservation, table detection, figure analysis, and structured markdown output. + Optimized for RAG scenarios. + - prebuilt-audioSearch - Transcribes audio content with speaker diarization, timing information, + and conversation summaries. Supports multilingual transcription. + - prebuilt-videoSearch - Analyzes video content with visual frame extraction, audio transcription, + and structured summaries. Provides temporal alignment of visual and audio content. + - prebuilt-imageSearch - Analyzes standalone images and returns a one-paragraph Summary of the + image content. For images that contain text (including hand-written text), use + prebuilt-documentSearch. - For documents that contain images with hand-written text, the prebuilt-documentSearch analyzer - includes OCR capabilities by default. + This sample uses prebuilt-documentSearch to extract structured content from PDF documents. USAGE: python sample_analyze_binary.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index 6a93ea9dfff3..7d0e7f04469a 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -9,11 +9,11 @@ DESCRIPTION: This sample demonstrates how to extract additional features from documents such as charts, - hyperlinks, formulas, and annotations using the `prebuilt-documentSearch` analyzer, which has + hyperlinks, formulas, and annotations using the prebuilt-documentSearch analyzer, which has formulas, layout, and OCR enabled by default. ABOUT ANALYSIS CONFIGS: - The `prebuilt-documentSearch` analyzer has the following configurations enabled by default: + The prebuilt-documentSearch analyzer has the following configurations enabled by default: - ReturnDetails: true - Returns detailed information about document elements - EnableOcr: true - Performs OCR on documents - EnableLayout: true - Extracts layout information (tables, figures, hyperlinks, annotations) @@ -34,7 +34,7 @@ the analyzer. PREREQUISITES: - To get started you'll need a **Microsoft Foundry resource**. See sample_update_defaults.py + To get started you'll need a Microsoft Foundry resource. See sample_update_defaults.py for setup guidance. USAGE: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index 61b9ea610572..769d343080b1 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -8,11 +8,27 @@ FILE: sample_analyze_invoice.py DESCRIPTION: - Analyze an invoice using prebuilt analyzer + This sample demonstrates how to analyze an invoice from a URL using the prebuilt-invoice analyzer + and extract structured fields from the result. + + ## About analyzing invoices + + Content Understanding provides a rich set of prebuilt analyzers that are ready to use without any + configuration. These analyzers are powered by knowledge bases of thousands of real-world document + examples, enabling them to understand document structure and adapt to variations in format and + content. + + Prebuilt analyzers are ideal for: + - Content ingestion in search and retrieval-augmented generation (RAG) workflows + - Intelligent document processing (IDP) to extract structured data from common document types + - Agentic flows as tools for extracting structured representations from input files + + ### The prebuilt-invoice analyzer + + The prebuilt-invoice analyzer is a domain-specific analyzer optimized for processing invoices, + utility bills, sales orders, and purchase orders. It automatically extracts structured fields + including: - This sample demonstrates how to analyze an invoice from a URL using the `prebuilt-invoice` analyzer - and extract structured fields from the result. The prebuilt-invoice analyzer automatically extracts - structured fields including: - Customer/Vendor information: Name, address, contact details - Invoice metadata: Invoice number, date, due date, purchase order number - Line items: Description, quantity, unit price, total for each item @@ -20,6 +36,12 @@ - Payment information: Payment terms, payment method, remittance address The analyzer works out of the box with various invoice formats and requires no configuration. + It's part of the financial documents category of prebuilt analyzers, which also includes: + - prebuilt-receipt - Sales receipts from retail and dining establishments + - prebuilt-creditCard - Credit card statements + - prebuilt-bankStatement.us - US bank statements + - prebuilt-check.us - US bank checks + - prebuilt-creditMemo - Credit memos and refund documents USAGE: python sample_analyze_invoice.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py index 8f3234e7c6a7..7d3dae8df044 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_url.py @@ -9,18 +9,26 @@ DESCRIPTION: Another great value of Content Understanding is its rich set of prebuilt analyzers. Great examples - of these are the RAG analyzers that work for all modalities (prebuilt-documentSearch, prebuilt-imageSearch, - prebuilt-audioSearch, and prebuilt-videoSearch). + of these are the RAG analyzers that work for all modalities (prebuilt-documentSearch, + prebuilt-imageSearch, prebuilt-audioSearch, and prebuilt-videoSearch). This sample demonstrates + these RAG analyzers. Many more prebuilt analyzers are available (for example, prebuilt-invoice); + see the invoice sample or the prebuilt analyzer documentation to explore the full list. - This sample demonstrates these RAG analyzers with URL inputs. Content Understanding supports both - local binary inputs (see sample_analyze_binary.py) and URL inputs across all modalities. + ## About analyzing URLs across modalities + + Content Understanding supports both local binary inputs (see sample_analyze_binary.py) and URL + inputs across all modalities. This sample focuses on prebuilt RAG analyzers (the prebuilt-*Search + analyzers, such as prebuilt-documentSearch) with URL inputs. Important: For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. - For binary data (local files), use begin_analyze_binary() instead. + For binary data (local files), use begin_analyze_binary() instead. This sample demonstrates + begin_analyze() with URL inputs. Documents, HTML, and images with text are returned as DocumentContent (derived from MediaContent), while audio and video are returned as AudioVisualContent (also derived from MediaContent). These - prebuilt RAG analyzers return markdown and a one-paragraph Summary for each content item. + prebuilt RAG analyzers return markdown and a one-paragraph Summary for each content item; + prebuilt-videoSearch can return multiple segments, so iterate over all contents rather than just + the first. USAGE: python sample_analyze_url.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py index 8875f5b3a566..9769141a07b3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_copy_analyzer.py @@ -9,13 +9,13 @@ DESCRIPTION: This sample demonstrates how to copy an analyzer from source to target within the same - resource using the copy_analyzer API. This is useful for creating copies of analyzers - for testing, staging, or production deployment. + Microsoft Foundry resource using the begin_copy_analyzer API. This is useful for + creating copies of analyzers for testing, staging, or production deployment. - The copy_analyzer API allows you to copy an analyzer within the same Azure resource: + About copying analyzers + The begin_copy_analyzer API allows you to copy an analyzer within the same Azure resource: - Same-resource copy: Copies an analyzer from one ID to another within the same resource - Exact copy: The target analyzer is an exact copy of the source analyzer - - Use cases: Testing, staging, production deployment, versioning Note: For cross-resource copying (copying between different Azure resources or subscriptions), use the grant_copy_auth sample instead. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py index 284c5d01655a..14e42b98ef36 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_analyzer.py @@ -9,17 +9,38 @@ DESCRIPTION: This sample demonstrates how to create a custom analyzer with a field schema to extract - structured data from documents. + structured data from documents. While this sample shows document modalities, custom analyzers + can also be created for video, audio, and image content. The same concepts apply across all + modalities. - Custom analyzers allow you to: + ## About custom analyzers + + Custom analyzers allow you to define a field schema that specifies what structured data to + extract from documents. You can: - Define custom fields (string, number, date, object, array) - - Specify extraction methods: - - extract: Values are extracted as they appear in the content (literal text extraction) - - generate: Values are generated freely based on the content using AI models - - classify: Values are classified against a predefined set of categories - - Use prebuilt analyzers as a base (prebuilt-document, prebuilt-audio, prebuilt-video, prebuilt-image) + - Specify extraction methods to control how field values are extracted: + - generate - Values are generated freely based on the content using AI models (best for + complex or variable fields requiring interpretation) + - classify - Values are classified against a predefined set of categories (best when using + enum with a fixed set of possible values) + - extract - Values are extracted as they appear in the content (best for literal text + extraction from specific locations). Note: This method is only available for document + content. Requires estimateSourceAndConfidence to be set to true for the field. + + When not specified, the system automatically determines the best method based on the field + type and description. + - Use prebuilt analyzers as a base. Supported base analyzers include: + - prebuilt-document - for document-based custom analyzers + - prebuilt-audio - for audio-based custom analyzers + - prebuilt-video - for video-based custom analyzers + - prebuilt-image - for image-based custom analyzers - Configure analysis options (OCR, layout, formulas) - - Enable source and confidence tracking for extracted field values + - Enable source and confidence tracking: Set estimateFieldSourceAndConfidence to true at the + analyzer level (in ContentAnalyzerConfig) or estimateSourceAndConfidence to true at the field + level to get source location (page number, bounding box) and confidence scores for extracted + field values. This is required for fields with method = extract and is useful for validation, + quality assurance, debugging, and highlighting source text in user interfaces. Field-level + settings override analyzer-level settings. USAGE: python sample_create_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py index c3dece6b01e9..79bf7ccef29d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_create_classifier.py @@ -8,14 +8,31 @@ FILE: sample_create_classifier.py DESCRIPTION: - This sample demonstrates how to create a classifier analyzer to categorize documents and - use it to analyze documents with and without automatic segmentation. - - Classifiers are a type of custom analyzer that categorize documents into predefined categories. - They're useful for: - - Document routing: Automatically route documents to the right processing pipeline - - Content organization: Organize large document collections by type - - Multi-document processing: Process files containing multiple document types by segmenting them + This sample demonstrates how to create a classifier analyzer to categorize documents and use it + to analyze documents with and without automatic segmentation. + + ## About classifiers + + Classifiers are a type of custom analyzer that create classification workflows to categorize + documents into predefined custom categories using ContentCategories. They allow you to perform + classification and content extraction as part of a single API call. Classifiers are useful for: + - Content organization: Organize large document collections by type through categorization + - Data routing (optional): Optionally route your data to specific custom analyzers based on + category, ensuring your data is routed to the best analyzer for processing when needed + - Multi-document processing: Process files containing multiple document types by automatically + segmenting them + + Classifiers use custom categories to define the types of documents they can identify. Each + category has a Description that helps the AI model understand what documents belong to that + category. You can define up to 200 category names and descriptions. You can include an "other" + category to handle unmatched content; otherwise, all files are forced to be classified into one + of your defined categories. + + The enable_segment property in the analyzer configuration controls whether multi-document files + are split into segments: + - enable_segment = False: Classifies the entire file as a single category (classify only) + - enable_segment = True: Automatically splits the file into segments by category (classify and + segment) USAGE: python sample_create_classifier.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py index 401ae82b7ca2..a22b287d6ed5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_delete_result.py @@ -12,10 +12,14 @@ This is useful for removing temporary or sensitive analysis results immediately, rather than waiting for automatic deletion after 24 hours. - Analysis results are stored temporarily and can be deleted using the delete_result API: - - Immediate deletion: Results are marked for deletion and permanently removed - - Automatic deletion: Results are automatically deleted after 24 hours if not manually deleted - - Operation ID required: You need the operation ID from the analysis operation to delete + About deleting results: + Analysis results from analyze or begin_analyze are automatically deleted after 24 hours. + However, you may want to delete results earlier in certain cases: + - Remove sensitive data immediately: Ensure sensitive information is not retained longer than necessary + - Comply with data retention policies: Meet requirements for data deletion + + To delete results earlier than the 24-hour automatic deletion, use delete_result. + This method requires the operation ID from the analysis operation. Important: Once deleted, results cannot be recovered. Make sure you have saved any data you need before deleting. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py index b88a835b0276..f19b87439268 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_analyzer.py @@ -11,14 +11,18 @@ This sample demonstrates how to retrieve information about analyzers, including prebuilt analyzers and custom analyzers. - The get_analyzer method allows you to retrieve detailed information about any analyzer: - - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice + ## About getting analyzer information + + The get_analyzer method allows you to retrieve detailed information about any analyzer, + including: + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice, + etc. - Custom analyzers: Analyzers you've created with custom field schemas or classifiers This is useful for: - - Verifying analyzer configuration - - Inspecting prebuilt analyzers to learn about their capabilities - - Debugging analyzer behavior + - Verifying analyzer configuration: Check the current state of an analyzer + - Inspecting prebuilt analyzers: Learn about available prebuilt analyzers and their capabilities + - Debugging: Understand why an analyzer behaves a certain way USAGE: python sample_get_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py index 5c8100a86e67..31f844c2ec86 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_get_result_file.py @@ -9,18 +9,18 @@ DESCRIPTION: This sample demonstrates how to retrieve result files (such as keyframe images) from a - video analysis operation using the `get_result_file` API. + video analysis operation using the get_result_file API. About result files: When analyzing video content, the Content Understanding service can generate result files such as: - Keyframe images: Extracted frames from the video at specific timestamps - Other result files: Additional files generated during analysis - The `get_result_file` API allows you to retrieve these files using: + The get_result_file API allows you to retrieve these files using: - Operation ID: Extracted from the analysis operation - File path: The path to the specific result file. In the recording, keyframes were accessed - with paths like `keyframes/733` and `keyframes/9000`, following the - `keyframes/{frameTimeMs}` pattern. + with paths like keyframes/733 and keyframes/9000, following the + keyframes/{frameTimeMs} pattern. USAGE: python sample_get_result_file.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py index 8f86dc65b751..0e743ca19630 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_grant_copy_auth.py @@ -12,8 +12,8 @@ Microsoft Foundry resource to a target Microsoft Foundry resource (cross-resource copying). This is useful for copying analyzers between different Azure resources or subscriptions. -ABOUT CROSS-RESOURCE COPYING: - The `grant_copy_authorization` and `copy_analyzer` APIs allow you to copy an analyzer + About cross-resource copying + The grant_copy_authorization and begin_copy_analyzer APIs allow you to copy an analyzer between different Azure resources: - Cross-resource copy: Copies an analyzer from one Azure resource to another - Authorization required: You must grant copy authorization before copying @@ -28,26 +28,36 @@ use the sample_copy_analyzer.py sample instead. PREREQUISITES: - To get started you'll need a **Microsoft Foundry resource**. For this cross-resource scenario, - you'll also need: + To get started you'll need a Microsoft Foundry resource. See Sample 00: Configure model + deployment defaults for setup guidance. For this cross-resource scenario, you'll also need: - Source Microsoft Foundry resource with model deployments configured - Target Microsoft Foundry resource with model deployments configured - + Important: Both the source and target resources require the 'Cognitive Services User' role to be granted to the credential used to run the code. This role is required for cross-resource - copying operations. Without this role, the grant_copy_authorization and copy_analyzer + copying operations. Without this role, the grant_copy_authorization and begin_copy_analyzer operations will fail with authorization errors. HOW AUTHORIZATION WORKS: The grant_copy_authorization method must be called on the source Microsoft Foundry resource (where the analyzer currently exists). This is because the source resource needs to explicitly grant permission for its analyzer to be copied. The method creates a time-limited authorization - record that grants permission to a specific target resource. - - Where copy is performed: The copy_analyzer method must be called on the target Microsoft Foundry - resource (where the analyzer will be copied to). This is because the target resource is the one - receiving and creating the copy. When the target resource calls copy_analyzer, the service - validates that authorization was previously granted by the source resource. + record that grants permission to a specific target resource. The method takes: + - The source analyzer ID to be copied + - The target Azure resource ID that is allowed to receive the copy + - The target region where the copy will be performed (optional, defaults to current region) + + The method returns a CopyAuthorization object containing: + - The full path of the source analyzer + - The target Azure resource ID + - An expiration timestamp for the authorization + + Where copy is performed: The begin_copy_analyzer method must be called on the target Microsoft + Foundry resource (where the analyzer will be copied to). This is because the target resource + is the one receiving and creating the copy. When the target resource calls begin_copy_analyzer, + the service validates that authorization was previously granted by the source resource. The + authorization must be active (not expired) and match the target resource ID and region + specified in the copy request. USAGE: python sample_grant_copy_auth.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py index 9562d334f1d5..48c4fb386e40 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_list_analyzers.py @@ -12,7 +12,7 @@ resource, including both prebuilt and custom analyzers. The list_analyzers method returns all analyzers in your resource, including: - - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice, etc. - Custom analyzers: Analyzers you've created This is useful for: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py index 70959bb3f7f4..538376c7f14b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_analyzer.py @@ -11,7 +11,8 @@ This sample demonstrates how to update an existing custom analyzer, including updating its description and tags. - The update_analyzer method allows you to modify certain properties of an existing analyzer: + The update_analyzer method allows you to modify certain properties of an existing analyzer. + The following properties can be updated: - Description: Update the analyzer's description - Tags: Add or update tags diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py index 7e1e359e69c2..e286e6a3e2ce 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py @@ -9,21 +9,21 @@ DESCRIPTION: This sample demonstrates how to configure and retrieve default model deployment settings - for your Microsoft Foundry resource. This is a **required one-time setup per Microsoft Foundry - resource** before using prebuilt or custom analyzers. + for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry + resource before using prebuilt or custom analyzers. ## About model deployment configuration Content Understanding prebuilt analyzers and custom analyzers require specific large language model deployments to function. Currently, Content Understanding uses OpenAI GPT models: - - **gpt-4.1** - Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, + - gpt-4.1 - Used by most prebuilt analyzers (e.g., prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument) - - **gpt-4.1-mini** - Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, + - gpt-4.1-mini - Used by RAG analyzers (e.g., prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch, prebuilt-videoSearch) - - **text-embedding-3-large** - Used for semantic search and embeddings + - text-embedding-3-large - Used for semantic search and embeddings - This configuration is **per Microsoft Foundry resource** and persists across sessions. + This configuration is per Microsoft Foundry resource and persists across sessions. You only need to configure it once per Microsoft Foundry resource (or when you change deployment names). @@ -31,20 +31,20 @@ To get started you'll need: - 1. An Azure subscription and a **Microsoft Foundry resource**. To create a Microsoft Foundry + 1. An Azure subscription and a Microsoft Foundry resource. To create a Microsoft Foundry resource, follow the steps in the Azure Content Understanding quickstart. You must create your Microsoft Foundry resource in a region that supports Content Understanding. - 2. After creating your Microsoft Foundry resource, you must grant yourself the **Cognitive Services - User** role to enable API calls for setting default model deployments. This role assignment + 2. After creating your Microsoft Foundry resource, you must grant yourself the Cognitive Services + User role to enable API calls for setting default model deployments. This role assignment is required even if you are the owner of the resource. - 3. Take note of your Microsoft Foundry resource **endpoint** and, if you plan to use key-based - authentication, the **API key**. A typical endpoint looks like: + 3. Take note of your Microsoft Foundry resource endpoint and, if you plan to use key-based + authentication, the API key. A typical endpoint looks like: https://your-foundry.services.ai.azure.com - 4. If you plan to use `DefaultAzureCredential` for authentication, you will need to log in to - Azure first. Typically, you can do this by running `az login` (Azure CLI) or `azd login` + 4. If you plan to use DefaultAzureCredential for authentication, you will need to log in to + Azure first. Typically, you can do this by running az login (Azure CLI) or azd login (Azure Developer CLI) in your terminal. 5. Deploy the following models in Microsoft Foundry: @@ -52,9 +52,9 @@ - gpt-4.1-mini - text-embedding-3-large - 6. Take note of the **deployment names** used for each model. The convention is to use the model + 6. Take note of the deployment names used for each model. The convention is to use the model names (e.g., "gpt-4.1", "gpt-4.1-mini", "text-embedding-3-large"), but you can change these - during deployment. + during deployment. You'll use these deployment names when configuring defaults. USAGE: python sample_update_defaults.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py index 1fc7e8695c10..4f533172ea91 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py @@ -12,19 +12,8 @@ DESCRIPTION: These tests validate the sample_analyze_binary.py sample code. - - This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` - analyzer. The service returns an AnalyzeResult that contains an array of MediaContent items - in AnalyzeResult.contents. For documents, each item is a DocumentContent that exposes markdown - plus detailed structure such as pages, tables, figures, and paragraphs. - - The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- - readable data optimized for RAG scenarios. It extracts rich GitHub Flavored Markdown that preserves - document structure and can include: structured text, tables (in HTML format), charts and diagrams, - mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. - - Content Understanding supports many document types including PDF, Word, Excel, PowerPoint, images - (including scanned image files with hand-written text), and more. + This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + analyzer. USAGE: pytest test_sample_analyze_binary.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py index a2714cea394b..21aa28dc78e0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py @@ -11,20 +11,9 @@ TEST FILE: test_sample_analyze_binary_async.py DESCRIPTION: - These tests validate the sample_analyze_binary.py sample code (async version). - - This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` - analyzer. The service returns an AnalyzeResult that contains an array of MediaContent items - in AnalyzeResult.contents. For documents, each item is a DocumentContent that exposes markdown - plus detailed structure such as pages, tables, figures, and paragraphs. - - The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- - readable data optimized for RAG scenarios. It extracts rich GitHub Flavored Markdown that preserves - document structure and can include: structured text, tables (in HTML format), charts and diagrams, - mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. - - Content Understanding supports many document types including PDF, Word, Excel, PowerPoint, images - (including scanned image files with hand-written text), and more. + These tests validate the sample_analyze_binary_async.py sample code. + This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch + analyzer. USAGE: pytest test_sample_analyze_binary_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py index 2ffad9aa239b..ba72233744fd 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py @@ -11,8 +11,7 @@ DESCRIPTION: These tests validate the sample_analyze_invoice.py sample code. - This sample demonstrates extracting structured invoice fields (customer name, line items, - totals, etc.) using the prebuilt-invoice analyzer. + This sample demonstrates how to analyze an invoice using the prebuilt-invoice analyzer. USAGE: pytest test_sample_analyze_invoice.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py index 8c828cf695d8..3d1b8e4a0f2e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice_async.py @@ -10,9 +10,8 @@ TEST FILE: test_sample_analyze_invoice_async.py DESCRIPTION: - These tests validate the sample_analyze_invoice.py sample code (async version). - This sample demonstrates extracting structured invoice fields (customer name, line items, - totals, etc.) using the prebuilt-invoice analyzer. + These tests validate the sample_analyze_invoice_async.py sample code. + This sample demonstrates how to analyze an invoice using the prebuilt-invoice analyzer. USAGE: pytest test_sample_analyze_invoice_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py index d8709bfe9280..990f802830c2 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py @@ -12,9 +12,8 @@ DESCRIPTION: These tests validate the sample_analyze_url.py sample code. - This sample demonstrates prebuilt RAG analyzers with URL inputs. Content Understanding supports - both local binary inputs (see sample_analyze_binary.py) and URL inputs across all modalities. - For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. + This sample demonstrates how to analyze content from URLs across modalities using prebuilt RAG + analyzers. USAGE: pytest test_sample_analyze_url.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py index 5a84724f7131..4d8b556dc984 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py @@ -11,10 +11,9 @@ TEST FILE: test_sample_analyze_url_async.py DESCRIPTION: - These tests validate the sample_analyze_url.py sample code (async version). - This sample demonstrates prebuilt RAG analyzers with URL inputs. Content Understanding supports - both local binary inputs (see sample_analyze_binary_async.py) and URL inputs across all modalities. - For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. + These tests validate the sample_analyze_url_async.py sample code. + This sample demonstrates how to analyze content from URLs across modalities using prebuilt RAG + analyzers. USAGE: pytest test_sample_analyze_url_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py index 482ac22e2e36..e0b492b8ebf0 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer.py @@ -11,7 +11,8 @@ DESCRIPTION: These tests validate the sample_copy_analyzer.py sample code. - This sample demonstrates copying an analyzer within the same resource. + This sample demonstrates how to copy an analyzer from source to target within the same + Microsoft Foundry resource using the begin_copy_analyzer API. USAGE: pytest test_sample_copy_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py index db16facd90d2..3c137d6f1fde 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_copy_analyzer_async.py @@ -11,7 +11,8 @@ DESCRIPTION: These tests validate the sample_copy_analyzer.py sample code (async version). - This sample demonstrates copying an analyzer within the same resource. + This sample demonstrates how to copy an analyzer from source to target within the same + Microsoft Foundry resource using the begin_copy_analyzer API. USAGE: pytest test_sample_copy_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py index ae9f20dc5a4b..dfb5023aeed1 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer.py @@ -11,7 +11,7 @@ DESCRIPTION: These tests validate the sample_create_analyzer.py sample code. - This sample demonstrates creating a custom analyzer with a field schema to extract + This sample demonstrates how to create a custom analyzer with a field schema to extract structured data from documents. USAGE: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py index 0c3b82aee151..0cfbfa86bbb7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_analyzer_async.py @@ -10,8 +10,8 @@ TEST FILE: test_sample_create_analyzer_async.py DESCRIPTION: - These tests validate the sample_create_analyzer.py sample code (async version). - This sample demonstrates creating a custom analyzer with a field schema to extract + These tests validate the sample_create_analyzer_async.py sample code. + This sample demonstrates how to create a custom analyzer with a field schema to extract structured data from documents. USAGE: diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py index c602d5665ff3..a9fe18b409e7 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier.py @@ -12,8 +12,8 @@ DESCRIPTION: These tests validate the sample_create_classifier.py sample code. - This sample demonstrates creating a classifier analyzer to categorize documents - into predefined categories with optional automatic segmentation. + This sample demonstrates how to create a classifier analyzer to categorize documents and use it + to analyze documents with and without automatic segmentation. USAGE: pytest test_sample_create_classifier.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py index 14c2736415cc..55e794e1072d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_create_classifier_async.py @@ -11,9 +11,9 @@ TEST FILE: test_sample_create_classifier_async.py DESCRIPTION: - These tests validate the sample_create_classifier.py sample code (async version). - This sample demonstrates creating a classifier analyzer to categorize documents - into predefined categories with optional automatic segmentation. + These tests validate the sample_create_classifier_async.py sample code. + This sample demonstrates how to create a classifier analyzer to categorize documents and use it + to analyze documents with and without automatic segmentation. USAGE: pytest test_sample_create_classifier_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py index 09a0b285816a..c8a17dc80e85 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer.py @@ -11,7 +11,13 @@ DESCRIPTION: These tests validate the sample_delete_analyzer.py sample code. - This sample demonstrates permanently deleting a custom analyzer. + This sample demonstrates how to delete a custom analyzer. + + The delete_analyzer method permanently removes a custom analyzer from your resource. + This operation cannot be undone. + + Important notes: + - Only custom analyzers can be deleted. Prebuilt analyzers cannot be deleted. USAGE: pytest test_sample_delete_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py index d36451bfb13f..8b823eb31f24 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_analyzer_async.py @@ -11,7 +11,13 @@ DESCRIPTION: These tests validate the sample_delete_analyzer.py sample code (async version). - This sample demonstrates permanently deleting a custom analyzer. + This sample demonstrates how to delete a custom analyzer. + + The delete_analyzer method permanently removes a custom analyzer from your resource. + This operation cannot be undone. + + Important notes: + - Only custom analyzers can be deleted. Prebuilt analyzers cannot be deleted. USAGE: pytest test_sample_delete_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py index 3575650f657a..fd63f1afe996 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result.py @@ -11,7 +11,7 @@ DESCRIPTION: These tests validate the sample_delete_result.py sample code. - This sample demonstrates deleting analysis results for immediate cleanup. + This sample demonstrates how to delete analysis results using the delete_result API. USAGE: pytest test_sample_delete_result.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py index 29630c9301e2..67e2a3c4ffeb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_delete_result_async.py @@ -11,7 +11,7 @@ DESCRIPTION: These tests validate the sample_delete_result_async.py sample code (async version). - This sample demonstrates deleting analysis results for immediate cleanup. + This sample demonstrates how to delete analysis results using the delete_result API. USAGE: pytest test_sample_delete_result_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py index a4bb8e1e08ea..eab251c77078 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer.py @@ -11,7 +11,8 @@ DESCRIPTION: These tests validate the sample_get_analyzer.py sample code. - This sample demonstrates retrieving information about prebuilt and custom analyzers. + This sample demonstrates how to retrieve information about analyzers, including prebuilt + analyzers and custom analyzers. USAGE: pytest test_sample_get_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py index cc5dfd9613b8..ee06ad8679bc 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_analyzer_async.py @@ -10,8 +10,9 @@ TEST FILE: test_sample_get_analyzer_async.py DESCRIPTION: - These tests validate the sample_get_analyzer.py sample code (async version). - This sample demonstrates retrieving information about prebuilt and custom analyzers. + These tests validate the sample_get_analyzer_async.py sample code. + This sample demonstrates how to retrieve information about analyzers, including prebuilt + analyzers and custom analyzers. USAGE: pytest test_sample_get_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py index b5f3dfcb2225..b9ab9e07f6f5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file.py @@ -11,7 +11,8 @@ DESCRIPTION: These tests validate the sample_get_result_file.py sample code. - This sample demonstrates retrieving result files (like keyframe images) from video analysis. + This sample demonstrates how to retrieve result files (such as keyframe images) from a + video analysis operation using the get_result_file API. USAGE: pytest test_sample_get_result_file.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py index 7c80716f11ba..473cf4c6df31 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_get_result_file_async.py @@ -11,7 +11,8 @@ DESCRIPTION: These tests validate the sample_get_result_file.py sample code (async version). - This sample demonstrates retrieving result files (like keyframe images) from video analysis. + This sample demonstrates how to retrieve result files (such as keyframe images) from a + video analysis operation using the get_result_file API. USAGE: pytest test_sample_get_result_file_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py index 1382f4a85b72..3a99f11f0600 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py @@ -12,7 +12,8 @@ DESCRIPTION: These tests validate the sample_grant_copy_auth.py sample code. - This sample demonstrates cross-resource analyzer copying with authorization. + This sample demonstrates how to grant copy authorization and copy an analyzer from a source + Microsoft Foundry resource to a target Microsoft Foundry resource (cross-resource copying). USAGE: pytest test_sample_grant_copy_auth.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py index cd63412d041c..0d1212953b8b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py @@ -12,7 +12,8 @@ DESCRIPTION: These tests validate the sample_grant_copy_auth.py sample code (async version). - This sample demonstrates cross-resource analyzer copying with authorization. + This sample demonstrates how to grant copy authorization and copy an analyzer from a source + Microsoft Foundry resource to a target Microsoft Foundry resource (cross-resource copying). USAGE: pytest test_sample_grant_copy_auth_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py index 3902053641e8..d1e4ab1a2a72 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers.py @@ -11,7 +11,17 @@ DESCRIPTION: These tests validate the sample_list_analyzers.py sample code. - This sample demonstrates listing all available analyzers (prebuilt and custom). + This sample demonstrates how to list all available analyzers in your Microsoft Foundry + resource, including both prebuilt and custom analyzers. + + The list_analyzers method returns all analyzers in your resource, including: + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice, etc. + - Custom analyzers: Analyzers you've created + + This is useful for: + - Discovery: See what analyzers are available in your resource + - Management: Get an overview of all your custom analyzers + - Debugging: Verify that analyzers were created successfully USAGE: pytest test_sample_list_analyzers.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py index e248993d5b3e..6c7b2dd6bde3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_list_analyzers_async.py @@ -11,7 +11,17 @@ DESCRIPTION: These tests validate the sample_list_analyzers.py sample code (async version). - This sample demonstrates listing all available analyzers (prebuilt and custom). + This sample demonstrates how to list all available analyzers in your Microsoft Foundry + resource, including both prebuilt and custom analyzers. + + The list_analyzers method returns all analyzers in your resource, including: + - Prebuilt analyzers: System-provided analyzers like prebuilt-documentSearch, prebuilt-invoice, etc. + - Custom analyzers: Analyzers you've created + + This is useful for: + - Discovery: See what analyzers are available in your resource + - Management: Get an overview of all your custom analyzers + - Debugging: Verify that analyzers were created successfully USAGE: pytest test_sample_list_analyzers_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py index a55a9366c8ee..94dcfb47cb45 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer.py @@ -11,7 +11,13 @@ DESCRIPTION: These tests validate the sample_update_analyzer.py sample code. - This sample demonstrates updating an existing custom analyzer's description and tags. + This sample demonstrates how to update an existing custom analyzer, including updating + its description and tags. + + The update_analyzer method allows you to modify certain properties of an existing analyzer. + The following properties can be updated: + - Description: Update the analyzer's description + - Tags: Add or update tags USAGE: pytest test_sample_update_analyzer.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py index 93ff309d593a..c73469010c90 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_analyzer_async.py @@ -11,7 +11,13 @@ DESCRIPTION: These tests validate the sample_update_analyzer.py sample code (async version). - This sample demonstrates updating an existing custom analyzer's description and tags. + This sample demonstrates how to update an existing custom analyzer, including updating + its description and tags. + + The update_analyzer method allows you to modify certain properties of an existing analyzer. + The following properties can be updated: + - Description: Update the analyzer's description + - Tags: Add or update tags USAGE: pytest test_sample_update_analyzer_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py index 7682ab81b6a9..b6c1faec06d3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults.py @@ -11,7 +11,9 @@ DESCRIPTION: These tests validate the sample_update_defaults.py sample code. - This sample demonstrates configuring model deployment settings for prebuilt analyzers. + This sample demonstrates how to configure and retrieve default model deployment settings + for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry + resource before using prebuilt or custom analyzers. The tests validate: 1. UpdateDefaults: Configuring model deployment mappings (optional, requires env vars) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py index afced35a05da..5f47cc15cfeb 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_update_defaults_async.py @@ -10,8 +10,10 @@ TEST FILE: test_sample_update_defaults_async.py DESCRIPTION: - These tests validate the sample_update_defaults_async.py sample code (async version). - This sample demonstrates configuring model deployment settings for prebuilt analyzers. + These tests validate the sample_update_defaults_async.py sample code. + This sample demonstrates how to configure and retrieve default model deployment settings + for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry + resource before using prebuilt or custom analyzers. The tests validate: 1. UpdateDefaults: Configuring model deployment mappings (optional, requires env vars) From 02b8a4af56e899c56f681e7a2a2a67a2e7c0e5f6 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 22 Dec 2025 12:14:08 -0800 Subject: [PATCH 097/105] [SAMPLE-DOC] update readme and test sample description --- .../samples/README.md | 95 +++++++++++++++---- .../samples/test_sample_analyze_binary.py | 15 ++- .../test_sample_analyze_binary_async.py | 17 +++- .../samples/test_sample_analyze_invoice.py | 3 +- .../tests/samples/test_sample_analyze_url.py | 5 +- .../samples/test_sample_analyze_url_async.py | 7 +- 6 files changed, 112 insertions(+), 30 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index b470a693d25b..ab9348456bd3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -21,6 +21,7 @@ These code samples demonstrate common scenarios with the Azure AI Content Unders * You need an [Azure subscription][azure_sub] and a [Microsoft Foundry resource][contentunderstanding_quickstart] to use this package. * The Microsoft Foundry resource must be created in a [supported region][contentunderstanding_regions]. * **Required setup:** GPT-4.1, GPT-4.1-mini, and text-embedding-3-large models must be deployed in your Microsoft Foundry project and configured using `sample_update_defaults.py` before using prebuilt analyzers. +* The 'Cognitive Services User' role is required for your credential to perform operations like configuring model deployments and creating custom analyzers. ## Setup @@ -108,6 +109,8 @@ Set the following in `.env`: * `GPT_4_1_MINI_DEPLOYMENT` (required for sample_update_defaults.py) - Your GPT-4.1-mini deployment name in Microsoft Foundry * `TEXT_EMBEDDING_3_LARGE_DEPLOYMENT` (required for sample_update_defaults.py) - Your text-embedding-3-large deployment name in Microsoft Foundry +**Important:** Your credential must have the 'Cognitive Services User' role assigned to perform operations like configuring model deployments and creating custom analyzers. + **Example `.env` file:** ```bash AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://mmi-sample-foundry.services.ai.azure.com/ @@ -134,7 +137,10 @@ Sync samples are in the `samples/` directory. Run them from the package director ```bash # Make sure virtual environment is activated +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 # From the package directory, run sync samples python samples/sample_analyze_url.py @@ -145,7 +151,10 @@ Or navigate to the samples directory first: ```bash # Make sure virtual environment is activated +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 # Navigate to samples directory cd samples @@ -161,7 +170,10 @@ Async samples are in the `samples/async_samples/` directory. Run them from the p ```bash # Make sure virtual environment is activated +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 # From the package directory, run async samples python samples/async_samples/sample_analyze_url_async.py @@ -172,7 +184,10 @@ Or navigate to the async_samples directory: ```bash # Make sure virtual environment is activated +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 # Navigate to async_samples directory cd samples/async_samples @@ -189,7 +204,7 @@ python sample_analyze_binary_async.py ### Sample 00: Configure Defaults #### `sample_update_defaults.py` / `sample_update_defaults_async.py` -**Required setup!** Configures and retrieves default model deployment settings for your Content Understanding resource. This is a one-time setup before using prebuilt analyzers. +**Required setup!** Configures and retrieves default model deployment settings for your Microsoft Foundry resource. This is a required one-time setup per Microsoft Foundry resource before using prebuilt or custom analyzers. **Key concepts:** - Setting up model deployment mappings (GPT-4.1, GPT-4.1-mini, text-embedding-3-large) @@ -210,80 +225,88 @@ Analyzes a PDF document from local binary data using `prebuilt-documentSearch`. ### Sample 02: Analyze URL #### `sample_analyze_url.py` / `sample_analyze_url_async.py` -**Start here!** Analyzes a document from a remote URL using `prebuilt-documentSearch`. Shows basic document analysis and content extraction. +**Start here!** Analyzes a document from a remote URL using `prebuilt-documentSearch`. Shows basic document analysis and content extraction across modalities (documents, images, audio, video). **Key concepts:** - Using `begin_analyze` with URL input - Extracting markdown content - Working with the analysis result object model +- Analyzing different content types (documents, images, audio, video) ### Sample 03: Analyze Invoice #### `sample_analyze_invoice.py` / `sample_analyze_invoice_async.py` -Extracts structured fields from invoices using `prebuilt-invoice` analyzer. Shows how to work with structured field extraction. +Extracts structured fields from invoices using `prebuilt-invoice` analyzer. Shows how to work with structured field extraction from domain-specific prebuilt analyzers. **Key concepts:** -- Using specialized prebuilt analyzers +- Using specialized prebuilt analyzers (prebuilt-invoice) - Extracting structured fields (customer name, totals, dates, line items) - Working with field confidence scores and source locations - Accessing object fields and array fields +- Financial document processing (invoices, receipts, credit cards, bank statements, checks) ### Sample 04: Create Analyzer #### `sample_create_analyzer.py` / `sample_create_analyzer_async.py` -Creates a custom analyzer with field schema to extract structured data from documents. +Creates a custom analyzer with field schema to extract structured data from documents. Shows how to define custom fields and extraction methods for document, audio, video, and image content. **Key concepts:** - Defining custom field schemas (string, number, date, object, array) - Using extraction methods: `extract`, `generate`, `classify` - Configuring analysis options (OCR, layout, formulas) - Enabling source and confidence tracking +- Creating analyzers for different modalities (document, audio, video, image) ### Sample 05: Create Classifier #### `sample_create_classifier.py` / `sample_create_classifier_async.py` -Creates a classifier analyzer to categorize documents and demonstrates automatic segmentation. +Creates a classifier analyzer to categorize documents and demonstrates automatic segmentation. Shows how to create classification workflows with custom categories. **Key concepts:** - Creating classifiers with content categories - Document categorization (Loan_Application, Invoice, Bank_Statement) - Enabling segmentation for multi-document files - Processing classification results +- Content organization and data routing ### Sample 06: Get Analyzer #### `sample_get_analyzer.py` / `sample_get_analyzer_async.py` -Retrieves information about analyzers, including prebuilt and custom analyzers. +Retrieves information about analyzers, including prebuilt and custom analyzers. Shows how to inspect analyzer configuration and capabilities. **Key concepts:** - Getting prebuilt analyzer details - Getting custom analyzer details - Dumping analyzer configuration as JSON +- Verifying analyzer configuration +- Inspecting analyzer capabilities ### Sample 07: List Analyzers #### `sample_list_analyzers.py` / `sample_list_analyzers_async.py` -Lists all available analyzers in your Microsoft Foundry resource. +Lists all available analyzers in your Microsoft Foundry resource. Shows how to discover and manage analyzers. **Key concepts:** - Listing prebuilt and custom analyzers - Displaying analyzer summary and details - Identifying analyzer types +- Analyzer discovery and management ### Sample 08: Update Analyzer #### `sample_update_analyzer.py` / `sample_update_analyzer_async.py` -Updates an existing custom analyzer's description and tags. +Updates an existing custom analyzer's description and tags. Shows how to modify analyzer properties. **Key concepts:** - Updating analyzer description - Adding, updating, and removing tags - Verifying analyzer updates +- Modifying analyzer properties ### Sample 09: Delete Analyzer #### `sample_delete_analyzer.py` / `sample_delete_analyzer_async.py` -Deletes a custom analyzer from your resource. +Deletes a custom analyzer from your resource. Shows how to remove custom analyzers (prebuilt analyzers cannot be deleted). **Key concepts:** - Creating a simple analyzer for deletion demo @@ -293,68 +316,75 @@ Deletes a custom analyzer from your resource. ### Sample 10: Analyze Configs #### `sample_analyze_configs.py` / `sample_analyze_configs_async.py` -Extracts additional features from documents such as charts, hyperlinks, formulas, and annotations. +Extracts additional features from documents such as charts, hyperlinks, formulas, and annotations. Shows advanced document analysis capabilities. **Key concepts:** - Using prebuilt-documentSearch with enhanced features -- Extracting chart figures +- Extracting chart figures (Chart.js format) - Extracting hyperlinks -- Extracting mathematical formulas +- Extracting mathematical formulas (LaTeX) - Extracting PDF annotations +- Analysis configuration options (OCR, layout, formulas) ### Sample 11: Analyze Return Raw JSON #### `sample_analyze_return_raw_json.py` / `sample_analyze_return_raw_json_async.py` -Accesses the raw JSON response from analysis operations for custom processing. +Accesses the raw JSON response from analysis operations for custom processing. Shows how to work with raw service responses. **Key concepts:** - Getting raw JSON response - Saving analysis results to file - Custom JSON processing +- Inspecting complete response structure +- Debugging and troubleshooting ### Sample 12: Get Result File #### `sample_get_result_file.py` / `sample_get_result_file_async.py` -Retrieves result files (such as keyframe images) from video analysis operations. +Retrieves result files (such as keyframe images) from video analysis operations. Shows how to access generated files from analysis. **Key concepts:** - Analyzing video content - Extracting operation IDs - Retrieving keyframe images - Saving result files to disk +- Working with generated analysis artifacts ### Sample 13: Delete Result #### `sample_delete_result.py` / `sample_delete_result_async.py` -Demonstrates analyzing a document and then deleting the analysis result. +Demonstrates analyzing a document and then deleting the analysis result. Shows how to manage result retention and data cleanup. **Key concepts:** - Extracting operation IDs from analysis operations - Deleting analysis results to manage storage - Verifying result deletion - Understanding result retention policies (24-hour auto-deletion) +- Data retention and compliance ### Sample 14: Copy Analyzer #### `sample_copy_analyzer.py` / `sample_copy_analyzer_async.py` -Copies an analyzer from source to target within the same resource. +Copies an analyzer from source to target within the same resource. Shows how to duplicate analyzers for testing and deployment. **Key concepts:** - Creating source analyzers - Copying analyzers within the same resource - Updating copied analyzers with new tags - Use cases: testing, staging, production deployment +- Same-resource analyzer management ### Sample 15: Grant Copy Auth #### `sample_grant_copy_auth.py` / `sample_grant_copy_auth_async.py` -Grants copy authorization and copies an analyzer from a source resource to a target resource (cross-resource copying). +Grants copy authorization and copies an analyzer from a source resource to a target resource (cross-resource copying). Shows cross-resource analyzer migration. **Key concepts:** - Cross-resource copying between different Azure resources - Granting copy authorization - Resource migration and multi-region deployment - Required environment variables for cross-resource operations +- Cross-subscription analyzer deployment ## Common Patterns @@ -419,7 +449,10 @@ if content.kind == MediaContentKind.DOCUMENT: **Solution:** Make sure the virtual environment is activated and the SDK is installed: ```bash +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 pip install -e . ``` @@ -427,7 +460,10 @@ pip install -e . **Solution:** Install the development dependencies: ```bash +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 pip install -r dev_requirements.txt ``` @@ -443,7 +479,10 @@ pip install -r dev_requirements.txt **Solution:** Reinstall the SDK in the virtual environment: ```bash +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 pip install -e . --force-reinstall ``` @@ -451,25 +490,43 @@ pip install -e . --force-reinstall **Solution:** Run the setup sample to configure model deployments: ```bash +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 cd samples - python sample_update_defaults.py +python sample_update_defaults.py ``` This configures the required GPT-4.1, GPT-4.1-mini, and text-embedding-3-large model deployments that prebuilt analyzers depend on. +### "Access denied" or "authorization errors" when creating analyzers or configuring deployments + +**Solution:** Ensure your credential has the 'Cognitive Services User' role assigned to your Microsoft Foundry resource. This role is required for operations like: +- Configuring model deployments (`sample_update_defaults.py`) +- Creating custom analyzers +- Cross-resource copying operations + +You can assign this role in the Azure portal under your Microsoft Foundry resource's Access Control (IAM) section. + ### "FileNotFoundError" when running samples with local files **Solution:** Make sure you run samples that use local files from the `samples/` directory: ```bash +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 cd samples python sample_analyze_binary.py # This will find sample_files/sample_invoice.pdf ``` If running from the package directory, use the full path: ```bash +# macOS / Linux source .venv/bin/activate +# Windows PowerShell +.venv\Scripts\Activate.ps1 python samples/sample_analyze_binary.py # Make sure you're in the package directory ``` diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py index 4f533172ea91..1fc7e8695c10 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary.py @@ -12,8 +12,19 @@ DESCRIPTION: These tests validate the sample_analyze_binary.py sample code. - This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch - analyzer. + + This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` + analyzer. The service returns an AnalyzeResult that contains an array of MediaContent items + in AnalyzeResult.contents. For documents, each item is a DocumentContent that exposes markdown + plus detailed structure such as pages, tables, figures, and paragraphs. + + The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- + readable data optimized for RAG scenarios. It extracts rich GitHub Flavored Markdown that preserves + document structure and can include: structured text, tables (in HTML format), charts and diagrams, + mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. + + Content Understanding supports many document types including PDF, Word, Excel, PowerPoint, images + (including scanned image files with hand-written text), and more. USAGE: pytest test_sample_analyze_binary.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py index 21aa28dc78e0..a2714cea394b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_binary_async.py @@ -11,9 +11,20 @@ TEST FILE: test_sample_analyze_binary_async.py DESCRIPTION: - These tests validate the sample_analyze_binary_async.py sample code. - This sample demonstrates how to analyze a PDF file from disk using the prebuilt-documentSearch - analyzer. + These tests validate the sample_analyze_binary.py sample code (async version). + + This sample demonstrates how to analyze a PDF file from disk using the `prebuilt-documentSearch` + analyzer. The service returns an AnalyzeResult that contains an array of MediaContent items + in AnalyzeResult.contents. For documents, each item is a DocumentContent that exposes markdown + plus detailed structure such as pages, tables, figures, and paragraphs. + + The prebuilt-documentSearch analyzer transforms unstructured documents into structured, machine- + readable data optimized for RAG scenarios. It extracts rich GitHub Flavored Markdown that preserves + document structure and can include: structured text, tables (in HTML format), charts and diagrams, + mathematical formulas, hyperlinks, barcodes, annotations, and page metadata. + + Content Understanding supports many document types including PDF, Word, Excel, PowerPoint, images + (including scanned image files with hand-written text), and more. USAGE: pytest test_sample_analyze_binary_async.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py index ba72233744fd..2ffad9aa239b 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_invoice.py @@ -11,7 +11,8 @@ DESCRIPTION: These tests validate the sample_analyze_invoice.py sample code. - This sample demonstrates how to analyze an invoice using the prebuilt-invoice analyzer. + This sample demonstrates extracting structured invoice fields (customer name, line items, + totals, etc.) using the prebuilt-invoice analyzer. USAGE: pytest test_sample_analyze_invoice.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py index 990f802830c2..d8709bfe9280 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url.py @@ -12,8 +12,9 @@ DESCRIPTION: These tests validate the sample_analyze_url.py sample code. - This sample demonstrates how to analyze content from URLs across modalities using prebuilt RAG - analyzers. + This sample demonstrates prebuilt RAG analyzers with URL inputs. Content Understanding supports + both local binary inputs (see sample_analyze_binary.py) and URL inputs across all modalities. + For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. USAGE: pytest test_sample_analyze_url.py diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py index 4d8b556dc984..5a84724f7131 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_analyze_url_async.py @@ -11,9 +11,10 @@ TEST FILE: test_sample_analyze_url_async.py DESCRIPTION: - These tests validate the sample_analyze_url_async.py sample code. - This sample demonstrates how to analyze content from URLs across modalities using prebuilt RAG - analyzers. + These tests validate the sample_analyze_url.py sample code (async version). + This sample demonstrates prebuilt RAG analyzers with URL inputs. Content Understanding supports + both local binary inputs (see sample_analyze_binary_async.py) and URL inputs across all modalities. + For URL inputs, use begin_analyze() with AnalyzeInput objects that wrap the URL. USAGE: pytest test_sample_analyze_url_async.py From 67937a59466e95dd14d02e4141d9c7146ca6d97f Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 22 Dec 2025 13:45:07 -0800 Subject: [PATCH 098/105] [SAMPLE-DOC] update sample readme --- .../samples/README.md | 32 +------------------ 1 file changed, 1 insertion(+), 31 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index ab9348456bd3..b4e6856ff88e 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -137,10 +137,7 @@ Sync samples are in the `samples/` directory. Run them from the package director ```bash # Make sure virtual environment is activated -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 # From the package directory, run sync samples python samples/sample_analyze_url.py @@ -151,10 +148,7 @@ Or navigate to the samples directory first: ```bash # Make sure virtual environment is activated -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 # Navigate to samples directory cd samples @@ -170,10 +164,7 @@ Async samples are in the `samples/async_samples/` directory. Run them from the p ```bash # Make sure virtual environment is activated -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 # From the package directory, run async samples python samples/async_samples/sample_analyze_url_async.py @@ -184,10 +175,7 @@ Or navigate to the async_samples directory: ```bash # Make sure virtual environment is activated -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 # Navigate to async_samples directory cd samples/async_samples @@ -449,10 +437,7 @@ if content.kind == MediaContentKind.DOCUMENT: **Solution:** Make sure the virtual environment is activated and the SDK is installed: ```bash -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 pip install -e . ``` @@ -460,10 +445,7 @@ pip install -e . **Solution:** Install the development dependencies: ```bash -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 pip install -r dev_requirements.txt ``` @@ -479,10 +461,7 @@ pip install -r dev_requirements.txt **Solution:** Reinstall the SDK in the virtual environment: ```bash -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 pip install -e . --force-reinstall ``` @@ -490,12 +469,9 @@ pip install -e . --force-reinstall **Solution:** Run the setup sample to configure model deployments: ```bash -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 cd samples -python sample_update_defaults.py + python sample_update_defaults.py ``` This configures the required GPT-4.1, GPT-4.1-mini, and text-embedding-3-large model deployments that prebuilt analyzers depend on. @@ -513,20 +489,14 @@ You can assign this role in the Azure portal under your Microsoft Foundry resour **Solution:** Make sure you run samples that use local files from the `samples/` directory: ```bash -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 cd samples python sample_analyze_binary.py # This will find sample_files/sample_invoice.pdf ``` If running from the package directory, use the full path: ```bash -# macOS / Linux source .venv/bin/activate -# Windows PowerShell -.venv\Scripts\Activate.ps1 python samples/sample_analyze_binary.py # Make sure you're in the package directory ``` From c7d59d3f12069336d88f294c8f2ce9c86fb9b006 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 22 Dec 2025 15:41:30 -0800 Subject: [PATCH 099/105] [README] update based on .NET --- .../azure-ai-contentunderstanding/README.md | 67 ++++++++++--------- 1 file changed, 35 insertions(+), 32 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index 999f684ce64a..572ff357d331 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -4,11 +4,12 @@ Azure AI Content Understanding is a multimodal AI service that extracts semantic Use the client library for Azure AI Content Understanding to: -* **Extract document content** - Extract text, tables, figures, layout information, and structured markdown from documents (PDF, images, Office documents) +* **Extract document content** - Extract text, tables, figures, layout information, and structured markdown from documents (PDF, images with text or hand-written text, Office documents and more) * **Transcribe and analyze audio** - Convert audio content into searchable transcripts with speaker diarization and timing information * **Analyze video content** - Extract visual frames, transcribe audio tracks, and generate structured summaries from video files -* **Create custom analyzers** - Build domain-specific analyzers for specialized content extraction needs -* **Classify documents** - Automatically categorize and organize documents by type or content +* **Leverage prebuilt analyzers** - Use production-ready prebuilt analyzers across industries including finance and tax (invoices, receipts, tax forms), identity verification (passports, driver's licenses), mortgage and lending (loan applications, appraisals), procurement and contracts (purchase orders, agreements), and utilities (billing statements) +* **Create custom analyzers** - Build domain-specific analyzers for specialized content extraction needs across all four modalities (documents, video, audio, and images) +* **Classify documents and video** - Automatically categorize and extract information from documents and video by type [Source code][python_cu_src] | [Package (PyPI)][python_cu_pypi] | [Product documentation][python_cu_product_docs] | [Samples][python_cu_samples] @@ -258,28 +259,30 @@ For more information on authentication, see [Azure Identity client library][azur ## Key concepts -### Prebuilt Analyzers +### Prebuilt analyzers -Content Understanding provides prebuilt analyzers that are ready to use without any configuration. These analyzers use the `*Search` naming pattern: +Content Understanding provides a rich set of prebuilt analyzers that are ready to use without any configuration. These analyzers are powered by knowledge bases of thousands of real-world document examples, enabling them to understand document structure and adapt to variations in format and content. -* **`prebuilt-documentSearch`** - Extracts content from documents (PDF, images, Office documents) with layout preservation, table detection, figure analysis, and structured markdown output. Optimized for RAG scenarios. -* **`prebuilt-audioSearch`** - Transcribes audio content with speaker diarization, timing information, and conversation summaries. Supports multilingual transcription. -* **`prebuilt-videoSearch`** - Analyzes video content with visual frame extraction, audio transcription, and structured summaries. Provides temporal alignment of visual and audio content. +Prebuilt analyzers are organized into several categories: -> **Note:** The prebuilt analyzers use the `prebuilt-{type}Search` naming pattern (not `prebuilt-{type}Analyzer`). This is a recent change in the Content Understanding service. +* **RAG analyzers** - Optimized for retrieval-augmented generation scenarios with semantic analysis and markdown extraction. These analyzers return markdown and a one-paragraph `Summary` for each content item: + * **`prebuilt-documentSearch`** - Extracts content from documents (PDF, images, Office documents) with layout preservation, table detection, figure analysis, and structured markdown output. Optimized for RAG scenarios. + * **`prebuilt-imageSearch`** - Analyzes standalone images and returns a one-paragraph description of the image content. Optimized for image understanding and search scenarios. For images that contain text (including hand-written text), use `prebuilt-documentSearch`. + * **`prebuilt-audioSearch`** - Transcribes audio content with speaker diarization, timing information, and conversation summaries. Supports multilingual transcription. + * **`prebuilt-videoSearch`** - Analyzes video content with visual frame extraction, audio transcription, and structured summaries. Provides temporal alignment of visual and audio content and can return multiple segments per video. +* **Content extraction analyzers** - Focus on OCR and layout analysis (e.g., `prebuilt-read`, `prebuilt-layout`) +* **Base analyzers** - Fundamental content processing capabilities used as parent analyzers for custom analyzers (e.g., `prebuilt-document`, `prebuilt-image`, `prebuilt-audio`, `prebuilt-video`) +* **Domain-specific analyzers** - Preconfigured analyzers for common document categories including financial documents (invoices, receipts, bank statements), identity documents (passports, driver's licenses), tax forms, mortgage documents, and contracts +* **Utility analyzers** - Specialized tools for schema generation and field extraction (e.g., `prebuilt-documentFieldSchema`, `prebuilt-documentFields`) -For a full list of prebuilt analyzers, see [Azure AI Content Understanding prebuilt analyzers][cu_prebuilt_analyzers]. +For a complete list of available prebuilt analyzers and their capabilities, see the [Prebuilt analyzers documentation][cu_prebuilt_analyzers]. -### Custom Analyzers +### Content types -You can create custom analyzers with specific field schemas for multi-modal content processing (documents, images, audio, video). Custom analyzers allow you to extract domain-specific information tailored to your use case. +The API returns different content types based on the input. Both `DocumentContent` and `AudioVisualContent` classes derive from `MediaContent` class, which provides basic information and markdown representation. Each derived class provides additional properties to access detailed information: -### Content Types - -The API returns different content types based on the input: - -* **`document`** - For document files (PDF, images, Office documents). Contains pages, tables, figures, paragraphs, and markdown representation. -* **`audioVisual`** - For audio and video files. Contains transcript phrases, timing information, and for video, visual frame references. +* **`DocumentContent`** - For document files (PDF, HTML, images, Office documents such as Word, Excel, PowerPoint, and more). Provides basic information such as page count and MIME type. Retrieve detailed information including pages, tables, figures, paragraphs, and many others. +* **`AudioVisualContent`** - For audio and video files. Provides basic information such as timing information (start/end times) and frame dimensions (for video). Retrieve detailed information including transcript phrases, timing information, and for video, key frame references and more. ### Asynchronous Operations @@ -317,11 +320,15 @@ You can familiarize yourself with different APIs using [Samples][python_cu_sampl The samples demonstrate: -* **Document Analysis** - Extract content from PDFs and images using `prebuilt-documentSearch` -* **Audio Analysis** - Transcribe and analyze audio files using `prebuilt-audioSearch` -* **Video Analysis** - Analyze video content using `prebuilt-videoSearch` -* **Custom Analyzers** - Create domain-specific analyzers for specialized extraction needs -* **Document Classification** - Classify documents by type or content +* **Configuration** - Configure model deployment defaults for prebuilt analyzers and custom analyzers +* **Document Content Extraction** - Extract structured markdown content from PDFs and images using `prebuilt-documentSearch`, optimized for RAG (Retrieval-Augmented Generation) applications +* **Multi-Modal Content Analysis** - Analyze content from URLs across all modalities: extract markdown and summaries from documents, images, audio, and video using `prebuilt-documentSearch`, `prebuilt-imageSearch`, `prebuilt-audioSearch`, and `prebuilt-videoSearch` +* **Domain-Specific Analysis** - Extract structured fields from invoices using `prebuilt-invoice` +* **Advanced Document Features** - Extract charts, hyperlinks, formulas, and annotations from documents +* **Custom Analyzers** - Create custom analyzers with field schemas for specialized extraction needs +* **Document Classification** - Create and use classifiers to categorize documents +* **Analyzer Management** - Get, list, update, and delete analyzers +* **Result Management** - Retrieve result files from video analysis and delete analysis results See the [samples directory][python_cu_samples] for complete examples. @@ -495,15 +502,9 @@ See full SDK logging documentation with examples [here][sdk_logging_docs]. ## Next steps -### More sample code - -See the [Sample README][sample_readme] for several code snippets illustrating common patterns used in the Content Understanding Python API. - -### Additional documentation - -For more extensive documentation on Azure AI Content Understanding, see the [Content Understanding documentation][python_cu_product_docs] on docs.microsoft.com. - -* Explore the [samples directory][python_cu_samples] for complete code examples +* [`sample_update_defaults.py`][sample00] – One-time setup to configure model deployments for prebuilt and custom analyzers +* [`sample_analyze_binary.py`][sample01] – Analyze PDF files from disk using `prebuilt-documentSearch` +* Explore the [`samples` directory][python_cu_samples] for more code examples * Read the [Azure AI Content Understanding documentation][python_cu_product_docs] for detailed service information ## Running the Update Defaults Sample @@ -659,3 +660,5 @@ This project has adopted the [Microsoft Open Source Code of Conduct][code_of_con [code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ [code_of_conduct_faq]: https://opensource.microsoft.com/codeofconduct/faq/ [opencode_email]: mailto:opencode@microsoft.com +[sample00]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_update_defaults.py +[sample01]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_binary.py From 6563b264e56b7fecc9d7eba02ff2529d8df3a5b9 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 22 Dec 2025 16:40:21 -0800 Subject: [PATCH 100/105] [TEST-FIX] fix test_sample_grant_copy_auth --- .../tests/samples/test_sample_grant_copy_auth.py | 5 ++++- .../tests/samples/test_sample_grant_copy_auth_async.py | 5 ++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py index 3a99f11f0600..7820a3ae451c 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth.py @@ -105,7 +105,10 @@ def test_sample_grant_copy_auth(self, azure_content_understanding_endpoint: str, if target_endpoint != azure_content_understanding_endpoint or target_key: # Create target client with different endpoint/credential - target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() + if target_key: + target_credential = AzureKeyCredential(target_key) + else: + target_credential = self.get_credential(ContentUnderstandingClient) target_client = cast( ContentUnderstandingClient, self.create_client_from_credential( diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py index 0d1212953b8b..9e32aa5d0017 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/tests/samples/test_sample_grant_copy_auth_async.py @@ -106,7 +106,10 @@ async def test_sample_grant_copy_auth_async(self, azure_content_understanding_en if target_endpoint != azure_content_understanding_endpoint or target_key: # Create target client with different endpoint/credential - target_credential = AzureKeyCredential(target_key) if target_key else DefaultAzureCredential() + if target_key: + target_credential = AzureKeyCredential(target_key) + else: + target_credential = self.get_credential(ContentUnderstandingClient, is_async=True) target_client = cast( ContentUnderstandingClient, self.create_client_from_credential( From c82387fed94860909002631e9ac25e8b05445199 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 23 Dec 2025 12:25:13 -0800 Subject: [PATCH 101/105] [SAMPLE-FIX] MyPy fix --- .../samples/async_samples/sample_analyze_configs_async.py | 3 +-- .../samples/async_samples/sample_analyze_invoice_async.py | 6 +++--- .../samples/sample_analyze_configs.py | 2 +- .../samples/sample_analyze_invoice.py | 6 +++--- 4 files changed, 8 insertions(+), 9 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py index 895857f93dca..20c16943b1d1 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_configs_async.py @@ -112,10 +112,9 @@ async def main() -> None: # [START extract_formulas] # Extract formulas from document pages (enabled by EnableFormula config) content: DocumentContent = result.contents[0] # type: ignore - all_formulas = [] + all_formulas: list = [] for page in content.pages or []: all_formulas.extend(page.formulas or []) - print(f"Found {len(all_formulas)} formula(s)") for formula in all_formulas: print(f" Formula Kind: {formula.kind}") diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py index 238d21090146..717ea57086df 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/async_samples/sample_analyze_invoice_async.py @@ -145,8 +145,8 @@ async def main() -> None: amount = amount_field.value if amount_field else None currency = currency_field.value if currency_field else "$" print(f"\nTotal: {currency}{amount:.2f}" if isinstance(amount, (int, float)) else f"\nTotal: {currency}{amount}") - print(f" Confidence: {total_amount_field.confidence:.2f}" if total_amount_field.confidence else " Confidence: N/A") - print(f" Source: {total_amount_field.source or 'N/A'}") + print(f" Confidence: {total_amount_field.confidence:.2f}" if total_amount_field.confidence else " Confidence: N/A") # type: ignore + print(f" Source: {total_amount_field.source or 'N/A'}") # type: ignore # Extract array fields (collections like line items) line_items_field = document_content.fields.get("LineItems") @@ -159,7 +159,7 @@ async def main() -> None: description = description_field.value if description_field else "N/A" quantity = quantity_field.value if quantity_field else "N/A" print(f" Item {i}: {description} (Qty: {quantity})") - print(f" Confidence: {item.confidence:.2f}" if item.confidence else " Confidence: N/A") + print(f" Confidence: {item.confidence:.2f}" if item.confidence else " Confidence: N/A") # type: ignore # [END extract_invoice_fields] if not isinstance(credential, AzureKeyCredential): diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py index 7d0e7f04469a..20809a1c5a19 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_configs.py @@ -112,7 +112,7 @@ def main() -> None: # [START extract_formulas] # Extract formulas from document pages (enabled by EnableFormula config) content: DocumentContent = result.contents[0] # type: ignore - all_formulas = [] + all_formulas: list = [] for page in content.pages or []: all_formulas.extend(page.formulas or []) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py index 769d343080b1..fdb93bc5076d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_analyze_invoice.py @@ -145,8 +145,8 @@ def main() -> None: amount = amount_field.value if amount_field else None currency = currency_field.value if currency_field else "$" print(f"\nTotal: {currency}{amount:.2f}" if isinstance(amount, (int, float)) else f"\nTotal: {currency}{amount}") - print(f" Confidence: {total_amount_field.confidence:.2f}" if total_amount_field.confidence else " Confidence: N/A") - print(f" Source: {total_amount_field.source or 'N/A'}") + print(f" Confidence: {total_amount_field.confidence:.2f}" if total_amount_field.confidence else " Confidence: N/A") # type: ignore + print(f" Source: {total_amount_field.source or 'N/A'}") # type: ignore # Extract array fields (collections like line items) line_items_field = document_content.fields.get("LineItems") @@ -159,7 +159,7 @@ def main() -> None: description = description_field.value if description_field else "N/A" quantity = quantity_field.value if quantity_field else "N/A" print(f" Item {i}: {description} (Qty: {quantity})") - print(f" Confidence: {item.confidence:.2f}" if item.confidence else " Confidence: N/A") + print(f" Confidence: {item.confidence:.2f}" if item.confidence else " Confidence: N/A") # type: ignore # [END extract_invoice_fields] From b8c263e79c39dc37468b7eff30ad26db49b56e91 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 23 Dec 2025 12:25:56 -0800 Subject: [PATCH 102/105] [ANALYZE-FIX] spelling and link --- .../azure-ai-contentunderstanding/README.md | 10 ++-------- .../azure-ai-contentunderstanding/cspell.json | 4 +++- 2 files changed, 5 insertions(+), 9 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md index 572ff357d331..f5de3ab672a3 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/README.md @@ -309,10 +309,7 @@ We guarantee that all client instance methods are thread-safe and independent of [Client options][client_options] | [Accessing the response][accessing_response] | [Long-running operations][long_running_operations] | -[Handling failures][handling_failures] | -[Diagnostics][diagnostics] | -[Mocking][mocking] | -[Client lifetime][client_lifetime] +[Handling failures][handling_failures] ## Examples @@ -532,7 +529,7 @@ $env:TEXT_EMBEDDING_3_LARGE_DEPLOYMENT="text-embedding-3-large" ``` **On Windows (Command Prompt):** -```cmd +```batch set AZURE_CONTENT_UNDERSTANDING_ENDPOINT=https://.services.ai.azure.com/ set AZURE_CONTENT_UNDERSTANDING_KEY= # Optional if using DefaultAzureCredential set GPT_4_1_DEPLOYMENT=gpt-4.1 @@ -647,9 +644,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct][code_of_con [accessing_response]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/README.md#accessing-http-response-details-using-responset [long_running_operations]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/README.md#consuming-long-running-operations-using-operationt [handling_failures]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/README.md#reporting-errors-requestfailedexception -[diagnostics]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/samples/Diagnostics.md -[mocking]: https://learn.microsoft.com/azure/developer/python/sdk/azure-sdk-mock-helpers -[client_lifetime]: https://devblogs.microsoft.com/azure-sdk/lifetime-management-and-thread-safety-guarantees-of-azure-sdk-python-clients/ [python_logging]: https://docs.python.org/3/library/logging.html [sdk_logging_docs]: https://learn.microsoft.com/azure/developer/python/sdk/azure-sdk-logging [sample_readme]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/contentunderstanding/azure-ai-contentunderstanding/samples diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/cspell.json b/sdk/contentunderstanding/azure-ai-contentunderstanding/cspell.json index 3dc1f7fb0f8b..03b7fba517f5 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/cspell.json +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/cspell.json @@ -1,5 +1,7 @@ { "ignoreWords": [ + "Agentic", + "chartjs", "laren", "Milsa", "nlaren", @@ -12,6 +14,6 @@ "ignorePaths": [ "sdk/contentunderstanding/azure-ai-contentunderstanding/samples/sample_files/training_samples/*.json" ], - "_comment": "ignoreWords: laren/Milsa/nlaren/PTIN from sample JSON files (IRS tax form test data); UPCA/UPCE/upca/upce are barcode types from _enums.py and _models.py as OCR Barcode types standardized in the ISO/IEC 15415:2019 standard" + "_comment": "ignoreWords: laren/Milsa/nlaren/PTIN from sample JSON files (IRS tax form test data); UPCA/UPCE/upca/upce are barcode types from _enums.py and _models.py as OCR Barcode types standardized in the ISO/IEC 15415:2019 standard; Agentic is a term for agentic AI; chartjs refers to Chart.js format" } From 6f58471b52514d5fceb994c42d484c95e2a88297 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 23 Dec 2025 13:18:27 -0800 Subject: [PATCH 103/105] [ANALYZE-FIX] pylint --- .../azure/ai/contentunderstanding/_operations/_patch.py | 2 +- .../azure/ai/contentunderstanding/aio/_operations/_patch.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py index 2c83f9d04d09..ae7b1e8a8c2d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_operations/_patch.py @@ -18,4 +18,4 @@ def patch_sdk(): Previous patches for copy_analyzer URL path and status codes have been incorporated into the generated code. """ - pass + # No patches currently required diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py index 2c83f9d04d09..ae7b1e8a8c2d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_operations/_patch.py @@ -18,4 +18,4 @@ def patch_sdk(): Previous patches for copy_analyzer URL path and status codes have been incorporated into the generated code. """ - pass + # No patches currently required From db521e741751859a67385577eefaf326daa62621 Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Tue, 23 Dec 2025 15:04:42 -0800 Subject: [PATCH 104/105] [PATCH-UPDATE] remove unused patch --- .../azure/ai/contentunderstanding/_patch.py | 34 ------------------- .../ai/contentunderstanding/aio/_patch.py | 34 ------------------- 2 files changed, 68 deletions(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py index edb384719761..711933a71944 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/_patch.py @@ -9,8 +9,6 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ from typing import TYPE_CHECKING, Any, IO, Optional, Union, overload -from typing_extensions import Self -from azure.core.rest import HttpRequest, HttpResponse from azure.core.tracing.decorator import distributed_trace from ._client import ContentUnderstandingClient as GeneratedClient @@ -284,38 +282,6 @@ def begin_analyze_binary( poller._polling_method, # pylint: disable=protected-access ) - def send_request( - self, request: HttpRequest, *, stream: bool = False, **kwargs: Any - ) -> HttpResponse: # pylint: disable=useless-parent-delegation - """Runs the network request through the client's chained policies. - - >>> from azure.core.rest import HttpRequest - >>> request = HttpRequest("GET", "https://www.example.org/") - - >>> response = client.send_request(request) - - - 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 - """ - return super().send_request(request, stream=stream, **kwargs) - - def close(self) -> None: # pylint: disable=useless-parent-delegation - """Close the client session.""" - super().close() - - def __enter__(self) -> Self: - super().__enter__() - return self - - def __exit__(self, *exc_details: Any) -> None: # pylint: disable=useless-parent-delegation - super().__exit__(*exc_details) - def patch_sdk(): """Do not remove from this file. diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py index 56401d0965c0..0a8872326d4d 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/azure/ai/contentunderstanding/aio/_patch.py @@ -9,8 +9,6 @@ Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ from typing import TYPE_CHECKING, Any, IO, Optional, Union, overload -from typing_extensions import Self -from azure.core.rest import AsyncHttpResponse, HttpRequest from azure.core.tracing.decorator_async import distributed_trace_async from ._client import ContentUnderstandingClient as GeneratedClient @@ -284,38 +282,6 @@ async def begin_analyze_binary( poller._polling_method, # pylint: disable=protected-access ) - async def send_request( - self, request: HttpRequest, *, stream: bool = False, **kwargs: Any - ) -> AsyncHttpResponse: # pylint: disable=invalid-overridden-method,useless-parent-delegation - """Runs the network request through the client's chained policies. - - >>> from azure.core.rest import HttpRequest - >>> request = HttpRequest("GET", "https://www.example.org/") - - >>> response = await client.send_request(request) - - - 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.AsyncHttpResponse - """ - return await super().send_request(request, stream=stream, **kwargs) - - async def close(self) -> None: # pylint: disable=useless-parent-delegation - """Close the client session.""" - await super().close() - - async def __aenter__(self) -> Self: - await super().__aenter__() - return self - - async def __aexit__(self, *exc_details: Any) -> None: # pylint: disable=useless-parent-delegation - await super().__aexit__(*exc_details) - def patch_sdk(): """Do not remove from this file. From 85bd72a9bb6e80ce86ae5e27407d00ece952bfbc Mon Sep 17 00:00:00 2001 From: Chien Yuan Chang Date: Mon, 29 Dec 2025 14:23:11 -0800 Subject: [PATCH 105/105] [SAMPLE-README] improvement --- .../azure-ai-contentunderstanding/samples/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md index b4e6856ff88e..a23203d3f988 100644 --- a/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md +++ b/sdk/contentunderstanding/azure-ai-contentunderstanding/samples/README.md @@ -451,7 +451,7 @@ pip install -r dev_requirements.txt ### "KeyError: 'AZURE_CONTENT_UNDERSTANDING_ENDPOINT'" -**Solution:** Create a `.env` file with your credentials (see Setup step 3). +**Solution:** Create a `.env` file with your credentials (see [Setup step 3](#3-configure-environment-variables)). ### "Could not load credentials from the environment"