Skip to content

Commit c03f03f

Browse files
author
SDKAuto
committed
CodeGen from PR 33495 in Azure/azure-rest-api-specs
Merge 9f31a48813b91493f491215f04854cdcbd59fd79 into 45924e49834c4e01c0713e6b7ca21f94be17e396
1 parent e16a937 commit c03f03f

32 files changed

+681
-2973
lines changed

‎sdk/translation/azure-ai-translation-document/CHANGELOG.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Release History
22

3+
## 0.0.0b1 (2025-03-26)
4+
5+
change log generation failed!!!
6+
37
## 1.1.1 (Unreleased)
48

59
### Features Added

‎sdk/translation/azure-ai-translation-document/MANIFEST.in‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,3 @@ recursive-include samples *.py *.md
66
include azure/__init__.py
77
include azure/ai/__init__.py
88
include azure/ai/translation/__init__.py
9-
recursive-include doc *.rst

‎sdk/translation/azure-ai-translation-document/_meta.json‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"commit": "1e151b8b1c5a14e1847adb3d0620392307ad2962",
3+
"repository_url": "https://github.com/Azure/azure-rest-api-specs",
4+
"typespec_src": "specification/translation/Azure.AI.DocumentTranslation",
5+
"@azure-tools/typespec-python": "0.41.0"
6+
}

‎sdk/translation/azure-ai-translation-document/apiview-properties.json‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
{
2+
"CrossLanguagePackageId": "DocumentTranslation",
3+
"CrossLanguageDefinitionId": {
4+
"azure.ai.translation.document.models.BatchOptions": "DocumentTranslation.BatchOptions",
5+
"azure.ai.translation.document.models.DocumentBatch": "DocumentTranslation.BatchRequest",
6+
"azure.ai.translation.document.models.DocumentFilter": "DocumentTranslation.DocumentFilter",
7+
"azure.ai.translation.document.models.DocumentStatus": "DocumentTranslation.DocumentStatus",
8+
"azure.ai.translation.document.models.DocumentTranslateContent": "DocumentTranslation.DocumentTranslateContent",
9+
"azure.ai.translation.document.models.DocumentTranslationError": "DocumentTranslation.TranslationError",
10+
"azure.ai.translation.document.models.DocumentTranslationFileFormat": "DocumentTranslation.FileFormat",
11+
"azure.ai.translation.document.models.InnerTranslationError": "DocumentTranslation.InnerTranslationError",
12+
"azure.ai.translation.document.models.SourceInput": "DocumentTranslation.SourceInput",
13+
"azure.ai.translation.document.models.StartTranslationDetails": "DocumentTranslation.StartTranslationDetails",
14+
"azure.ai.translation.document.models.TranslationErrorResponse": "DocumentTranslation.TranslationErrorResponse",
15+
"azure.ai.translation.document.models.TranslationGlossary": "DocumentTranslation.Glossary",
16+
"azure.ai.translation.document.models.TranslationStatus": "DocumentTranslation.TranslationStatus",
17+
"azure.ai.translation.document.models.TranslationStatusSummary": "DocumentTranslation.StatusSummary",
18+
"azure.ai.translation.document.models.TranslationTarget": "DocumentTranslation.TargetInput",
19+
"azure.ai.translation.document.models.Status": "DocumentTranslation.Status",
20+
"azure.ai.translation.document.models.TranslationErrorCode": "DocumentTranslation.TranslationErrorCode",
21+
"azure.ai.translation.document.models.TranslationStorageSource": "DocumentTranslation.StorageSource",
22+
"azure.ai.translation.document.models.StorageInputType": "DocumentTranslation.StorageInputType",
23+
"azure.ai.translation.document.models.FileFormatType": "DocumentTranslation.FileFormatType",
24+
"azure.ai.translation.document.DocumentTranslationClient.begin_translation": "ClientCustomizations.DocumentTranslationClient.startTranslation",
25+
"azure.ai.translation.document.DocumentTranslationClient.list_translation_statuses": "ClientCustomizations.DocumentTranslationClient.getTranslationsStatus",
26+
"azure.ai.translation.document.DocumentTranslationClient.get_document_status": "ClientCustomizations.DocumentTranslationClient.getDocumentStatus",
27+
"azure.ai.translation.document.DocumentTranslationClient.get_translation_status": "ClientCustomizations.DocumentTranslationClient.getTranslationStatus",
28+
"azure.ai.translation.document.DocumentTranslationClient.cancel_translation": "ClientCustomizations.DocumentTranslationClient.cancelTranslation",
29+
"azure.ai.translation.document.DocumentTranslationClient.list_document_statuses": "ClientCustomizations.DocumentTranslationClient.getDocumentsStatus",
30+
"azure.ai.translation.document.SingleDocumentTranslationClient.translate": "ClientCustomizations.SingleDocumentTranslationClient.documentTranslate"
31+
}
32+
}

‎sdk/translation/azure-ai-translation-document/azure/ai/translation/document/__init__.py‎

Lines changed: 14 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -5,40 +5,30 @@
55
# Code generated by Microsoft (R) Python Code Generator.
66
# Changes may cause incorrect behavior and will be lost if the code is regenerated.
77
# --------------------------------------------------------------------------
8+
# pylint: disable=wrong-import-position
89

9-
from ._patch import DocumentTranslationClient
10-
from ._client import SingleDocumentTranslationClient
10+
from typing import TYPE_CHECKING
11+
12+
if TYPE_CHECKING:
13+
from ._patch import * # pylint: disable=unused-wildcard-import
14+
15+
from ._client import DocumentTranslationClient # type: ignore
16+
from ._client import SingleDocumentTranslationClient # type: ignore
1117
from ._version import VERSION
1218

1319
__version__ = VERSION
1420

15-
16-
from ._patch import DocumentTranslationApiVersion
17-
from ._patch import DocumentTranslationLROPoller
18-
from ._patch import TranslationGlossary
19-
from ._patch import TranslationTarget
20-
from ._patch import DocumentTranslationInput
21-
from ._patch import TranslationStatus
22-
from ._patch import DocumentStatus
23-
from ._patch import DocumentTranslationError
24-
from ._patch import DocumentTranslationFileFormat
25-
from ._patch import StorageInputType
21+
try:
22+
from ._patch import __all__ as _patch_all
23+
from ._patch import *
24+
except ImportError:
25+
_patch_all = []
2626
from ._patch import patch_sdk as _patch_sdk
2727

2828
__all__ = [
29-
"DocumentTranslationApiVersion",
30-
"DocumentTranslationLROPoller",
31-
"TranslationGlossary",
32-
"TranslationTarget",
33-
"DocumentTranslationInput",
34-
"TranslationStatus",
35-
"DocumentStatus",
36-
"DocumentTranslationError",
37-
"DocumentTranslationFileFormat",
38-
"StorageInputType",
3929
"DocumentTranslationClient",
4030
"SingleDocumentTranslationClient",
4131
]
42-
32+
__all__.extend([p for p in _patch_all if p not in __all__]) # pyright: ignore
4333

4434
_patch_sdk()

‎sdk/translation/azure-ai-translation-document/azure/ai/translation/document/_client.py‎

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,13 @@ class DocumentTranslationClient(DocumentTranslationClientOperationsMixin):
2929
:param endpoint: Supported document Translation endpoint, protocol and hostname, for example:
3030
https://{TranslatorResourceName}.cognitiveservices.azure.com/translator. Required.
3131
:type endpoint: str
32-
:param credential: Credential used to authenticate requests to the service. Is either a
33-
AzureKeyCredential type or a TokenCredential type. Required.
32+
:param credential: Credential used to authenticate requests to the service. Is either a key
33+
credential type or a token credential type. Required.
3434
:type credential: ~azure.core.credentials.AzureKeyCredential or
3535
~azure.core.credentials.TokenCredential
36-
:keyword api_version: The API version to use for this operation. Default value is "2024-05-01".
37-
Note that overriding this default value may result in unsupported behavior.
36+
:keyword api_version: The API version to use for this operation. Default value is
37+
"2024-11-01-preview". Note that overriding this default value may result in unsupported
38+
behavior.
3839
:paramtype api_version: str
3940
:keyword int polling_interval: Default waiting time between two polls for LRO operations if no
4041
Retry-After header is present.
@@ -109,12 +110,13 @@ class SingleDocumentTranslationClient(SingleDocumentTranslationClientOperationsM
109110
:param endpoint: Supported document Translation endpoint, protocol and hostname, for example:
110111
https://{TranslatorResourceName}.cognitiveservices.azure.com/translator. Required.
111112
:type endpoint: str
112-
:param credential: Credential used to authenticate requests to the service. Is either a
113-
AzureKeyCredential type or a TokenCredential type. Required.
113+
:param credential: Credential used to authenticate requests to the service. Is either a key
114+
credential type or a token credential type. Required.
114115
:type credential: ~azure.core.credentials.AzureKeyCredential or
115116
~azure.core.credentials.TokenCredential
116-
:keyword api_version: The API version to use for this operation. Default value is "2024-05-01".
117-
Note that overriding this default value may result in unsupported behavior.
117+
:keyword api_version: The API version to use for this operation. Default value is
118+
"2024-11-01-preview". Note that overriding this default value may result in unsupported
119+
behavior.
118120
:paramtype api_version: str
119121
"""
120122

‎sdk/translation/azure-ai-translation-document/azure/ai/translation/document/_configuration.py‎

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -26,17 +26,18 @@ class DocumentTranslationClientConfiguration: # pylint: disable=too-many-instan
2626
:param endpoint: Supported document Translation endpoint, protocol and hostname, for example:
2727
https://{TranslatorResourceName}.cognitiveservices.azure.com/translator. Required.
2828
:type endpoint: str
29-
:param credential: Credential used to authenticate requests to the service. Is either a
30-
AzureKeyCredential type or a TokenCredential type. Required.
29+
:param credential: Credential used to authenticate requests to the service. Is either a key
30+
credential type or a token credential type. Required.
3131
:type credential: ~azure.core.credentials.AzureKeyCredential or
3232
~azure.core.credentials.TokenCredential
33-
:keyword api_version: The API version to use for this operation. Default value is "2024-05-01".
34-
Note that overriding this default value may result in unsupported behavior.
33+
:keyword api_version: The API version to use for this operation. Default value is
34+
"2024-11-01-preview". Note that overriding this default value may result in unsupported
35+
behavior.
3536
:paramtype api_version: str
3637
"""
3738

3839
def __init__(self, endpoint: str, credential: Union[AzureKeyCredential, "TokenCredential"], **kwargs: Any) -> None:
39-
api_version: str = kwargs.pop("api_version", "2024-05-01")
40+
api_version: str = kwargs.pop("api_version", "2024-11-01-preview")
4041

4142
if endpoint is None:
4243
raise ValueError("Parameter 'endpoint' must not be None.")
@@ -81,17 +82,18 @@ class SingleDocumentTranslationClientConfiguration: # pylint: disable=too-many-
8182
:param endpoint: Supported document Translation endpoint, protocol and hostname, for example:
8283
https://{TranslatorResourceName}.cognitiveservices.azure.com/translator. Required.
8384
:type endpoint: str
84-
:param credential: Credential used to authenticate requests to the service. Is either a
85-
AzureKeyCredential type or a TokenCredential type. Required.
85+
:param credential: Credential used to authenticate requests to the service. Is either a key
86+
credential type or a token credential type. Required.
8687
:type credential: ~azure.core.credentials.AzureKeyCredential or
8788
~azure.core.credentials.TokenCredential
88-
:keyword api_version: The API version to use for this operation. Default value is "2024-05-01".
89-
Note that overriding this default value may result in unsupported behavior.
89+
:keyword api_version: The API version to use for this operation. Default value is
90+
"2024-11-01-preview". Note that overriding this default value may result in unsupported
91+
behavior.
9092
:paramtype api_version: str
9193
"""
9294

9395
def __init__(self, endpoint: str, credential: Union[AzureKeyCredential, "TokenCredential"], **kwargs: Any) -> None:
94-
api_version: str = kwargs.pop("api_version", "2024-05-01")
96+
api_version: str = kwargs.pop("api_version", "2024-11-01-preview")
9597

9698
if endpoint is None:
9799
raise ValueError("Parameter 'endpoint' must not be None.")

‎sdk/translation/azure-ai-translation-document/azure/ai/translation/document/_model_base.py‎

Lines changed: 77 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -373,15 +373,34 @@ def __ne__(self, other: typing.Any) -> bool:
373373
return not self.__eq__(other)
374374

375375
def keys(self) -> typing.KeysView[str]:
376+
"""
377+
:returns: a set-like object providing a view on D's keys
378+
:rtype: ~typing.KeysView
379+
"""
376380
return self._data.keys()
377381

378382
def values(self) -> typing.ValuesView[typing.Any]:
383+
"""
384+
:returns: an object providing a view on D's values
385+
:rtype: ~typing.ValuesView
386+
"""
379387
return self._data.values()
380388

381389
def items(self) -> typing.ItemsView[str, typing.Any]:
390+
"""
391+
:returns: set-like object providing a view on D's items
392+
:rtype: ~typing.ItemsView
393+
"""
382394
return self._data.items()
383395

384396
def get(self, key: str, default: typing.Any = None) -> typing.Any:
397+
"""
398+
Get the value for key if key is in the dictionary, else default.
399+
:param str key: The key to look up.
400+
:param any default: The value to return if key is not in the dictionary. Defaults to None
401+
:returns: D[k] if k in D, else d.
402+
:rtype: any
403+
"""
385404
try:
386405
return self[key]
387406
except KeyError:
@@ -397,17 +416,38 @@ def pop(self, key: str, default: _T) -> _T: ...
397416
def pop(self, key: str, default: typing.Any) -> typing.Any: ...
398417

399418
def pop(self, key: str, default: typing.Any = _UNSET) -> typing.Any:
419+
"""
420+
Removes specified key and return the corresponding value.
421+
:param str key: The key to pop.
422+
:param any default: The value to return if key is not in the dictionary
423+
:returns: The value corresponding to the key.
424+
:rtype: any
425+
:raises KeyError: If key is not found and default is not given.
426+
"""
400427
if default is _UNSET:
401428
return self._data.pop(key)
402429
return self._data.pop(key, default)
403430

404431
def popitem(self) -> typing.Tuple[str, typing.Any]:
432+
"""
433+
Removes and returns some (key, value) pair
434+
:returns: The (key, value) pair.
435+
:rtype: tuple
436+
:raises KeyError: if D is empty.
437+
"""
405438
return self._data.popitem()
406439

407440
def clear(self) -> None:
441+
"""
442+
Remove all items from D.
443+
"""
408444
self._data.clear()
409445

410446
def update(self, *args: typing.Any, **kwargs: typing.Any) -> None:
447+
"""
448+
Updates D from mapping/iterable E and F.
449+
:param any args: Either a mapping object or an iterable of key-value pairs.
450+
"""
411451
self._data.update(*args, **kwargs)
412452

413453
@typing.overload
@@ -417,6 +457,13 @@ def setdefault(self, key: str, default: None = None) -> None: ...
417457
def setdefault(self, key: str, default: typing.Any) -> typing.Any: ...
418458

419459
def setdefault(self, key: str, default: typing.Any = _UNSET) -> typing.Any:
460+
"""
461+
Same as calling D.get(k, d), and setting D[k]=d if k not found
462+
:param str key: The key to look up.
463+
:param any default: The value to set if key is not in the dictionary
464+
:returns: D[k] if k in D, else d.
465+
:rtype: any
466+
"""
420467
if default is _UNSET:
421468
return self._data.setdefault(key)
422469
return self._data.setdefault(key, default)
@@ -754,7 +801,7 @@ def _get_deserialize_callable_from_annotation( # pylint: disable=too-many-retur
754801
except AttributeError:
755802
model_name = annotation
756803
if module is not None:
757-
annotation = _get_model(module, model_name)
804+
annotation = _get_model(module, model_name) # type: ignore
758805

759806
try:
760807
if module and _is_model(annotation):
@@ -894,6 +941,35 @@ def _deserialize(
894941
return _deserialize_with_callable(deserializer, value)
895942

896943

944+
def _failsafe_deserialize(
945+
deserializer: typing.Any,
946+
value: typing.Any,
947+
module: typing.Optional[str] = None,
948+
rf: typing.Optional["_RestField"] = None,
949+
format: typing.Optional[str] = None,
950+
) -> typing.Any:
951+
try:
952+
return _deserialize(deserializer, value, module, rf, format)
953+
except DeserializationError:
954+
_LOGGER.warning(
955+
"Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True
956+
)
957+
return None
958+
959+
960+
def _failsafe_deserialize_xml(
961+
deserializer: typing.Any,
962+
value: typing.Any,
963+
) -> typing.Any:
964+
try:
965+
return _deserialize_xml(deserializer, value)
966+
except DeserializationError:
967+
_LOGGER.warning(
968+
"Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True
969+
)
970+
return None
971+
972+
897973
class _RestField:
898974
def __init__(
899975
self,

‎sdk/translation/azure-ai-translation-document/azure/ai/translation/document/_operations/__init__.py‎

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,16 +5,23 @@
55
# Code generated by Microsoft (R) Python Code Generator.
66
# Changes may cause incorrect behavior and will be lost if the code is regenerated.
77
# --------------------------------------------------------------------------
8+
# pylint: disable=wrong-import-position
89

9-
from ._patch import DocumentTranslationClientOperationsMixin
10-
from ._patch import SingleDocumentTranslationClientOperationsMixin
10+
from typing import TYPE_CHECKING
1111

12+
if TYPE_CHECKING:
13+
from ._patch import * # pylint: disable=unused-wildcard-import
1214

15+
from ._operations import DocumentTranslationClientOperationsMixin # type: ignore
16+
from ._operations import SingleDocumentTranslationClientOperationsMixin # type: ignore
17+
18+
from ._patch import __all__ as _patch_all
19+
from ._patch import *
1320
from ._patch import patch_sdk as _patch_sdk
1421

1522
__all__ = [
1623
"DocumentTranslationClientOperationsMixin",
1724
"SingleDocumentTranslationClientOperationsMixin",
1825
]
19-
26+
__all__.extend([p for p in _patch_all if p not in __all__]) # pyright: ignore
2027
_patch_sdk()

0 commit comments

Comments
 (0)