diff --git a/packages/google-cloud-translate/google/cloud/translate/__init__.py b/packages/google-cloud-translate/google/cloud/translate/__init__.py index ec5f62191712..c29d918b5c30 100644 --- a/packages/google-cloud-translate/google/cloud/translate/__init__.py +++ b/packages/google-cloud-translate/google/cloud/translate/__init__.py @@ -24,6 +24,32 @@ from google.cloud.translate_v3.services.translation_service.client import ( TranslationServiceClient, ) +from google.cloud.translate_v3.types.adaptive_mt import ( + AdaptiveMtDataset, + AdaptiveMtFile, + AdaptiveMtSentence, + AdaptiveMtTranslateRequest, + AdaptiveMtTranslateResponse, + AdaptiveMtTranslation, + CreateAdaptiveMtDatasetRequest, + DeleteAdaptiveMtDatasetRequest, + DeleteAdaptiveMtFileRequest, + GetAdaptiveMtDatasetRequest, + GetAdaptiveMtFileRequest, + ImportAdaptiveMtFileRequest, + ImportAdaptiveMtFileResponse, + ListAdaptiveMtDatasetsRequest, + ListAdaptiveMtDatasetsResponse, + ListAdaptiveMtFilesRequest, + ListAdaptiveMtFilesResponse, + ListAdaptiveMtSentencesRequest, + ListAdaptiveMtSentencesResponse, +) +from google.cloud.translate_v3.types.common import ( + FileInputSource, + GcsInputSource, + GcsOutputDestination, +) from google.cloud.translate_v3.types.translation_service import ( BatchDocumentInputConfig, BatchDocumentOutputConfig, @@ -67,6 +93,28 @@ __all__ = ( "TranslationServiceClient", "TranslationServiceAsyncClient", + "AdaptiveMtDataset", + "AdaptiveMtFile", + "AdaptiveMtSentence", + "AdaptiveMtTranslateRequest", + "AdaptiveMtTranslateResponse", + "AdaptiveMtTranslation", + "CreateAdaptiveMtDatasetRequest", + "DeleteAdaptiveMtDatasetRequest", + "DeleteAdaptiveMtFileRequest", + "GetAdaptiveMtDatasetRequest", + "GetAdaptiveMtFileRequest", + "ImportAdaptiveMtFileRequest", + "ImportAdaptiveMtFileResponse", + "ListAdaptiveMtDatasetsRequest", + "ListAdaptiveMtDatasetsResponse", + "ListAdaptiveMtFilesRequest", + "ListAdaptiveMtFilesResponse", + "ListAdaptiveMtSentencesRequest", + "ListAdaptiveMtSentencesResponse", + "FileInputSource", + "GcsInputSource", + "GcsOutputDestination", "BatchDocumentInputConfig", "BatchDocumentOutputConfig", "BatchTranslateDocumentMetadata", diff --git a/packages/google-cloud-translate/google/cloud/translate/gapic_version.py b/packages/google-cloud-translate/google/cloud/translate/gapic_version.py index 82156347f3eb..360a0d13ebdd 100644 --- a/packages/google-cloud-translate/google/cloud/translate/gapic_version.py +++ b/packages/google-cloud-translate/google/cloud/translate/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "3.13.0" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-translate/google/cloud/translate_v2/__init__.py b/packages/google-cloud-translate/google/cloud/translate_v2/__init__.py index 654d187a1330..686456cd1bf7 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v2/__init__.py +++ b/packages/google-cloud-translate/google/cloud/translate_v2/__init__.py @@ -16,7 +16,6 @@ from google.cloud.translate import __version__ - from google.cloud.translate_v2.client import Client __all__ = ("__version__", "Client") diff --git a/packages/google-cloud-translate/google/cloud/translate_v2/client.py b/packages/google-cloud-translate/google/cloud/translate_v2/client.py index 4d5f37ac9b60..e329334dc222 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v2/client.py +++ b/packages/google-cloud-translate/google/cloud/translate_v2/client.py @@ -17,6 +17,7 @@ import google.api_core.client_options from google.cloud.client import Client as BaseClient + from google.cloud.translate_v2._http import Connection ENGLISH_ISO_639 = "en" diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/__init__.py b/packages/google-cloud-translate/google/cloud/translate_v3/__init__.py index b32fbb77db77..ea1d4d36eaa5 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/__init__.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/__init__.py @@ -22,6 +22,28 @@ TranslationServiceAsyncClient, TranslationServiceClient, ) +from .types.adaptive_mt import ( + AdaptiveMtDataset, + AdaptiveMtFile, + AdaptiveMtSentence, + AdaptiveMtTranslateRequest, + AdaptiveMtTranslateResponse, + AdaptiveMtTranslation, + CreateAdaptiveMtDatasetRequest, + DeleteAdaptiveMtDatasetRequest, + DeleteAdaptiveMtFileRequest, + GetAdaptiveMtDatasetRequest, + GetAdaptiveMtFileRequest, + ImportAdaptiveMtFileRequest, + ImportAdaptiveMtFileResponse, + ListAdaptiveMtDatasetsRequest, + ListAdaptiveMtDatasetsResponse, + ListAdaptiveMtFilesRequest, + ListAdaptiveMtFilesResponse, + ListAdaptiveMtSentencesRequest, + ListAdaptiveMtSentencesResponse, +) +from .types.common import FileInputSource, GcsInputSource, GcsOutputDestination from .types.translation_service import ( BatchDocumentInputConfig, BatchDocumentOutputConfig, @@ -64,6 +86,12 @@ __all__ = ( "TranslationServiceAsyncClient", + "AdaptiveMtDataset", + "AdaptiveMtFile", + "AdaptiveMtSentence", + "AdaptiveMtTranslateRequest", + "AdaptiveMtTranslateResponse", + "AdaptiveMtTranslation", "BatchDocumentInputConfig", "BatchDocumentOutputConfig", "BatchTranslateDocumentMetadata", @@ -72,8 +100,11 @@ "BatchTranslateMetadata", "BatchTranslateResponse", "BatchTranslateTextRequest", + "CreateAdaptiveMtDatasetRequest", "CreateGlossaryMetadata", "CreateGlossaryRequest", + "DeleteAdaptiveMtDatasetRequest", + "DeleteAdaptiveMtFileRequest", "DeleteGlossaryMetadata", "DeleteGlossaryRequest", "DeleteGlossaryResponse", @@ -83,13 +114,26 @@ "DocumentInputConfig", "DocumentOutputConfig", "DocumentTranslation", + "FileInputSource", "GcsDestination", + "GcsInputSource", + "GcsOutputDestination", "GcsSource", + "GetAdaptiveMtDatasetRequest", + "GetAdaptiveMtFileRequest", "GetGlossaryRequest", "GetSupportedLanguagesRequest", "Glossary", "GlossaryInputConfig", + "ImportAdaptiveMtFileRequest", + "ImportAdaptiveMtFileResponse", "InputConfig", + "ListAdaptiveMtDatasetsRequest", + "ListAdaptiveMtDatasetsResponse", + "ListAdaptiveMtFilesRequest", + "ListAdaptiveMtFilesResponse", + "ListAdaptiveMtSentencesRequest", + "ListAdaptiveMtSentencesResponse", "ListGlossariesRequest", "ListGlossariesResponse", "OutputConfig", diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/gapic_metadata.json b/packages/google-cloud-translate/google/cloud/translate_v3/gapic_metadata.json index b61ab661417e..4f341c6ab80c 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/gapic_metadata.json +++ b/packages/google-cloud-translate/google/cloud/translate_v3/gapic_metadata.json @@ -10,6 +10,11 @@ "grpc": { "libraryClient": "TranslationServiceClient", "rpcs": { + "AdaptiveMtTranslate": { + "methods": [ + "adaptive_mt_translate" + ] + }, "BatchTranslateDocument": { "methods": [ "batch_translate_document" @@ -20,11 +25,26 @@ "batch_translate_text" ] }, + "CreateAdaptiveMtDataset": { + "methods": [ + "create_adaptive_mt_dataset" + ] + }, "CreateGlossary": { "methods": [ "create_glossary" ] }, + "DeleteAdaptiveMtDataset": { + "methods": [ + "delete_adaptive_mt_dataset" + ] + }, + "DeleteAdaptiveMtFile": { + "methods": [ + "delete_adaptive_mt_file" + ] + }, "DeleteGlossary": { "methods": [ "delete_glossary" @@ -35,6 +55,16 @@ "detect_language" ] }, + "GetAdaptiveMtDataset": { + "methods": [ + "get_adaptive_mt_dataset" + ] + }, + "GetAdaptiveMtFile": { + "methods": [ + "get_adaptive_mt_file" + ] + }, "GetGlossary": { "methods": [ "get_glossary" @@ -45,6 +75,26 @@ "get_supported_languages" ] }, + "ImportAdaptiveMtFile": { + "methods": [ + "import_adaptive_mt_file" + ] + }, + "ListAdaptiveMtDatasets": { + "methods": [ + "list_adaptive_mt_datasets" + ] + }, + "ListAdaptiveMtFiles": { + "methods": [ + "list_adaptive_mt_files" + ] + }, + "ListAdaptiveMtSentences": { + "methods": [ + "list_adaptive_mt_sentences" + ] + }, "ListGlossaries": { "methods": [ "list_glossaries" @@ -65,6 +115,11 @@ "grpc-async": { "libraryClient": "TranslationServiceAsyncClient", "rpcs": { + "AdaptiveMtTranslate": { + "methods": [ + "adaptive_mt_translate" + ] + }, "BatchTranslateDocument": { "methods": [ "batch_translate_document" @@ -75,11 +130,26 @@ "batch_translate_text" ] }, + "CreateAdaptiveMtDataset": { + "methods": [ + "create_adaptive_mt_dataset" + ] + }, "CreateGlossary": { "methods": [ "create_glossary" ] }, + "DeleteAdaptiveMtDataset": { + "methods": [ + "delete_adaptive_mt_dataset" + ] + }, + "DeleteAdaptiveMtFile": { + "methods": [ + "delete_adaptive_mt_file" + ] + }, "DeleteGlossary": { "methods": [ "delete_glossary" @@ -90,6 +160,16 @@ "detect_language" ] }, + "GetAdaptiveMtDataset": { + "methods": [ + "get_adaptive_mt_dataset" + ] + }, + "GetAdaptiveMtFile": { + "methods": [ + "get_adaptive_mt_file" + ] + }, "GetGlossary": { "methods": [ "get_glossary" @@ -100,6 +180,26 @@ "get_supported_languages" ] }, + "ImportAdaptiveMtFile": { + "methods": [ + "import_adaptive_mt_file" + ] + }, + "ListAdaptiveMtDatasets": { + "methods": [ + "list_adaptive_mt_datasets" + ] + }, + "ListAdaptiveMtFiles": { + "methods": [ + "list_adaptive_mt_files" + ] + }, + "ListAdaptiveMtSentences": { + "methods": [ + "list_adaptive_mt_sentences" + ] + }, "ListGlossaries": { "methods": [ "list_glossaries" @@ -120,6 +220,11 @@ "rest": { "libraryClient": "TranslationServiceClient", "rpcs": { + "AdaptiveMtTranslate": { + "methods": [ + "adaptive_mt_translate" + ] + }, "BatchTranslateDocument": { "methods": [ "batch_translate_document" @@ -130,11 +235,26 @@ "batch_translate_text" ] }, + "CreateAdaptiveMtDataset": { + "methods": [ + "create_adaptive_mt_dataset" + ] + }, "CreateGlossary": { "methods": [ "create_glossary" ] }, + "DeleteAdaptiveMtDataset": { + "methods": [ + "delete_adaptive_mt_dataset" + ] + }, + "DeleteAdaptiveMtFile": { + "methods": [ + "delete_adaptive_mt_file" + ] + }, "DeleteGlossary": { "methods": [ "delete_glossary" @@ -145,6 +265,16 @@ "detect_language" ] }, + "GetAdaptiveMtDataset": { + "methods": [ + "get_adaptive_mt_dataset" + ] + }, + "GetAdaptiveMtFile": { + "methods": [ + "get_adaptive_mt_file" + ] + }, "GetGlossary": { "methods": [ "get_glossary" @@ -155,6 +285,26 @@ "get_supported_languages" ] }, + "ImportAdaptiveMtFile": { + "methods": [ + "import_adaptive_mt_file" + ] + }, + "ListAdaptiveMtDatasets": { + "methods": [ + "list_adaptive_mt_datasets" + ] + }, + "ListAdaptiveMtFiles": { + "methods": [ + "list_adaptive_mt_files" + ] + }, + "ListAdaptiveMtSentences": { + "methods": [ + "list_adaptive_mt_sentences" + ] + }, "ListGlossaries": { "methods": [ "list_glossaries" diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/gapic_version.py b/packages/google-cloud-translate/google/cloud/translate_v3/gapic_version.py index 82156347f3eb..360a0d13ebdd 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/gapic_version.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "3.13.0" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/async_client.py b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/async_client.py index be7401517ecb..b17d48a58e20 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/async_client.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/async_client.py @@ -33,9 +33,10 @@ from google.api_core import retry_async as retries from google.api_core.client_options import ClientOptions from google.auth import credentials as ga_credentials # type: ignore -from google.cloud.translate_v3 import gapic_version as package_version from google.oauth2 import service_account # type: ignore +from google.cloud.translate_v3 import gapic_version as package_version + try: OptionalRetry = Union[retries.AsyncRetry, gapic_v1.method._MethodDefault] except AttributeError: # pragma: NO COVER @@ -43,10 +44,11 @@ from google.api_core import operation # type: ignore from google.api_core import operation_async # type: ignore -from google.cloud.translate_v3.services.translation_service import pagers -from google.cloud.translate_v3.types import translation_service from google.protobuf import timestamp_pb2 # type: ignore +from google.cloud.translate_v3.services.translation_service import pagers +from google.cloud.translate_v3.types import adaptive_mt, translation_service + from .client import TranslationServiceClient from .transports.base import DEFAULT_CLIENT_INFO, TranslationServiceTransport from .transports.grpc_asyncio import TranslationServiceGrpcAsyncIOTransport @@ -60,6 +62,22 @@ class TranslationServiceAsyncClient: DEFAULT_ENDPOINT = TranslationServiceClient.DEFAULT_ENDPOINT DEFAULT_MTLS_ENDPOINT = TranslationServiceClient.DEFAULT_MTLS_ENDPOINT + adaptive_mt_dataset_path = staticmethod( + TranslationServiceClient.adaptive_mt_dataset_path + ) + parse_adaptive_mt_dataset_path = staticmethod( + TranslationServiceClient.parse_adaptive_mt_dataset_path + ) + adaptive_mt_file_path = staticmethod(TranslationServiceClient.adaptive_mt_file_path) + parse_adaptive_mt_file_path = staticmethod( + TranslationServiceClient.parse_adaptive_mt_file_path + ) + adaptive_mt_sentence_path = staticmethod( + TranslationServiceClient.adaptive_mt_sentence_path + ) + parse_adaptive_mt_sentence_path = staticmethod( + TranslationServiceClient.parse_adaptive_mt_sentence_path + ) glossary_path = staticmethod(TranslationServiceClient.glossary_path) parse_glossary_path = staticmethod(TranslationServiceClient.parse_glossary_path) common_billing_account_path = staticmethod( @@ -1648,6 +1666,1091 @@ async def sample_delete_glossary(): # Done; return the response. return response + async def create_adaptive_mt_dataset( + self, + request: Optional[ + Union[adaptive_mt.CreateAdaptiveMtDatasetRequest, dict] + ] = None, + *, + parent: Optional[str] = None, + adaptive_mt_dataset: Optional[adaptive_mt.AdaptiveMtDataset] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtDataset: + r"""Creates an Adaptive MT dataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_create_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + adaptive_mt_dataset = translate_v3.AdaptiveMtDataset() + adaptive_mt_dataset.name = "name_value" + + request = translate_v3.CreateAdaptiveMtDatasetRequest( + parent="parent_value", + adaptive_mt_dataset=adaptive_mt_dataset, + ) + + # Make the request + response = await client.create_adaptive_mt_dataset(request=request) + + # Handle the response + print(response) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.CreateAdaptiveMtDatasetRequest, dict]]): + The request object. Request message for creating an + AdaptiveMtDataset. + parent (:class:`str`): + Required. Name of the parent project. In form of + ``projects/{project-number-or-id}/locations/{location-id}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + adaptive_mt_dataset (:class:`google.cloud.translate_v3.types.AdaptiveMtDataset`): + Required. The AdaptiveMtDataset to be + created. + + This corresponds to the ``adaptive_mt_dataset`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.AdaptiveMtDataset: + An Adaptive MT Dataset. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent, adaptive_mt_dataset]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.CreateAdaptiveMtDatasetRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + if adaptive_mt_dataset is not None: + request.adaptive_mt_dataset = adaptive_mt_dataset + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.create_adaptive_mt_dataset, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + async def delete_adaptive_mt_dataset( + self, + request: Optional[ + Union[adaptive_mt.DeleteAdaptiveMtDatasetRequest, dict] + ] = None, + *, + name: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> None: + r"""Deletes an Adaptive MT dataset, including all its + entries and associated metadata. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_delete_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.DeleteAdaptiveMtDatasetRequest( + name="name_value", + ) + + # Make the request + await client.delete_adaptive_mt_dataset(request=request) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.DeleteAdaptiveMtDatasetRequest, dict]]): + The request object. Request message for deleting an + AdaptiveMtDataset. + name (:class:`str`): + Required. Name of the dataset. In the form of + ``projects/{project-number-or-id}/locations/{location-id}/adaptiveMtDatasets/{adaptive-mt-dataset-id}`` + + This corresponds to the ``name`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([name]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.DeleteAdaptiveMtDatasetRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if name is not None: + request.name = name + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.delete_adaptive_mt_dataset, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)), + ) + + # Send the request. + await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + async def get_adaptive_mt_dataset( + self, + request: Optional[Union[adaptive_mt.GetAdaptiveMtDatasetRequest, dict]] = None, + *, + name: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtDataset: + r"""Gets the Adaptive MT dataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_get_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.GetAdaptiveMtDatasetRequest( + name="name_value", + ) + + # Make the request + response = await client.get_adaptive_mt_dataset(request=request) + + # Handle the response + print(response) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.GetAdaptiveMtDatasetRequest, dict]]): + The request object. Request message for getting an + Adaptive MT dataset. + name (:class:`str`): + Required. Name of the dataset. In the form of + ``projects/{project-number-or-id}/locations/{location-id}/adaptiveMtDatasets/{adaptive-mt-dataset-id}`` + + This corresponds to the ``name`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.AdaptiveMtDataset: + An Adaptive MT Dataset. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([name]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.GetAdaptiveMtDatasetRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if name is not None: + request.name = name + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.get_adaptive_mt_dataset, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)), + ) + + # Send the request. + response = await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + async def list_adaptive_mt_datasets( + self, + request: Optional[ + Union[adaptive_mt.ListAdaptiveMtDatasetsRequest, dict] + ] = None, + *, + parent: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> pagers.ListAdaptiveMtDatasetsAsyncPager: + r"""Lists all Adaptive MT datasets for which the caller + has read permission. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_list_adaptive_mt_datasets(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtDatasetsRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_datasets(request=request) + + # Handle the response + async for response in page_result: + print(response) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.ListAdaptiveMtDatasetsRequest, dict]]): + The request object. Request message for listing all + Adaptive MT datasets that the requestor + has access to. + parent (:class:`str`): + Required. The resource name of the project from which to + list the Adaptive MT datasets. + ``projects/{project-number-or-id}/locations/{location-id}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtDatasetsAsyncPager: + A list of AdaptiveMtDatasets. + + Iterating over this object will yield + results and resolve additional pages + automatically. + + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.ListAdaptiveMtDatasetsRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.list_adaptive_mt_datasets, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # This method is paged; wrap the response in a pager, which provides + # an `__aiter__` convenience method. + response = pagers.ListAdaptiveMtDatasetsAsyncPager( + method=rpc, + request=request, + response=response, + metadata=metadata, + ) + + # Done; return the response. + return response + + async def adaptive_mt_translate( + self, + request: Optional[Union[adaptive_mt.AdaptiveMtTranslateRequest, dict]] = None, + *, + parent: Optional[str] = None, + content: Optional[MutableSequence[str]] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtTranslateResponse: + r"""Translate text using Adaptive MT. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_adaptive_mt_translate(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.AdaptiveMtTranslateRequest( + parent="parent_value", + dataset="dataset_value", + content=['content_value1', 'content_value2'], + ) + + # Make the request + response = await client.adaptive_mt_translate(request=request) + + # Handle the response + print(response) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.AdaptiveMtTranslateRequest, dict]]): + The request object. The request for sending an AdaptiveMt + translation query. + parent (:class:`str`): + Required. Location to make a regional call. + + Format: + ``projects/{project-number-or-id}/locations/{location-id}``. + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + content (:class:`MutableSequence[str]`): + Required. The content of the input in + string format. For now only one sentence + per request is supported. + + This corresponds to the ``content`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.AdaptiveMtTranslateResponse: + An AdaptiveMtTranslate response. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent, content]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.AdaptiveMtTranslateRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + if content: + request.content.extend(content) + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.adaptive_mt_translate, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + async def get_adaptive_mt_file( + self, + request: Optional[Union[adaptive_mt.GetAdaptiveMtFileRequest, dict]] = None, + *, + name: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtFile: + r"""Gets and AdaptiveMtFile + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_get_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.GetAdaptiveMtFileRequest( + name="name_value", + ) + + # Make the request + response = await client.get_adaptive_mt_file(request=request) + + # Handle the response + print(response) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.GetAdaptiveMtFileRequest, dict]]): + The request object. The request for getting an + AdaptiveMtFile. + name (:class:`str`): + Required. The resource name of the file, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + + This corresponds to the ``name`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.AdaptiveMtFile: + An AdaptiveMtFile. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([name]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.GetAdaptiveMtFileRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if name is not None: + request.name = name + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.get_adaptive_mt_file, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)), + ) + + # Send the request. + response = await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + async def delete_adaptive_mt_file( + self, + request: Optional[Union[adaptive_mt.DeleteAdaptiveMtFileRequest, dict]] = None, + *, + name: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> None: + r"""Deletes an AdaptiveMtFile along with its sentences. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_delete_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.DeleteAdaptiveMtFileRequest( + name="name_value", + ) + + # Make the request + await client.delete_adaptive_mt_file(request=request) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.DeleteAdaptiveMtFileRequest, dict]]): + The request object. The request for deleting an + AdaptiveMt file. + name (:class:`str`): + Required. The resource name of the file to delete, in + form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + + This corresponds to the ``name`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([name]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.DeleteAdaptiveMtFileRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if name is not None: + request.name = name + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.delete_adaptive_mt_file, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)), + ) + + # Send the request. + await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + async def import_adaptive_mt_file( + self, + request: Optional[Union[adaptive_mt.ImportAdaptiveMtFileRequest, dict]] = None, + *, + parent: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.ImportAdaptiveMtFileResponse: + r"""Imports an AdaptiveMtFile and adds all of its + sentences into the AdaptiveMtDataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_import_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + file_input_source = translate_v3.FileInputSource() + file_input_source.mime_type = "mime_type_value" + file_input_source.content = b'content_blob' + file_input_source.display_name = "display_name_value" + + request = translate_v3.ImportAdaptiveMtFileRequest( + file_input_source=file_input_source, + parent="parent_value", + ) + + # Make the request + response = await client.import_adaptive_mt_file(request=request) + + # Handle the response + print(response) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.ImportAdaptiveMtFileRequest, dict]]): + The request object. The request for importing an + AdaptiveMt file along with its + sentences. + parent (:class:`str`): + Required. The resource name of the file, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.ImportAdaptiveMtFileResponse: + The response for importing an + AdaptiveMtFile + + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.ImportAdaptiveMtFileRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.import_adaptive_mt_file, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + async def list_adaptive_mt_files( + self, + request: Optional[Union[adaptive_mt.ListAdaptiveMtFilesRequest, dict]] = None, + *, + parent: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> pagers.ListAdaptiveMtFilesAsyncPager: + r"""Lists all AdaptiveMtFiles associated to an + AdaptiveMtDataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_list_adaptive_mt_files(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtFilesRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_files(request=request) + + # Handle the response + async for response in page_result: + print(response) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.ListAdaptiveMtFilesRequest, dict]]): + The request object. The request to list all AdaptiveMt + files under a given dataset. + parent (:class:`str`): + Required. The resource name of the project from which to + list the Adaptive MT files. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtFilesAsyncPager: + The response for listing all + AdaptiveMt files under a given dataset. + Iterating over this object will yield + results and resolve additional pages + automatically. + + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.ListAdaptiveMtFilesRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.list_adaptive_mt_files, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # This method is paged; wrap the response in a pager, which provides + # an `__aiter__` convenience method. + response = pagers.ListAdaptiveMtFilesAsyncPager( + method=rpc, + request=request, + response=response, + metadata=metadata, + ) + + # Done; return the response. + return response + + async def list_adaptive_mt_sentences( + self, + request: Optional[ + Union[adaptive_mt.ListAdaptiveMtSentencesRequest, dict] + ] = None, + *, + parent: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> pagers.ListAdaptiveMtSentencesAsyncPager: + r"""Lists all AdaptiveMtSentences under a given + file/dataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + async def sample_list_adaptive_mt_sentences(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtSentencesRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_sentences(request=request) + + # Handle the response + async for response in page_result: + print(response) + + Args: + request (Optional[Union[google.cloud.translate_v3.types.ListAdaptiveMtSentencesRequest, dict]]): + The request object. The request for listing Adaptive MT + sentences from a Dataset/File. + parent (:class:`str`): + Required. The resource name of the project from which to + list the Adaptive MT files. The following format lists + all sentences under a file. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + The following format lists all sentences within a + dataset. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtSentencesAsyncPager: + List AdaptiveMt sentences response. + + Iterating over this object will yield + results and resolve additional pages + automatically. + + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + request = adaptive_mt.ListAdaptiveMtSentencesRequest(request) + + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.list_adaptive_mt_sentences, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # This method is paged; wrap the response in a pager, which provides + # an `__aiter__` convenience method. + response = pagers.ListAdaptiveMtSentencesAsyncPager( + method=rpc, + request=request, + response=response, + metadata=metadata, + ) + + # Done; return the response. + return response + async def __aenter__(self) -> "TranslationServiceAsyncClient": return self diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/client.py b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/client.py index 1d4f4310f983..9f6576a9f6b9 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/client.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/client.py @@ -37,9 +37,10 @@ from google.auth.exceptions import MutualTLSChannelError # type: ignore from google.auth.transport import mtls # type: ignore from google.auth.transport.grpc import SslCredentials # type: ignore -from google.cloud.translate_v3 import gapic_version as package_version from google.oauth2 import service_account # type: ignore +from google.cloud.translate_v3 import gapic_version as package_version + try: OptionalRetry = Union[retries.Retry, gapic_v1.method._MethodDefault] except AttributeError: # pragma: NO COVER @@ -47,10 +48,11 @@ from google.api_core import operation # type: ignore from google.api_core import operation_async # type: ignore -from google.cloud.translate_v3.services.translation_service import pagers -from google.cloud.translate_v3.types import translation_service from google.protobuf import timestamp_pb2 # type: ignore +from google.cloud.translate_v3.services.translation_service import pagers +from google.cloud.translate_v3.types import adaptive_mt, translation_service + from .transports.base import DEFAULT_CLIENT_INFO, TranslationServiceTransport from .transports.grpc import TranslationServiceGrpcTransport from .transports.grpc_asyncio import TranslationServiceGrpcAsyncIOTransport @@ -179,6 +181,78 @@ def transport(self) -> TranslationServiceTransport: """ return self._transport + @staticmethod + def adaptive_mt_dataset_path( + project: str, + location: str, + dataset: str, + ) -> str: + """Returns a fully-qualified adaptive_mt_dataset string.""" + return "projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}".format( + project=project, + location=location, + dataset=dataset, + ) + + @staticmethod + def parse_adaptive_mt_dataset_path(path: str) -> Dict[str, str]: + """Parses a adaptive_mt_dataset path into its component segments.""" + m = re.match( + r"^projects/(?P.+?)/locations/(?P.+?)/adaptiveMtDatasets/(?P.+?)$", + path, + ) + return m.groupdict() if m else {} + + @staticmethod + def adaptive_mt_file_path( + project: str, + location: str, + dataset: str, + file: str, + ) -> str: + """Returns a fully-qualified adaptive_mt_file string.""" + return "projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}".format( + project=project, + location=location, + dataset=dataset, + file=file, + ) + + @staticmethod + def parse_adaptive_mt_file_path(path: str) -> Dict[str, str]: + """Parses a adaptive_mt_file path into its component segments.""" + m = re.match( + r"^projects/(?P.+?)/locations/(?P.+?)/adaptiveMtDatasets/(?P.+?)/adaptiveMtFiles/(?P.+?)$", + path, + ) + return m.groupdict() if m else {} + + @staticmethod + def adaptive_mt_sentence_path( + project: str, + location: str, + dataset: str, + file: str, + sentence: str, + ) -> str: + """Returns a fully-qualified adaptive_mt_sentence string.""" + return "projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}/adaptiveMtSentences/{sentence}".format( + project=project, + location=location, + dataset=dataset, + file=file, + sentence=sentence, + ) + + @staticmethod + def parse_adaptive_mt_sentence_path(path: str) -> Dict[str, str]: + """Parses a adaptive_mt_sentence path into its component segments.""" + m = re.match( + r"^projects/(?P.+?)/locations/(?P.+?)/adaptiveMtDatasets/(?P.+?)/adaptiveMtFiles/(?P.+?)/adaptiveMtSentences/(?P.+?)$", + path, + ) + return m.groupdict() if m else {} + @staticmethod def glossary_path( project: str, @@ -1838,6 +1912,1099 @@ def sample_delete_glossary(): # Done; return the response. return response + def create_adaptive_mt_dataset( + self, + request: Optional[ + Union[adaptive_mt.CreateAdaptiveMtDatasetRequest, dict] + ] = None, + *, + parent: Optional[str] = None, + adaptive_mt_dataset: Optional[adaptive_mt.AdaptiveMtDataset] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtDataset: + r"""Creates an Adaptive MT dataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_create_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + adaptive_mt_dataset = translate_v3.AdaptiveMtDataset() + adaptive_mt_dataset.name = "name_value" + + request = translate_v3.CreateAdaptiveMtDatasetRequest( + parent="parent_value", + adaptive_mt_dataset=adaptive_mt_dataset, + ) + + # Make the request + response = client.create_adaptive_mt_dataset(request=request) + + # Handle the response + print(response) + + Args: + request (Union[google.cloud.translate_v3.types.CreateAdaptiveMtDatasetRequest, dict]): + The request object. Request message for creating an + AdaptiveMtDataset. + parent (str): + Required. Name of the parent project. In form of + ``projects/{project-number-or-id}/locations/{location-id}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + adaptive_mt_dataset (google.cloud.translate_v3.types.AdaptiveMtDataset): + Required. The AdaptiveMtDataset to be + created. + + This corresponds to the ``adaptive_mt_dataset`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.AdaptiveMtDataset: + An Adaptive MT Dataset. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent, adaptive_mt_dataset]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.CreateAdaptiveMtDatasetRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.CreateAdaptiveMtDatasetRequest): + request = adaptive_mt.CreateAdaptiveMtDatasetRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + if adaptive_mt_dataset is not None: + request.adaptive_mt_dataset = adaptive_mt_dataset + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[ + self._transport.create_adaptive_mt_dataset + ] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + def delete_adaptive_mt_dataset( + self, + request: Optional[ + Union[adaptive_mt.DeleteAdaptiveMtDatasetRequest, dict] + ] = None, + *, + name: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> None: + r"""Deletes an Adaptive MT dataset, including all its + entries and associated metadata. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_delete_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.DeleteAdaptiveMtDatasetRequest( + name="name_value", + ) + + # Make the request + client.delete_adaptive_mt_dataset(request=request) + + Args: + request (Union[google.cloud.translate_v3.types.DeleteAdaptiveMtDatasetRequest, dict]): + The request object. Request message for deleting an + AdaptiveMtDataset. + name (str): + Required. Name of the dataset. In the form of + ``projects/{project-number-or-id}/locations/{location-id}/adaptiveMtDatasets/{adaptive-mt-dataset-id}`` + + This corresponds to the ``name`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([name]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.DeleteAdaptiveMtDatasetRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.DeleteAdaptiveMtDatasetRequest): + request = adaptive_mt.DeleteAdaptiveMtDatasetRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if name is not None: + request.name = name + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[ + self._transport.delete_adaptive_mt_dataset + ] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)), + ) + + # Send the request. + rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + def get_adaptive_mt_dataset( + self, + request: Optional[Union[adaptive_mt.GetAdaptiveMtDatasetRequest, dict]] = None, + *, + name: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtDataset: + r"""Gets the Adaptive MT dataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_get_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.GetAdaptiveMtDatasetRequest( + name="name_value", + ) + + # Make the request + response = client.get_adaptive_mt_dataset(request=request) + + # Handle the response + print(response) + + Args: + request (Union[google.cloud.translate_v3.types.GetAdaptiveMtDatasetRequest, dict]): + The request object. Request message for getting an + Adaptive MT dataset. + name (str): + Required. Name of the dataset. In the form of + ``projects/{project-number-or-id}/locations/{location-id}/adaptiveMtDatasets/{adaptive-mt-dataset-id}`` + + This corresponds to the ``name`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.AdaptiveMtDataset: + An Adaptive MT Dataset. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([name]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.GetAdaptiveMtDatasetRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.GetAdaptiveMtDatasetRequest): + request = adaptive_mt.GetAdaptiveMtDatasetRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if name is not None: + request.name = name + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.get_adaptive_mt_dataset] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)), + ) + + # Send the request. + response = rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + def list_adaptive_mt_datasets( + self, + request: Optional[ + Union[adaptive_mt.ListAdaptiveMtDatasetsRequest, dict] + ] = None, + *, + parent: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> pagers.ListAdaptiveMtDatasetsPager: + r"""Lists all Adaptive MT datasets for which the caller + has read permission. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_list_adaptive_mt_datasets(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtDatasetsRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_datasets(request=request) + + # Handle the response + for response in page_result: + print(response) + + Args: + request (Union[google.cloud.translate_v3.types.ListAdaptiveMtDatasetsRequest, dict]): + The request object. Request message for listing all + Adaptive MT datasets that the requestor + has access to. + parent (str): + Required. The resource name of the project from which to + list the Adaptive MT datasets. + ``projects/{project-number-or-id}/locations/{location-id}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtDatasetsPager: + A list of AdaptiveMtDatasets. + + Iterating over this object will yield + results and resolve additional pages + automatically. + + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.ListAdaptiveMtDatasetsRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.ListAdaptiveMtDatasetsRequest): + request = adaptive_mt.ListAdaptiveMtDatasetsRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[ + self._transport.list_adaptive_mt_datasets + ] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # This method is paged; wrap the response in a pager, which provides + # an `__iter__` convenience method. + response = pagers.ListAdaptiveMtDatasetsPager( + method=rpc, + request=request, + response=response, + metadata=metadata, + ) + + # Done; return the response. + return response + + def adaptive_mt_translate( + self, + request: Optional[Union[adaptive_mt.AdaptiveMtTranslateRequest, dict]] = None, + *, + parent: Optional[str] = None, + content: Optional[MutableSequence[str]] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtTranslateResponse: + r"""Translate text using Adaptive MT. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_adaptive_mt_translate(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.AdaptiveMtTranslateRequest( + parent="parent_value", + dataset="dataset_value", + content=['content_value1', 'content_value2'], + ) + + # Make the request + response = client.adaptive_mt_translate(request=request) + + # Handle the response + print(response) + + Args: + request (Union[google.cloud.translate_v3.types.AdaptiveMtTranslateRequest, dict]): + The request object. The request for sending an AdaptiveMt + translation query. + parent (str): + Required. Location to make a regional call. + + Format: + ``projects/{project-number-or-id}/locations/{location-id}``. + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + content (MutableSequence[str]): + Required. The content of the input in + string format. For now only one sentence + per request is supported. + + This corresponds to the ``content`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.AdaptiveMtTranslateResponse: + An AdaptiveMtTranslate response. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent, content]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.AdaptiveMtTranslateRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.AdaptiveMtTranslateRequest): + request = adaptive_mt.AdaptiveMtTranslateRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + if content is not None: + request.content = content + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.adaptive_mt_translate] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + def get_adaptive_mt_file( + self, + request: Optional[Union[adaptive_mt.GetAdaptiveMtFileRequest, dict]] = None, + *, + name: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtFile: + r"""Gets and AdaptiveMtFile + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_get_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.GetAdaptiveMtFileRequest( + name="name_value", + ) + + # Make the request + response = client.get_adaptive_mt_file(request=request) + + # Handle the response + print(response) + + Args: + request (Union[google.cloud.translate_v3.types.GetAdaptiveMtFileRequest, dict]): + The request object. The request for getting an + AdaptiveMtFile. + name (str): + Required. The resource name of the file, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + + This corresponds to the ``name`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.AdaptiveMtFile: + An AdaptiveMtFile. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([name]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.GetAdaptiveMtFileRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.GetAdaptiveMtFileRequest): + request = adaptive_mt.GetAdaptiveMtFileRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if name is not None: + request.name = name + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.get_adaptive_mt_file] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)), + ) + + # Send the request. + response = rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + def delete_adaptive_mt_file( + self, + request: Optional[Union[adaptive_mt.DeleteAdaptiveMtFileRequest, dict]] = None, + *, + name: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> None: + r"""Deletes an AdaptiveMtFile along with its sentences. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_delete_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.DeleteAdaptiveMtFileRequest( + name="name_value", + ) + + # Make the request + client.delete_adaptive_mt_file(request=request) + + Args: + request (Union[google.cloud.translate_v3.types.DeleteAdaptiveMtFileRequest, dict]): + The request object. The request for deleting an + AdaptiveMt file. + name (str): + Required. The resource name of the file to delete, in + form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + + This corresponds to the ``name`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([name]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.DeleteAdaptiveMtFileRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.DeleteAdaptiveMtFileRequest): + request = adaptive_mt.DeleteAdaptiveMtFileRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if name is not None: + request.name = name + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.delete_adaptive_mt_file] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)), + ) + + # Send the request. + rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + def import_adaptive_mt_file( + self, + request: Optional[Union[adaptive_mt.ImportAdaptiveMtFileRequest, dict]] = None, + *, + parent: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.ImportAdaptiveMtFileResponse: + r"""Imports an AdaptiveMtFile and adds all of its + sentences into the AdaptiveMtDataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_import_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + file_input_source = translate_v3.FileInputSource() + file_input_source.mime_type = "mime_type_value" + file_input_source.content = b'content_blob' + file_input_source.display_name = "display_name_value" + + request = translate_v3.ImportAdaptiveMtFileRequest( + file_input_source=file_input_source, + parent="parent_value", + ) + + # Make the request + response = client.import_adaptive_mt_file(request=request) + + # Handle the response + print(response) + + Args: + request (Union[google.cloud.translate_v3.types.ImportAdaptiveMtFileRequest, dict]): + The request object. The request for importing an + AdaptiveMt file along with its + sentences. + parent (str): + Required. The resource name of the file, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.types.ImportAdaptiveMtFileResponse: + The response for importing an + AdaptiveMtFile + + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.ImportAdaptiveMtFileRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.ImportAdaptiveMtFileRequest): + request = adaptive_mt.ImportAdaptiveMtFileRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.import_adaptive_mt_file] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # Done; return the response. + return response + + def list_adaptive_mt_files( + self, + request: Optional[Union[adaptive_mt.ListAdaptiveMtFilesRequest, dict]] = None, + *, + parent: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> pagers.ListAdaptiveMtFilesPager: + r"""Lists all AdaptiveMtFiles associated to an + AdaptiveMtDataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_list_adaptive_mt_files(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtFilesRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_files(request=request) + + # Handle the response + for response in page_result: + print(response) + + Args: + request (Union[google.cloud.translate_v3.types.ListAdaptiveMtFilesRequest, dict]): + The request object. The request to list all AdaptiveMt + files under a given dataset. + parent (str): + Required. The resource name of the project from which to + list the Adaptive MT files. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtFilesPager: + The response for listing all + AdaptiveMt files under a given dataset. + Iterating over this object will yield + results and resolve additional pages + automatically. + + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.ListAdaptiveMtFilesRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.ListAdaptiveMtFilesRequest): + request = adaptive_mt.ListAdaptiveMtFilesRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.list_adaptive_mt_files] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # This method is paged; wrap the response in a pager, which provides + # an `__iter__` convenience method. + response = pagers.ListAdaptiveMtFilesPager( + method=rpc, + request=request, + response=response, + metadata=metadata, + ) + + # Done; return the response. + return response + + def list_adaptive_mt_sentences( + self, + request: Optional[ + Union[adaptive_mt.ListAdaptiveMtSentencesRequest, dict] + ] = None, + *, + parent: Optional[str] = None, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Union[float, object] = gapic_v1.method.DEFAULT, + metadata: Sequence[Tuple[str, str]] = (), + ) -> pagers.ListAdaptiveMtSentencesPager: + r"""Lists all AdaptiveMtSentences under a given + file/dataset. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import translate_v3 + + def sample_list_adaptive_mt_sentences(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtSentencesRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_sentences(request=request) + + # Handle the response + for response in page_result: + print(response) + + Args: + request (Union[google.cloud.translate_v3.types.ListAdaptiveMtSentencesRequest, dict]): + The request object. The request for listing Adaptive MT + sentences from a Dataset/File. + parent (str): + Required. The resource name of the project from which to + list the Adaptive MT files. The following format lists + all sentences under a file. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + The following format lists all sentences within a + dataset. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}`` + + This corresponds to the ``parent`` field + on the ``request`` instance; if ``request`` is provided, this + should not be set. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtSentencesPager: + List AdaptiveMt sentences response. + + Iterating over this object will yield + results and resolve additional pages + automatically. + + """ + # Create or coerce a protobuf request object. + # Quick check: If we got a request object, we should *not* have + # gotten any keyword arguments that map to the request. + has_flattened_params = any([parent]) + if request is not None and has_flattened_params: + raise ValueError( + "If the `request` argument is set, then none of " + "the individual field arguments should be set." + ) + + # Minor optimization to avoid making a copy if the user passes + # in a adaptive_mt.ListAdaptiveMtSentencesRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, adaptive_mt.ListAdaptiveMtSentencesRequest): + request = adaptive_mt.ListAdaptiveMtSentencesRequest(request) + # If we have keyword arguments corresponding to fields on the + # request, apply these. + if parent is not None: + request.parent = parent + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[ + self._transport.list_adaptive_mt_sentences + ] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", request.parent),)), + ) + + # Send the request. + response = rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + + # This method is paged; wrap the response in a pager, which provides + # an `__iter__` convenience method. + response = pagers.ListAdaptiveMtSentencesPager( + method=rpc, + request=request, + response=response, + metadata=metadata, + ) + + # Done; return the response. + return response + def __enter__(self) -> "TranslationServiceClient": return self diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/pagers.py b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/pagers.py index 90ba674c40a1..97150302b979 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/pagers.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/pagers.py @@ -24,7 +24,7 @@ Tuple, ) -from google.cloud.translate_v3.types import translation_service +from google.cloud.translate_v3.types import adaptive_mt, translation_service class ListGlossariesPager: @@ -153,3 +153,387 @@ async def async_generator(): def __repr__(self) -> str: return "{0}<{1!r}>".format(self.__class__.__name__, self._response) + + +class ListAdaptiveMtDatasetsPager: + """A pager for iterating through ``list_adaptive_mt_datasets`` requests. + + This class thinly wraps an initial + :class:`google.cloud.translate_v3.types.ListAdaptiveMtDatasetsResponse` object, and + provides an ``__iter__`` method to iterate through its + ``adaptive_mt_datasets`` field. + + If there are more pages, the ``__iter__`` method will make additional + ``ListAdaptiveMtDatasets`` requests and continue to iterate + through the ``adaptive_mt_datasets`` field on the + corresponding responses. + + All the usual :class:`google.cloud.translate_v3.types.ListAdaptiveMtDatasetsResponse` + attributes are available on the pager. If multiple requests are made, only + the most recent response is retained, and thus used for attribute lookup. + """ + + def __init__( + self, + method: Callable[..., adaptive_mt.ListAdaptiveMtDatasetsResponse], + request: adaptive_mt.ListAdaptiveMtDatasetsRequest, + response: adaptive_mt.ListAdaptiveMtDatasetsResponse, + *, + metadata: Sequence[Tuple[str, str]] = () + ): + """Instantiate the pager. + + Args: + method (Callable): The method that was originally called, and + which instantiated this pager. + request (google.cloud.translate_v3.types.ListAdaptiveMtDatasetsRequest): + The initial request object. + response (google.cloud.translate_v3.types.ListAdaptiveMtDatasetsResponse): + The initial response object. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + self._method = method + self._request = adaptive_mt.ListAdaptiveMtDatasetsRequest(request) + self._response = response + self._metadata = metadata + + def __getattr__(self, name: str) -> Any: + return getattr(self._response, name) + + @property + def pages(self) -> Iterator[adaptive_mt.ListAdaptiveMtDatasetsResponse]: + yield self._response + while self._response.next_page_token: + self._request.page_token = self._response.next_page_token + self._response = self._method(self._request, metadata=self._metadata) + yield self._response + + def __iter__(self) -> Iterator[adaptive_mt.AdaptiveMtDataset]: + for page in self.pages: + yield from page.adaptive_mt_datasets + + def __repr__(self) -> str: + return "{0}<{1!r}>".format(self.__class__.__name__, self._response) + + +class ListAdaptiveMtDatasetsAsyncPager: + """A pager for iterating through ``list_adaptive_mt_datasets`` requests. + + This class thinly wraps an initial + :class:`google.cloud.translate_v3.types.ListAdaptiveMtDatasetsResponse` object, and + provides an ``__aiter__`` method to iterate through its + ``adaptive_mt_datasets`` field. + + If there are more pages, the ``__aiter__`` method will make additional + ``ListAdaptiveMtDatasets`` requests and continue to iterate + through the ``adaptive_mt_datasets`` field on the + corresponding responses. + + All the usual :class:`google.cloud.translate_v3.types.ListAdaptiveMtDatasetsResponse` + attributes are available on the pager. If multiple requests are made, only + the most recent response is retained, and thus used for attribute lookup. + """ + + def __init__( + self, + method: Callable[..., Awaitable[adaptive_mt.ListAdaptiveMtDatasetsResponse]], + request: adaptive_mt.ListAdaptiveMtDatasetsRequest, + response: adaptive_mt.ListAdaptiveMtDatasetsResponse, + *, + metadata: Sequence[Tuple[str, str]] = () + ): + """Instantiates the pager. + + Args: + method (Callable): The method that was originally called, and + which instantiated this pager. + request (google.cloud.translate_v3.types.ListAdaptiveMtDatasetsRequest): + The initial request object. + response (google.cloud.translate_v3.types.ListAdaptiveMtDatasetsResponse): + The initial response object. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + self._method = method + self._request = adaptive_mt.ListAdaptiveMtDatasetsRequest(request) + self._response = response + self._metadata = metadata + + def __getattr__(self, name: str) -> Any: + return getattr(self._response, name) + + @property + async def pages(self) -> AsyncIterator[adaptive_mt.ListAdaptiveMtDatasetsResponse]: + yield self._response + while self._response.next_page_token: + self._request.page_token = self._response.next_page_token + self._response = await self._method(self._request, metadata=self._metadata) + yield self._response + + def __aiter__(self) -> AsyncIterator[adaptive_mt.AdaptiveMtDataset]: + async def async_generator(): + async for page in self.pages: + for response in page.adaptive_mt_datasets: + yield response + + return async_generator() + + def __repr__(self) -> str: + return "{0}<{1!r}>".format(self.__class__.__name__, self._response) + + +class ListAdaptiveMtFilesPager: + """A pager for iterating through ``list_adaptive_mt_files`` requests. + + This class thinly wraps an initial + :class:`google.cloud.translate_v3.types.ListAdaptiveMtFilesResponse` object, and + provides an ``__iter__`` method to iterate through its + ``adaptive_mt_files`` field. + + If there are more pages, the ``__iter__`` method will make additional + ``ListAdaptiveMtFiles`` requests and continue to iterate + through the ``adaptive_mt_files`` field on the + corresponding responses. + + All the usual :class:`google.cloud.translate_v3.types.ListAdaptiveMtFilesResponse` + attributes are available on the pager. If multiple requests are made, only + the most recent response is retained, and thus used for attribute lookup. + """ + + def __init__( + self, + method: Callable[..., adaptive_mt.ListAdaptiveMtFilesResponse], + request: adaptive_mt.ListAdaptiveMtFilesRequest, + response: adaptive_mt.ListAdaptiveMtFilesResponse, + *, + metadata: Sequence[Tuple[str, str]] = () + ): + """Instantiate the pager. + + Args: + method (Callable): The method that was originally called, and + which instantiated this pager. + request (google.cloud.translate_v3.types.ListAdaptiveMtFilesRequest): + The initial request object. + response (google.cloud.translate_v3.types.ListAdaptiveMtFilesResponse): + The initial response object. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + self._method = method + self._request = adaptive_mt.ListAdaptiveMtFilesRequest(request) + self._response = response + self._metadata = metadata + + def __getattr__(self, name: str) -> Any: + return getattr(self._response, name) + + @property + def pages(self) -> Iterator[adaptive_mt.ListAdaptiveMtFilesResponse]: + yield self._response + while self._response.next_page_token: + self._request.page_token = self._response.next_page_token + self._response = self._method(self._request, metadata=self._metadata) + yield self._response + + def __iter__(self) -> Iterator[adaptive_mt.AdaptiveMtFile]: + for page in self.pages: + yield from page.adaptive_mt_files + + def __repr__(self) -> str: + return "{0}<{1!r}>".format(self.__class__.__name__, self._response) + + +class ListAdaptiveMtFilesAsyncPager: + """A pager for iterating through ``list_adaptive_mt_files`` requests. + + This class thinly wraps an initial + :class:`google.cloud.translate_v3.types.ListAdaptiveMtFilesResponse` object, and + provides an ``__aiter__`` method to iterate through its + ``adaptive_mt_files`` field. + + If there are more pages, the ``__aiter__`` method will make additional + ``ListAdaptiveMtFiles`` requests and continue to iterate + through the ``adaptive_mt_files`` field on the + corresponding responses. + + All the usual :class:`google.cloud.translate_v3.types.ListAdaptiveMtFilesResponse` + attributes are available on the pager. If multiple requests are made, only + the most recent response is retained, and thus used for attribute lookup. + """ + + def __init__( + self, + method: Callable[..., Awaitable[adaptive_mt.ListAdaptiveMtFilesResponse]], + request: adaptive_mt.ListAdaptiveMtFilesRequest, + response: adaptive_mt.ListAdaptiveMtFilesResponse, + *, + metadata: Sequence[Tuple[str, str]] = () + ): + """Instantiates the pager. + + Args: + method (Callable): The method that was originally called, and + which instantiated this pager. + request (google.cloud.translate_v3.types.ListAdaptiveMtFilesRequest): + The initial request object. + response (google.cloud.translate_v3.types.ListAdaptiveMtFilesResponse): + The initial response object. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + self._method = method + self._request = adaptive_mt.ListAdaptiveMtFilesRequest(request) + self._response = response + self._metadata = metadata + + def __getattr__(self, name: str) -> Any: + return getattr(self._response, name) + + @property + async def pages(self) -> AsyncIterator[adaptive_mt.ListAdaptiveMtFilesResponse]: + yield self._response + while self._response.next_page_token: + self._request.page_token = self._response.next_page_token + self._response = await self._method(self._request, metadata=self._metadata) + yield self._response + + def __aiter__(self) -> AsyncIterator[adaptive_mt.AdaptiveMtFile]: + async def async_generator(): + async for page in self.pages: + for response in page.adaptive_mt_files: + yield response + + return async_generator() + + def __repr__(self) -> str: + return "{0}<{1!r}>".format(self.__class__.__name__, self._response) + + +class ListAdaptiveMtSentencesPager: + """A pager for iterating through ``list_adaptive_mt_sentences`` requests. + + This class thinly wraps an initial + :class:`google.cloud.translate_v3.types.ListAdaptiveMtSentencesResponse` object, and + provides an ``__iter__`` method to iterate through its + ``adaptive_mt_sentences`` field. + + If there are more pages, the ``__iter__`` method will make additional + ``ListAdaptiveMtSentences`` requests and continue to iterate + through the ``adaptive_mt_sentences`` field on the + corresponding responses. + + All the usual :class:`google.cloud.translate_v3.types.ListAdaptiveMtSentencesResponse` + attributes are available on the pager. If multiple requests are made, only + the most recent response is retained, and thus used for attribute lookup. + """ + + def __init__( + self, + method: Callable[..., adaptive_mt.ListAdaptiveMtSentencesResponse], + request: adaptive_mt.ListAdaptiveMtSentencesRequest, + response: adaptive_mt.ListAdaptiveMtSentencesResponse, + *, + metadata: Sequence[Tuple[str, str]] = () + ): + """Instantiate the pager. + + Args: + method (Callable): The method that was originally called, and + which instantiated this pager. + request (google.cloud.translate_v3.types.ListAdaptiveMtSentencesRequest): + The initial request object. + response (google.cloud.translate_v3.types.ListAdaptiveMtSentencesResponse): + The initial response object. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + self._method = method + self._request = adaptive_mt.ListAdaptiveMtSentencesRequest(request) + self._response = response + self._metadata = metadata + + def __getattr__(self, name: str) -> Any: + return getattr(self._response, name) + + @property + def pages(self) -> Iterator[adaptive_mt.ListAdaptiveMtSentencesResponse]: + yield self._response + while self._response.next_page_token: + self._request.page_token = self._response.next_page_token + self._response = self._method(self._request, metadata=self._metadata) + yield self._response + + def __iter__(self) -> Iterator[adaptive_mt.AdaptiveMtSentence]: + for page in self.pages: + yield from page.adaptive_mt_sentences + + def __repr__(self) -> str: + return "{0}<{1!r}>".format(self.__class__.__name__, self._response) + + +class ListAdaptiveMtSentencesAsyncPager: + """A pager for iterating through ``list_adaptive_mt_sentences`` requests. + + This class thinly wraps an initial + :class:`google.cloud.translate_v3.types.ListAdaptiveMtSentencesResponse` object, and + provides an ``__aiter__`` method to iterate through its + ``adaptive_mt_sentences`` field. + + If there are more pages, the ``__aiter__`` method will make additional + ``ListAdaptiveMtSentences`` requests and continue to iterate + through the ``adaptive_mt_sentences`` field on the + corresponding responses. + + All the usual :class:`google.cloud.translate_v3.types.ListAdaptiveMtSentencesResponse` + attributes are available on the pager. If multiple requests are made, only + the most recent response is retained, and thus used for attribute lookup. + """ + + def __init__( + self, + method: Callable[..., Awaitable[adaptive_mt.ListAdaptiveMtSentencesResponse]], + request: adaptive_mt.ListAdaptiveMtSentencesRequest, + response: adaptive_mt.ListAdaptiveMtSentencesResponse, + *, + metadata: Sequence[Tuple[str, str]] = () + ): + """Instantiates the pager. + + Args: + method (Callable): The method that was originally called, and + which instantiated this pager. + request (google.cloud.translate_v3.types.ListAdaptiveMtSentencesRequest): + The initial request object. + response (google.cloud.translate_v3.types.ListAdaptiveMtSentencesResponse): + The initial response object. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + self._method = method + self._request = adaptive_mt.ListAdaptiveMtSentencesRequest(request) + self._response = response + self._metadata = metadata + + def __getattr__(self, name: str) -> Any: + return getattr(self._response, name) + + @property + async def pages(self) -> AsyncIterator[adaptive_mt.ListAdaptiveMtSentencesResponse]: + yield self._response + while self._response.next_page_token: + self._request.page_token = self._response.next_page_token + self._response = await self._method(self._request, metadata=self._metadata) + yield self._response + + def __aiter__(self) -> AsyncIterator[adaptive_mt.AdaptiveMtSentence]: + async def async_generator(): + async for page in self.pages: + for response in page.adaptive_mt_sentences: + yield response + + return async_generator() + + def __repr__(self) -> str: + return "{0}<{1!r}>".format(self.__class__.__name__, self._response) diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/base.py b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/base.py index 1b5d4c338e9b..c4937b556f24 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/base.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/base.py @@ -22,10 +22,12 @@ from google.api_core import retry as retries import google.auth # type: ignore from google.auth import credentials as ga_credentials # type: ignore -from google.cloud.translate_v3 import gapic_version as package_version -from google.cloud.translate_v3.types import translation_service from google.longrunning import operations_pb2 # type: ignore from google.oauth2 import service_account # type: ignore +from google.protobuf import empty_pb2 # type: ignore + +from google.cloud.translate_v3 import gapic_version as package_version +from google.cloud.translate_v3.types import adaptive_mt, translation_service DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo( gapic_version=package_version.__version__ @@ -215,6 +217,56 @@ def _prep_wrapped_messages(self, client_info): default_timeout=600.0, client_info=client_info, ), + self.create_adaptive_mt_dataset: gapic_v1.method.wrap_method( + self.create_adaptive_mt_dataset, + default_timeout=None, + client_info=client_info, + ), + self.delete_adaptive_mt_dataset: gapic_v1.method.wrap_method( + self.delete_adaptive_mt_dataset, + default_timeout=None, + client_info=client_info, + ), + self.get_adaptive_mt_dataset: gapic_v1.method.wrap_method( + self.get_adaptive_mt_dataset, + default_timeout=None, + client_info=client_info, + ), + self.list_adaptive_mt_datasets: gapic_v1.method.wrap_method( + self.list_adaptive_mt_datasets, + default_timeout=None, + client_info=client_info, + ), + self.adaptive_mt_translate: gapic_v1.method.wrap_method( + self.adaptive_mt_translate, + default_timeout=None, + client_info=client_info, + ), + self.get_adaptive_mt_file: gapic_v1.method.wrap_method( + self.get_adaptive_mt_file, + default_timeout=None, + client_info=client_info, + ), + self.delete_adaptive_mt_file: gapic_v1.method.wrap_method( + self.delete_adaptive_mt_file, + default_timeout=None, + client_info=client_info, + ), + self.import_adaptive_mt_file: gapic_v1.method.wrap_method( + self.import_adaptive_mt_file, + default_timeout=None, + client_info=client_info, + ), + self.list_adaptive_mt_files: gapic_v1.method.wrap_method( + self.list_adaptive_mt_files, + default_timeout=None, + client_info=client_info, + ), + self.list_adaptive_mt_sentences: gapic_v1.method.wrap_method( + self.list_adaptive_mt_sentences, + default_timeout=None, + client_info=client_info, + ), } def close(self): @@ -336,6 +388,111 @@ def delete_glossary( ]: raise NotImplementedError() + @property + def create_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.CreateAdaptiveMtDatasetRequest], + Union[adaptive_mt.AdaptiveMtDataset, Awaitable[adaptive_mt.AdaptiveMtDataset]], + ]: + raise NotImplementedError() + + @property + def delete_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.DeleteAdaptiveMtDatasetRequest], + Union[empty_pb2.Empty, Awaitable[empty_pb2.Empty]], + ]: + raise NotImplementedError() + + @property + def get_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.GetAdaptiveMtDatasetRequest], + Union[adaptive_mt.AdaptiveMtDataset, Awaitable[adaptive_mt.AdaptiveMtDataset]], + ]: + raise NotImplementedError() + + @property + def list_adaptive_mt_datasets( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtDatasetsRequest], + Union[ + adaptive_mt.ListAdaptiveMtDatasetsResponse, + Awaitable[adaptive_mt.ListAdaptiveMtDatasetsResponse], + ], + ]: + raise NotImplementedError() + + @property + def adaptive_mt_translate( + self, + ) -> Callable[ + [adaptive_mt.AdaptiveMtTranslateRequest], + Union[ + adaptive_mt.AdaptiveMtTranslateResponse, + Awaitable[adaptive_mt.AdaptiveMtTranslateResponse], + ], + ]: + raise NotImplementedError() + + @property + def get_adaptive_mt_file( + self, + ) -> Callable[ + [adaptive_mt.GetAdaptiveMtFileRequest], + Union[adaptive_mt.AdaptiveMtFile, Awaitable[adaptive_mt.AdaptiveMtFile]], + ]: + raise NotImplementedError() + + @property + def delete_adaptive_mt_file( + self, + ) -> Callable[ + [adaptive_mt.DeleteAdaptiveMtFileRequest], + Union[empty_pb2.Empty, Awaitable[empty_pb2.Empty]], + ]: + raise NotImplementedError() + + @property + def import_adaptive_mt_file( + self, + ) -> Callable[ + [adaptive_mt.ImportAdaptiveMtFileRequest], + Union[ + adaptive_mt.ImportAdaptiveMtFileResponse, + Awaitable[adaptive_mt.ImportAdaptiveMtFileResponse], + ], + ]: + raise NotImplementedError() + + @property + def list_adaptive_mt_files( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtFilesRequest], + Union[ + adaptive_mt.ListAdaptiveMtFilesResponse, + Awaitable[adaptive_mt.ListAdaptiveMtFilesResponse], + ], + ]: + raise NotImplementedError() + + @property + def list_adaptive_mt_sentences( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtSentencesRequest], + Union[ + adaptive_mt.ListAdaptiveMtSentencesResponse, + Awaitable[adaptive_mt.ListAdaptiveMtSentencesResponse], + ], + ]: + raise NotImplementedError() + @property def kind(self) -> str: raise NotImplementedError() diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/grpc.py b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/grpc.py index aca6525948cf..d2d25800328f 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/grpc.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/grpc.py @@ -16,14 +16,15 @@ from typing import Callable, Dict, Optional, Sequence, Tuple, Union import warnings -import grpc # type: ignore - from google.api_core import gapic_v1, grpc_helpers, operations_v1 import google.auth # type: ignore from google.auth import credentials as ga_credentials # type: ignore from google.auth.transport.grpc import SslCredentials # type: ignore -from google.cloud.translate_v3.types import translation_service from google.longrunning import operations_pb2 # type: ignore +from google.protobuf import empty_pb2 # type: ignore +import grpc # type: ignore + +from google.cloud.translate_v3.types import adaptive_mt, translation_service from .base import DEFAULT_CLIENT_INFO, TranslationServiceTransport @@ -553,6 +554,290 @@ def delete_glossary( ) return self._stubs["delete_glossary"] + @property + def create_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.CreateAdaptiveMtDatasetRequest], adaptive_mt.AdaptiveMtDataset + ]: + r"""Return a callable for the create adaptive mt dataset method over gRPC. + + Creates an Adaptive MT dataset. + + Returns: + Callable[[~.CreateAdaptiveMtDatasetRequest], + ~.AdaptiveMtDataset]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "create_adaptive_mt_dataset" not in self._stubs: + self._stubs["create_adaptive_mt_dataset"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/CreateAdaptiveMtDataset", + request_serializer=adaptive_mt.CreateAdaptiveMtDatasetRequest.serialize, + response_deserializer=adaptive_mt.AdaptiveMtDataset.deserialize, + ) + return self._stubs["create_adaptive_mt_dataset"] + + @property + def delete_adaptive_mt_dataset( + self, + ) -> Callable[[adaptive_mt.DeleteAdaptiveMtDatasetRequest], empty_pb2.Empty]: + r"""Return a callable for the delete adaptive mt dataset method over gRPC. + + Deletes an Adaptive MT dataset, including all its + entries and associated metadata. + + Returns: + Callable[[~.DeleteAdaptiveMtDatasetRequest], + ~.Empty]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "delete_adaptive_mt_dataset" not in self._stubs: + self._stubs["delete_adaptive_mt_dataset"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/DeleteAdaptiveMtDataset", + request_serializer=adaptive_mt.DeleteAdaptiveMtDatasetRequest.serialize, + response_deserializer=empty_pb2.Empty.FromString, + ) + return self._stubs["delete_adaptive_mt_dataset"] + + @property + def get_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.GetAdaptiveMtDatasetRequest], adaptive_mt.AdaptiveMtDataset + ]: + r"""Return a callable for the get adaptive mt dataset method over gRPC. + + Gets the Adaptive MT dataset. + + Returns: + Callable[[~.GetAdaptiveMtDatasetRequest], + ~.AdaptiveMtDataset]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "get_adaptive_mt_dataset" not in self._stubs: + self._stubs["get_adaptive_mt_dataset"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/GetAdaptiveMtDataset", + request_serializer=adaptive_mt.GetAdaptiveMtDatasetRequest.serialize, + response_deserializer=adaptive_mt.AdaptiveMtDataset.deserialize, + ) + return self._stubs["get_adaptive_mt_dataset"] + + @property + def list_adaptive_mt_datasets( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtDatasetsRequest], + adaptive_mt.ListAdaptiveMtDatasetsResponse, + ]: + r"""Return a callable for the list adaptive mt datasets method over gRPC. + + Lists all Adaptive MT datasets for which the caller + has read permission. + + Returns: + Callable[[~.ListAdaptiveMtDatasetsRequest], + ~.ListAdaptiveMtDatasetsResponse]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "list_adaptive_mt_datasets" not in self._stubs: + self._stubs["list_adaptive_mt_datasets"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/ListAdaptiveMtDatasets", + request_serializer=adaptive_mt.ListAdaptiveMtDatasetsRequest.serialize, + response_deserializer=adaptive_mt.ListAdaptiveMtDatasetsResponse.deserialize, + ) + return self._stubs["list_adaptive_mt_datasets"] + + @property + def adaptive_mt_translate( + self, + ) -> Callable[ + [adaptive_mt.AdaptiveMtTranslateRequest], + adaptive_mt.AdaptiveMtTranslateResponse, + ]: + r"""Return a callable for the adaptive mt translate method over gRPC. + + Translate text using Adaptive MT. + + Returns: + Callable[[~.AdaptiveMtTranslateRequest], + ~.AdaptiveMtTranslateResponse]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "adaptive_mt_translate" not in self._stubs: + self._stubs["adaptive_mt_translate"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/AdaptiveMtTranslate", + request_serializer=adaptive_mt.AdaptiveMtTranslateRequest.serialize, + response_deserializer=adaptive_mt.AdaptiveMtTranslateResponse.deserialize, + ) + return self._stubs["adaptive_mt_translate"] + + @property + def get_adaptive_mt_file( + self, + ) -> Callable[[adaptive_mt.GetAdaptiveMtFileRequest], adaptive_mt.AdaptiveMtFile]: + r"""Return a callable for the get adaptive mt file method over gRPC. + + Gets and AdaptiveMtFile + + Returns: + Callable[[~.GetAdaptiveMtFileRequest], + ~.AdaptiveMtFile]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "get_adaptive_mt_file" not in self._stubs: + self._stubs["get_adaptive_mt_file"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/GetAdaptiveMtFile", + request_serializer=adaptive_mt.GetAdaptiveMtFileRequest.serialize, + response_deserializer=adaptive_mt.AdaptiveMtFile.deserialize, + ) + return self._stubs["get_adaptive_mt_file"] + + @property + def delete_adaptive_mt_file( + self, + ) -> Callable[[adaptive_mt.DeleteAdaptiveMtFileRequest], empty_pb2.Empty]: + r"""Return a callable for the delete adaptive mt file method over gRPC. + + Deletes an AdaptiveMtFile along with its sentences. + + Returns: + Callable[[~.DeleteAdaptiveMtFileRequest], + ~.Empty]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "delete_adaptive_mt_file" not in self._stubs: + self._stubs["delete_adaptive_mt_file"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/DeleteAdaptiveMtFile", + request_serializer=adaptive_mt.DeleteAdaptiveMtFileRequest.serialize, + response_deserializer=empty_pb2.Empty.FromString, + ) + return self._stubs["delete_adaptive_mt_file"] + + @property + def import_adaptive_mt_file( + self, + ) -> Callable[ + [adaptive_mt.ImportAdaptiveMtFileRequest], + adaptive_mt.ImportAdaptiveMtFileResponse, + ]: + r"""Return a callable for the import adaptive mt file method over gRPC. + + Imports an AdaptiveMtFile and adds all of its + sentences into the AdaptiveMtDataset. + + Returns: + Callable[[~.ImportAdaptiveMtFileRequest], + ~.ImportAdaptiveMtFileResponse]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "import_adaptive_mt_file" not in self._stubs: + self._stubs["import_adaptive_mt_file"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/ImportAdaptiveMtFile", + request_serializer=adaptive_mt.ImportAdaptiveMtFileRequest.serialize, + response_deserializer=adaptive_mt.ImportAdaptiveMtFileResponse.deserialize, + ) + return self._stubs["import_adaptive_mt_file"] + + @property + def list_adaptive_mt_files( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtFilesRequest], + adaptive_mt.ListAdaptiveMtFilesResponse, + ]: + r"""Return a callable for the list adaptive mt files method over gRPC. + + Lists all AdaptiveMtFiles associated to an + AdaptiveMtDataset. + + Returns: + Callable[[~.ListAdaptiveMtFilesRequest], + ~.ListAdaptiveMtFilesResponse]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "list_adaptive_mt_files" not in self._stubs: + self._stubs["list_adaptive_mt_files"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/ListAdaptiveMtFiles", + request_serializer=adaptive_mt.ListAdaptiveMtFilesRequest.serialize, + response_deserializer=adaptive_mt.ListAdaptiveMtFilesResponse.deserialize, + ) + return self._stubs["list_adaptive_mt_files"] + + @property + def list_adaptive_mt_sentences( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtSentencesRequest], + adaptive_mt.ListAdaptiveMtSentencesResponse, + ]: + r"""Return a callable for the list adaptive mt sentences method over gRPC. + + Lists all AdaptiveMtSentences under a given + file/dataset. + + Returns: + Callable[[~.ListAdaptiveMtSentencesRequest], + ~.ListAdaptiveMtSentencesResponse]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "list_adaptive_mt_sentences" not in self._stubs: + self._stubs["list_adaptive_mt_sentences"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/ListAdaptiveMtSentences", + request_serializer=adaptive_mt.ListAdaptiveMtSentencesRequest.serialize, + response_deserializer=adaptive_mt.ListAdaptiveMtSentencesResponse.deserialize, + ) + return self._stubs["list_adaptive_mt_sentences"] + def close(self): self.grpc_channel.close() diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/grpc_asyncio.py b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/grpc_asyncio.py index 8cdc572e8d96..1daabe2b44b7 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/grpc_asyncio.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/grpc_asyncio.py @@ -16,14 +16,15 @@ from typing import Awaitable, Callable, Dict, Optional, Sequence, Tuple, Union import warnings -import grpc # type: ignore -from grpc.experimental import aio # type: ignore - from google.api_core import gapic_v1, grpc_helpers_async, operations_v1 from google.auth import credentials as ga_credentials # type: ignore from google.auth.transport.grpc import SslCredentials # type: ignore -from google.cloud.translate_v3.types import translation_service from google.longrunning import operations_pb2 # type: ignore +from google.protobuf import empty_pb2 # type: ignore +import grpc # type: ignore +from grpc.experimental import aio # type: ignore + +from google.cloud.translate_v3.types import adaptive_mt, translation_service from .base import DEFAULT_CLIENT_INFO, TranslationServiceTransport from .grpc import TranslationServiceGrpcTransport @@ -561,6 +562,298 @@ def delete_glossary( ) return self._stubs["delete_glossary"] + @property + def create_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.CreateAdaptiveMtDatasetRequest], + Awaitable[adaptive_mt.AdaptiveMtDataset], + ]: + r"""Return a callable for the create adaptive mt dataset method over gRPC. + + Creates an Adaptive MT dataset. + + Returns: + Callable[[~.CreateAdaptiveMtDatasetRequest], + Awaitable[~.AdaptiveMtDataset]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "create_adaptive_mt_dataset" not in self._stubs: + self._stubs["create_adaptive_mt_dataset"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/CreateAdaptiveMtDataset", + request_serializer=adaptive_mt.CreateAdaptiveMtDatasetRequest.serialize, + response_deserializer=adaptive_mt.AdaptiveMtDataset.deserialize, + ) + return self._stubs["create_adaptive_mt_dataset"] + + @property + def delete_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.DeleteAdaptiveMtDatasetRequest], Awaitable[empty_pb2.Empty] + ]: + r"""Return a callable for the delete adaptive mt dataset method over gRPC. + + Deletes an Adaptive MT dataset, including all its + entries and associated metadata. + + Returns: + Callable[[~.DeleteAdaptiveMtDatasetRequest], + Awaitable[~.Empty]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "delete_adaptive_mt_dataset" not in self._stubs: + self._stubs["delete_adaptive_mt_dataset"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/DeleteAdaptiveMtDataset", + request_serializer=adaptive_mt.DeleteAdaptiveMtDatasetRequest.serialize, + response_deserializer=empty_pb2.Empty.FromString, + ) + return self._stubs["delete_adaptive_mt_dataset"] + + @property + def get_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.GetAdaptiveMtDatasetRequest], + Awaitable[adaptive_mt.AdaptiveMtDataset], + ]: + r"""Return a callable for the get adaptive mt dataset method over gRPC. + + Gets the Adaptive MT dataset. + + Returns: + Callable[[~.GetAdaptiveMtDatasetRequest], + Awaitable[~.AdaptiveMtDataset]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "get_adaptive_mt_dataset" not in self._stubs: + self._stubs["get_adaptive_mt_dataset"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/GetAdaptiveMtDataset", + request_serializer=adaptive_mt.GetAdaptiveMtDatasetRequest.serialize, + response_deserializer=adaptive_mt.AdaptiveMtDataset.deserialize, + ) + return self._stubs["get_adaptive_mt_dataset"] + + @property + def list_adaptive_mt_datasets( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtDatasetsRequest], + Awaitable[adaptive_mt.ListAdaptiveMtDatasetsResponse], + ]: + r"""Return a callable for the list adaptive mt datasets method over gRPC. + + Lists all Adaptive MT datasets for which the caller + has read permission. + + Returns: + Callable[[~.ListAdaptiveMtDatasetsRequest], + Awaitable[~.ListAdaptiveMtDatasetsResponse]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "list_adaptive_mt_datasets" not in self._stubs: + self._stubs["list_adaptive_mt_datasets"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/ListAdaptiveMtDatasets", + request_serializer=adaptive_mt.ListAdaptiveMtDatasetsRequest.serialize, + response_deserializer=adaptive_mt.ListAdaptiveMtDatasetsResponse.deserialize, + ) + return self._stubs["list_adaptive_mt_datasets"] + + @property + def adaptive_mt_translate( + self, + ) -> Callable[ + [adaptive_mt.AdaptiveMtTranslateRequest], + Awaitable[adaptive_mt.AdaptiveMtTranslateResponse], + ]: + r"""Return a callable for the adaptive mt translate method over gRPC. + + Translate text using Adaptive MT. + + Returns: + Callable[[~.AdaptiveMtTranslateRequest], + Awaitable[~.AdaptiveMtTranslateResponse]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "adaptive_mt_translate" not in self._stubs: + self._stubs["adaptive_mt_translate"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/AdaptiveMtTranslate", + request_serializer=adaptive_mt.AdaptiveMtTranslateRequest.serialize, + response_deserializer=adaptive_mt.AdaptiveMtTranslateResponse.deserialize, + ) + return self._stubs["adaptive_mt_translate"] + + @property + def get_adaptive_mt_file( + self, + ) -> Callable[ + [adaptive_mt.GetAdaptiveMtFileRequest], Awaitable[adaptive_mt.AdaptiveMtFile] + ]: + r"""Return a callable for the get adaptive mt file method over gRPC. + + Gets and AdaptiveMtFile + + Returns: + Callable[[~.GetAdaptiveMtFileRequest], + Awaitable[~.AdaptiveMtFile]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "get_adaptive_mt_file" not in self._stubs: + self._stubs["get_adaptive_mt_file"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/GetAdaptiveMtFile", + request_serializer=adaptive_mt.GetAdaptiveMtFileRequest.serialize, + response_deserializer=adaptive_mt.AdaptiveMtFile.deserialize, + ) + return self._stubs["get_adaptive_mt_file"] + + @property + def delete_adaptive_mt_file( + self, + ) -> Callable[ + [adaptive_mt.DeleteAdaptiveMtFileRequest], Awaitable[empty_pb2.Empty] + ]: + r"""Return a callable for the delete adaptive mt file method over gRPC. + + Deletes an AdaptiveMtFile along with its sentences. + + Returns: + Callable[[~.DeleteAdaptiveMtFileRequest], + Awaitable[~.Empty]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "delete_adaptive_mt_file" not in self._stubs: + self._stubs["delete_adaptive_mt_file"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/DeleteAdaptiveMtFile", + request_serializer=adaptive_mt.DeleteAdaptiveMtFileRequest.serialize, + response_deserializer=empty_pb2.Empty.FromString, + ) + return self._stubs["delete_adaptive_mt_file"] + + @property + def import_adaptive_mt_file( + self, + ) -> Callable[ + [adaptive_mt.ImportAdaptiveMtFileRequest], + Awaitable[adaptive_mt.ImportAdaptiveMtFileResponse], + ]: + r"""Return a callable for the import adaptive mt file method over gRPC. + + Imports an AdaptiveMtFile and adds all of its + sentences into the AdaptiveMtDataset. + + Returns: + Callable[[~.ImportAdaptiveMtFileRequest], + Awaitable[~.ImportAdaptiveMtFileResponse]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "import_adaptive_mt_file" not in self._stubs: + self._stubs["import_adaptive_mt_file"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/ImportAdaptiveMtFile", + request_serializer=adaptive_mt.ImportAdaptiveMtFileRequest.serialize, + response_deserializer=adaptive_mt.ImportAdaptiveMtFileResponse.deserialize, + ) + return self._stubs["import_adaptive_mt_file"] + + @property + def list_adaptive_mt_files( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtFilesRequest], + Awaitable[adaptive_mt.ListAdaptiveMtFilesResponse], + ]: + r"""Return a callable for the list adaptive mt files method over gRPC. + + Lists all AdaptiveMtFiles associated to an + AdaptiveMtDataset. + + Returns: + Callable[[~.ListAdaptiveMtFilesRequest], + Awaitable[~.ListAdaptiveMtFilesResponse]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "list_adaptive_mt_files" not in self._stubs: + self._stubs["list_adaptive_mt_files"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/ListAdaptiveMtFiles", + request_serializer=adaptive_mt.ListAdaptiveMtFilesRequest.serialize, + response_deserializer=adaptive_mt.ListAdaptiveMtFilesResponse.deserialize, + ) + return self._stubs["list_adaptive_mt_files"] + + @property + def list_adaptive_mt_sentences( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtSentencesRequest], + Awaitable[adaptive_mt.ListAdaptiveMtSentencesResponse], + ]: + r"""Return a callable for the list adaptive mt sentences method over gRPC. + + Lists all AdaptiveMtSentences under a given + file/dataset. + + Returns: + Callable[[~.ListAdaptiveMtSentencesRequest], + Awaitable[~.ListAdaptiveMtSentencesResponse]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "list_adaptive_mt_sentences" not in self._stubs: + self._stubs["list_adaptive_mt_sentences"] = self.grpc_channel.unary_unary( + "/google.cloud.translation.v3.TranslationService/ListAdaptiveMtSentences", + request_serializer=adaptive_mt.ListAdaptiveMtSentencesRequest.serialize, + response_deserializer=adaptive_mt.ListAdaptiveMtSentencesResponse.deserialize, + ) + return self._stubs["list_adaptive_mt_sentences"] + def close(self): return self.grpc_channel.close() diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/rest.py b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/rest.py index b57ebb081755..e00021084f35 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/rest.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/services/translation_service/transports/rest.py @@ -20,9 +20,6 @@ from typing import Any, Callable, Dict, List, Optional, Sequence, Tuple, Union import warnings -import grpc # type: ignore -from requests import __version__ as requests_version - from google.api_core import ( gapic_v1, operations_v1, @@ -36,6 +33,8 @@ from google.auth.transport.grpc import SslCredentials # type: ignore from google.auth.transport.requests import AuthorizedSession # type: ignore from google.protobuf import json_format +import grpc # type: ignore +from requests import __version__ as requests_version try: OptionalRetry = Union[retries.Retry, gapic_v1.method._MethodDefault] @@ -43,8 +42,10 @@ OptionalRetry = Union[retries.Retry, object] # type: ignore -from google.cloud.translate_v3.types import translation_service from google.longrunning import operations_pb2 # type: ignore +from google.protobuf import empty_pb2 # type: ignore + +from google.cloud.translate_v3.types import adaptive_mt, translation_service from .base import DEFAULT_CLIENT_INFO as BASE_DEFAULT_CLIENT_INFO from .base import TranslationServiceTransport @@ -71,6 +72,14 @@ class TranslationServiceRestInterceptor: .. code-block:: python class MyCustomTranslationServiceInterceptor(TranslationServiceRestInterceptor): + def pre_adaptive_mt_translate(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def post_adaptive_mt_translate(self, response): + logging.log(f"Received response: {response}") + return response + def pre_batch_translate_document(self, request, metadata): logging.log(f"Received request: {request}") return request, metadata @@ -87,6 +96,14 @@ def post_batch_translate_text(self, response): logging.log(f"Received response: {response}") return response + def pre_create_adaptive_mt_dataset(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def post_create_adaptive_mt_dataset(self, response): + logging.log(f"Received response: {response}") + return response + def pre_create_glossary(self, request, metadata): logging.log(f"Received request: {request}") return request, metadata @@ -95,6 +112,14 @@ def post_create_glossary(self, response): logging.log(f"Received response: {response}") return response + def pre_delete_adaptive_mt_dataset(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def pre_delete_adaptive_mt_file(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + def pre_delete_glossary(self, request, metadata): logging.log(f"Received request: {request}") return request, metadata @@ -111,6 +136,22 @@ def post_detect_language(self, response): logging.log(f"Received response: {response}") return response + def pre_get_adaptive_mt_dataset(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def post_get_adaptive_mt_dataset(self, response): + logging.log(f"Received response: {response}") + return response + + def pre_get_adaptive_mt_file(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def post_get_adaptive_mt_file(self, response): + logging.log(f"Received response: {response}") + return response + def pre_get_glossary(self, request, metadata): logging.log(f"Received request: {request}") return request, metadata @@ -127,6 +168,38 @@ def post_get_supported_languages(self, response): logging.log(f"Received response: {response}") return response + def pre_import_adaptive_mt_file(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def post_import_adaptive_mt_file(self, response): + logging.log(f"Received response: {response}") + return response + + def pre_list_adaptive_mt_datasets(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def post_list_adaptive_mt_datasets(self, response): + logging.log(f"Received response: {response}") + return response + + def pre_list_adaptive_mt_files(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def post_list_adaptive_mt_files(self, response): + logging.log(f"Received response: {response}") + return response + + def pre_list_adaptive_mt_sentences(self, request, metadata): + logging.log(f"Received request: {request}") + return request, metadata + + def post_list_adaptive_mt_sentences(self, response): + logging.log(f"Received response: {response}") + return response + def pre_list_glossaries(self, request, metadata): logging.log(f"Received request: {request}") return request, metadata @@ -157,6 +230,29 @@ def post_translate_text(self, response): """ + def pre_adaptive_mt_translate( + self, + request: adaptive_mt.AdaptiveMtTranslateRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.AdaptiveMtTranslateRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for adaptive_mt_translate + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def post_adaptive_mt_translate( + self, response: adaptive_mt.AdaptiveMtTranslateResponse + ) -> adaptive_mt.AdaptiveMtTranslateResponse: + """Post-rpc interceptor for adaptive_mt_translate + + Override in a subclass to manipulate the response + after it is returned by the TranslationService server but before + it is returned to user code. + """ + return response + def pre_batch_translate_document( self, request: translation_service.BatchTranslateDocumentRequest, @@ -207,6 +303,29 @@ def post_batch_translate_text( """ return response + def pre_create_adaptive_mt_dataset( + self, + request: adaptive_mt.CreateAdaptiveMtDatasetRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.CreateAdaptiveMtDatasetRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for create_adaptive_mt_dataset + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def post_create_adaptive_mt_dataset( + self, response: adaptive_mt.AdaptiveMtDataset + ) -> adaptive_mt.AdaptiveMtDataset: + """Post-rpc interceptor for create_adaptive_mt_dataset + + Override in a subclass to manipulate the response + after it is returned by the TranslationService server but before + it is returned to user code. + """ + return response + def pre_create_glossary( self, request: translation_service.CreateGlossaryRequest, @@ -230,6 +349,30 @@ def post_create_glossary( """ return response + def pre_delete_adaptive_mt_dataset( + self, + request: adaptive_mt.DeleteAdaptiveMtDatasetRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.DeleteAdaptiveMtDatasetRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for delete_adaptive_mt_dataset + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def pre_delete_adaptive_mt_file( + self, + request: adaptive_mt.DeleteAdaptiveMtFileRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.DeleteAdaptiveMtFileRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for delete_adaptive_mt_file + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + def pre_delete_glossary( self, request: translation_service.DeleteGlossaryRequest, @@ -276,6 +419,52 @@ def post_detect_language( """ return response + def pre_get_adaptive_mt_dataset( + self, + request: adaptive_mt.GetAdaptiveMtDatasetRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.GetAdaptiveMtDatasetRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for get_adaptive_mt_dataset + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def post_get_adaptive_mt_dataset( + self, response: adaptive_mt.AdaptiveMtDataset + ) -> adaptive_mt.AdaptiveMtDataset: + """Post-rpc interceptor for get_adaptive_mt_dataset + + Override in a subclass to manipulate the response + after it is returned by the TranslationService server but before + it is returned to user code. + """ + return response + + def pre_get_adaptive_mt_file( + self, + request: adaptive_mt.GetAdaptiveMtFileRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.GetAdaptiveMtFileRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for get_adaptive_mt_file + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def post_get_adaptive_mt_file( + self, response: adaptive_mt.AdaptiveMtFile + ) -> adaptive_mt.AdaptiveMtFile: + """Post-rpc interceptor for get_adaptive_mt_file + + Override in a subclass to manipulate the response + after it is returned by the TranslationService server but before + it is returned to user code. + """ + return response + def pre_get_glossary( self, request: translation_service.GetGlossaryRequest, @@ -324,6 +513,98 @@ def post_get_supported_languages( """ return response + def pre_import_adaptive_mt_file( + self, + request: adaptive_mt.ImportAdaptiveMtFileRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.ImportAdaptiveMtFileRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for import_adaptive_mt_file + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def post_import_adaptive_mt_file( + self, response: adaptive_mt.ImportAdaptiveMtFileResponse + ) -> adaptive_mt.ImportAdaptiveMtFileResponse: + """Post-rpc interceptor for import_adaptive_mt_file + + Override in a subclass to manipulate the response + after it is returned by the TranslationService server but before + it is returned to user code. + """ + return response + + def pre_list_adaptive_mt_datasets( + self, + request: adaptive_mt.ListAdaptiveMtDatasetsRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.ListAdaptiveMtDatasetsRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for list_adaptive_mt_datasets + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def post_list_adaptive_mt_datasets( + self, response: adaptive_mt.ListAdaptiveMtDatasetsResponse + ) -> adaptive_mt.ListAdaptiveMtDatasetsResponse: + """Post-rpc interceptor for list_adaptive_mt_datasets + + Override in a subclass to manipulate the response + after it is returned by the TranslationService server but before + it is returned to user code. + """ + return response + + def pre_list_adaptive_mt_files( + self, + request: adaptive_mt.ListAdaptiveMtFilesRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.ListAdaptiveMtFilesRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for list_adaptive_mt_files + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def post_list_adaptive_mt_files( + self, response: adaptive_mt.ListAdaptiveMtFilesResponse + ) -> adaptive_mt.ListAdaptiveMtFilesResponse: + """Post-rpc interceptor for list_adaptive_mt_files + + Override in a subclass to manipulate the response + after it is returned by the TranslationService server but before + it is returned to user code. + """ + return response + + def pre_list_adaptive_mt_sentences( + self, + request: adaptive_mt.ListAdaptiveMtSentencesRequest, + metadata: Sequence[Tuple[str, str]], + ) -> Tuple[adaptive_mt.ListAdaptiveMtSentencesRequest, Sequence[Tuple[str, str]]]: + """Pre-rpc interceptor for list_adaptive_mt_sentences + + Override in a subclass to manipulate the request or metadata + before they are sent to the TranslationService server. + """ + return request, metadata + + def post_list_adaptive_mt_sentences( + self, response: adaptive_mt.ListAdaptiveMtSentencesResponse + ) -> adaptive_mt.ListAdaptiveMtSentencesResponse: + """Post-rpc interceptor for list_adaptive_mt_sentences + + Override in a subclass to manipulate the response + after it is returned by the TranslationService server but before + it is returned to user code. + """ + return response + def pre_list_glossaries( self, request: translation_service.ListGlossariesRequest, @@ -551,9 +832,9 @@ def operations_client(self) -> operations_v1.AbstractOperationsClient: # Return the client from cache. return self._operations_client - class _BatchTranslateDocument(TranslationServiceRestStub): + class _AdaptiveMtTranslate(TranslationServiceRestStub): def __hash__(self): - return hash("BatchTranslateDocument") + return hash("AdaptiveMtTranslate") __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} @@ -567,17 +848,18 @@ def _get_unset_required_fields(cls, message_dict): def __call__( self, - request: translation_service.BatchTranslateDocumentRequest, + request: adaptive_mt.AdaptiveMtTranslateRequest, *, retry: OptionalRetry = gapic_v1.method.DEFAULT, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = (), - ) -> operations_pb2.Operation: - r"""Call the batch translate document method over HTTP. + ) -> adaptive_mt.AdaptiveMtTranslateResponse: + r"""Call the adaptive mt translate method over HTTP. Args: - request (~.translation_service.BatchTranslateDocumentRequest): - The request object. The BatchTranslateDocument request. + request (~.adaptive_mt.AdaptiveMtTranslateRequest): + The request object. The request for sending an AdaptiveMt + translation query. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. @@ -585,24 +867,21 @@ def __call__( sent along with the request as metadata. Returns: - ~.operations_pb2.Operation: - This resource represents a - long-running operation that is the - result of a network API call. - + ~.adaptive_mt.AdaptiveMtTranslateResponse: + An AdaptiveMtTranslate response. """ http_options: List[Dict[str, str]] = [ { "method": "post", - "uri": "/v3/{parent=projects/*/locations/*}:batchTranslateDocument", + "uri": "/v3/{parent=projects/*/locations/*}:adaptiveMtTranslate", "body": "*", }, ] - request, metadata = self._interceptor.pre_batch_translate_document( + request, metadata = self._interceptor.pre_adaptive_mt_translate( request, metadata ) - pb_request = translation_service.BatchTranslateDocumentRequest.pb(request) + pb_request = adaptive_mt.AdaptiveMtTranslateRequest.pb(request) transcoded_request = path_template.transcode(http_options, pb_request) # Jsonify the request body @@ -644,14 +923,16 @@ def __call__( raise core_exceptions.from_http_response(response) # Return the response - resp = operations_pb2.Operation() - json_format.Parse(response.content, resp, ignore_unknown_fields=True) - resp = self._interceptor.post_batch_translate_document(resp) + resp = adaptive_mt.AdaptiveMtTranslateResponse() + pb_resp = adaptive_mt.AdaptiveMtTranslateResponse.pb(resp) + + json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) + resp = self._interceptor.post_adaptive_mt_translate(resp) return resp - class _BatchTranslateText(TranslationServiceRestStub): + class _BatchTranslateDocument(TranslationServiceRestStub): def __hash__(self): - return hash("BatchTranslateText") + return hash("BatchTranslateDocument") __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} @@ -665,17 +946,17 @@ def _get_unset_required_fields(cls, message_dict): def __call__( self, - request: translation_service.BatchTranslateTextRequest, + request: translation_service.BatchTranslateDocumentRequest, *, retry: OptionalRetry = gapic_v1.method.DEFAULT, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = (), ) -> operations_pb2.Operation: - r"""Call the batch translate text method over HTTP. + r"""Call the batch translate document method over HTTP. Args: - request (~.translation_service.BatchTranslateTextRequest): - The request object. The batch translation request. + request (~.translation_service.BatchTranslateDocumentRequest): + The request object. The BatchTranslateDocument request. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. @@ -693,23 +974,926 @@ def __call__( http_options: List[Dict[str, str]] = [ { "method": "post", - "uri": "/v3/{parent=projects/*/locations/*}:batchTranslateText", + "uri": "/v3/{parent=projects/*/locations/*}:batchTranslateDocument", "body": "*", }, ] - request, metadata = self._interceptor.pre_batch_translate_text( - request, metadata - ) - pb_request = translation_service.BatchTranslateTextRequest.pb(request) + request, metadata = self._interceptor.pre_batch_translate_document( + request, metadata + ) + pb_request = translation_service.BatchTranslateDocumentRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + # Jsonify the request body + + body = json_format.MessageToJson( + transcoded_request["body"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + resp = operations_pb2.Operation() + json_format.Parse(response.content, resp, ignore_unknown_fields=True) + resp = self._interceptor.post_batch_translate_document(resp) + return resp + + class _BatchTranslateText(TranslationServiceRestStub): + def __hash__(self): + return hash("BatchTranslateText") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: translation_service.BatchTranslateTextRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> operations_pb2.Operation: + r"""Call the batch translate text method over HTTP. + + Args: + request (~.translation_service.BatchTranslateTextRequest): + The request object. The batch translation request. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.operations_pb2.Operation: + This resource represents a + long-running operation that is the + result of a network API call. + + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "post", + "uri": "/v3/{parent=projects/*/locations/*}:batchTranslateText", + "body": "*", + }, + ] + request, metadata = self._interceptor.pre_batch_translate_text( + request, metadata + ) + pb_request = translation_service.BatchTranslateTextRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + # Jsonify the request body + + body = json_format.MessageToJson( + transcoded_request["body"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + resp = operations_pb2.Operation() + json_format.Parse(response.content, resp, ignore_unknown_fields=True) + resp = self._interceptor.post_batch_translate_text(resp) + return resp + + class _CreateAdaptiveMtDataset(TranslationServiceRestStub): + def __hash__(self): + return hash("CreateAdaptiveMtDataset") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: adaptive_mt.CreateAdaptiveMtDatasetRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtDataset: + r"""Call the create adaptive mt + dataset method over HTTP. + + Args: + request (~.adaptive_mt.CreateAdaptiveMtDatasetRequest): + The request object. Request message for creating an + AdaptiveMtDataset. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.adaptive_mt.AdaptiveMtDataset: + An Adaptive MT Dataset. + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "post", + "uri": "/v3/{parent=projects/*/locations/*}/adaptiveMtDatasets", + "body": "adaptive_mt_dataset", + }, + ] + request, metadata = self._interceptor.pre_create_adaptive_mt_dataset( + request, metadata + ) + pb_request = adaptive_mt.CreateAdaptiveMtDatasetRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + # Jsonify the request body + + body = json_format.MessageToJson( + transcoded_request["body"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + resp = adaptive_mt.AdaptiveMtDataset() + pb_resp = adaptive_mt.AdaptiveMtDataset.pb(resp) + + json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) + resp = self._interceptor.post_create_adaptive_mt_dataset(resp) + return resp + + class _CreateGlossary(TranslationServiceRestStub): + def __hash__(self): + return hash("CreateGlossary") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: translation_service.CreateGlossaryRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> operations_pb2.Operation: + r"""Call the create glossary method over HTTP. + + Args: + request (~.translation_service.CreateGlossaryRequest): + The request object. Request message for CreateGlossary. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.operations_pb2.Operation: + This resource represents a + long-running operation that is the + result of a network API call. + + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "post", + "uri": "/v3/{parent=projects/*/locations/*}/glossaries", + "body": "glossary", + }, + ] + request, metadata = self._interceptor.pre_create_glossary(request, metadata) + pb_request = translation_service.CreateGlossaryRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + # Jsonify the request body + + body = json_format.MessageToJson( + transcoded_request["body"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + resp = operations_pb2.Operation() + json_format.Parse(response.content, resp, ignore_unknown_fields=True) + resp = self._interceptor.post_create_glossary(resp) + return resp + + class _DeleteAdaptiveMtDataset(TranslationServiceRestStub): + def __hash__(self): + return hash("DeleteAdaptiveMtDataset") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: adaptive_mt.DeleteAdaptiveMtDatasetRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ): + r"""Call the delete adaptive mt + dataset method over HTTP. + + Args: + request (~.adaptive_mt.DeleteAdaptiveMtDatasetRequest): + The request object. Request message for deleting an + AdaptiveMtDataset. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "delete", + "uri": "/v3/{name=projects/*/locations/*/adaptiveMtDatasets/*}", + }, + ] + request, metadata = self._interceptor.pre_delete_adaptive_mt_dataset( + request, metadata + ) + pb_request = adaptive_mt.DeleteAdaptiveMtDatasetRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + class _DeleteAdaptiveMtFile(TranslationServiceRestStub): + def __hash__(self): + return hash("DeleteAdaptiveMtFile") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: adaptive_mt.DeleteAdaptiveMtFileRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ): + r"""Call the delete adaptive mt file method over HTTP. + + Args: + request (~.adaptive_mt.DeleteAdaptiveMtFileRequest): + The request object. The request for deleting an + AdaptiveMt file. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "delete", + "uri": "/v3/{name=projects/*/locations/*/adaptiveMtDatasets/*/adaptiveMtFiles/*}", + }, + ] + request, metadata = self._interceptor.pre_delete_adaptive_mt_file( + request, metadata + ) + pb_request = adaptive_mt.DeleteAdaptiveMtFileRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + class _DeleteGlossary(TranslationServiceRestStub): + def __hash__(self): + return hash("DeleteGlossary") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: translation_service.DeleteGlossaryRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> operations_pb2.Operation: + r"""Call the delete glossary method over HTTP. + + Args: + request (~.translation_service.DeleteGlossaryRequest): + The request object. Request message for DeleteGlossary. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.operations_pb2.Operation: + This resource represents a + long-running operation that is the + result of a network API call. + + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "delete", + "uri": "/v3/{name=projects/*/locations/*/glossaries/*}", + }, + ] + request, metadata = self._interceptor.pre_delete_glossary(request, metadata) + pb_request = translation_service.DeleteGlossaryRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + resp = operations_pb2.Operation() + json_format.Parse(response.content, resp, ignore_unknown_fields=True) + resp = self._interceptor.post_delete_glossary(resp) + return resp + + class _DetectLanguage(TranslationServiceRestStub): + def __hash__(self): + return hash("DetectLanguage") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: translation_service.DetectLanguageRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> translation_service.DetectLanguageResponse: + r"""Call the detect language method over HTTP. + + Args: + request (~.translation_service.DetectLanguageRequest): + The request object. The request message for language + detection. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.translation_service.DetectLanguageResponse: + The response message for language + detection. + + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "post", + "uri": "/v3/{parent=projects/*/locations/*}:detectLanguage", + "body": "*", + }, + { + "method": "post", + "uri": "/v3/{parent=projects/*}:detectLanguage", + "body": "*", + }, + ] + request, metadata = self._interceptor.pre_detect_language(request, metadata) + pb_request = translation_service.DetectLanguageRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + # Jsonify the request body + + body = json_format.MessageToJson( + transcoded_request["body"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + data=body, + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + resp = translation_service.DetectLanguageResponse() + pb_resp = translation_service.DetectLanguageResponse.pb(resp) + + json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) + resp = self._interceptor.post_detect_language(resp) + return resp + + class _GetAdaptiveMtDataset(TranslationServiceRestStub): + def __hash__(self): + return hash("GetAdaptiveMtDataset") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: adaptive_mt.GetAdaptiveMtDatasetRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtDataset: + r"""Call the get adaptive mt dataset method over HTTP. + + Args: + request (~.adaptive_mt.GetAdaptiveMtDatasetRequest): + The request object. Request message for getting an + Adaptive MT dataset. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.adaptive_mt.AdaptiveMtDataset: + An Adaptive MT Dataset. + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "get", + "uri": "/v3/{name=projects/*/locations/*/adaptiveMtDatasets/*}", + }, + ] + request, metadata = self._interceptor.pre_get_adaptive_mt_dataset( + request, metadata + ) + pb_request = adaptive_mt.GetAdaptiveMtDatasetRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + resp = adaptive_mt.AdaptiveMtDataset() + pb_resp = adaptive_mt.AdaptiveMtDataset.pb(resp) + + json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) + resp = self._interceptor.post_get_adaptive_mt_dataset(resp) + return resp + + class _GetAdaptiveMtFile(TranslationServiceRestStub): + def __hash__(self): + return hash("GetAdaptiveMtFile") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: adaptive_mt.GetAdaptiveMtFileRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> adaptive_mt.AdaptiveMtFile: + r"""Call the get adaptive mt file method over HTTP. + + Args: + request (~.adaptive_mt.GetAdaptiveMtFileRequest): + The request object. The request for getting an + AdaptiveMtFile. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.adaptive_mt.AdaptiveMtFile: + An AdaptiveMtFile. + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "get", + "uri": "/v3/{name=projects/*/locations/*/adaptiveMtDatasets/*/adaptiveMtFiles/*}", + }, + ] + request, metadata = self._interceptor.pre_get_adaptive_mt_file( + request, metadata + ) + pb_request = adaptive_mt.GetAdaptiveMtFileRequest.pb(request) + transcoded_request = path_template.transcode(http_options, pb_request) + + uri = transcoded_request["uri"] + method = transcoded_request["method"] + + # Jsonify the query params + query_params = json.loads( + json_format.MessageToJson( + transcoded_request["query_params"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) + ) + query_params.update(self._get_unset_required_fields(query_params)) + + query_params["$alt"] = "json;enum-encoding=int" + + # Send the request + headers = dict(metadata) + headers["Content-Type"] = "application/json" + response = getattr(self._session, method)( + "{host}{uri}".format(host=self._host, uri=uri), + timeout=timeout, + headers=headers, + params=rest_helpers.flatten_query_params(query_params, strict=True), + ) + + # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception + # subclass. + if response.status_code >= 400: + raise core_exceptions.from_http_response(response) + + # Return the response + resp = adaptive_mt.AdaptiveMtFile() + pb_resp = adaptive_mt.AdaptiveMtFile.pb(resp) + + json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) + resp = self._interceptor.post_get_adaptive_mt_file(resp) + return resp + + class _GetGlossary(TranslationServiceRestStub): + def __hash__(self): + return hash("GetGlossary") + + __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} + + @classmethod + def _get_unset_required_fields(cls, message_dict): + return { + k: v + for k, v in cls.__REQUIRED_FIELDS_DEFAULT_VALUES.items() + if k not in message_dict + } + + def __call__( + self, + request: translation_service.GetGlossaryRequest, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: Optional[float] = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> translation_service.Glossary: + r"""Call the get glossary method over HTTP. + + Args: + request (~.translation_service.GetGlossaryRequest): + The request object. Request message for GetGlossary. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.translation_service.Glossary: + Represents a glossary built from + user-provided data. + + """ + + http_options: List[Dict[str, str]] = [ + { + "method": "get", + "uri": "/v3/{name=projects/*/locations/*/glossaries/*}", + }, + ] + request, metadata = self._interceptor.pre_get_glossary(request, metadata) + pb_request = translation_service.GetGlossaryRequest.pb(request) transcoded_request = path_template.transcode(http_options, pb_request) - # Jsonify the request body - - body = json_format.MessageToJson( - transcoded_request["body"], - including_default_value_fields=False, - use_integers_for_enums=True, - ) uri = transcoded_request["uri"] method = transcoded_request["method"] @@ -733,7 +1917,6 @@ def __call__( timeout=timeout, headers=headers, params=rest_helpers.flatten_query_params(query_params, strict=True), - data=body, ) # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception @@ -742,14 +1925,16 @@ def __call__( raise core_exceptions.from_http_response(response) # Return the response - resp = operations_pb2.Operation() - json_format.Parse(response.content, resp, ignore_unknown_fields=True) - resp = self._interceptor.post_batch_translate_text(resp) + resp = translation_service.Glossary() + pb_resp = translation_service.Glossary.pb(resp) + + json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) + resp = self._interceptor.post_get_glossary(resp) return resp - class _CreateGlossary(TranslationServiceRestStub): + class _GetSupportedLanguages(TranslationServiceRestStub): def __hash__(self): - return hash("CreateGlossary") + return hash("GetSupportedLanguages") __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} @@ -763,17 +1948,18 @@ def _get_unset_required_fields(cls, message_dict): def __call__( self, - request: translation_service.CreateGlossaryRequest, + request: translation_service.GetSupportedLanguagesRequest, *, retry: OptionalRetry = gapic_v1.method.DEFAULT, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = (), - ) -> operations_pb2.Operation: - r"""Call the create glossary method over HTTP. + ) -> translation_service.SupportedLanguages: + r"""Call the get supported languages method over HTTP. Args: - request (~.translation_service.CreateGlossaryRequest): - The request object. Request message for CreateGlossary. + request (~.translation_service.GetSupportedLanguagesRequest): + The request object. The request message for discovering + supported languages. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. @@ -781,31 +1967,28 @@ def __call__( sent along with the request as metadata. Returns: - ~.operations_pb2.Operation: - This resource represents a - long-running operation that is the - result of a network API call. + ~.translation_service.SupportedLanguages: + The response message for discovering + supported languages. """ http_options: List[Dict[str, str]] = [ { - "method": "post", - "uri": "/v3/{parent=projects/*/locations/*}/glossaries", - "body": "glossary", + "method": "get", + "uri": "/v3/{parent=projects/*/locations/*}/supportedLanguages", + }, + { + "method": "get", + "uri": "/v3/{parent=projects/*}/supportedLanguages", }, ] - request, metadata = self._interceptor.pre_create_glossary(request, metadata) - pb_request = translation_service.CreateGlossaryRequest.pb(request) + request, metadata = self._interceptor.pre_get_supported_languages( + request, metadata + ) + pb_request = translation_service.GetSupportedLanguagesRequest.pb(request) transcoded_request = path_template.transcode(http_options, pb_request) - # Jsonify the request body - - body = json_format.MessageToJson( - transcoded_request["body"], - including_default_value_fields=False, - use_integers_for_enums=True, - ) uri = transcoded_request["uri"] method = transcoded_request["method"] @@ -829,7 +2012,6 @@ def __call__( timeout=timeout, headers=headers, params=rest_helpers.flatten_query_params(query_params, strict=True), - data=body, ) # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception @@ -838,14 +2020,16 @@ def __call__( raise core_exceptions.from_http_response(response) # Return the response - resp = operations_pb2.Operation() - json_format.Parse(response.content, resp, ignore_unknown_fields=True) - resp = self._interceptor.post_create_glossary(resp) + resp = translation_service.SupportedLanguages() + pb_resp = translation_service.SupportedLanguages.pb(resp) + + json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) + resp = self._interceptor.post_get_supported_languages(resp) return resp - class _DeleteGlossary(TranslationServiceRestStub): + class _ImportAdaptiveMtFile(TranslationServiceRestStub): def __hash__(self): - return hash("DeleteGlossary") + return hash("ImportAdaptiveMtFile") __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} @@ -859,17 +2043,19 @@ def _get_unset_required_fields(cls, message_dict): def __call__( self, - request: translation_service.DeleteGlossaryRequest, + request: adaptive_mt.ImportAdaptiveMtFileRequest, *, retry: OptionalRetry = gapic_v1.method.DEFAULT, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = (), - ) -> operations_pb2.Operation: - r"""Call the delete glossary method over HTTP. + ) -> adaptive_mt.ImportAdaptiveMtFileResponse: + r"""Call the import adaptive mt file method over HTTP. Args: - request (~.translation_service.DeleteGlossaryRequest): - The request object. Request message for DeleteGlossary. + request (~.adaptive_mt.ImportAdaptiveMtFileRequest): + The request object. The request for importing an + AdaptiveMt file along with its + sentences. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. @@ -877,23 +2063,32 @@ def __call__( sent along with the request as metadata. Returns: - ~.operations_pb2.Operation: - This resource represents a - long-running operation that is the - result of a network API call. + ~.adaptive_mt.ImportAdaptiveMtFileResponse: + The response for importing an + AdaptiveMtFile """ http_options: List[Dict[str, str]] = [ { - "method": "delete", - "uri": "/v3/{name=projects/*/locations/*/glossaries/*}", + "method": "post", + "uri": "/v3/{parent=projects/*/locations/*/adaptiveMtDatasets/*}:importAdaptiveMtFile", + "body": "*", }, ] - request, metadata = self._interceptor.pre_delete_glossary(request, metadata) - pb_request = translation_service.DeleteGlossaryRequest.pb(request) + request, metadata = self._interceptor.pre_import_adaptive_mt_file( + request, metadata + ) + pb_request = adaptive_mt.ImportAdaptiveMtFileRequest.pb(request) transcoded_request = path_template.transcode(http_options, pb_request) + # Jsonify the request body + + body = json_format.MessageToJson( + transcoded_request["body"], + including_default_value_fields=False, + use_integers_for_enums=True, + ) uri = transcoded_request["uri"] method = transcoded_request["method"] @@ -917,6 +2112,7 @@ def __call__( timeout=timeout, headers=headers, params=rest_helpers.flatten_query_params(query_params, strict=True), + data=body, ) # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception @@ -925,14 +2121,16 @@ def __call__( raise core_exceptions.from_http_response(response) # Return the response - resp = operations_pb2.Operation() - json_format.Parse(response.content, resp, ignore_unknown_fields=True) - resp = self._interceptor.post_delete_glossary(resp) + resp = adaptive_mt.ImportAdaptiveMtFileResponse() + pb_resp = adaptive_mt.ImportAdaptiveMtFileResponse.pb(resp) + + json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) + resp = self._interceptor.post_import_adaptive_mt_file(resp) return resp - class _DetectLanguage(TranslationServiceRestStub): + class _ListAdaptiveMtDatasets(TranslationServiceRestStub): def __hash__(self): - return hash("DetectLanguage") + return hash("ListAdaptiveMtDatasets") __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} @@ -946,18 +2144,19 @@ def _get_unset_required_fields(cls, message_dict): def __call__( self, - request: translation_service.DetectLanguageRequest, + request: adaptive_mt.ListAdaptiveMtDatasetsRequest, *, retry: OptionalRetry = gapic_v1.method.DEFAULT, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = (), - ) -> translation_service.DetectLanguageResponse: - r"""Call the detect language method over HTTP. + ) -> adaptive_mt.ListAdaptiveMtDatasetsResponse: + r"""Call the list adaptive mt datasets method over HTTP. Args: - request (~.translation_service.DetectLanguageRequest): - The request object. The request message for language - detection. + request (~.adaptive_mt.ListAdaptiveMtDatasetsRequest): + The request object. Request message for listing all + Adaptive MT datasets that the requestor + has access to. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. @@ -965,35 +2164,22 @@ def __call__( sent along with the request as metadata. Returns: - ~.translation_service.DetectLanguageResponse: - The response message for language - detection. - + ~.adaptive_mt.ListAdaptiveMtDatasetsResponse: + A list of AdaptiveMtDatasets. """ http_options: List[Dict[str, str]] = [ { - "method": "post", - "uri": "/v3/{parent=projects/*/locations/*}:detectLanguage", - "body": "*", - }, - { - "method": "post", - "uri": "/v3/{parent=projects/*}:detectLanguage", - "body": "*", + "method": "get", + "uri": "/v3/{parent=projects/*/locations/*}/adaptiveMtDatasets", }, ] - request, metadata = self._interceptor.pre_detect_language(request, metadata) - pb_request = translation_service.DetectLanguageRequest.pb(request) + request, metadata = self._interceptor.pre_list_adaptive_mt_datasets( + request, metadata + ) + pb_request = adaptive_mt.ListAdaptiveMtDatasetsRequest.pb(request) transcoded_request = path_template.transcode(http_options, pb_request) - # Jsonify the request body - - body = json_format.MessageToJson( - transcoded_request["body"], - including_default_value_fields=False, - use_integers_for_enums=True, - ) uri = transcoded_request["uri"] method = transcoded_request["method"] @@ -1017,7 +2203,6 @@ def __call__( timeout=timeout, headers=headers, params=rest_helpers.flatten_query_params(query_params, strict=True), - data=body, ) # In case of error, raise the appropriate core_exceptions.GoogleAPICallError exception @@ -1026,16 +2211,16 @@ def __call__( raise core_exceptions.from_http_response(response) # Return the response - resp = translation_service.DetectLanguageResponse() - pb_resp = translation_service.DetectLanguageResponse.pb(resp) + resp = adaptive_mt.ListAdaptiveMtDatasetsResponse() + pb_resp = adaptive_mt.ListAdaptiveMtDatasetsResponse.pb(resp) json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) - resp = self._interceptor.post_detect_language(resp) + resp = self._interceptor.post_list_adaptive_mt_datasets(resp) return resp - class _GetGlossary(TranslationServiceRestStub): + class _ListAdaptiveMtFiles(TranslationServiceRestStub): def __hash__(self): - return hash("GetGlossary") + return hash("ListAdaptiveMtFiles") __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} @@ -1049,17 +2234,18 @@ def _get_unset_required_fields(cls, message_dict): def __call__( self, - request: translation_service.GetGlossaryRequest, + request: adaptive_mt.ListAdaptiveMtFilesRequest, *, retry: OptionalRetry = gapic_v1.method.DEFAULT, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = (), - ) -> translation_service.Glossary: - r"""Call the get glossary method over HTTP. + ) -> adaptive_mt.ListAdaptiveMtFilesResponse: + r"""Call the list adaptive mt files method over HTTP. Args: - request (~.translation_service.GetGlossaryRequest): - The request object. Request message for GetGlossary. + request (~.adaptive_mt.ListAdaptiveMtFilesRequest): + The request object. The request to list all AdaptiveMt + files under a given dataset. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. @@ -1067,20 +2253,22 @@ def __call__( sent along with the request as metadata. Returns: - ~.translation_service.Glossary: - Represents a glossary built from - user-provided data. + ~.adaptive_mt.ListAdaptiveMtFilesResponse: + The response for listing all + AdaptiveMt files under a given dataset. """ http_options: List[Dict[str, str]] = [ { "method": "get", - "uri": "/v3/{name=projects/*/locations/*/glossaries/*}", + "uri": "/v3/{parent=projects/*/locations/*/adaptiveMtDatasets/*}/adaptiveMtFiles", }, ] - request, metadata = self._interceptor.pre_get_glossary(request, metadata) - pb_request = translation_service.GetGlossaryRequest.pb(request) + request, metadata = self._interceptor.pre_list_adaptive_mt_files( + request, metadata + ) + pb_request = adaptive_mt.ListAdaptiveMtFilesRequest.pb(request) transcoded_request = path_template.transcode(http_options, pb_request) uri = transcoded_request["uri"] @@ -1114,16 +2302,16 @@ def __call__( raise core_exceptions.from_http_response(response) # Return the response - resp = translation_service.Glossary() - pb_resp = translation_service.Glossary.pb(resp) + resp = adaptive_mt.ListAdaptiveMtFilesResponse() + pb_resp = adaptive_mt.ListAdaptiveMtFilesResponse.pb(resp) json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) - resp = self._interceptor.post_get_glossary(resp) + resp = self._interceptor.post_list_adaptive_mt_files(resp) return resp - class _GetSupportedLanguages(TranslationServiceRestStub): + class _ListAdaptiveMtSentences(TranslationServiceRestStub): def __hash__(self): - return hash("GetSupportedLanguages") + return hash("ListAdaptiveMtSentences") __REQUIRED_FIELDS_DEFAULT_VALUES: Dict[str, Any] = {} @@ -1137,45 +2325,44 @@ def _get_unset_required_fields(cls, message_dict): def __call__( self, - request: translation_service.GetSupportedLanguagesRequest, + request: adaptive_mt.ListAdaptiveMtSentencesRequest, *, retry: OptionalRetry = gapic_v1.method.DEFAULT, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = (), - ) -> translation_service.SupportedLanguages: - r"""Call the get supported languages method over HTTP. - - Args: - request (~.translation_service.GetSupportedLanguagesRequest): - The request object. The request message for discovering - supported languages. - retry (google.api_core.retry.Retry): Designation of what errors, if any, - should be retried. - timeout (float): The timeout for this request. - metadata (Sequence[Tuple[str, str]]): Strings which should be - sent along with the request as metadata. - - Returns: - ~.translation_service.SupportedLanguages: - The response message for discovering - supported languages. - + ) -> adaptive_mt.ListAdaptiveMtSentencesResponse: + r"""Call the list adaptive mt + sentences method over HTTP. + + Args: + request (~.adaptive_mt.ListAdaptiveMtSentencesRequest): + The request object. The request for listing Adaptive MT + sentences from a Dataset/File. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + + Returns: + ~.adaptive_mt.ListAdaptiveMtSentencesResponse: + List AdaptiveMt sentences response. """ http_options: List[Dict[str, str]] = [ { "method": "get", - "uri": "/v3/{parent=projects/*/locations/*}/supportedLanguages", + "uri": "/v3/{parent=projects/*/locations/*/adaptiveMtDatasets/*/adaptiveMtFiles/*}/adaptiveMtSentences", }, { "method": "get", - "uri": "/v3/{parent=projects/*}/supportedLanguages", + "uri": "/v3/{parent=projects/*/locations/*/adaptiveMtDatasets/*}/adaptiveMtSentences", }, ] - request, metadata = self._interceptor.pre_get_supported_languages( + request, metadata = self._interceptor.pre_list_adaptive_mt_sentences( request, metadata ) - pb_request = translation_service.GetSupportedLanguagesRequest.pb(request) + pb_request = adaptive_mt.ListAdaptiveMtSentencesRequest.pb(request) transcoded_request = path_template.transcode(http_options, pb_request) uri = transcoded_request["uri"] @@ -1209,11 +2396,11 @@ def __call__( raise core_exceptions.from_http_response(response) # Return the response - resp = translation_service.SupportedLanguages() - pb_resp = translation_service.SupportedLanguages.pb(resp) + resp = adaptive_mt.ListAdaptiveMtSentencesResponse() + pb_resp = adaptive_mt.ListAdaptiveMtSentencesResponse.pb(resp) json_format.Parse(response.content, pb_resp, ignore_unknown_fields=True) - resp = self._interceptor.post_get_supported_languages(resp) + resp = self._interceptor.post_list_adaptive_mt_sentences(resp) return resp class _ListGlossaries(TranslationServiceRestStub): @@ -1502,6 +2689,17 @@ def __call__( resp = self._interceptor.post_translate_text(resp) return resp + @property + def adaptive_mt_translate( + self, + ) -> Callable[ + [adaptive_mt.AdaptiveMtTranslateRequest], + adaptive_mt.AdaptiveMtTranslateResponse, + ]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._AdaptiveMtTranslate(self._session, self._host, self._interceptor) # type: ignore + @property def batch_translate_document( self, @@ -1522,6 +2720,16 @@ def batch_translate_text( # In C++ this would require a dynamic_cast return self._BatchTranslateText(self._session, self._host, self._interceptor) # type: ignore + @property + def create_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.CreateAdaptiveMtDatasetRequest], adaptive_mt.AdaptiveMtDataset + ]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._CreateAdaptiveMtDataset(self._session, self._host, self._interceptor) # type: ignore + @property def create_glossary( self, @@ -1532,6 +2740,22 @@ def create_glossary( # In C++ this would require a dynamic_cast return self._CreateGlossary(self._session, self._host, self._interceptor) # type: ignore + @property + def delete_adaptive_mt_dataset( + self, + ) -> Callable[[adaptive_mt.DeleteAdaptiveMtDatasetRequest], empty_pb2.Empty]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._DeleteAdaptiveMtDataset(self._session, self._host, self._interceptor) # type: ignore + + @property + def delete_adaptive_mt_file( + self, + ) -> Callable[[adaptive_mt.DeleteAdaptiveMtFileRequest], empty_pb2.Empty]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._DeleteAdaptiveMtFile(self._session, self._host, self._interceptor) # type: ignore + @property def delete_glossary( self, @@ -1553,6 +2777,24 @@ def detect_language( # In C++ this would require a dynamic_cast return self._DetectLanguage(self._session, self._host, self._interceptor) # type: ignore + @property + def get_adaptive_mt_dataset( + self, + ) -> Callable[ + [adaptive_mt.GetAdaptiveMtDatasetRequest], adaptive_mt.AdaptiveMtDataset + ]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._GetAdaptiveMtDataset(self._session, self._host, self._interceptor) # type: ignore + + @property + def get_adaptive_mt_file( + self, + ) -> Callable[[adaptive_mt.GetAdaptiveMtFileRequest], adaptive_mt.AdaptiveMtFile]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._GetAdaptiveMtFile(self._session, self._host, self._interceptor) # type: ignore + @property def get_glossary( self, @@ -1574,6 +2816,50 @@ def get_supported_languages( # In C++ this would require a dynamic_cast return self._GetSupportedLanguages(self._session, self._host, self._interceptor) # type: ignore + @property + def import_adaptive_mt_file( + self, + ) -> Callable[ + [adaptive_mt.ImportAdaptiveMtFileRequest], + adaptive_mt.ImportAdaptiveMtFileResponse, + ]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._ImportAdaptiveMtFile(self._session, self._host, self._interceptor) # type: ignore + + @property + def list_adaptive_mt_datasets( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtDatasetsRequest], + adaptive_mt.ListAdaptiveMtDatasetsResponse, + ]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._ListAdaptiveMtDatasets(self._session, self._host, self._interceptor) # type: ignore + + @property + def list_adaptive_mt_files( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtFilesRequest], + adaptive_mt.ListAdaptiveMtFilesResponse, + ]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._ListAdaptiveMtFiles(self._session, self._host, self._interceptor) # type: ignore + + @property + def list_adaptive_mt_sentences( + self, + ) -> Callable[ + [adaptive_mt.ListAdaptiveMtSentencesRequest], + adaptive_mt.ListAdaptiveMtSentencesResponse, + ]: + # The return type is fine, but mypy isn't sophisticated enough to determine what's going on here. + # In C++ this would require a dynamic_cast + return self._ListAdaptiveMtSentences(self._session, self._host, self._interceptor) # type: ignore + @property def list_glossaries( self, diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/types/__init__.py b/packages/google-cloud-translate/google/cloud/translate_v3/types/__init__.py index 3a700ac0d8cb..64c97da095f6 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/types/__init__.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/types/__init__.py @@ -13,6 +13,28 @@ # See the License for the specific language governing permissions and # limitations under the License. # +from .adaptive_mt import ( + AdaptiveMtDataset, + AdaptiveMtFile, + AdaptiveMtSentence, + AdaptiveMtTranslateRequest, + AdaptiveMtTranslateResponse, + AdaptiveMtTranslation, + CreateAdaptiveMtDatasetRequest, + DeleteAdaptiveMtDatasetRequest, + DeleteAdaptiveMtFileRequest, + GetAdaptiveMtDatasetRequest, + GetAdaptiveMtFileRequest, + ImportAdaptiveMtFileRequest, + ImportAdaptiveMtFileResponse, + ListAdaptiveMtDatasetsRequest, + ListAdaptiveMtDatasetsResponse, + ListAdaptiveMtFilesRequest, + ListAdaptiveMtFilesResponse, + ListAdaptiveMtSentencesRequest, + ListAdaptiveMtSentencesResponse, +) +from .common import FileInputSource, GcsInputSource, GcsOutputDestination from .translation_service import ( BatchDocumentInputConfig, BatchDocumentOutputConfig, @@ -54,6 +76,28 @@ ) __all__ = ( + "AdaptiveMtDataset", + "AdaptiveMtFile", + "AdaptiveMtSentence", + "AdaptiveMtTranslateRequest", + "AdaptiveMtTranslateResponse", + "AdaptiveMtTranslation", + "CreateAdaptiveMtDatasetRequest", + "DeleteAdaptiveMtDatasetRequest", + "DeleteAdaptiveMtFileRequest", + "GetAdaptiveMtDatasetRequest", + "GetAdaptiveMtFileRequest", + "ImportAdaptiveMtFileRequest", + "ImportAdaptiveMtFileResponse", + "ListAdaptiveMtDatasetsRequest", + "ListAdaptiveMtDatasetsResponse", + "ListAdaptiveMtFilesRequest", + "ListAdaptiveMtFilesResponse", + "ListAdaptiveMtSentencesRequest", + "ListAdaptiveMtSentencesResponse", + "FileInputSource", + "GcsInputSource", + "GcsOutputDestination", "BatchDocumentInputConfig", "BatchDocumentOutputConfig", "BatchTranslateDocumentMetadata", diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/types/adaptive_mt.py b/packages/google-cloud-translate/google/cloud/translate_v3/types/adaptive_mt.py new file mode 100644 index 000000000000..d98f649cfd49 --- /dev/null +++ b/packages/google-cloud-translate/google/cloud/translate_v3/types/adaptive_mt.py @@ -0,0 +1,606 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from __future__ import annotations + +from typing import MutableMapping, MutableSequence + +from google.protobuf import timestamp_pb2 # type: ignore +import proto # type: ignore + +from google.cloud.translate_v3.types import common + +__protobuf__ = proto.module( + package="google.cloud.translation.v3", + manifest={ + "AdaptiveMtDataset", + "CreateAdaptiveMtDatasetRequest", + "DeleteAdaptiveMtDatasetRequest", + "GetAdaptiveMtDatasetRequest", + "ListAdaptiveMtDatasetsRequest", + "ListAdaptiveMtDatasetsResponse", + "AdaptiveMtTranslateRequest", + "AdaptiveMtTranslation", + "AdaptiveMtTranslateResponse", + "AdaptiveMtFile", + "GetAdaptiveMtFileRequest", + "DeleteAdaptiveMtFileRequest", + "ImportAdaptiveMtFileRequest", + "ImportAdaptiveMtFileResponse", + "ListAdaptiveMtFilesRequest", + "ListAdaptiveMtFilesResponse", + "AdaptiveMtSentence", + "ListAdaptiveMtSentencesRequest", + "ListAdaptiveMtSentencesResponse", + }, +) + + +class AdaptiveMtDataset(proto.Message): + r"""An Adaptive MT Dataset. + + Attributes: + name (str): + Required. The resource name of the dataset, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset_id}`` + display_name (str): + The name of the dataset to show in the interface. The name + can be up to 32 characters long and can consist only of + ASCII Latin letters A-Z and a-z, underscores (_), and ASCII + digits 0-9. + source_language_code (str): + The BCP-47 language code of the source + language. + target_language_code (str): + The BCP-47 language code of the target + language. + example_count (int): + The number of examples in the dataset. + create_time (google.protobuf.timestamp_pb2.Timestamp): + Output only. Timestamp when this dataset was + created. + update_time (google.protobuf.timestamp_pb2.Timestamp): + Output only. Timestamp when this dataset was + last updated. + """ + + name: str = proto.Field( + proto.STRING, + number=1, + ) + display_name: str = proto.Field( + proto.STRING, + number=2, + ) + source_language_code: str = proto.Field( + proto.STRING, + number=3, + ) + target_language_code: str = proto.Field( + proto.STRING, + number=4, + ) + example_count: int = proto.Field( + proto.INT32, + number=5, + ) + create_time: timestamp_pb2.Timestamp = proto.Field( + proto.MESSAGE, + number=9, + message=timestamp_pb2.Timestamp, + ) + update_time: timestamp_pb2.Timestamp = proto.Field( + proto.MESSAGE, + number=10, + message=timestamp_pb2.Timestamp, + ) + + +class CreateAdaptiveMtDatasetRequest(proto.Message): + r"""Request message for creating an AdaptiveMtDataset. + + Attributes: + parent (str): + Required. Name of the parent project. In form of + ``projects/{project-number-or-id}/locations/{location-id}`` + adaptive_mt_dataset (google.cloud.translate_v3.types.AdaptiveMtDataset): + Required. The AdaptiveMtDataset to be + created. + """ + + parent: str = proto.Field( + proto.STRING, + number=1, + ) + adaptive_mt_dataset: "AdaptiveMtDataset" = proto.Field( + proto.MESSAGE, + number=2, + message="AdaptiveMtDataset", + ) + + +class DeleteAdaptiveMtDatasetRequest(proto.Message): + r"""Request message for deleting an AdaptiveMtDataset. + + Attributes: + name (str): + Required. Name of the dataset. In the form of + ``projects/{project-number-or-id}/locations/{location-id}/adaptiveMtDatasets/{adaptive-mt-dataset-id}`` + """ + + name: str = proto.Field( + proto.STRING, + number=1, + ) + + +class GetAdaptiveMtDatasetRequest(proto.Message): + r"""Request message for getting an Adaptive MT dataset. + + Attributes: + name (str): + Required. Name of the dataset. In the form of + ``projects/{project-number-or-id}/locations/{location-id}/adaptiveMtDatasets/{adaptive-mt-dataset-id}`` + """ + + name: str = proto.Field( + proto.STRING, + number=1, + ) + + +class ListAdaptiveMtDatasetsRequest(proto.Message): + r"""Request message for listing all Adaptive MT datasets that the + requestor has access to. + + Attributes: + parent (str): + Required. The resource name of the project from which to + list the Adaptive MT datasets. + ``projects/{project-number-or-id}/locations/{location-id}`` + page_size (int): + Optional. Requested page size. The server may + return fewer results than requested. If + unspecified, the server picks an appropriate + default. + page_token (str): + Optional. A token identifying a page of results the server + should return. Typically, this is the value of + ListAdaptiveMtDatasetsResponse.next_page_token returned from + the previous call to ``ListAdaptiveMtDatasets`` method. The + first page is returned if ``page_token``\ is empty or + missing. + filter (str): + Optional. An expression for filtering the + results of the request. Filter is not supported + yet. + """ + + parent: str = proto.Field( + proto.STRING, + number=1, + ) + page_size: int = proto.Field( + proto.INT32, + number=2, + ) + page_token: str = proto.Field( + proto.STRING, + number=3, + ) + filter: str = proto.Field( + proto.STRING, + number=4, + ) + + +class ListAdaptiveMtDatasetsResponse(proto.Message): + r"""A list of AdaptiveMtDatasets. + + Attributes: + adaptive_mt_datasets (MutableSequence[google.cloud.translate_v3.types.AdaptiveMtDataset]): + Output only. A list of Adaptive MT datasets. + next_page_token (str): + Optional. A token to retrieve a page of results. Pass this + value in the [ListAdaptiveMtDatasetsRequest.page_token] + field in the subsequent call to ``ListAdaptiveMtDatasets`` + method to retrieve the next page of results. + """ + + @property + def raw_page(self): + return self + + adaptive_mt_datasets: MutableSequence["AdaptiveMtDataset"] = proto.RepeatedField( + proto.MESSAGE, + number=1, + message="AdaptiveMtDataset", + ) + next_page_token: str = proto.Field( + proto.STRING, + number=2, + ) + + +class AdaptiveMtTranslateRequest(proto.Message): + r"""The request for sending an AdaptiveMt translation query. + + Attributes: + parent (str): + Required. Location to make a regional call. + + Format: + ``projects/{project-number-or-id}/locations/{location-id}``. + dataset (str): + Required. The resource name for the dataset to use for + adaptive MT. + ``projects/{project}/locations/{location-id}/adaptiveMtDatasets/{dataset}`` + content (MutableSequence[str]): + Required. The content of the input in string + format. For now only one sentence per request is + supported. + """ + + parent: str = proto.Field( + proto.STRING, + number=1, + ) + dataset: str = proto.Field( + proto.STRING, + number=2, + ) + content: MutableSequence[str] = proto.RepeatedField( + proto.STRING, + number=3, + ) + + +class AdaptiveMtTranslation(proto.Message): + r"""An AdaptiveMt translation. + + Attributes: + translated_text (str): + Output only. The translated text. + """ + + translated_text: str = proto.Field( + proto.STRING, + number=1, + ) + + +class AdaptiveMtTranslateResponse(proto.Message): + r"""An AdaptiveMtTranslate response. + + Attributes: + translations (MutableSequence[google.cloud.translate_v3.types.AdaptiveMtTranslation]): + Output only. The translation. + language_code (str): + Output only. The translation's language code. + """ + + translations: MutableSequence["AdaptiveMtTranslation"] = proto.RepeatedField( + proto.MESSAGE, + number=1, + message="AdaptiveMtTranslation", + ) + language_code: str = proto.Field( + proto.STRING, + number=2, + ) + + +class AdaptiveMtFile(proto.Message): + r"""An AdaptiveMtFile. + + Attributes: + name (str): + Required. The resource name of the file, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + display_name (str): + The file's display name. + entry_count (int): + The number of entries that the file contains. + create_time (google.protobuf.timestamp_pb2.Timestamp): + Output only. Timestamp when this file was + created. + update_time (google.protobuf.timestamp_pb2.Timestamp): + Output only. Timestamp when this file was + last updated. + """ + + name: str = proto.Field( + proto.STRING, + number=1, + ) + display_name: str = proto.Field( + proto.STRING, + number=2, + ) + entry_count: int = proto.Field( + proto.INT32, + number=3, + ) + create_time: timestamp_pb2.Timestamp = proto.Field( + proto.MESSAGE, + number=4, + message=timestamp_pb2.Timestamp, + ) + update_time: timestamp_pb2.Timestamp = proto.Field( + proto.MESSAGE, + number=5, + message=timestamp_pb2.Timestamp, + ) + + +class GetAdaptiveMtFileRequest(proto.Message): + r"""The request for getting an AdaptiveMtFile. + + Attributes: + name (str): + Required. The resource name of the file, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + """ + + name: str = proto.Field( + proto.STRING, + number=1, + ) + + +class DeleteAdaptiveMtFileRequest(proto.Message): + r"""The request for deleting an AdaptiveMt file. + + Attributes: + name (str): + Required. The resource name of the file to delete, in form + of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + """ + + name: str = proto.Field( + proto.STRING, + number=1, + ) + + +class ImportAdaptiveMtFileRequest(proto.Message): + r"""The request for importing an AdaptiveMt file along with its + sentences. + + This message has `oneof`_ fields (mutually exclusive fields). + For each oneof, at most one member field can be set at the same time. + Setting any member of the oneof automatically clears all other + members. + + .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields + + Attributes: + parent (str): + Required. The resource name of the file, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}`` + file_input_source (google.cloud.translate_v3.types.FileInputSource): + Inline file source. + + This field is a member of `oneof`_ ``source``. + gcs_input_source (google.cloud.translate_v3.types.GcsInputSource): + Google Cloud Storage file source. + + This field is a member of `oneof`_ ``source``. + """ + + parent: str = proto.Field( + proto.STRING, + number=1, + ) + file_input_source: common.FileInputSource = proto.Field( + proto.MESSAGE, + number=2, + oneof="source", + message=common.FileInputSource, + ) + gcs_input_source: common.GcsInputSource = proto.Field( + proto.MESSAGE, + number=3, + oneof="source", + message=common.GcsInputSource, + ) + + +class ImportAdaptiveMtFileResponse(proto.Message): + r"""The response for importing an AdaptiveMtFile + + Attributes: + adaptive_mt_file (google.cloud.translate_v3.types.AdaptiveMtFile): + Output only. The Adaptive MT file that was + imported. + """ + + adaptive_mt_file: "AdaptiveMtFile" = proto.Field( + proto.MESSAGE, + number=1, + message="AdaptiveMtFile", + ) + + +class ListAdaptiveMtFilesRequest(proto.Message): + r"""The request to list all AdaptiveMt files under a given + dataset. + + Attributes: + parent (str): + Required. The resource name of the project from which to + list the Adaptive MT files. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}`` + page_size (int): + Optional. + page_token (str): + Optional. A token identifying a page of results the server + should return. Typically, this is the value of + ListAdaptiveMtFilesResponse.next_page_token returned from + the previous call to ``ListAdaptiveMtFiles`` method. The + first page is returned if ``page_token``\ is empty or + missing. + """ + + parent: str = proto.Field( + proto.STRING, + number=1, + ) + page_size: int = proto.Field( + proto.INT32, + number=2, + ) + page_token: str = proto.Field( + proto.STRING, + number=3, + ) + + +class ListAdaptiveMtFilesResponse(proto.Message): + r"""The response for listing all AdaptiveMt files under a given + dataset. + + Attributes: + adaptive_mt_files (MutableSequence[google.cloud.translate_v3.types.AdaptiveMtFile]): + Output only. The Adaptive MT files. + next_page_token (str): + Optional. A token to retrieve a page of results. Pass this + value in the ListAdaptiveMtFilesRequest.page_token field in + the subsequent call to ``ListAdaptiveMtFiles`` method to + retrieve the next page of results. + """ + + @property + def raw_page(self): + return self + + adaptive_mt_files: MutableSequence["AdaptiveMtFile"] = proto.RepeatedField( + proto.MESSAGE, + number=1, + message="AdaptiveMtFile", + ) + next_page_token: str = proto.Field( + proto.STRING, + number=3, + ) + + +class AdaptiveMtSentence(proto.Message): + r"""An AdaptiveMt sentence entry. + + Attributes: + name (str): + Required. The resource name of the file, in form of + ``projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}/adaptiveMtSentences/{sentence}`` + source_sentence (str): + Required. The source sentence. + target_sentence (str): + Required. The target sentence. + create_time (google.protobuf.timestamp_pb2.Timestamp): + Output only. Timestamp when this sentence was + created. + update_time (google.protobuf.timestamp_pb2.Timestamp): + Output only. Timestamp when this sentence was + last updated. + """ + + name: str = proto.Field( + proto.STRING, + number=1, + ) + source_sentence: str = proto.Field( + proto.STRING, + number=2, + ) + target_sentence: str = proto.Field( + proto.STRING, + number=3, + ) + create_time: timestamp_pb2.Timestamp = proto.Field( + proto.MESSAGE, + number=4, + message=timestamp_pb2.Timestamp, + ) + update_time: timestamp_pb2.Timestamp = proto.Field( + proto.MESSAGE, + number=5, + message=timestamp_pb2.Timestamp, + ) + + +class ListAdaptiveMtSentencesRequest(proto.Message): + r"""The request for listing Adaptive MT sentences from a + Dataset/File. + + Attributes: + parent (str): + Required. The resource name of the project from which to + list the Adaptive MT files. The following format lists all + sentences under a file. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}`` + The following format lists all sentences within a dataset. + ``projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}`` + page_size (int): + + page_token (str): + A token identifying a page of results the server should + return. Typically, this is the value of + ListAdaptiveMtSentencesRequest.next_page_token returned from + the previous call to ``ListTranslationMemories`` method. The + first page is returned if ``page_token`` is empty or + missing. + """ + + parent: str = proto.Field( + proto.STRING, + number=1, + ) + page_size: int = proto.Field( + proto.INT32, + number=2, + ) + page_token: str = proto.Field( + proto.STRING, + number=3, + ) + + +class ListAdaptiveMtSentencesResponse(proto.Message): + r"""List AdaptiveMt sentences response. + + Attributes: + adaptive_mt_sentences (MutableSequence[google.cloud.translate_v3.types.AdaptiveMtSentence]): + Output only. The list of AdaptiveMtSentences. + next_page_token (str): + Optional. + """ + + @property + def raw_page(self): + return self + + adaptive_mt_sentences: MutableSequence["AdaptiveMtSentence"] = proto.RepeatedField( + proto.MESSAGE, + number=1, + message="AdaptiveMtSentence", + ) + next_page_token: str = proto.Field( + proto.STRING, + number=2, + ) + + +__all__ = tuple(sorted(__protobuf__.manifest)) diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/types/common.py b/packages/google-cloud-translate/google/cloud/translate_v3/types/common.py new file mode 100644 index 000000000000..e75192298bb5 --- /dev/null +++ b/packages/google-cloud-translate/google/cloud/translate_v3/types/common.py @@ -0,0 +1,90 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +from __future__ import annotations + +from typing import MutableMapping, MutableSequence + +import proto # type: ignore + +__protobuf__ = proto.module( + package="google.cloud.translation.v3", + manifest={ + "GcsInputSource", + "FileInputSource", + "GcsOutputDestination", + }, +) + + +class GcsInputSource(proto.Message): + r"""The Google Cloud Storage location for the input content. + + Attributes: + input_uri (str): + Required. Source data URI. For example, + ``gs://my_bucket/my_object``. + """ + + input_uri: str = proto.Field( + proto.STRING, + number=1, + ) + + +class FileInputSource(proto.Message): + r"""An inlined file. + + Attributes: + mime_type (str): + Required. The file's mime type. + content (bytes): + Required. The file's byte contents. + display_name (str): + Required. The file's display name. + """ + + mime_type: str = proto.Field( + proto.STRING, + number=1, + ) + content: bytes = proto.Field( + proto.BYTES, + number=2, + ) + display_name: str = proto.Field( + proto.STRING, + number=3, + ) + + +class GcsOutputDestination(proto.Message): + r"""The Google Cloud Storage location for the output content. + + Attributes: + output_uri_prefix (str): + Required. Google Cloud Storage URI to output directory. For + example, ``gs://bucket/directory``. The requesting user must + have write permission to the bucket. The directory will be + created if it doesn't exist. + """ + + output_uri_prefix: str = proto.Field( + proto.STRING, + number=1, + ) + + +__all__ = tuple(sorted(__protobuf__.manifest)) diff --git a/packages/google-cloud-translate/google/cloud/translate_v3/types/translation_service.py b/packages/google-cloud-translate/google/cloud/translate_v3/types/translation_service.py index 160fc54741f5..8f6dbe4f36eb 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3/types/translation_service.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3/types/translation_service.py @@ -17,9 +17,8 @@ from typing import MutableMapping, MutableSequence -import proto # type: ignore - from google.protobuf import timestamp_pb2 # type: ignore +import proto # type: ignore __protobuf__ = proto.module( package="google.cloud.translation.v3", @@ -1801,9 +1800,9 @@ class BatchTranslateDocumentRequest(proto.Message): Optional. Glossaries to be applied. It's keyed by target language code. format_conversions (MutableMapping[str, str]): - Optional. File format conversion map to be applied to all - input files. Map's key is the original mime_type. Map's - value is the target mime_type of translated documents. + Optional. The file format conversion map that is applied to + all input files. The map key is the original mime_type. The + map value is the target mime_type of translated documents. Supported file format conversion includes: diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/gapic_version.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/gapic_version.py index 82156347f3eb..360a0d13ebdd 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3beta1/gapic_version.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3beta1/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "3.13.0" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/async_client.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/async_client.py index 5c4d17ec43f6..5c2a2207bce2 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/async_client.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/async_client.py @@ -33,9 +33,10 @@ from google.api_core import retry_async as retries from google.api_core.client_options import ClientOptions from google.auth import credentials as ga_credentials # type: ignore -from google.cloud.translate_v3beta1 import gapic_version as package_version from google.oauth2 import service_account # type: ignore +from google.cloud.translate_v3beta1 import gapic_version as package_version + try: OptionalRetry = Union[retries.AsyncRetry, gapic_v1.method._MethodDefault] except AttributeError: # pragma: NO COVER @@ -43,9 +44,10 @@ from google.api_core import operation # type: ignore from google.api_core import operation_async # type: ignore +from google.protobuf import timestamp_pb2 # type: ignore + from google.cloud.translate_v3beta1.services.translation_service import pagers from google.cloud.translate_v3beta1.types import translation_service -from google.protobuf import timestamp_pb2 # type: ignore from .client import TranslationServiceClient from .transports.base import DEFAULT_CLIENT_INFO, TranslationServiceTransport diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/client.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/client.py index d9fa9bd56b12..afcaa170c225 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/client.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/client.py @@ -37,9 +37,10 @@ from google.auth.exceptions import MutualTLSChannelError # type: ignore from google.auth.transport import mtls # type: ignore from google.auth.transport.grpc import SslCredentials # type: ignore -from google.cloud.translate_v3beta1 import gapic_version as package_version from google.oauth2 import service_account # type: ignore +from google.cloud.translate_v3beta1 import gapic_version as package_version + try: OptionalRetry = Union[retries.Retry, gapic_v1.method._MethodDefault] except AttributeError: # pragma: NO COVER @@ -47,9 +48,10 @@ from google.api_core import operation # type: ignore from google.api_core import operation_async # type: ignore +from google.protobuf import timestamp_pb2 # type: ignore + from google.cloud.translate_v3beta1.services.translation_service import pagers from google.cloud.translate_v3beta1.types import translation_service -from google.protobuf import timestamp_pb2 # type: ignore from .transports.base import DEFAULT_CLIENT_INFO, TranslationServiceTransport from .transports.grpc import TranslationServiceGrpcTransport diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/base.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/base.py index 3064d9b19609..7c9a5ad76a5f 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/base.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/base.py @@ -22,11 +22,12 @@ from google.api_core import retry as retries import google.auth # type: ignore from google.auth import credentials as ga_credentials # type: ignore -from google.cloud.translate_v3beta1 import gapic_version as package_version -from google.cloud.translate_v3beta1.types import translation_service from google.longrunning import operations_pb2 # type: ignore from google.oauth2 import service_account # type: ignore +from google.cloud.translate_v3beta1 import gapic_version as package_version +from google.cloud.translate_v3beta1.types import translation_service + DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo( gapic_version=package_version.__version__ ) diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/grpc.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/grpc.py index 66ef7112a0f5..810eb99bbe47 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/grpc.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/grpc.py @@ -16,14 +16,14 @@ from typing import Callable, Dict, Optional, Sequence, Tuple, Union import warnings -import grpc # type: ignore - from google.api_core import gapic_v1, grpc_helpers, operations_v1 import google.auth # type: ignore from google.auth import credentials as ga_credentials # type: ignore from google.auth.transport.grpc import SslCredentials # type: ignore -from google.cloud.translate_v3beta1.types import translation_service from google.longrunning import operations_pb2 # type: ignore +import grpc # type: ignore + +from google.cloud.translate_v3beta1.types import translation_service from .base import DEFAULT_CLIENT_INFO, TranslationServiceTransport diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/grpc_asyncio.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/grpc_asyncio.py index 6e175a4b7c8d..373d3bb6c483 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/grpc_asyncio.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/grpc_asyncio.py @@ -16,14 +16,14 @@ from typing import Awaitable, Callable, Dict, Optional, Sequence, Tuple, Union import warnings -import grpc # type: ignore -from grpc.experimental import aio # type: ignore - from google.api_core import gapic_v1, grpc_helpers_async, operations_v1 from google.auth import credentials as ga_credentials # type: ignore from google.auth.transport.grpc import SslCredentials # type: ignore -from google.cloud.translate_v3beta1.types import translation_service from google.longrunning import operations_pb2 # type: ignore +import grpc # type: ignore +from grpc.experimental import aio # type: ignore + +from google.cloud.translate_v3beta1.types import translation_service from .base import DEFAULT_CLIENT_INFO, TranslationServiceTransport from .grpc import TranslationServiceGrpcTransport diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/rest.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/rest.py index 2fe8bbe126fe..688ea51356c0 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/rest.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3beta1/services/translation_service/transports/rest.py @@ -20,9 +20,6 @@ from typing import Any, Callable, Dict, List, Optional, Sequence, Tuple, Union import warnings -import grpc # type: ignore -from requests import __version__ as requests_version - from google.api_core import ( gapic_v1, operations_v1, @@ -36,6 +33,8 @@ from google.auth.transport.grpc import SslCredentials # type: ignore from google.auth.transport.requests import AuthorizedSession # type: ignore from google.protobuf import json_format +import grpc # type: ignore +from requests import __version__ as requests_version try: OptionalRetry = Union[retries.Retry, gapic_v1.method._MethodDefault] @@ -43,9 +42,10 @@ OptionalRetry = Union[retries.Retry, object] # type: ignore -from google.cloud.translate_v3beta1.types import translation_service from google.longrunning import operations_pb2 # type: ignore +from google.cloud.translate_v3beta1.types import translation_service + from .base import DEFAULT_CLIENT_INFO as BASE_DEFAULT_CLIENT_INFO from .base import TranslationServiceTransport diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/types/translation_service.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/types/translation_service.py index 3acbbdfc0004..0c66d71be0df 100644 --- a/packages/google-cloud-translate/google/cloud/translate_v3beta1/types/translation_service.py +++ b/packages/google-cloud-translate/google/cloud/translate_v3beta1/types/translation_service.py @@ -17,9 +17,8 @@ from typing import MutableMapping, MutableSequence -import proto # type: ignore - from google.protobuf import timestamp_pb2 # type: ignore +import proto # type: ignore __protobuf__ = proto.module( package="google.cloud.translation.v3beta1", diff --git a/packages/google-cloud-translate/samples/generated_samples/snippet_metadata_google.cloud.translation.v3.json b/packages/google-cloud-translate/samples/generated_samples/snippet_metadata_google.cloud.translation.v3.json index ecbacba53967..715f0750dcf9 100644 --- a/packages/google-cloud-translate/samples/generated_samples/snippet_metadata_google.cloud.translation.v3.json +++ b/packages/google-cloud-translate/samples/generated_samples/snippet_metadata_google.cloud.translation.v3.json @@ -8,9 +8,178 @@ ], "language": "PYTHON", "name": "google-cloud-translate", - "version": "3.13.0" + "version": "0.1.0" }, "snippets": [ + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.adaptive_mt_translate", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.AdaptiveMtTranslate", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "AdaptiveMtTranslate" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.AdaptiveMtTranslateRequest" + }, + { + "name": "parent", + "type": "str" + }, + { + "name": "content", + "type": "MutableSequence[str]" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.AdaptiveMtTranslateResponse", + "shortName": "adaptive_mt_translate" + }, + "description": "Sample for AdaptiveMtTranslate", + "file": "translate_v3_generated_translation_service_adaptive_mt_translate_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_AdaptiveMtTranslate_async", + "segments": [ + { + "end": 53, + "start": 27, + "type": "FULL" + }, + { + "end": 53, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 47, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 50, + "start": 48, + "type": "REQUEST_EXECUTION" + }, + { + "end": 54, + "start": 51, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_adaptive_mt_translate_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.adaptive_mt_translate", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.AdaptiveMtTranslate", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "AdaptiveMtTranslate" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.AdaptiveMtTranslateRequest" + }, + { + "name": "parent", + "type": "str" + }, + { + "name": "content", + "type": "MutableSequence[str]" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.AdaptiveMtTranslateResponse", + "shortName": "adaptive_mt_translate" + }, + "description": "Sample for AdaptiveMtTranslate", + "file": "translate_v3_generated_translation_service_adaptive_mt_translate_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_AdaptiveMtTranslate_sync", + "segments": [ + { + "end": 53, + "start": 27, + "type": "FULL" + }, + { + "end": 53, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 47, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 50, + "start": 48, + "type": "REQUEST_EXECUTION" + }, + { + "end": 54, + "start": 51, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_adaptive_mt_translate_sync.py" + }, { "canonical": true, "clientMethod": { @@ -365,27 +534,27 @@ "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", "shortName": "TranslationServiceAsyncClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.create_glossary", + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.create_adaptive_mt_dataset", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.CreateGlossary", + "fullName": "google.cloud.translation.v3.TranslationService.CreateAdaptiveMtDataset", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "CreateGlossary" + "shortName": "CreateAdaptiveMtDataset" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.CreateGlossaryRequest" + "type": "google.cloud.translate_v3.types.CreateAdaptiveMtDatasetRequest" }, { "name": "parent", "type": "str" }, { - "name": "glossary", - "type": "google.cloud.translate_v3.types.Glossary" + "name": "adaptive_mt_dataset", + "type": "google.cloud.translate_v3.types.AdaptiveMtDataset" }, { "name": "retry", @@ -400,22 +569,1503 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.api_core.operation_async.AsyncOperation", - "shortName": "create_glossary" + "resultType": "google.cloud.translate_v3.types.AdaptiveMtDataset", + "shortName": "create_adaptive_mt_dataset" + }, + "description": "Sample for CreateAdaptiveMtDataset", + "file": "translate_v3_generated_translation_service_create_adaptive_mt_dataset_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_CreateAdaptiveMtDataset_async", + "segments": [ + { + "end": 55, + "start": 27, + "type": "FULL" + }, + { + "end": 55, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 49, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 52, + "start": 50, + "type": "REQUEST_EXECUTION" + }, + { + "end": 56, + "start": 53, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_create_adaptive_mt_dataset_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.create_adaptive_mt_dataset", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.CreateAdaptiveMtDataset", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "CreateAdaptiveMtDataset" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.CreateAdaptiveMtDatasetRequest" + }, + { + "name": "parent", + "type": "str" + }, + { + "name": "adaptive_mt_dataset", + "type": "google.cloud.translate_v3.types.AdaptiveMtDataset" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.AdaptiveMtDataset", + "shortName": "create_adaptive_mt_dataset" + }, + "description": "Sample for CreateAdaptiveMtDataset", + "file": "translate_v3_generated_translation_service_create_adaptive_mt_dataset_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_CreateAdaptiveMtDataset_sync", + "segments": [ + { + "end": 55, + "start": 27, + "type": "FULL" + }, + { + "end": 55, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 49, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 52, + "start": 50, + "type": "REQUEST_EXECUTION" + }, + { + "end": 56, + "start": 53, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_create_adaptive_mt_dataset_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.create_glossary", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.CreateGlossary", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "CreateGlossary" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.CreateGlossaryRequest" + }, + { + "name": "parent", + "type": "str" + }, + { + "name": "glossary", + "type": "google.cloud.translate_v3.types.Glossary" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.api_core.operation_async.AsyncOperation", + "shortName": "create_glossary" + }, + "description": "Sample for CreateGlossary", + "file": "translate_v3_generated_translation_service_create_glossary_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_CreateGlossary_async", + "segments": [ + { + "end": 59, + "start": 27, + "type": "FULL" + }, + { + "end": 59, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 49, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 56, + "start": 50, + "type": "REQUEST_EXECUTION" + }, + { + "end": 60, + "start": 57, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_create_glossary_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.create_glossary", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.CreateGlossary", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "CreateGlossary" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.CreateGlossaryRequest" + }, + { + "name": "parent", + "type": "str" + }, + { + "name": "glossary", + "type": "google.cloud.translate_v3.types.Glossary" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.api_core.operation.Operation", + "shortName": "create_glossary" + }, + "description": "Sample for CreateGlossary", + "file": "translate_v3_generated_translation_service_create_glossary_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_CreateGlossary_sync", + "segments": [ + { + "end": 59, + "start": 27, + "type": "FULL" + }, + { + "end": 59, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 49, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 56, + "start": 50, + "type": "REQUEST_EXECUTION" + }, + { + "end": 60, + "start": 57, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_create_glossary_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.delete_adaptive_mt_dataset", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.DeleteAdaptiveMtDataset", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "DeleteAdaptiveMtDataset" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.DeleteAdaptiveMtDatasetRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "shortName": "delete_adaptive_mt_dataset" + }, + "description": "Sample for DeleteAdaptiveMtDataset", + "file": "translate_v3_generated_translation_service_delete_adaptive_mt_dataset_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_DeleteAdaptiveMtDataset_async", + "segments": [ + { + "end": 49, + "start": 27, + "type": "FULL" + }, + { + "end": 49, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 50, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_delete_adaptive_mt_dataset_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.delete_adaptive_mt_dataset", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.DeleteAdaptiveMtDataset", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "DeleteAdaptiveMtDataset" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.DeleteAdaptiveMtDatasetRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "shortName": "delete_adaptive_mt_dataset" + }, + "description": "Sample for DeleteAdaptiveMtDataset", + "file": "translate_v3_generated_translation_service_delete_adaptive_mt_dataset_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_DeleteAdaptiveMtDataset_sync", + "segments": [ + { + "end": 49, + "start": 27, + "type": "FULL" + }, + { + "end": 49, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 50, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_delete_adaptive_mt_dataset_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.delete_adaptive_mt_file", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.DeleteAdaptiveMtFile", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "DeleteAdaptiveMtFile" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.DeleteAdaptiveMtFileRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "shortName": "delete_adaptive_mt_file" + }, + "description": "Sample for DeleteAdaptiveMtFile", + "file": "translate_v3_generated_translation_service_delete_adaptive_mt_file_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_DeleteAdaptiveMtFile_async", + "segments": [ + { + "end": 49, + "start": 27, + "type": "FULL" + }, + { + "end": 49, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 50, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_delete_adaptive_mt_file_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.delete_adaptive_mt_file", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.DeleteAdaptiveMtFile", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "DeleteAdaptiveMtFile" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.DeleteAdaptiveMtFileRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "shortName": "delete_adaptive_mt_file" + }, + "description": "Sample for DeleteAdaptiveMtFile", + "file": "translate_v3_generated_translation_service_delete_adaptive_mt_file_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_DeleteAdaptiveMtFile_sync", + "segments": [ + { + "end": 49, + "start": 27, + "type": "FULL" + }, + { + "end": 49, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 50, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_delete_adaptive_mt_file_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.delete_glossary", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.DeleteGlossary", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "DeleteGlossary" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.DeleteGlossaryRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.api_core.operation_async.AsyncOperation", + "shortName": "delete_glossary" + }, + "description": "Sample for DeleteGlossary", + "file": "translate_v3_generated_translation_service_delete_glossary_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_DeleteGlossary_async", + "segments": [ + { + "end": 55, + "start": 27, + "type": "FULL" + }, + { + "end": 55, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 52, + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 56, + "start": 53, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_delete_glossary_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.delete_glossary", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.DeleteGlossary", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "DeleteGlossary" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.DeleteGlossaryRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.api_core.operation.Operation", + "shortName": "delete_glossary" + }, + "description": "Sample for DeleteGlossary", + "file": "translate_v3_generated_translation_service_delete_glossary_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_DeleteGlossary_sync", + "segments": [ + { + "end": 55, + "start": 27, + "type": "FULL" + }, + { + "end": 55, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 52, + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 56, + "start": 53, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_delete_glossary_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.detect_language", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.DetectLanguage", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "DetectLanguage" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.DetectLanguageRequest" + }, + { + "name": "parent", + "type": "str" + }, + { + "name": "model", + "type": "str" + }, + { + "name": "mime_type", + "type": "str" + }, + { + "name": "content", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.DetectLanguageResponse", + "shortName": "detect_language" + }, + "description": "Sample for DetectLanguage", + "file": "translate_v3_generated_translation_service_detect_language_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_DetectLanguage_async", + "segments": [ + { + "end": 52, + "start": 27, + "type": "FULL" + }, + { + "end": 52, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 46, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 49, + "start": 47, + "type": "REQUEST_EXECUTION" + }, + { + "end": 53, + "start": 50, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_detect_language_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.detect_language", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.DetectLanguage", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "DetectLanguage" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.DetectLanguageRequest" + }, + { + "name": "parent", + "type": "str" + }, + { + "name": "model", + "type": "str" + }, + { + "name": "mime_type", + "type": "str" + }, + { + "name": "content", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.DetectLanguageResponse", + "shortName": "detect_language" + }, + "description": "Sample for DetectLanguage", + "file": "translate_v3_generated_translation_service_detect_language_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_DetectLanguage_sync", + "segments": [ + { + "end": 52, + "start": 27, + "type": "FULL" + }, + { + "end": 52, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 46, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 49, + "start": 47, + "type": "REQUEST_EXECUTION" + }, + { + "end": 53, + "start": 50, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_detect_language_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.get_adaptive_mt_dataset", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.GetAdaptiveMtDataset", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "GetAdaptiveMtDataset" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.GetAdaptiveMtDatasetRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.AdaptiveMtDataset", + "shortName": "get_adaptive_mt_dataset" + }, + "description": "Sample for GetAdaptiveMtDataset", + "file": "translate_v3_generated_translation_service_get_adaptive_mt_dataset_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_GetAdaptiveMtDataset_async", + "segments": [ + { + "end": 51, + "start": 27, + "type": "FULL" + }, + { + "end": 51, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 48, + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 52, + "start": 49, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_get_adaptive_mt_dataset_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.get_adaptive_mt_dataset", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.GetAdaptiveMtDataset", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "GetAdaptiveMtDataset" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.GetAdaptiveMtDatasetRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.AdaptiveMtDataset", + "shortName": "get_adaptive_mt_dataset" + }, + "description": "Sample for GetAdaptiveMtDataset", + "file": "translate_v3_generated_translation_service_get_adaptive_mt_dataset_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_GetAdaptiveMtDataset_sync", + "segments": [ + { + "end": 51, + "start": 27, + "type": "FULL" + }, + { + "end": 51, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 48, + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 52, + "start": 49, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_get_adaptive_mt_dataset_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.get_adaptive_mt_file", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.GetAdaptiveMtFile", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "GetAdaptiveMtFile" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.GetAdaptiveMtFileRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.AdaptiveMtFile", + "shortName": "get_adaptive_mt_file" + }, + "description": "Sample for GetAdaptiveMtFile", + "file": "translate_v3_generated_translation_service_get_adaptive_mt_file_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_GetAdaptiveMtFile_async", + "segments": [ + { + "end": 51, + "start": 27, + "type": "FULL" + }, + { + "end": 51, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 48, + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 52, + "start": 49, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_get_adaptive_mt_file_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.get_adaptive_mt_file", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.GetAdaptiveMtFile", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "GetAdaptiveMtFile" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.GetAdaptiveMtFileRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.AdaptiveMtFile", + "shortName": "get_adaptive_mt_file" + }, + "description": "Sample for GetAdaptiveMtFile", + "file": "translate_v3_generated_translation_service_get_adaptive_mt_file_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_GetAdaptiveMtFile_sync", + "segments": [ + { + "end": 51, + "start": 27, + "type": "FULL" + }, + { + "end": 51, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 48, + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 52, + "start": 49, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_get_adaptive_mt_file_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.get_glossary", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.GetGlossary", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "GetGlossary" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.GetGlossaryRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.Glossary", + "shortName": "get_glossary" + }, + "description": "Sample for GetGlossary", + "file": "translate_v3_generated_translation_service_get_glossary_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_GetGlossary_async", + "segments": [ + { + "end": 51, + "start": 27, + "type": "FULL" + }, + { + "end": 51, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 48, + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 52, + "start": 49, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_get_glossary_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceClient", + "shortName": "TranslationServiceClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceClient.get_glossary", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.GetGlossary", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "GetGlossary" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.GetGlossaryRequest" + }, + { + "name": "name", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.Glossary", + "shortName": "get_glossary" + }, + "description": "Sample for GetGlossary", + "file": "translate_v3_generated_translation_service_get_glossary_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "translate_v3_generated_TranslationService_GetGlossary_sync", + "segments": [ + { + "end": 51, + "start": 27, + "type": "FULL" + }, + { + "end": 51, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 45, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "end": 48, + "start": 46, + "type": "REQUEST_EXECUTION" + }, + { + "end": 52, + "start": 49, + "type": "RESPONSE_HANDLING" + } + ], + "title": "translate_v3_generated_translation_service_get_glossary_sync.py" + }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", + "shortName": "TranslationServiceAsyncClient" + }, + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.get_supported_languages", + "method": { + "fullName": "google.cloud.translation.v3.TranslationService.GetSupportedLanguages", + "service": { + "fullName": "google.cloud.translation.v3.TranslationService", + "shortName": "TranslationService" + }, + "shortName": "GetSupportedLanguages" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.translate_v3.types.GetSupportedLanguagesRequest" + }, + { + "name": "parent", + "type": "str" + }, + { + "name": "model", + "type": "str" + }, + { + "name": "display_language_code", + "type": "str" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "resultType": "google.cloud.translate_v3.types.SupportedLanguages", + "shortName": "get_supported_languages" }, - "description": "Sample for CreateGlossary", - "file": "translate_v3_generated_translation_service_create_glossary_async.py", + "description": "Sample for GetSupportedLanguages", + "file": "translate_v3_generated_translation_service_get_supported_languages_async.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_CreateGlossary_async", + "regionTag": "translate_v3_generated_TranslationService_GetSupportedLanguages_async", "segments": [ { - "end": 59, + "end": 51, "start": 27, "type": "FULL" }, { - "end": 59, + "end": 51, "start": 27, "type": "SHORT" }, @@ -425,22 +2075,22 @@ "type": "CLIENT_INITIALIZATION" }, { - "end": 49, + "end": 45, "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 56, - "start": 50, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 60, - "start": 57, + "end": 52, + "start": 49, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_create_glossary_async.py" + "title": "translate_v3_generated_translation_service_get_supported_languages_async.py" }, { "canonical": true, @@ -449,27 +2099,31 @@ "fullName": "google.cloud.translate_v3.TranslationServiceClient", "shortName": "TranslationServiceClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceClient.create_glossary", + "fullName": "google.cloud.translate_v3.TranslationServiceClient.get_supported_languages", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.CreateGlossary", + "fullName": "google.cloud.translation.v3.TranslationService.GetSupportedLanguages", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "CreateGlossary" + "shortName": "GetSupportedLanguages" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.CreateGlossaryRequest" + "type": "google.cloud.translate_v3.types.GetSupportedLanguagesRequest" }, { "name": "parent", "type": "str" }, { - "name": "glossary", - "type": "google.cloud.translate_v3.types.Glossary" + "name": "model", + "type": "str" + }, + { + "name": "display_language_code", + "type": "str" }, { "name": "retry", @@ -484,22 +2138,22 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.api_core.operation.Operation", - "shortName": "create_glossary" + "resultType": "google.cloud.translate_v3.types.SupportedLanguages", + "shortName": "get_supported_languages" }, - "description": "Sample for CreateGlossary", - "file": "translate_v3_generated_translation_service_create_glossary_sync.py", + "description": "Sample for GetSupportedLanguages", + "file": "translate_v3_generated_translation_service_get_supported_languages_sync.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_CreateGlossary_sync", + "regionTag": "translate_v3_generated_TranslationService_GetSupportedLanguages_sync", "segments": [ { - "end": 59, + "end": 51, "start": 27, "type": "FULL" }, { - "end": 59, + "end": 51, "start": 27, "type": "SHORT" }, @@ -509,22 +2163,22 @@ "type": "CLIENT_INITIALIZATION" }, { - "end": 49, + "end": 45, "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 56, - "start": 50, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 60, - "start": 57, + "end": 52, + "start": 49, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_create_glossary_sync.py" + "title": "translate_v3_generated_translation_service_get_supported_languages_sync.py" }, { "canonical": true, @@ -534,22 +2188,22 @@ "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", "shortName": "TranslationServiceAsyncClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.delete_glossary", + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.import_adaptive_mt_file", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.DeleteGlossary", + "fullName": "google.cloud.translation.v3.TranslationService.ImportAdaptiveMtFile", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "DeleteGlossary" + "shortName": "ImportAdaptiveMtFile" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.DeleteGlossaryRequest" + "type": "google.cloud.translate_v3.types.ImportAdaptiveMtFileRequest" }, { - "name": "name", + "name": "parent", "type": "str" }, { @@ -565,22 +2219,22 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.api_core.operation_async.AsyncOperation", - "shortName": "delete_glossary" + "resultType": "google.cloud.translate_v3.types.ImportAdaptiveMtFileResponse", + "shortName": "import_adaptive_mt_file" }, - "description": "Sample for DeleteGlossary", - "file": "translate_v3_generated_translation_service_delete_glossary_async.py", + "description": "Sample for ImportAdaptiveMtFile", + "file": "translate_v3_generated_translation_service_import_adaptive_mt_file_async.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_DeleteGlossary_async", + "regionTag": "translate_v3_generated_TranslationService_ImportAdaptiveMtFile_async", "segments": [ { - "end": 55, + "end": 57, "start": 27, "type": "FULL" }, { - "end": 55, + "end": 57, "start": 27, "type": "SHORT" }, @@ -590,22 +2244,22 @@ "type": "CLIENT_INITIALIZATION" }, { - "end": 45, + "end": 51, "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 52, - "start": 46, + "end": 54, + "start": 52, "type": "REQUEST_EXECUTION" }, { - "end": 56, - "start": 53, + "end": 58, + "start": 55, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_delete_glossary_async.py" + "title": "translate_v3_generated_translation_service_import_adaptive_mt_file_async.py" }, { "canonical": true, @@ -614,22 +2268,22 @@ "fullName": "google.cloud.translate_v3.TranslationServiceClient", "shortName": "TranslationServiceClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceClient.delete_glossary", + "fullName": "google.cloud.translate_v3.TranslationServiceClient.import_adaptive_mt_file", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.DeleteGlossary", + "fullName": "google.cloud.translation.v3.TranslationService.ImportAdaptiveMtFile", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "DeleteGlossary" + "shortName": "ImportAdaptiveMtFile" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.DeleteGlossaryRequest" + "type": "google.cloud.translate_v3.types.ImportAdaptiveMtFileRequest" }, { - "name": "name", + "name": "parent", "type": "str" }, { @@ -645,22 +2299,22 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.api_core.operation.Operation", - "shortName": "delete_glossary" + "resultType": "google.cloud.translate_v3.types.ImportAdaptiveMtFileResponse", + "shortName": "import_adaptive_mt_file" }, - "description": "Sample for DeleteGlossary", - "file": "translate_v3_generated_translation_service_delete_glossary_sync.py", + "description": "Sample for ImportAdaptiveMtFile", + "file": "translate_v3_generated_translation_service_import_adaptive_mt_file_sync.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_DeleteGlossary_sync", + "regionTag": "translate_v3_generated_TranslationService_ImportAdaptiveMtFile_sync", "segments": [ { - "end": 55, + "end": 57, "start": 27, "type": "FULL" }, { - "end": 55, + "end": 57, "start": 27, "type": "SHORT" }, @@ -670,22 +2324,22 @@ "type": "CLIENT_INITIALIZATION" }, { - "end": 45, + "end": 51, "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 52, - "start": 46, + "end": 54, + "start": 52, "type": "REQUEST_EXECUTION" }, { - "end": 56, - "start": 53, + "end": 58, + "start": 55, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_delete_glossary_sync.py" + "title": "translate_v3_generated_translation_service_import_adaptive_mt_file_sync.py" }, { "canonical": true, @@ -695,36 +2349,24 @@ "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", "shortName": "TranslationServiceAsyncClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.detect_language", + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.list_adaptive_mt_datasets", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.DetectLanguage", + "fullName": "google.cloud.translation.v3.TranslationService.ListAdaptiveMtDatasets", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "DetectLanguage" + "shortName": "ListAdaptiveMtDatasets" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.DetectLanguageRequest" + "type": "google.cloud.translate_v3.types.ListAdaptiveMtDatasetsRequest" }, { "name": "parent", "type": "str" }, - { - "name": "model", - "type": "str" - }, - { - "name": "mime_type", - "type": "str" - }, - { - "name": "content", - "type": "str" - }, { "name": "retry", "type": "google.api_core.retry.Retry" @@ -738,14 +2380,14 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.cloud.translate_v3.types.DetectLanguageResponse", - "shortName": "detect_language" + "resultType": "google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtDatasetsAsyncPager", + "shortName": "list_adaptive_mt_datasets" }, - "description": "Sample for DetectLanguage", - "file": "translate_v3_generated_translation_service_detect_language_async.py", + "description": "Sample for ListAdaptiveMtDatasets", + "file": "translate_v3_generated_translation_service_list_adaptive_mt_datasets_async.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_DetectLanguage_async", + "regionTag": "translate_v3_generated_TranslationService_ListAdaptiveMtDatasets_async", "segments": [ { "end": 52, @@ -763,22 +2405,22 @@ "type": "CLIENT_INITIALIZATION" }, { - "end": 46, + "end": 45, "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 49, - "start": 47, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { "end": 53, - "start": 50, + "start": 49, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_detect_language_async.py" + "title": "translate_v3_generated_translation_service_list_adaptive_mt_datasets_async.py" }, { "canonical": true, @@ -787,36 +2429,24 @@ "fullName": "google.cloud.translate_v3.TranslationServiceClient", "shortName": "TranslationServiceClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceClient.detect_language", + "fullName": "google.cloud.translate_v3.TranslationServiceClient.list_adaptive_mt_datasets", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.DetectLanguage", + "fullName": "google.cloud.translation.v3.TranslationService.ListAdaptiveMtDatasets", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "DetectLanguage" + "shortName": "ListAdaptiveMtDatasets" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.DetectLanguageRequest" + "type": "google.cloud.translate_v3.types.ListAdaptiveMtDatasetsRequest" }, { "name": "parent", "type": "str" }, - { - "name": "model", - "type": "str" - }, - { - "name": "mime_type", - "type": "str" - }, - { - "name": "content", - "type": "str" - }, { "name": "retry", "type": "google.api_core.retry.Retry" @@ -830,14 +2460,14 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.cloud.translate_v3.types.DetectLanguageResponse", - "shortName": "detect_language" + "resultType": "google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtDatasetsPager", + "shortName": "list_adaptive_mt_datasets" }, - "description": "Sample for DetectLanguage", - "file": "translate_v3_generated_translation_service_detect_language_sync.py", + "description": "Sample for ListAdaptiveMtDatasets", + "file": "translate_v3_generated_translation_service_list_adaptive_mt_datasets_sync.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_DetectLanguage_sync", + "regionTag": "translate_v3_generated_TranslationService_ListAdaptiveMtDatasets_sync", "segments": [ { "end": 52, @@ -855,22 +2485,22 @@ "type": "CLIENT_INITIALIZATION" }, { - "end": 46, + "end": 45, "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 49, - "start": 47, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { "end": 53, - "start": 50, + "start": 49, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_detect_language_sync.py" + "title": "translate_v3_generated_translation_service_list_adaptive_mt_datasets_sync.py" }, { "canonical": true, @@ -880,22 +2510,22 @@ "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", "shortName": "TranslationServiceAsyncClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.get_glossary", + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.list_adaptive_mt_files", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.GetGlossary", + "fullName": "google.cloud.translation.v3.TranslationService.ListAdaptiveMtFiles", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "GetGlossary" + "shortName": "ListAdaptiveMtFiles" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.GetGlossaryRequest" + "type": "google.cloud.translate_v3.types.ListAdaptiveMtFilesRequest" }, { - "name": "name", + "name": "parent", "type": "str" }, { @@ -911,22 +2541,22 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.cloud.translate_v3.types.Glossary", - "shortName": "get_glossary" + "resultType": "google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtFilesAsyncPager", + "shortName": "list_adaptive_mt_files" }, - "description": "Sample for GetGlossary", - "file": "translate_v3_generated_translation_service_get_glossary_async.py", + "description": "Sample for ListAdaptiveMtFiles", + "file": "translate_v3_generated_translation_service_list_adaptive_mt_files_async.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_GetGlossary_async", + "regionTag": "translate_v3_generated_TranslationService_ListAdaptiveMtFiles_async", "segments": [ { - "end": 51, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 51, + "end": 52, "start": 27, "type": "SHORT" }, @@ -946,12 +2576,12 @@ "type": "REQUEST_EXECUTION" }, { - "end": 52, + "end": 53, "start": 49, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_get_glossary_async.py" + "title": "translate_v3_generated_translation_service_list_adaptive_mt_files_async.py" }, { "canonical": true, @@ -960,22 +2590,22 @@ "fullName": "google.cloud.translate_v3.TranslationServiceClient", "shortName": "TranslationServiceClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceClient.get_glossary", + "fullName": "google.cloud.translate_v3.TranslationServiceClient.list_adaptive_mt_files", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.GetGlossary", + "fullName": "google.cloud.translation.v3.TranslationService.ListAdaptiveMtFiles", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "GetGlossary" + "shortName": "ListAdaptiveMtFiles" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.GetGlossaryRequest" + "type": "google.cloud.translate_v3.types.ListAdaptiveMtFilesRequest" }, { - "name": "name", + "name": "parent", "type": "str" }, { @@ -991,22 +2621,22 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.cloud.translate_v3.types.Glossary", - "shortName": "get_glossary" + "resultType": "google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtFilesPager", + "shortName": "list_adaptive_mt_files" }, - "description": "Sample for GetGlossary", - "file": "translate_v3_generated_translation_service_get_glossary_sync.py", + "description": "Sample for ListAdaptiveMtFiles", + "file": "translate_v3_generated_translation_service_list_adaptive_mt_files_sync.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_GetGlossary_sync", + "regionTag": "translate_v3_generated_TranslationService_ListAdaptiveMtFiles_sync", "segments": [ { - "end": 51, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 51, + "end": 52, "start": 27, "type": "SHORT" }, @@ -1026,12 +2656,12 @@ "type": "REQUEST_EXECUTION" }, { - "end": 52, + "end": 53, "start": 49, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_get_glossary_sync.py" + "title": "translate_v3_generated_translation_service_list_adaptive_mt_files_sync.py" }, { "canonical": true, @@ -1041,32 +2671,24 @@ "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient", "shortName": "TranslationServiceAsyncClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.get_supported_languages", + "fullName": "google.cloud.translate_v3.TranslationServiceAsyncClient.list_adaptive_mt_sentences", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.GetSupportedLanguages", + "fullName": "google.cloud.translation.v3.TranslationService.ListAdaptiveMtSentences", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "GetSupportedLanguages" + "shortName": "ListAdaptiveMtSentences" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.GetSupportedLanguagesRequest" + "type": "google.cloud.translate_v3.types.ListAdaptiveMtSentencesRequest" }, { "name": "parent", "type": "str" }, - { - "name": "model", - "type": "str" - }, - { - "name": "display_language_code", - "type": "str" - }, { "name": "retry", "type": "google.api_core.retry.Retry" @@ -1080,22 +2702,22 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.cloud.translate_v3.types.SupportedLanguages", - "shortName": "get_supported_languages" + "resultType": "google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtSentencesAsyncPager", + "shortName": "list_adaptive_mt_sentences" }, - "description": "Sample for GetSupportedLanguages", - "file": "translate_v3_generated_translation_service_get_supported_languages_async.py", + "description": "Sample for ListAdaptiveMtSentences", + "file": "translate_v3_generated_translation_service_list_adaptive_mt_sentences_async.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_GetSupportedLanguages_async", + "regionTag": "translate_v3_generated_TranslationService_ListAdaptiveMtSentences_async", "segments": [ { - "end": 51, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 51, + "end": 52, "start": 27, "type": "SHORT" }, @@ -1115,12 +2737,12 @@ "type": "REQUEST_EXECUTION" }, { - "end": 52, + "end": 53, "start": 49, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_get_supported_languages_async.py" + "title": "translate_v3_generated_translation_service_list_adaptive_mt_sentences_async.py" }, { "canonical": true, @@ -1129,32 +2751,24 @@ "fullName": "google.cloud.translate_v3.TranslationServiceClient", "shortName": "TranslationServiceClient" }, - "fullName": "google.cloud.translate_v3.TranslationServiceClient.get_supported_languages", + "fullName": "google.cloud.translate_v3.TranslationServiceClient.list_adaptive_mt_sentences", "method": { - "fullName": "google.cloud.translation.v3.TranslationService.GetSupportedLanguages", + "fullName": "google.cloud.translation.v3.TranslationService.ListAdaptiveMtSentences", "service": { "fullName": "google.cloud.translation.v3.TranslationService", "shortName": "TranslationService" }, - "shortName": "GetSupportedLanguages" + "shortName": "ListAdaptiveMtSentences" }, "parameters": [ { "name": "request", - "type": "google.cloud.translate_v3.types.GetSupportedLanguagesRequest" + "type": "google.cloud.translate_v3.types.ListAdaptiveMtSentencesRequest" }, { "name": "parent", "type": "str" }, - { - "name": "model", - "type": "str" - }, - { - "name": "display_language_code", - "type": "str" - }, { "name": "retry", "type": "google.api_core.retry.Retry" @@ -1168,22 +2782,22 @@ "type": "Sequence[Tuple[str, str]" } ], - "resultType": "google.cloud.translate_v3.types.SupportedLanguages", - "shortName": "get_supported_languages" + "resultType": "google.cloud.translate_v3.services.translation_service.pagers.ListAdaptiveMtSentencesPager", + "shortName": "list_adaptive_mt_sentences" }, - "description": "Sample for GetSupportedLanguages", - "file": "translate_v3_generated_translation_service_get_supported_languages_sync.py", + "description": "Sample for ListAdaptiveMtSentences", + "file": "translate_v3_generated_translation_service_list_adaptive_mt_sentences_sync.py", "language": "PYTHON", "origin": "API_DEFINITION", - "regionTag": "translate_v3_generated_TranslationService_GetSupportedLanguages_sync", + "regionTag": "translate_v3_generated_TranslationService_ListAdaptiveMtSentences_sync", "segments": [ { - "end": 51, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 51, + "end": 52, "start": 27, "type": "SHORT" }, @@ -1203,12 +2817,12 @@ "type": "REQUEST_EXECUTION" }, { - "end": 52, + "end": 53, "start": 49, "type": "RESPONSE_HANDLING" } ], - "title": "translate_v3_generated_translation_service_get_supported_languages_sync.py" + "title": "translate_v3_generated_translation_service_list_adaptive_mt_sentences_sync.py" }, { "canonical": true, diff --git a/packages/google-cloud-translate/samples/generated_samples/snippet_metadata_google.cloud.translation.v3beta1.json b/packages/google-cloud-translate/samples/generated_samples/snippet_metadata_google.cloud.translation.v3beta1.json index 8c78ab1d4002..42d10a5032f6 100644 --- a/packages/google-cloud-translate/samples/generated_samples/snippet_metadata_google.cloud.translation.v3beta1.json +++ b/packages/google-cloud-translate/samples/generated_samples/snippet_metadata_google.cloud.translation.v3beta1.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-translate", - "version": "3.13.0" + "version": "0.1.0" }, "snippets": [ { diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_adaptive_mt_translate_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_adaptive_mt_translate_async.py new file mode 100644 index 000000000000..9dd123d9ad97 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_adaptive_mt_translate_async.py @@ -0,0 +1,54 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for AdaptiveMtTranslate +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_AdaptiveMtTranslate_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_adaptive_mt_translate(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.AdaptiveMtTranslateRequest( + parent="parent_value", + dataset="dataset_value", + content=['content_value1', 'content_value2'], + ) + + # Make the request + response = await client.adaptive_mt_translate(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_AdaptiveMtTranslate_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_adaptive_mt_translate_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_adaptive_mt_translate_sync.py new file mode 100644 index 000000000000..275648c1a429 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_adaptive_mt_translate_sync.py @@ -0,0 +1,54 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for AdaptiveMtTranslate +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_AdaptiveMtTranslate_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_adaptive_mt_translate(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.AdaptiveMtTranslateRequest( + parent="parent_value", + dataset="dataset_value", + content=['content_value1', 'content_value2'], + ) + + # Make the request + response = client.adaptive_mt_translate(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_AdaptiveMtTranslate_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_create_adaptive_mt_dataset_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_create_adaptive_mt_dataset_async.py new file mode 100644 index 000000000000..ff9b59dcc7b0 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_create_adaptive_mt_dataset_async.py @@ -0,0 +1,56 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for CreateAdaptiveMtDataset +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_CreateAdaptiveMtDataset_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_create_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + adaptive_mt_dataset = translate_v3.AdaptiveMtDataset() + adaptive_mt_dataset.name = "name_value" + + request = translate_v3.CreateAdaptiveMtDatasetRequest( + parent="parent_value", + adaptive_mt_dataset=adaptive_mt_dataset, + ) + + # Make the request + response = await client.create_adaptive_mt_dataset(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_CreateAdaptiveMtDataset_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_create_adaptive_mt_dataset_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_create_adaptive_mt_dataset_sync.py new file mode 100644 index 000000000000..df803a45de73 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_create_adaptive_mt_dataset_sync.py @@ -0,0 +1,56 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for CreateAdaptiveMtDataset +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_CreateAdaptiveMtDataset_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_create_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + adaptive_mt_dataset = translate_v3.AdaptiveMtDataset() + adaptive_mt_dataset.name = "name_value" + + request = translate_v3.CreateAdaptiveMtDatasetRequest( + parent="parent_value", + adaptive_mt_dataset=adaptive_mt_dataset, + ) + + # Make the request + response = client.create_adaptive_mt_dataset(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_CreateAdaptiveMtDataset_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_dataset_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_dataset_async.py new file mode 100644 index 000000000000..e26d048f79c5 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_dataset_async.py @@ -0,0 +1,50 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for DeleteAdaptiveMtDataset +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_DeleteAdaptiveMtDataset_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_delete_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.DeleteAdaptiveMtDatasetRequest( + name="name_value", + ) + + # Make the request + await client.delete_adaptive_mt_dataset(request=request) + + +# [END translate_v3_generated_TranslationService_DeleteAdaptiveMtDataset_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_dataset_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_dataset_sync.py new file mode 100644 index 000000000000..79e165e0d811 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_dataset_sync.py @@ -0,0 +1,50 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for DeleteAdaptiveMtDataset +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_DeleteAdaptiveMtDataset_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_delete_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.DeleteAdaptiveMtDatasetRequest( + name="name_value", + ) + + # Make the request + client.delete_adaptive_mt_dataset(request=request) + + +# [END translate_v3_generated_TranslationService_DeleteAdaptiveMtDataset_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_file_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_file_async.py new file mode 100644 index 000000000000..af6e726b9fd5 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_file_async.py @@ -0,0 +1,50 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for DeleteAdaptiveMtFile +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_DeleteAdaptiveMtFile_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_delete_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.DeleteAdaptiveMtFileRequest( + name="name_value", + ) + + # Make the request + await client.delete_adaptive_mt_file(request=request) + + +# [END translate_v3_generated_TranslationService_DeleteAdaptiveMtFile_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_file_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_file_sync.py new file mode 100644 index 000000000000..e415e826c0d5 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_delete_adaptive_mt_file_sync.py @@ -0,0 +1,50 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for DeleteAdaptiveMtFile +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_DeleteAdaptiveMtFile_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_delete_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.DeleteAdaptiveMtFileRequest( + name="name_value", + ) + + # Make the request + client.delete_adaptive_mt_file(request=request) + + +# [END translate_v3_generated_TranslationService_DeleteAdaptiveMtFile_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_dataset_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_dataset_async.py new file mode 100644 index 000000000000..fc944dd0ab8d --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_dataset_async.py @@ -0,0 +1,52 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for GetAdaptiveMtDataset +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_GetAdaptiveMtDataset_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_get_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.GetAdaptiveMtDatasetRequest( + name="name_value", + ) + + # Make the request + response = await client.get_adaptive_mt_dataset(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_GetAdaptiveMtDataset_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_dataset_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_dataset_sync.py new file mode 100644 index 000000000000..d7ca19ffc845 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_dataset_sync.py @@ -0,0 +1,52 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for GetAdaptiveMtDataset +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_GetAdaptiveMtDataset_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_get_adaptive_mt_dataset(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.GetAdaptiveMtDatasetRequest( + name="name_value", + ) + + # Make the request + response = client.get_adaptive_mt_dataset(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_GetAdaptiveMtDataset_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_file_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_file_async.py new file mode 100644 index 000000000000..d8386c5846c8 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_file_async.py @@ -0,0 +1,52 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for GetAdaptiveMtFile +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_GetAdaptiveMtFile_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_get_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.GetAdaptiveMtFileRequest( + name="name_value", + ) + + # Make the request + response = await client.get_adaptive_mt_file(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_GetAdaptiveMtFile_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_file_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_file_sync.py new file mode 100644 index 000000000000..d88fd7525bd6 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_get_adaptive_mt_file_sync.py @@ -0,0 +1,52 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for GetAdaptiveMtFile +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_GetAdaptiveMtFile_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_get_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.GetAdaptiveMtFileRequest( + name="name_value", + ) + + # Make the request + response = client.get_adaptive_mt_file(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_GetAdaptiveMtFile_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_import_adaptive_mt_file_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_import_adaptive_mt_file_async.py new file mode 100644 index 000000000000..aa59c25263aa --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_import_adaptive_mt_file_async.py @@ -0,0 +1,58 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for ImportAdaptiveMtFile +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_ImportAdaptiveMtFile_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_import_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + file_input_source = translate_v3.FileInputSource() + file_input_source.mime_type = "mime_type_value" + file_input_source.content = b'content_blob' + file_input_source.display_name = "display_name_value" + + request = translate_v3.ImportAdaptiveMtFileRequest( + file_input_source=file_input_source, + parent="parent_value", + ) + + # Make the request + response = await client.import_adaptive_mt_file(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_ImportAdaptiveMtFile_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_import_adaptive_mt_file_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_import_adaptive_mt_file_sync.py new file mode 100644 index 000000000000..2ef27f75ad6e --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_import_adaptive_mt_file_sync.py @@ -0,0 +1,58 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for ImportAdaptiveMtFile +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_ImportAdaptiveMtFile_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_import_adaptive_mt_file(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + file_input_source = translate_v3.FileInputSource() + file_input_source.mime_type = "mime_type_value" + file_input_source.content = b'content_blob' + file_input_source.display_name = "display_name_value" + + request = translate_v3.ImportAdaptiveMtFileRequest( + file_input_source=file_input_source, + parent="parent_value", + ) + + # Make the request + response = client.import_adaptive_mt_file(request=request) + + # Handle the response + print(response) + +# [END translate_v3_generated_TranslationService_ImportAdaptiveMtFile_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_datasets_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_datasets_async.py new file mode 100644 index 000000000000..08c122ffc40c --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_datasets_async.py @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for ListAdaptiveMtDatasets +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_ListAdaptiveMtDatasets_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_list_adaptive_mt_datasets(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtDatasetsRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_datasets(request=request) + + # Handle the response + async for response in page_result: + print(response) + +# [END translate_v3_generated_TranslationService_ListAdaptiveMtDatasets_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_datasets_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_datasets_sync.py new file mode 100644 index 000000000000..d2855d9da901 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_datasets_sync.py @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for ListAdaptiveMtDatasets +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_ListAdaptiveMtDatasets_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_list_adaptive_mt_datasets(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtDatasetsRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_datasets(request=request) + + # Handle the response + for response in page_result: + print(response) + +# [END translate_v3_generated_TranslationService_ListAdaptiveMtDatasets_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_files_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_files_async.py new file mode 100644 index 000000000000..7831238bf875 --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_files_async.py @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for ListAdaptiveMtFiles +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_ListAdaptiveMtFiles_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_list_adaptive_mt_files(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtFilesRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_files(request=request) + + # Handle the response + async for response in page_result: + print(response) + +# [END translate_v3_generated_TranslationService_ListAdaptiveMtFiles_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_files_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_files_sync.py new file mode 100644 index 000000000000..d526f5d91d5e --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_files_sync.py @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for ListAdaptiveMtFiles +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_ListAdaptiveMtFiles_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_list_adaptive_mt_files(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtFilesRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_files(request=request) + + # Handle the response + for response in page_result: + print(response) + +# [END translate_v3_generated_TranslationService_ListAdaptiveMtFiles_sync] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_sentences_async.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_sentences_async.py new file mode 100644 index 000000000000..ae959c4e0cdb --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_sentences_async.py @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for ListAdaptiveMtSentences +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_ListAdaptiveMtSentences_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +async def sample_list_adaptive_mt_sentences(): + # Create a client + client = translate_v3.TranslationServiceAsyncClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtSentencesRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_sentences(request=request) + + # Handle the response + async for response in page_result: + print(response) + +# [END translate_v3_generated_TranslationService_ListAdaptiveMtSentences_async] diff --git a/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_sentences_sync.py b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_sentences_sync.py new file mode 100644 index 000000000000..223d5c66666b --- /dev/null +++ b/packages/google-cloud-translate/samples/generated_samples/translate_v3_generated_translation_service_list_adaptive_mt_sentences_sync.py @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +# Copyright 2023 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for ListAdaptiveMtSentences +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-translate + + +# [START translate_v3_generated_TranslationService_ListAdaptiveMtSentences_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import translate_v3 + + +def sample_list_adaptive_mt_sentences(): + # Create a client + client = translate_v3.TranslationServiceClient() + + # Initialize request argument(s) + request = translate_v3.ListAdaptiveMtSentencesRequest( + parent="parent_value", + ) + + # Make the request + page_result = client.list_adaptive_mt_sentences(request=request) + + # Handle the response + for response in page_result: + print(response) + +# [END translate_v3_generated_TranslationService_ListAdaptiveMtSentences_sync] diff --git a/packages/google-cloud-translate/scripts/fixup_translate_v3_keywords.py b/packages/google-cloud-translate/scripts/fixup_translate_v3_keywords.py index ef488ce1f7b8..9337f07f0f28 100644 --- a/packages/google-cloud-translate/scripts/fixup_translate_v3_keywords.py +++ b/packages/google-cloud-translate/scripts/fixup_translate_v3_keywords.py @@ -39,13 +39,23 @@ def partition( class translateCallTransformer(cst.CSTTransformer): CTRL_PARAMS: Tuple[str] = ('retry', 'timeout', 'metadata') METHOD_TO_PARAMS: Dict[str, Tuple[str]] = { + 'adaptive_mt_translate': ('parent', 'dataset', 'content', ), 'batch_translate_document': ('parent', 'source_language_code', 'target_language_codes', 'input_configs', 'output_config', 'models', 'glossaries', 'format_conversions', 'customized_attribution', 'enable_shadow_removal_native_pdf', 'enable_rotation_correction', ), 'batch_translate_text': ('parent', 'source_language_code', 'target_language_codes', 'input_configs', 'output_config', 'models', 'glossaries', 'labels', ), + 'create_adaptive_mt_dataset': ('parent', 'adaptive_mt_dataset', ), 'create_glossary': ('parent', 'glossary', ), + 'delete_adaptive_mt_dataset': ('name', ), + 'delete_adaptive_mt_file': ('name', ), 'delete_glossary': ('name', ), 'detect_language': ('parent', 'model', 'content', 'mime_type', 'labels', ), + 'get_adaptive_mt_dataset': ('name', ), + 'get_adaptive_mt_file': ('name', ), 'get_glossary': ('name', ), 'get_supported_languages': ('parent', 'display_language_code', 'model', ), + 'import_adaptive_mt_file': ('parent', 'file_input_source', 'gcs_input_source', ), + 'list_adaptive_mt_datasets': ('parent', 'page_size', 'page_token', 'filter', ), + 'list_adaptive_mt_files': ('parent', 'page_size', 'page_token', ), + 'list_adaptive_mt_sentences': ('parent', 'page_size', 'page_token', ), 'list_glossaries': ('parent', 'page_size', 'page_token', 'filter', ), 'translate_document': ('parent', 'target_language_code', 'document_input_config', 'source_language_code', 'document_output_config', 'model', 'glossary_config', 'labels', 'customized_attribution', 'is_translate_native_pdf_only', 'enable_shadow_removal_native_pdf', 'enable_rotation_correction', ), 'translate_text': ('contents', 'target_language_code', 'parent', 'mime_type', 'source_language_code', 'model', 'glossary_config', 'labels', ), diff --git a/packages/google-cloud-translate/tests/unit/gapic/translate_v3/test_translation_service.py b/packages/google-cloud-translate/tests/unit/gapic/translate_v3/test_translation_service.py index 1e00bc3dd584..5c3a83581afa 100644 --- a/packages/google-cloud-translate/tests/unit/gapic/translate_v3/test_translation_service.py +++ b/packages/google-cloud-translate/tests/unit/gapic/translate_v3/test_translation_service.py @@ -26,14 +26,6 @@ import json import math -import grpc -from grpc.experimental import aio -from proto.marshal.rules import wrappers -from proto.marshal.rules.dates import DurationRule, TimestampRule -import pytest -from requests import PreparedRequest, Request, Response -from requests.sessions import Session - from google.api_core import ( future, gapic_v1, @@ -49,17 +41,25 @@ import google.auth from google.auth import credentials as ga_credentials from google.auth.exceptions import MutualTLSChannelError +from google.longrunning import operations_pb2 # type: ignore +from google.oauth2 import service_account +from google.protobuf import json_format +from google.protobuf import timestamp_pb2 # type: ignore +import grpc +from grpc.experimental import aio +from proto.marshal.rules import wrappers +from proto.marshal.rules.dates import DurationRule, TimestampRule +import pytest +from requests import PreparedRequest, Request, Response +from requests.sessions import Session + from google.cloud.translate_v3.services.translation_service import ( TranslationServiceAsyncClient, TranslationServiceClient, pagers, transports, ) -from google.cloud.translate_v3.types import translation_service -from google.longrunning import operations_pb2 # type: ignore -from google.oauth2 import service_account -from google.protobuf import json_format -from google.protobuf import timestamp_pb2 # type: ignore +from google.cloud.translate_v3.types import adaptive_mt, common, translation_service def client_cert_source_callback(): @@ -3320,191 +3320,6231 @@ async def test_delete_glossary_flattened_error_async(): @pytest.mark.parametrize( "request_type", [ - translation_service.TranslateTextRequest, + adaptive_mt.CreateAdaptiveMtDatasetRequest, dict, ], ) -def test_translate_text_rest(request_type): +def test_create_adaptive_mt_dataset(request_type, transport: str = "grpc"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), - transport="rest", + transport=transport, ) - # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} - request = request_type(**request_init) - - # Mock the http request call within the method and fake a response. - with mock.patch.object(type(client.transport._session), "request") as req: - # Designate an appropriate value for the returned response. - return_value = translation_service.TranslateTextResponse() + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() - # Wrap the value into a proper Response obj - response_value = Response() - response_value.status_code = 200 - # Convert return value to protobuf type - return_value = translation_service.TranslateTextResponse.pb(return_value) - json_return_value = json_format.MessageToJson(return_value) + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.create_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtDataset( + name="name_value", + display_name="display_name_value", + source_language_code="source_language_code_value", + target_language_code="target_language_code_value", + example_count=1396, + ) + response = client.create_adaptive_mt_dataset(request) - response_value._content = json_return_value.encode("UTF-8") - req.return_value = response_value - response = client.translate_text(request) + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.CreateAdaptiveMtDatasetRequest() # Establish that the response is the type that we expect. - assert isinstance(response, translation_service.TranslateTextResponse) + assert isinstance(response, adaptive_mt.AdaptiveMtDataset) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.source_language_code == "source_language_code_value" + assert response.target_language_code == "target_language_code_value" + assert response.example_count == 1396 -def test_translate_text_rest_required_fields( - request_type=translation_service.TranslateTextRequest, -): - transport_class = transports.TranslationServiceRestTransport +def test_create_adaptive_mt_dataset_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) - request_init = {} - request_init["contents"] = "" - request_init["target_language_code"] = "" - request_init["parent"] = "" - request = request_type(**request_init) - pb_request = request_type.pb(request) - jsonified_request = json.loads( - json_format.MessageToJson( - pb_request, - including_default_value_fields=False, - use_integers_for_enums=False, - ) + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.create_adaptive_mt_dataset), "__call__" + ) as call: + client.create_adaptive_mt_dataset() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.CreateAdaptiveMtDatasetRequest() + + +@pytest.mark.asyncio +async def test_create_adaptive_mt_dataset_async( + transport: str = "grpc_asyncio", + request_type=adaptive_mt.CreateAdaptiveMtDatasetRequest, +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, ) - # verify fields with default values are dropped + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() - unset_fields = transport_class( - credentials=ga_credentials.AnonymousCredentials() - ).translate_text._get_unset_required_fields(jsonified_request) - jsonified_request.update(unset_fields) + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.create_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtDataset( + name="name_value", + display_name="display_name_value", + source_language_code="source_language_code_value", + target_language_code="target_language_code_value", + example_count=1396, + ) + ) + response = await client.create_adaptive_mt_dataset(request) - # verify required fields with default values are now present + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.CreateAdaptiveMtDatasetRequest() - jsonified_request["contents"] = "contents_value" - jsonified_request["targetLanguageCode"] = "target_language_code_value" - jsonified_request["parent"] = "parent_value" + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.AdaptiveMtDataset) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.source_language_code == "source_language_code_value" + assert response.target_language_code == "target_language_code_value" + assert response.example_count == 1396 - unset_fields = transport_class( - credentials=ga_credentials.AnonymousCredentials() - ).translate_text._get_unset_required_fields(jsonified_request) - jsonified_request.update(unset_fields) - # verify required fields with non-default values are left alone - assert "contents" in jsonified_request - assert jsonified_request["contents"] == "contents_value" - assert "targetLanguageCode" in jsonified_request - assert jsonified_request["targetLanguageCode"] == "target_language_code_value" - assert "parent" in jsonified_request - assert jsonified_request["parent"] == "parent_value" +@pytest.mark.asyncio +async def test_create_adaptive_mt_dataset_async_from_dict(): + await test_create_adaptive_mt_dataset_async(request_type=dict) + +def test_create_adaptive_mt_dataset_field_headers(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), - transport="rest", ) - request = request_type(**request_init) - - # Designate an appropriate value for the returned response. - return_value = translation_service.TranslateTextResponse() - # Mock the http request call within the method and fake a response. - with mock.patch.object(Session, "request") as req: - # We need to mock transcode() because providing default values - # for required fields will fail the real version if the http_options - # expect actual values for those fields. - with mock.patch.object(path_template, "transcode") as transcode: - # A uri without fields and an empty body will force all the - # request fields to show up in the query_params. - pb_request = request_type.pb(request) - transcode_result = { - "uri": "v1/sample_method", - "method": "post", - "query_params": pb_request, - } - transcode_result["body"] = pb_request - transcode.return_value = transcode_result - response_value = Response() - response_value.status_code = 200 + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.CreateAdaptiveMtDatasetRequest() - # Convert return value to protobuf type - return_value = translation_service.TranslateTextResponse.pb(return_value) - json_return_value = json_format.MessageToJson(return_value) + request.parent = "parent_value" - response_value._content = json_return_value.encode("UTF-8") - req.return_value = response_value + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.create_adaptive_mt_dataset), "__call__" + ) as call: + call.return_value = adaptive_mt.AdaptiveMtDataset() + client.create_adaptive_mt_dataset(request) - response = client.translate_text(request) + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request - expected_params = [("$alt", "json;enum-encoding=int")] - actual_params = req.call_args.kwargs["params"] - assert expected_params == actual_params + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] -def test_translate_text_rest_unset_required_fields(): - transport = transports.TranslationServiceRestTransport( - credentials=ga_credentials.AnonymousCredentials +@pytest.mark.asyncio +async def test_create_adaptive_mt_dataset_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), ) - unset_fields = transport.translate_text._get_unset_required_fields({}) - assert set(unset_fields) == ( - set(()) - & set( - ( - "contents", - "targetLanguageCode", - "parent", - ) + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.CreateAdaptiveMtDatasetRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.create_adaptive_mt_dataset), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtDataset() ) - ) + await client.create_adaptive_mt_dataset(request) + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request -@pytest.mark.parametrize("null_interceptor", [True, False]) -def test_translate_text_rest_interceptors(null_interceptor): - transport = transports.TranslationServiceRestTransport( + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +def test_create_adaptive_mt_dataset_flattened(): + client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), - interceptor=None - if null_interceptor - else transports.TranslationServiceRestInterceptor(), ) - client = TranslationServiceClient(transport=transport) + + # Mock the actual call within the gRPC stub, and fake the request. with mock.patch.object( - type(client.transport._session), "request" - ) as req, mock.patch.object( - path_template, "transcode" - ) as transcode, mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_translate_text" - ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_translate_text" - ) as pre: - pre.assert_not_called() - post.assert_not_called() - pb_message = translation_service.TranslateTextRequest.pb( - translation_service.TranslateTextRequest() + type(client.transport.create_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtDataset() + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.create_adaptive_mt_dataset( + parent="parent_value", + adaptive_mt_dataset=adaptive_mt.AdaptiveMtDataset(name="name_value"), ) - transcode.return_value = { - "method": "post", - "uri": "my_uri", - "body": pb_message, - "query_params": pb_message, - } + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + arg = args[0].adaptive_mt_dataset + mock_val = adaptive_mt.AdaptiveMtDataset(name="name_value") + assert arg == mock_val + + +def test_create_adaptive_mt_dataset_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.create_adaptive_mt_dataset( + adaptive_mt.CreateAdaptiveMtDatasetRequest(), + parent="parent_value", + adaptive_mt_dataset=adaptive_mt.AdaptiveMtDataset(name="name_value"), + ) + + +@pytest.mark.asyncio +async def test_create_adaptive_mt_dataset_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.create_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtDataset() + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtDataset() + ) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.create_adaptive_mt_dataset( + parent="parent_value", + adaptive_mt_dataset=adaptive_mt.AdaptiveMtDataset(name="name_value"), + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + arg = args[0].adaptive_mt_dataset + mock_val = adaptive_mt.AdaptiveMtDataset(name="name_value") + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_create_adaptive_mt_dataset_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.create_adaptive_mt_dataset( + adaptive_mt.CreateAdaptiveMtDatasetRequest(), + parent="parent_value", + adaptive_mt_dataset=adaptive_mt.AdaptiveMtDataset(name="name_value"), + ) + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.DeleteAdaptiveMtDatasetRequest, + dict, + ], +) +def test_delete_adaptive_mt_dataset(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = None + response = client.delete_adaptive_mt_dataset(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.DeleteAdaptiveMtDatasetRequest() + + # Establish that the response is the type that we expect. + assert response is None + + +def test_delete_adaptive_mt_dataset_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_dataset), "__call__" + ) as call: + client.delete_adaptive_mt_dataset() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.DeleteAdaptiveMtDatasetRequest() + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_dataset_async( + transport: str = "grpc_asyncio", + request_type=adaptive_mt.DeleteAdaptiveMtDatasetRequest, +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall(None) + response = await client.delete_adaptive_mt_dataset(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.DeleteAdaptiveMtDatasetRequest() + + # Establish that the response is the type that we expect. + assert response is None + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_dataset_async_from_dict(): + await test_delete_adaptive_mt_dataset_async(request_type=dict) + + +def test_delete_adaptive_mt_dataset_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.DeleteAdaptiveMtDatasetRequest() + + request.name = "name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_dataset), "__call__" + ) as call: + call.return_value = None + client.delete_adaptive_mt_dataset(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "name=name_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_dataset_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.DeleteAdaptiveMtDatasetRequest() + + request.name = "name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_dataset), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall(None) + await client.delete_adaptive_mt_dataset(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "name=name_value", + ) in kw["metadata"] + + +def test_delete_adaptive_mt_dataset_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = None + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.delete_adaptive_mt_dataset( + name="name_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].name + mock_val = "name_value" + assert arg == mock_val + + +def test_delete_adaptive_mt_dataset_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.delete_adaptive_mt_dataset( + adaptive_mt.DeleteAdaptiveMtDatasetRequest(), + name="name_value", + ) + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_dataset_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = None + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall(None) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.delete_adaptive_mt_dataset( + name="name_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].name + mock_val = "name_value" + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_dataset_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.delete_adaptive_mt_dataset( + adaptive_mt.DeleteAdaptiveMtDatasetRequest(), + name="name_value", + ) + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.GetAdaptiveMtDatasetRequest, + dict, + ], +) +def test_get_adaptive_mt_dataset(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtDataset( + name="name_value", + display_name="display_name_value", + source_language_code="source_language_code_value", + target_language_code="target_language_code_value", + example_count=1396, + ) + response = client.get_adaptive_mt_dataset(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.GetAdaptiveMtDatasetRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.AdaptiveMtDataset) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.source_language_code == "source_language_code_value" + assert response.target_language_code == "target_language_code_value" + assert response.example_count == 1396 + + +def test_get_adaptive_mt_dataset_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_dataset), "__call__" + ) as call: + client.get_adaptive_mt_dataset() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.GetAdaptiveMtDatasetRequest() + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_dataset_async( + transport: str = "grpc_asyncio", + request_type=adaptive_mt.GetAdaptiveMtDatasetRequest, +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtDataset( + name="name_value", + display_name="display_name_value", + source_language_code="source_language_code_value", + target_language_code="target_language_code_value", + example_count=1396, + ) + ) + response = await client.get_adaptive_mt_dataset(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.GetAdaptiveMtDatasetRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.AdaptiveMtDataset) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.source_language_code == "source_language_code_value" + assert response.target_language_code == "target_language_code_value" + assert response.example_count == 1396 + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_dataset_async_from_dict(): + await test_get_adaptive_mt_dataset_async(request_type=dict) + + +def test_get_adaptive_mt_dataset_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.GetAdaptiveMtDatasetRequest() + + request.name = "name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_dataset), "__call__" + ) as call: + call.return_value = adaptive_mt.AdaptiveMtDataset() + client.get_adaptive_mt_dataset(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "name=name_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_dataset_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.GetAdaptiveMtDatasetRequest() + + request.name = "name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_dataset), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtDataset() + ) + await client.get_adaptive_mt_dataset(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "name=name_value", + ) in kw["metadata"] + + +def test_get_adaptive_mt_dataset_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtDataset() + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.get_adaptive_mt_dataset( + name="name_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].name + mock_val = "name_value" + assert arg == mock_val + + +def test_get_adaptive_mt_dataset_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.get_adaptive_mt_dataset( + adaptive_mt.GetAdaptiveMtDatasetRequest(), + name="name_value", + ) + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_dataset_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_dataset), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtDataset() + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtDataset() + ) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.get_adaptive_mt_dataset( + name="name_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].name + mock_val = "name_value" + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_dataset_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.get_adaptive_mt_dataset( + adaptive_mt.GetAdaptiveMtDatasetRequest(), + name="name_value", + ) + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.ListAdaptiveMtDatasetsRequest, + dict, + ], +) +def test_list_adaptive_mt_datasets(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse( + next_page_token="next_page_token_value", + ) + response = client.list_adaptive_mt_datasets(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtDatasetsRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.ListAdaptiveMtDatasetsPager) + assert response.next_page_token == "next_page_token_value" + + +def test_list_adaptive_mt_datasets_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + client.list_adaptive_mt_datasets() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtDatasetsRequest() + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_datasets_async( + transport: str = "grpc_asyncio", + request_type=adaptive_mt.ListAdaptiveMtDatasetsRequest, +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtDatasetsResponse( + next_page_token="next_page_token_value", + ) + ) + response = await client.list_adaptive_mt_datasets(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtDatasetsRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.ListAdaptiveMtDatasetsAsyncPager) + assert response.next_page_token == "next_page_token_value" + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_datasets_async_from_dict(): + await test_list_adaptive_mt_datasets_async(request_type=dict) + + +def test_list_adaptive_mt_datasets_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.ListAdaptiveMtDatasetsRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + call.return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse() + client.list_adaptive_mt_datasets(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_datasets_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.ListAdaptiveMtDatasetsRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtDatasetsResponse() + ) + await client.list_adaptive_mt_datasets(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +def test_list_adaptive_mt_datasets_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse() + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.list_adaptive_mt_datasets( + parent="parent_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + + +def test_list_adaptive_mt_datasets_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.list_adaptive_mt_datasets( + adaptive_mt.ListAdaptiveMtDatasetsRequest(), + parent="parent_value", + ) + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_datasets_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse() + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtDatasetsResponse() + ) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.list_adaptive_mt_datasets( + parent="parent_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_datasets_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.list_adaptive_mt_datasets( + adaptive_mt.ListAdaptiveMtDatasetsRequest(), + parent="parent_value", + ) + + +def test_list_adaptive_mt_datasets_pager(transport_name: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials, + transport=transport_name, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + ), + RuntimeError, + ) + + metadata = () + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", ""),)), + ) + pager = client.list_adaptive_mt_datasets(request={}) + + assert pager._metadata == metadata + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtDataset) for i in results) + + +def test_list_adaptive_mt_datasets_pages(transport_name: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials, + transport=transport_name, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), "__call__" + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + ), + RuntimeError, + ) + pages = list(client.list_adaptive_mt_datasets(request={}).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_datasets_async_pager(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), + "__call__", + new_callable=mock.AsyncMock, + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + ), + RuntimeError, + ) + async_pager = await client.list_adaptive_mt_datasets( + request={}, + ) + assert async_pager.next_page_token == "abc" + responses = [] + async for response in async_pager: # pragma: no branch + responses.append(response) + + assert len(responses) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtDataset) for i in responses) + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_datasets_async_pages(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_datasets), + "__call__", + new_callable=mock.AsyncMock, + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + ), + RuntimeError, + ) + pages = [] + # Workaround issue in python 3.9 related to code coverage by adding `# pragma: no branch` + # See https://github.com/googleapis/gapic-generator-python/pull/1174#issuecomment-1025132372 + async for page_ in ( # pragma: no branch + await client.list_adaptive_mt_datasets(request={}) + ).pages: + pages.append(page_) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.AdaptiveMtTranslateRequest, + dict, + ], +) +def test_adaptive_mt_translate(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.adaptive_mt_translate), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtTranslateResponse( + language_code="language_code_value", + ) + response = client.adaptive_mt_translate(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.AdaptiveMtTranslateRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.AdaptiveMtTranslateResponse) + assert response.language_code == "language_code_value" + + +def test_adaptive_mt_translate_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.adaptive_mt_translate), "__call__" + ) as call: + client.adaptive_mt_translate() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.AdaptiveMtTranslateRequest() + + +@pytest.mark.asyncio +async def test_adaptive_mt_translate_async( + transport: str = "grpc_asyncio", request_type=adaptive_mt.AdaptiveMtTranslateRequest +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.adaptive_mt_translate), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtTranslateResponse( + language_code="language_code_value", + ) + ) + response = await client.adaptive_mt_translate(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.AdaptiveMtTranslateRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.AdaptiveMtTranslateResponse) + assert response.language_code == "language_code_value" + + +@pytest.mark.asyncio +async def test_adaptive_mt_translate_async_from_dict(): + await test_adaptive_mt_translate_async(request_type=dict) + + +def test_adaptive_mt_translate_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.AdaptiveMtTranslateRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.adaptive_mt_translate), "__call__" + ) as call: + call.return_value = adaptive_mt.AdaptiveMtTranslateResponse() + client.adaptive_mt_translate(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_adaptive_mt_translate_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.AdaptiveMtTranslateRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.adaptive_mt_translate), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtTranslateResponse() + ) + await client.adaptive_mt_translate(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +def test_adaptive_mt_translate_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.adaptive_mt_translate), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtTranslateResponse() + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.adaptive_mt_translate( + parent="parent_value", + content=["content_value"], + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + arg = args[0].content + mock_val = ["content_value"] + assert arg == mock_val + + +def test_adaptive_mt_translate_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.adaptive_mt_translate( + adaptive_mt.AdaptiveMtTranslateRequest(), + parent="parent_value", + content=["content_value"], + ) + + +@pytest.mark.asyncio +async def test_adaptive_mt_translate_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.adaptive_mt_translate), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtTranslateResponse() + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtTranslateResponse() + ) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.adaptive_mt_translate( + parent="parent_value", + content=["content_value"], + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + arg = args[0].content + mock_val = ["content_value"] + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_adaptive_mt_translate_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.adaptive_mt_translate( + adaptive_mt.AdaptiveMtTranslateRequest(), + parent="parent_value", + content=["content_value"], + ) + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.GetAdaptiveMtFileRequest, + dict, + ], +) +def test_get_adaptive_mt_file(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtFile( + name="name_value", + display_name="display_name_value", + entry_count=1210, + ) + response = client.get_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.GetAdaptiveMtFileRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.AdaptiveMtFile) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.entry_count == 1210 + + +def test_get_adaptive_mt_file_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_file), "__call__" + ) as call: + client.get_adaptive_mt_file() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.GetAdaptiveMtFileRequest() + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_file_async( + transport: str = "grpc_asyncio", request_type=adaptive_mt.GetAdaptiveMtFileRequest +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtFile( + name="name_value", + display_name="display_name_value", + entry_count=1210, + ) + ) + response = await client.get_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.GetAdaptiveMtFileRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.AdaptiveMtFile) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.entry_count == 1210 + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_file_async_from_dict(): + await test_get_adaptive_mt_file_async(request_type=dict) + + +def test_get_adaptive_mt_file_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.GetAdaptiveMtFileRequest() + + request.name = "name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_file), "__call__" + ) as call: + call.return_value = adaptive_mt.AdaptiveMtFile() + client.get_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "name=name_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_file_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.GetAdaptiveMtFileRequest() + + request.name = "name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_file), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtFile() + ) + await client.get_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "name=name_value", + ) in kw["metadata"] + + +def test_get_adaptive_mt_file_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtFile() + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.get_adaptive_mt_file( + name="name_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].name + mock_val = "name_value" + assert arg == mock_val + + +def test_get_adaptive_mt_file_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.get_adaptive_mt_file( + adaptive_mt.GetAdaptiveMtFileRequest(), + name="name_value", + ) + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_file_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.get_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.AdaptiveMtFile() + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.AdaptiveMtFile() + ) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.get_adaptive_mt_file( + name="name_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].name + mock_val = "name_value" + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_get_adaptive_mt_file_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.get_adaptive_mt_file( + adaptive_mt.GetAdaptiveMtFileRequest(), + name="name_value", + ) + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.DeleteAdaptiveMtFileRequest, + dict, + ], +) +def test_delete_adaptive_mt_file(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = None + response = client.delete_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.DeleteAdaptiveMtFileRequest() + + # Establish that the response is the type that we expect. + assert response is None + + +def test_delete_adaptive_mt_file_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_file), "__call__" + ) as call: + client.delete_adaptive_mt_file() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.DeleteAdaptiveMtFileRequest() + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_file_async( + transport: str = "grpc_asyncio", + request_type=adaptive_mt.DeleteAdaptiveMtFileRequest, +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall(None) + response = await client.delete_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.DeleteAdaptiveMtFileRequest() + + # Establish that the response is the type that we expect. + assert response is None + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_file_async_from_dict(): + await test_delete_adaptive_mt_file_async(request_type=dict) + + +def test_delete_adaptive_mt_file_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.DeleteAdaptiveMtFileRequest() + + request.name = "name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_file), "__call__" + ) as call: + call.return_value = None + client.delete_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "name=name_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_file_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.DeleteAdaptiveMtFileRequest() + + request.name = "name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_file), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall(None) + await client.delete_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "name=name_value", + ) in kw["metadata"] + + +def test_delete_adaptive_mt_file_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = None + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.delete_adaptive_mt_file( + name="name_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].name + mock_val = "name_value" + assert arg == mock_val + + +def test_delete_adaptive_mt_file_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.delete_adaptive_mt_file( + adaptive_mt.DeleteAdaptiveMtFileRequest(), + name="name_value", + ) + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_file_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = None + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall(None) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.delete_adaptive_mt_file( + name="name_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].name + mock_val = "name_value" + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_delete_adaptive_mt_file_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.delete_adaptive_mt_file( + adaptive_mt.DeleteAdaptiveMtFileRequest(), + name="name_value", + ) + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.ImportAdaptiveMtFileRequest, + dict, + ], +) +def test_import_adaptive_mt_file(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.import_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ImportAdaptiveMtFileResponse() + response = client.import_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ImportAdaptiveMtFileRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.ImportAdaptiveMtFileResponse) + + +def test_import_adaptive_mt_file_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.import_adaptive_mt_file), "__call__" + ) as call: + client.import_adaptive_mt_file() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ImportAdaptiveMtFileRequest() + + +@pytest.mark.asyncio +async def test_import_adaptive_mt_file_async( + transport: str = "grpc_asyncio", + request_type=adaptive_mt.ImportAdaptiveMtFileRequest, +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.import_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ImportAdaptiveMtFileResponse() + ) + response = await client.import_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ImportAdaptiveMtFileRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.ImportAdaptiveMtFileResponse) + + +@pytest.mark.asyncio +async def test_import_adaptive_mt_file_async_from_dict(): + await test_import_adaptive_mt_file_async(request_type=dict) + + +def test_import_adaptive_mt_file_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.ImportAdaptiveMtFileRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.import_adaptive_mt_file), "__call__" + ) as call: + call.return_value = adaptive_mt.ImportAdaptiveMtFileResponse() + client.import_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_import_adaptive_mt_file_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.ImportAdaptiveMtFileRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.import_adaptive_mt_file), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ImportAdaptiveMtFileResponse() + ) + await client.import_adaptive_mt_file(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +def test_import_adaptive_mt_file_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.import_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ImportAdaptiveMtFileResponse() + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.import_adaptive_mt_file( + parent="parent_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + + +def test_import_adaptive_mt_file_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.import_adaptive_mt_file( + adaptive_mt.ImportAdaptiveMtFileRequest(), + parent="parent_value", + ) + + +@pytest.mark.asyncio +async def test_import_adaptive_mt_file_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.import_adaptive_mt_file), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ImportAdaptiveMtFileResponse() + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ImportAdaptiveMtFileResponse() + ) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.import_adaptive_mt_file( + parent="parent_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_import_adaptive_mt_file_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.import_adaptive_mt_file( + adaptive_mt.ImportAdaptiveMtFileRequest(), + parent="parent_value", + ) + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.ListAdaptiveMtFilesRequest, + dict, + ], +) +def test_list_adaptive_mt_files(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtFilesResponse( + next_page_token="next_page_token_value", + ) + response = client.list_adaptive_mt_files(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtFilesRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.ListAdaptiveMtFilesPager) + assert response.next_page_token == "next_page_token_value" + + +def test_list_adaptive_mt_files_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + client.list_adaptive_mt_files() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtFilesRequest() + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_files_async( + transport: str = "grpc_asyncio", request_type=adaptive_mt.ListAdaptiveMtFilesRequest +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtFilesResponse( + next_page_token="next_page_token_value", + ) + ) + response = await client.list_adaptive_mt_files(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtFilesRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.ListAdaptiveMtFilesAsyncPager) + assert response.next_page_token == "next_page_token_value" + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_files_async_from_dict(): + await test_list_adaptive_mt_files_async(request_type=dict) + + +def test_list_adaptive_mt_files_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.ListAdaptiveMtFilesRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + call.return_value = adaptive_mt.ListAdaptiveMtFilesResponse() + client.list_adaptive_mt_files(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_files_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.ListAdaptiveMtFilesRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtFilesResponse() + ) + await client.list_adaptive_mt_files(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +def test_list_adaptive_mt_files_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtFilesResponse() + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.list_adaptive_mt_files( + parent="parent_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + + +def test_list_adaptive_mt_files_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.list_adaptive_mt_files( + adaptive_mt.ListAdaptiveMtFilesRequest(), + parent="parent_value", + ) + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_files_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtFilesResponse() + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtFilesResponse() + ) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.list_adaptive_mt_files( + parent="parent_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_files_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.list_adaptive_mt_files( + adaptive_mt.ListAdaptiveMtFilesRequest(), + parent="parent_value", + ) + + +def test_list_adaptive_mt_files_pager(transport_name: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials, + transport=transport_name, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + ), + RuntimeError, + ) + + metadata = () + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", ""),)), + ) + pager = client.list_adaptive_mt_files(request={}) + + assert pager._metadata == metadata + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtFile) for i in results) + + +def test_list_adaptive_mt_files_pages(transport_name: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials, + transport=transport_name, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), "__call__" + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + ), + RuntimeError, + ) + pages = list(client.list_adaptive_mt_files(request={}).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_files_async_pager(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), + "__call__", + new_callable=mock.AsyncMock, + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + ), + RuntimeError, + ) + async_pager = await client.list_adaptive_mt_files( + request={}, + ) + assert async_pager.next_page_token == "abc" + responses = [] + async for response in async_pager: # pragma: no branch + responses.append(response) + + assert len(responses) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtFile) for i in responses) + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_files_async_pages(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_files), + "__call__", + new_callable=mock.AsyncMock, + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + ), + RuntimeError, + ) + pages = [] + # Workaround issue in python 3.9 related to code coverage by adding `# pragma: no branch` + # See https://github.com/googleapis/gapic-generator-python/pull/1174#issuecomment-1025132372 + async for page_ in ( # pragma: no branch + await client.list_adaptive_mt_files(request={}) + ).pages: + pages.append(page_) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.ListAdaptiveMtSentencesRequest, + dict, + ], +) +def test_list_adaptive_mt_sentences(request_type, transport: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtSentencesResponse( + next_page_token="next_page_token_value", + ) + response = client.list_adaptive_mt_sentences(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtSentencesRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.ListAdaptiveMtSentencesPager) + assert response.next_page_token == "next_page_token_value" + + +def test_list_adaptive_mt_sentences_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + client.list_adaptive_mt_sentences() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtSentencesRequest() + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_sentences_async( + transport: str = "grpc_asyncio", + request_type=adaptive_mt.ListAdaptiveMtSentencesRequest, +): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtSentencesResponse( + next_page_token="next_page_token_value", + ) + ) + response = await client.list_adaptive_mt_sentences(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == adaptive_mt.ListAdaptiveMtSentencesRequest() + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.ListAdaptiveMtSentencesAsyncPager) + assert response.next_page_token == "next_page_token_value" + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_sentences_async_from_dict(): + await test_list_adaptive_mt_sentences_async(request_type=dict) + + +def test_list_adaptive_mt_sentences_field_headers(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.ListAdaptiveMtSentencesRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + call.return_value = adaptive_mt.ListAdaptiveMtSentencesResponse() + client.list_adaptive_mt_sentences(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_sentences_field_headers_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = adaptive_mt.ListAdaptiveMtSentencesRequest() + + request.parent = "parent_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtSentencesResponse() + ) + await client.list_adaptive_mt_sentences(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "parent=parent_value", + ) in kw["metadata"] + + +def test_list_adaptive_mt_sentences_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtSentencesResponse() + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + client.list_adaptive_mt_sentences( + parent="parent_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + + +def test_list_adaptive_mt_sentences_flattened_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.list_adaptive_mt_sentences( + adaptive_mt.ListAdaptiveMtSentencesRequest(), + parent="parent_value", + ) + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_sentences_flattened_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = adaptive_mt.ListAdaptiveMtSentencesResponse() + + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( + adaptive_mt.ListAdaptiveMtSentencesResponse() + ) + # Call the method with a truthy value for each flattened field, + # using the keyword arguments to the method. + response = await client.list_adaptive_mt_sentences( + parent="parent_value", + ) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + arg = args[0].parent + mock_val = "parent_value" + assert arg == mock_val + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_sentences_flattened_error_async(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + await client.list_adaptive_mt_sentences( + adaptive_mt.ListAdaptiveMtSentencesRequest(), + parent="parent_value", + ) + + +def test_list_adaptive_mt_sentences_pager(transport_name: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials, + transport=transport_name, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + ), + RuntimeError, + ) + + metadata = () + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("parent", ""),)), + ) + pager = client.list_adaptive_mt_sentences(request={}) + + assert pager._metadata == metadata + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtSentence) for i in results) + + +def test_list_adaptive_mt_sentences_pages(transport_name: str = "grpc"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials, + transport=transport_name, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), "__call__" + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + ), + RuntimeError, + ) + pages = list(client.list_adaptive_mt_sentences(request={}).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_sentences_async_pager(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), + "__call__", + new_callable=mock.AsyncMock, + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + ), + RuntimeError, + ) + async_pager = await client.list_adaptive_mt_sentences( + request={}, + ) + assert async_pager.next_page_token == "abc" + responses = [] + async for response in async_pager: # pragma: no branch + responses.append(response) + + assert len(responses) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtSentence) for i in responses) + + +@pytest.mark.asyncio +async def test_list_adaptive_mt_sentences_async_pages(): + client = TranslationServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials, + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.list_adaptive_mt_sentences), + "__call__", + new_callable=mock.AsyncMock, + ) as call: + # Set the response to a series of pages. + call.side_effect = ( + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + ), + RuntimeError, + ) + pages = [] + # Workaround issue in python 3.9 related to code coverage by adding `# pragma: no branch` + # See https://github.com/googleapis/gapic-generator-python/pull/1174#issuecomment-1025132372 + async for page_ in ( # pragma: no branch + await client.list_adaptive_mt_sentences(request={}) + ).pages: + pages.append(page_) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.TranslateTextRequest, + dict, + ], +) +def test_translate_text_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.TranslateTextResponse() + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.TranslateTextResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.translate_text(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, translation_service.TranslateTextResponse) + + +def test_translate_text_rest_required_fields( + request_type=translation_service.TranslateTextRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["contents"] = "" + request_init["target_language_code"] = "" + request_init["parent"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).translate_text._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["contents"] = "contents_value" + jsonified_request["targetLanguageCode"] = "target_language_code_value" + jsonified_request["parent"] = "parent_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).translate_text._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "contents" in jsonified_request + assert jsonified_request["contents"] == "contents_value" + assert "targetLanguageCode" in jsonified_request + assert jsonified_request["targetLanguageCode"] == "target_language_code_value" + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = translation_service.TranslateTextResponse() + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "post", + "query_params": pb_request, + } + transcode_result["body"] = pb_request + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = translation_service.TranslateTextResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.translate_text(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_translate_text_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.translate_text._get_unset_required_fields({}) + assert set(unset_fields) == ( + set(()) + & set( + ( + "contents", + "targetLanguageCode", + "parent", + ) + ) + ) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_translate_text_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_translate_text" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_translate_text" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.TranslateTextRequest.pb( + translation_service.TranslateTextRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = translation_service.TranslateTextResponse.to_json( + translation_service.TranslateTextResponse() + ) + + request = translation_service.TranslateTextRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = translation_service.TranslateTextResponse() + + client.translate_text( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_translate_text_rest_bad_request( + transport: str = "rest", request_type=translation_service.TranslateTextRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.translate_text(request) + + +def test_translate_text_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.TranslateTextResponse() + + # get arguments that satisfy an http rule for this method + sample_request = {"parent": "projects/sample1/locations/sample2"} + + # get truthy value for each flattened field + mock_args = dict( + parent="parent_value", + target_language_code="target_language_code_value", + contents=["contents_value"], + model="model_value", + mime_type="mime_type_value", + source_language_code="source_language_code_value", + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.TranslateTextResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.translate_text(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{parent=projects/*/locations/*}:translateText" + % client.transport._host, + args[1], + ) + + +def test_translate_text_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.translate_text( + translation_service.TranslateTextRequest(), + parent="parent_value", + target_language_code="target_language_code_value", + contents=["contents_value"], + model="model_value", + mime_type="mime_type_value", + source_language_code="source_language_code_value", + ) + + +def test_translate_text_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.DetectLanguageRequest, + dict, + ], +) +def test_detect_language_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.DetectLanguageResponse() + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.DetectLanguageResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.detect_language(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, translation_service.DetectLanguageResponse) + + +def test_detect_language_rest_required_fields( + request_type=translation_service.DetectLanguageRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["parent"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).detect_language._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["parent"] = "parent_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).detect_language._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = translation_service.DetectLanguageResponse() + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "post", + "query_params": pb_request, + } + transcode_result["body"] = pb_request + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = translation_service.DetectLanguageResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.detect_language(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_detect_language_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.detect_language._get_unset_required_fields({}) + assert set(unset_fields) == (set(()) & set(("parent",))) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_detect_language_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_detect_language" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_detect_language" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.DetectLanguageRequest.pb( + translation_service.DetectLanguageRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = translation_service.DetectLanguageResponse.to_json( + translation_service.DetectLanguageResponse() + ) + + request = translation_service.DetectLanguageRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = translation_service.DetectLanguageResponse() + + client.detect_language( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_detect_language_rest_bad_request( + transport: str = "rest", request_type=translation_service.DetectLanguageRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.detect_language(request) + + +def test_detect_language_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.DetectLanguageResponse() + + # get arguments that satisfy an http rule for this method + sample_request = {"parent": "projects/sample1/locations/sample2"} + + # get truthy value for each flattened field + mock_args = dict( + parent="parent_value", + model="model_value", + mime_type="mime_type_value", + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.DetectLanguageResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.detect_language(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{parent=projects/*/locations/*}:detectLanguage" + % client.transport._host, + args[1], + ) + + +def test_detect_language_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.detect_language( + translation_service.DetectLanguageRequest(), + parent="parent_value", + model="model_value", + mime_type="mime_type_value", + content="content_value", + ) + + +def test_detect_language_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.GetSupportedLanguagesRequest, + dict, + ], +) +def test_get_supported_languages_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.SupportedLanguages() + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.SupportedLanguages.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.get_supported_languages(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, translation_service.SupportedLanguages) + + +def test_get_supported_languages_rest_required_fields( + request_type=translation_service.GetSupportedLanguagesRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["parent"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).get_supported_languages._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["parent"] = "parent_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).get_supported_languages._get_unset_required_fields(jsonified_request) + # Check that path parameters and body parameters are not mixing in. + assert not set(unset_fields) - set( + ( + "display_language_code", + "model", + ) + ) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = translation_service.SupportedLanguages() + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "get", + "query_params": pb_request, + } + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = translation_service.SupportedLanguages.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.get_supported_languages(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_get_supported_languages_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.get_supported_languages._get_unset_required_fields({}) + assert set(unset_fields) == ( + set( + ( + "displayLanguageCode", + "model", + ) + ) + & set(("parent",)) + ) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_get_supported_languages_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_get_supported_languages" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_get_supported_languages" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.GetSupportedLanguagesRequest.pb( + translation_service.GetSupportedLanguagesRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = translation_service.SupportedLanguages.to_json( + translation_service.SupportedLanguages() + ) + + request = translation_service.GetSupportedLanguagesRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = translation_service.SupportedLanguages() + + client.get_supported_languages( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_get_supported_languages_rest_bad_request( + transport: str = "rest", + request_type=translation_service.GetSupportedLanguagesRequest, +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.get_supported_languages(request) + + +def test_get_supported_languages_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.SupportedLanguages() + + # get arguments that satisfy an http rule for this method + sample_request = {"parent": "projects/sample1/locations/sample2"} + + # get truthy value for each flattened field + mock_args = dict( + parent="parent_value", + model="model_value", + display_language_code="display_language_code_value", + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.SupportedLanguages.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.get_supported_languages(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{parent=projects/*/locations/*}/supportedLanguages" + % client.transport._host, + args[1], + ) + + +def test_get_supported_languages_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.get_supported_languages( + translation_service.GetSupportedLanguagesRequest(), + parent="parent_value", + model="model_value", + display_language_code="display_language_code_value", + ) + + +def test_get_supported_languages_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.TranslateDocumentRequest, + dict, + ], +) +def test_translate_document_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.TranslateDocumentResponse( + model="model_value", + ) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.TranslateDocumentResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.translate_document(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, translation_service.TranslateDocumentResponse) + assert response.model == "model_value" + + +def test_translate_document_rest_required_fields( + request_type=translation_service.TranslateDocumentRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["parent"] = "" + request_init["target_language_code"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).translate_document._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["parent"] = "parent_value" + jsonified_request["targetLanguageCode"] = "target_language_code_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).translate_document._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + assert "targetLanguageCode" in jsonified_request + assert jsonified_request["targetLanguageCode"] == "target_language_code_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = translation_service.TranslateDocumentResponse() + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "post", + "query_params": pb_request, + } + transcode_result["body"] = pb_request + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = translation_service.TranslateDocumentResponse.pb( + return_value + ) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.translate_document(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_translate_document_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.translate_document._get_unset_required_fields({}) + assert set(unset_fields) == ( + set(()) + & set( + ( + "parent", + "targetLanguageCode", + "documentInputConfig", + ) + ) + ) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_translate_document_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_translate_document" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_translate_document" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.TranslateDocumentRequest.pb( + translation_service.TranslateDocumentRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = ( + translation_service.TranslateDocumentResponse.to_json( + translation_service.TranslateDocumentResponse() + ) + ) + + request = translation_service.TranslateDocumentRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = translation_service.TranslateDocumentResponse() + + client.translate_document( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_translate_document_rest_bad_request( + transport: str = "rest", request_type=translation_service.TranslateDocumentRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.translate_document(request) + + +def test_translate_document_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.BatchTranslateTextRequest, + dict, + ], +) +def test_batch_translate_text_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.batch_translate_text(request) + + # Establish that the response is the type that we expect. + assert response.operation.name == "operations/spam" + + +def test_batch_translate_text_rest_required_fields( + request_type=translation_service.BatchTranslateTextRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["parent"] = "" + request_init["source_language_code"] = "" + request_init["target_language_codes"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).batch_translate_text._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["parent"] = "parent_value" + jsonified_request["sourceLanguageCode"] = "source_language_code_value" + jsonified_request["targetLanguageCodes"] = "target_language_codes_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).batch_translate_text._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + assert "sourceLanguageCode" in jsonified_request + assert jsonified_request["sourceLanguageCode"] == "source_language_code_value" + assert "targetLanguageCodes" in jsonified_request + assert jsonified_request["targetLanguageCodes"] == "target_language_codes_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "post", + "query_params": pb_request, + } + transcode_result["body"] = pb_request + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.batch_translate_text(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_batch_translate_text_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.batch_translate_text._get_unset_required_fields({}) + assert set(unset_fields) == ( + set(()) + & set( + ( + "parent", + "sourceLanguageCode", + "targetLanguageCodes", + "inputConfigs", + "outputConfig", + ) + ) + ) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_batch_translate_text_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + operation.Operation, "_set_result_from_operation" + ), mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_batch_translate_text" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_batch_translate_text" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.BatchTranslateTextRequest.pb( + translation_service.BatchTranslateTextRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = json_format.MessageToJson( + operations_pb2.Operation() + ) + + request = translation_service.BatchTranslateTextRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = operations_pb2.Operation() + + client.batch_translate_text( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_batch_translate_text_rest_bad_request( + transport: str = "rest", request_type=translation_service.BatchTranslateTextRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.batch_translate_text(request) + + +def test_batch_translate_text_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.BatchTranslateDocumentRequest, + dict, + ], +) +def test_batch_translate_document_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.batch_translate_document(request) + + # Establish that the response is the type that we expect. + assert response.operation.name == "operations/spam" + + +def test_batch_translate_document_rest_required_fields( + request_type=translation_service.BatchTranslateDocumentRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["parent"] = "" + request_init["source_language_code"] = "" + request_init["target_language_codes"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).batch_translate_document._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["parent"] = "parent_value" + jsonified_request["sourceLanguageCode"] = "source_language_code_value" + jsonified_request["targetLanguageCodes"] = "target_language_codes_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).batch_translate_document._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + assert "sourceLanguageCode" in jsonified_request + assert jsonified_request["sourceLanguageCode"] == "source_language_code_value" + assert "targetLanguageCodes" in jsonified_request + assert jsonified_request["targetLanguageCodes"] == "target_language_codes_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "post", + "query_params": pb_request, + } + transcode_result["body"] = pb_request + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.batch_translate_document(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_batch_translate_document_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.batch_translate_document._get_unset_required_fields({}) + assert set(unset_fields) == ( + set(()) + & set( + ( + "parent", + "sourceLanguageCode", + "targetLanguageCodes", + "inputConfigs", + "outputConfig", + ) + ) + ) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_batch_translate_document_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + operation.Operation, "_set_result_from_operation" + ), mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_batch_translate_document" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_batch_translate_document" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.BatchTranslateDocumentRequest.pb( + translation_service.BatchTranslateDocumentRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = json_format.MessageToJson( + operations_pb2.Operation() + ) + + request = translation_service.BatchTranslateDocumentRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = operations_pb2.Operation() + + client.batch_translate_document( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_batch_translate_document_rest_bad_request( + transport: str = "rest", + request_type=translation_service.BatchTranslateDocumentRequest, +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.batch_translate_document(request) + + +def test_batch_translate_document_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + + # get arguments that satisfy an http rule for this method + sample_request = {"parent": "projects/sample1/locations/sample2"} + + # get truthy value for each flattened field + mock_args = dict( + parent="parent_value", + source_language_code="source_language_code_value", + target_language_codes=["target_language_codes_value"], + input_configs=[ + translation_service.BatchDocumentInputConfig( + gcs_source=translation_service.GcsSource( + input_uri="input_uri_value" + ) + ) + ], + output_config=translation_service.BatchDocumentOutputConfig( + gcs_destination=translation_service.GcsDestination( + output_uri_prefix="output_uri_prefix_value" + ) + ), + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.batch_translate_document(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{parent=projects/*/locations/*}:batchTranslateDocument" + % client.transport._host, + args[1], + ) + + +def test_batch_translate_document_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.batch_translate_document( + translation_service.BatchTranslateDocumentRequest(), + parent="parent_value", + source_language_code="source_language_code_value", + target_language_codes=["target_language_codes_value"], + input_configs=[ + translation_service.BatchDocumentInputConfig( + gcs_source=translation_service.GcsSource( + input_uri="input_uri_value" + ) + ) + ], + output_config=translation_service.BatchDocumentOutputConfig( + gcs_destination=translation_service.GcsDestination( + output_uri_prefix="output_uri_prefix_value" + ) + ), + ) + + +def test_batch_translate_document_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.CreateGlossaryRequest, + dict, + ], +) +def test_create_glossary_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request_init["glossary"] = { + "name": "name_value", + "language_pair": { + "source_language_code": "source_language_code_value", + "target_language_code": "target_language_code_value", + }, + "language_codes_set": { + "language_codes": ["language_codes_value1", "language_codes_value2"] + }, + "input_config": {"gcs_source": {"input_uri": "input_uri_value"}}, + "entry_count": 1210, + "submit_time": {"seconds": 751, "nanos": 543}, + "end_time": {}, + "display_name": "display_name_value", + } + # The version of a generated dependency at test runtime may differ from the version used during generation. + # Delete any fields which are not present in the current runtime dependency + # See https://github.com/googleapis/gapic-generator-python/issues/1748 + + # Determine if the message type is proto-plus or protobuf + test_field = translation_service.CreateGlossaryRequest.meta.fields["glossary"] + + def get_message_fields(field): + # Given a field which is a message (composite type), return a list with + # all the fields of the message. + # If the field is not a composite type, return an empty list. + message_fields = [] + + if hasattr(field, "message") and field.message: + is_field_type_proto_plus_type = not hasattr(field.message, "DESCRIPTOR") + + if is_field_type_proto_plus_type: + message_fields = field.message.meta.fields.values() + # Add `# pragma: NO COVER` because there may not be any `*_pb2` field types + else: # pragma: NO COVER + message_fields = field.message.DESCRIPTOR.fields + return message_fields + + runtime_nested_fields = [ + (field.name, nested_field.name) + for field in get_message_fields(test_field) + for nested_field in get_message_fields(field) + ] + + subfields_not_in_runtime = [] + + # For each item in the sample request, create a list of sub fields which are not present at runtime + # Add `# pragma: NO COVER` because this test code will not run if all subfields are present at runtime + for field, value in request_init["glossary"].items(): # pragma: NO COVER + result = None + is_repeated = False + # For repeated fields + if isinstance(value, list) and len(value): + is_repeated = True + result = value[0] + # For fields where the type is another message + if isinstance(value, dict): + result = value + + if result and hasattr(result, "keys"): + for subfield in result.keys(): + if (field, subfield) not in runtime_nested_fields: + subfields_not_in_runtime.append( + { + "field": field, + "subfield": subfield, + "is_repeated": is_repeated, + } + ) + + # Remove fields from the sample request which are not present in the runtime version of the dependency + # Add `# pragma: NO COVER` because this test code will not run if all subfields are present at runtime + for subfield_to_delete in subfields_not_in_runtime: # pragma: NO COVER + field = subfield_to_delete.get("field") + field_repeated = subfield_to_delete.get("is_repeated") + subfield = subfield_to_delete.get("subfield") + if subfield: + if field_repeated: + for i in range(0, len(request_init["glossary"][field])): + del request_init["glossary"][field][i][subfield] + else: + del request_init["glossary"][field][subfield] + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.create_glossary(request) + + # Establish that the response is the type that we expect. + assert response.operation.name == "operations/spam" + + +def test_create_glossary_rest_required_fields( + request_type=translation_service.CreateGlossaryRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["parent"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).create_glossary._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["parent"] = "parent_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).create_glossary._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "post", + "query_params": pb_request, + } + transcode_result["body"] = pb_request + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.create_glossary(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_create_glossary_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.create_glossary._get_unset_required_fields({}) + assert set(unset_fields) == ( + set(()) + & set( + ( + "parent", + "glossary", + ) + ) + ) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_create_glossary_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + operation.Operation, "_set_result_from_operation" + ), mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_create_glossary" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_create_glossary" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.CreateGlossaryRequest.pb( + translation_service.CreateGlossaryRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = json_format.MessageToJson( + operations_pb2.Operation() + ) + + request = translation_service.CreateGlossaryRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = operations_pb2.Operation() + + client.create_glossary( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_create_glossary_rest_bad_request( + transport: str = "rest", request_type=translation_service.CreateGlossaryRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.create_glossary(request) + + +def test_create_glossary_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + + # get arguments that satisfy an http rule for this method + sample_request = {"parent": "projects/sample1/locations/sample2"} + + # get truthy value for each flattened field + mock_args = dict( + parent="parent_value", + glossary=translation_service.Glossary(name="name_value"), + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.create_glossary(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{parent=projects/*/locations/*}/glossaries" % client.transport._host, + args[1], + ) + + +def test_create_glossary_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.create_glossary( + translation_service.CreateGlossaryRequest(), + parent="parent_value", + glossary=translation_service.Glossary(name="name_value"), + ) + + +def test_create_glossary_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.ListGlossariesRequest, + dict, + ], +) +def test_list_glossaries_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.ListGlossariesResponse( + next_page_token="next_page_token_value", + ) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.ListGlossariesResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.list_glossaries(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, pagers.ListGlossariesPager) + assert response.next_page_token == "next_page_token_value" + + +def test_list_glossaries_rest_required_fields( + request_type=translation_service.ListGlossariesRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["parent"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).list_glossaries._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["parent"] = "parent_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).list_glossaries._get_unset_required_fields(jsonified_request) + # Check that path parameters and body parameters are not mixing in. + assert not set(unset_fields) - set( + ( + "filter", + "page_size", + "page_token", + ) + ) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = translation_service.ListGlossariesResponse() + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "get", + "query_params": pb_request, + } + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = translation_service.ListGlossariesResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.list_glossaries(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_list_glossaries_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.list_glossaries._get_unset_required_fields({}) + assert set(unset_fields) == ( + set( + ( + "filter", + "pageSize", + "pageToken", + ) + ) + & set(("parent",)) + ) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_list_glossaries_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_list_glossaries" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_list_glossaries" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.ListGlossariesRequest.pb( + translation_service.ListGlossariesRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = translation_service.ListGlossariesResponse.to_json( + translation_service.ListGlossariesResponse() + ) + + request = translation_service.ListGlossariesRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = translation_service.ListGlossariesResponse() + + client.list_glossaries( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_list_glossaries_rest_bad_request( + transport: str = "rest", request_type=translation_service.ListGlossariesRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.list_glossaries(request) + + +def test_list_glossaries_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.ListGlossariesResponse() + + # get arguments that satisfy an http rule for this method + sample_request = {"parent": "projects/sample1/locations/sample2"} + + # get truthy value for each flattened field + mock_args = dict( + parent="parent_value", + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.ListGlossariesResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.list_glossaries(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{parent=projects/*/locations/*}/glossaries" % client.transport._host, + args[1], + ) + + +def test_list_glossaries_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.list_glossaries( + translation_service.ListGlossariesRequest(), + parent="parent_value", + ) + + +def test_list_glossaries_rest_pager(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # TODO(kbandes): remove this mock unless there's a good reason for it. + # with mock.patch.object(path_template, 'transcode') as transcode: + # Set the response as a series of pages + response = ( + translation_service.ListGlossariesResponse( + glossaries=[ + translation_service.Glossary(), + translation_service.Glossary(), + translation_service.Glossary(), + ], + next_page_token="abc", + ), + translation_service.ListGlossariesResponse( + glossaries=[], + next_page_token="def", + ), + translation_service.ListGlossariesResponse( + glossaries=[ + translation_service.Glossary(), + ], + next_page_token="ghi", + ), + translation_service.ListGlossariesResponse( + glossaries=[ + translation_service.Glossary(), + translation_service.Glossary(), + ], + ), + ) + # Two responses for two calls + response = response + response + + # Wrap the values into proper Response objs + response = tuple( + translation_service.ListGlossariesResponse.to_json(x) for x in response + ) + return_values = tuple(Response() for i in response) + for return_val, response_val in zip(return_values, response): + return_val._content = response_val.encode("UTF-8") + return_val.status_code = 200 + req.side_effect = return_values + + sample_request = {"parent": "projects/sample1/locations/sample2"} + + pager = client.list_glossaries(request=sample_request) + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, translation_service.Glossary) for i in results) + + pages = list(client.list_glossaries(request=sample_request).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.GetGlossaryRequest, + dict, + ], +) +def test_get_glossary_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"name": "projects/sample1/locations/sample2/glossaries/sample3"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.Glossary( + name="name_value", + entry_count=1210, + display_name="display_name_value", + ) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.Glossary.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.get_glossary(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, translation_service.Glossary) + assert response.name == "name_value" + assert response.entry_count == 1210 + assert response.display_name == "display_name_value" + + +def test_get_glossary_rest_required_fields( + request_type=translation_service.GetGlossaryRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["name"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).get_glossary._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["name"] = "name_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).get_glossary._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "name" in jsonified_request + assert jsonified_request["name"] == "name_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = translation_service.Glossary() + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "get", + "query_params": pb_request, + } + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = translation_service.Glossary.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.get_glossary(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_get_glossary_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.get_glossary._get_unset_required_fields({}) + assert set(unset_fields) == (set(()) & set(("name",))) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_get_glossary_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_get_glossary" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_get_glossary" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.GetGlossaryRequest.pb( + translation_service.GetGlossaryRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = translation_service.Glossary.to_json( + translation_service.Glossary() + ) + + request = translation_service.GetGlossaryRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = translation_service.Glossary() + + client.get_glossary( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_get_glossary_rest_bad_request( + transport: str = "rest", request_type=translation_service.GetGlossaryRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"name": "projects/sample1/locations/sample2/glossaries/sample3"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.get_glossary(request) + + +def test_get_glossary_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = translation_service.Glossary() + + # get arguments that satisfy an http rule for this method + sample_request = { + "name": "projects/sample1/locations/sample2/glossaries/sample3" + } + + # get truthy value for each flattened field + mock_args = dict( + name="name_value", + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = translation_service.Glossary.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.get_glossary(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{name=projects/*/locations/*/glossaries/*}" % client.transport._host, + args[1], + ) + + +def test_get_glossary_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.get_glossary( + translation_service.GetGlossaryRequest(), + name="name_value", + ) + + +def test_get_glossary_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + translation_service.DeleteGlossaryRequest, + dict, + ], +) +def test_delete_glossary_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"name": "projects/sample1/locations/sample2/glossaries/sample3"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.delete_glossary(request) + + # Establish that the response is the type that we expect. + assert response.operation.name == "operations/spam" + + +def test_delete_glossary_rest_required_fields( + request_type=translation_service.DeleteGlossaryRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["name"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).delete_glossary._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["name"] = "name_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).delete_glossary._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "name" in jsonified_request + assert jsonified_request["name"] == "name_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "delete", + "query_params": pb_request, + } + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.delete_glossary(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_delete_glossary_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.delete_glossary._get_unset_required_fields({}) + assert set(unset_fields) == (set(()) & set(("name",))) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_delete_glossary_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + operation.Operation, "_set_result_from_operation" + ), mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_delete_glossary" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_delete_glossary" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = translation_service.DeleteGlossaryRequest.pb( + translation_service.DeleteGlossaryRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } + + req.return_value = Response() + req.return_value.status_code = 200 + req.return_value.request = PreparedRequest() + req.return_value._content = json_format.MessageToJson( + operations_pb2.Operation() + ) + + request = translation_service.DeleteGlossaryRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = operations_pb2.Operation() + + client.delete_glossary( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_delete_glossary_rest_bad_request( + transport: str = "rest", request_type=translation_service.DeleteGlossaryRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"name": "projects/sample1/locations/sample2/glossaries/sample3"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.delete_glossary(request) + + +def test_delete_glossary_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = operations_pb2.Operation(name="operations/spam") + + # get arguments that satisfy an http rule for this method + sample_request = { + "name": "projects/sample1/locations/sample2/glossaries/sample3" + } + + # get truthy value for each flattened field + mock_args = dict( + name="name_value", + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.delete_glossary(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{name=projects/*/locations/*/glossaries/*}" % client.transport._host, + args[1], + ) + + +def test_delete_glossary_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.delete_glossary( + translation_service.DeleteGlossaryRequest(), + name="name_value", + ) + + +def test_delete_glossary_rest_error(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), transport="rest" + ) + + +@pytest.mark.parametrize( + "request_type", + [ + adaptive_mt.CreateAdaptiveMtDatasetRequest, + dict, + ], +) +def test_create_adaptive_mt_dataset_rest(request_type): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request_init["adaptive_mt_dataset"] = { + "name": "name_value", + "display_name": "display_name_value", + "source_language_code": "source_language_code_value", + "target_language_code": "target_language_code_value", + "example_count": 1396, + "create_time": {"seconds": 751, "nanos": 543}, + "update_time": {}, + } + # The version of a generated dependency at test runtime may differ from the version used during generation. + # Delete any fields which are not present in the current runtime dependency + # See https://github.com/googleapis/gapic-generator-python/issues/1748 + + # Determine if the message type is proto-plus or protobuf + test_field = adaptive_mt.CreateAdaptiveMtDatasetRequest.meta.fields[ + "adaptive_mt_dataset" + ] + + def get_message_fields(field): + # Given a field which is a message (composite type), return a list with + # all the fields of the message. + # If the field is not a composite type, return an empty list. + message_fields = [] + + if hasattr(field, "message") and field.message: + is_field_type_proto_plus_type = not hasattr(field.message, "DESCRIPTOR") + + if is_field_type_proto_plus_type: + message_fields = field.message.meta.fields.values() + # Add `# pragma: NO COVER` because there may not be any `*_pb2` field types + else: # pragma: NO COVER + message_fields = field.message.DESCRIPTOR.fields + return message_fields + + runtime_nested_fields = [ + (field.name, nested_field.name) + for field in get_message_fields(test_field) + for nested_field in get_message_fields(field) + ] + + subfields_not_in_runtime = [] + + # For each item in the sample request, create a list of sub fields which are not present at runtime + # Add `# pragma: NO COVER` because this test code will not run if all subfields are present at runtime + for field, value in request_init["adaptive_mt_dataset"].items(): # pragma: NO COVER + result = None + is_repeated = False + # For repeated fields + if isinstance(value, list) and len(value): + is_repeated = True + result = value[0] + # For fields where the type is another message + if isinstance(value, dict): + result = value + + if result and hasattr(result, "keys"): + for subfield in result.keys(): + if (field, subfield) not in runtime_nested_fields: + subfields_not_in_runtime.append( + { + "field": field, + "subfield": subfield, + "is_repeated": is_repeated, + } + ) + + # Remove fields from the sample request which are not present in the runtime version of the dependency + # Add `# pragma: NO COVER` because this test code will not run if all subfields are present at runtime + for subfield_to_delete in subfields_not_in_runtime: # pragma: NO COVER + field = subfield_to_delete.get("field") + field_repeated = subfield_to_delete.get("is_repeated") + subfield = subfield_to_delete.get("subfield") + if subfield: + if field_repeated: + for i in range(0, len(request_init["adaptive_mt_dataset"][field])): + del request_init["adaptive_mt_dataset"][field][i][subfield] + else: + del request_init["adaptive_mt_dataset"][field][subfield] + request = request_type(**request_init) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = adaptive_mt.AdaptiveMtDataset( + name="name_value", + display_name="display_name_value", + source_language_code="source_language_code_value", + target_language_code="target_language_code_value", + example_count=1396, + ) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = adaptive_mt.AdaptiveMtDataset.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + response = client.create_adaptive_mt_dataset(request) + + # Establish that the response is the type that we expect. + assert isinstance(response, adaptive_mt.AdaptiveMtDataset) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.source_language_code == "source_language_code_value" + assert response.target_language_code == "target_language_code_value" + assert response.example_count == 1396 + + +def test_create_adaptive_mt_dataset_rest_required_fields( + request_type=adaptive_mt.CreateAdaptiveMtDatasetRequest, +): + transport_class = transports.TranslationServiceRestTransport + + request_init = {} + request_init["parent"] = "" + request = request_type(**request_init) + pb_request = request_type.pb(request) + jsonified_request = json.loads( + json_format.MessageToJson( + pb_request, + including_default_value_fields=False, + use_integers_for_enums=False, + ) + ) + + # verify fields with default values are dropped + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).create_adaptive_mt_dataset._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with default values are now present + + jsonified_request["parent"] = "parent_value" + + unset_fields = transport_class( + credentials=ga_credentials.AnonymousCredentials() + ).create_adaptive_mt_dataset._get_unset_required_fields(jsonified_request) + jsonified_request.update(unset_fields) + + # verify required fields with non-default values are left alone + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" + + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + request = request_type(**request_init) + + # Designate an appropriate value for the returned response. + return_value = adaptive_mt.AdaptiveMtDataset() + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # We need to mock transcode() because providing default values + # for required fields will fail the real version if the http_options + # expect actual values for those fields. + with mock.patch.object(path_template, "transcode") as transcode: + # A uri without fields and an empty body will force all the + # request fields to show up in the query_params. + pb_request = request_type.pb(request) + transcode_result = { + "uri": "v1/sample_method", + "method": "post", + "query_params": pb_request, + } + transcode_result["body"] = pb_request + transcode.return_value = transcode_result + + response_value = Response() + response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = adaptive_mt.AdaptiveMtDataset.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + response = client.create_adaptive_mt_dataset(request) + + expected_params = [("$alt", "json;enum-encoding=int")] + actual_params = req.call_args.kwargs["params"] + assert expected_params == actual_params + + +def test_create_adaptive_mt_dataset_rest_unset_required_fields(): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials + ) + + unset_fields = transport.create_adaptive_mt_dataset._get_unset_required_fields({}) + assert set(unset_fields) == ( + set(()) + & set( + ( + "parent", + "adaptiveMtDataset", + ) + ) + ) + + +@pytest.mark.parametrize("null_interceptor", [True, False]) +def test_create_adaptive_mt_dataset_rest_interceptors(null_interceptor): + transport = transports.TranslationServiceRestTransport( + credentials=ga_credentials.AnonymousCredentials(), + interceptor=None + if null_interceptor + else transports.TranslationServiceRestInterceptor(), + ) + client = TranslationServiceClient(transport=transport) + with mock.patch.object( + type(client.transport._session), "request" + ) as req, mock.patch.object( + path_template, "transcode" + ) as transcode, mock.patch.object( + transports.TranslationServiceRestInterceptor, "post_create_adaptive_mt_dataset" + ) as post, mock.patch.object( + transports.TranslationServiceRestInterceptor, "pre_create_adaptive_mt_dataset" + ) as pre: + pre.assert_not_called() + post.assert_not_called() + pb_message = adaptive_mt.CreateAdaptiveMtDatasetRequest.pb( + adaptive_mt.CreateAdaptiveMtDatasetRequest() + ) + transcode.return_value = { + "method": "post", + "uri": "my_uri", + "body": pb_message, + "query_params": pb_message, + } req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = translation_service.TranslateTextResponse.to_json( - translation_service.TranslateTextResponse() + req.return_value._content = adaptive_mt.AdaptiveMtDataset.to_json( + adaptive_mt.AdaptiveMtDataset() ) - request = translation_service.TranslateTextRequest() + request = adaptive_mt.CreateAdaptiveMtDatasetRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = translation_service.TranslateTextResponse() + post.return_value = adaptive_mt.AdaptiveMtDataset() - client.translate_text( + client.create_adaptive_mt_dataset( request, metadata=[ ("key", "val"), @@ -3516,8 +9556,8 @@ def test_translate_text_rest_interceptors(null_interceptor): post.assert_called_once() -def test_translate_text_rest_bad_request( - transport: str = "rest", request_type=translation_service.TranslateTextRequest +def test_create_adaptive_mt_dataset_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.CreateAdaptiveMtDatasetRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -3537,10 +9577,10 @@ def test_translate_text_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.translate_text(request) + client.create_adaptive_mt_dataset(request) -def test_translate_text_rest_flattened(): +def test_create_adaptive_mt_dataset_rest_flattened(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -3549,7 +9589,7 @@ def test_translate_text_rest_flattened(): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.TranslateTextResponse() + return_value = adaptive_mt.AdaptiveMtDataset() # get arguments that satisfy an http rule for this method sample_request = {"parent": "projects/sample1/locations/sample2"} @@ -3557,11 +9597,7 @@ def test_translate_text_rest_flattened(): # get truthy value for each flattened field mock_args = dict( parent="parent_value", - target_language_code="target_language_code_value", - contents=["contents_value"], - model="model_value", - mime_type="mime_type_value", - source_language_code="source_language_code_value", + adaptive_mt_dataset=adaptive_mt.AdaptiveMtDataset(name="name_value"), ) mock_args.update(sample_request) @@ -3569,25 +9605,25 @@ def test_translate_text_rest_flattened(): response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.TranslateTextResponse.pb(return_value) + return_value = adaptive_mt.AdaptiveMtDataset.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - client.translate_text(**mock_args) + client.create_adaptive_mt_dataset(**mock_args) # Establish that the underlying call was made with the expected # request object values. assert len(req.mock_calls) == 1 _, args, _ = req.mock_calls[0] assert path_template.validate( - "%s/v3/{parent=projects/*/locations/*}:translateText" + "%s/v3/{parent=projects/*/locations/*}/adaptiveMtDatasets" % client.transport._host, args[1], ) -def test_translate_text_rest_flattened_error(transport: str = "rest"): +def test_create_adaptive_mt_dataset_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, @@ -3596,18 +9632,14 @@ def test_translate_text_rest_flattened_error(transport: str = "rest"): # Attempting to call a method with both a request object and flattened # fields is an error. with pytest.raises(ValueError): - client.translate_text( - translation_service.TranslateTextRequest(), + client.create_adaptive_mt_dataset( + adaptive_mt.CreateAdaptiveMtDatasetRequest(), parent="parent_value", - target_language_code="target_language_code_value", - contents=["contents_value"], - model="model_value", - mime_type="mime_type_value", - source_language_code="source_language_code_value", + adaptive_mt_dataset=adaptive_mt.AdaptiveMtDataset(name="name_value"), ) -def test_translate_text_rest_error(): +def test_create_adaptive_mt_dataset_rest_error(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest" ) @@ -3616,47 +9648,47 @@ def test_translate_text_rest_error(): @pytest.mark.parametrize( "request_type", [ - translation_service.DetectLanguageRequest, + adaptive_mt.DeleteAdaptiveMtDatasetRequest, dict, ], ) -def test_detect_language_rest(request_type): +def test_delete_adaptive_mt_dataset_rest(request_type): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } request = request_type(**request_init) # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.DetectLanguageResponse() + return_value = None # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 - # Convert return value to protobuf type - return_value = translation_service.DetectLanguageResponse.pb(return_value) - json_return_value = json_format.MessageToJson(return_value) + json_return_value = "" response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.detect_language(request) + response = client.delete_adaptive_mt_dataset(request) # Establish that the response is the type that we expect. - assert isinstance(response, translation_service.DetectLanguageResponse) + assert response is None -def test_detect_language_rest_required_fields( - request_type=translation_service.DetectLanguageRequest, +def test_delete_adaptive_mt_dataset_rest_required_fields( + request_type=adaptive_mt.DeleteAdaptiveMtDatasetRequest, ): transport_class = transports.TranslationServiceRestTransport request_init = {} - request_init["parent"] = "" + request_init["name"] = "" request = request_type(**request_init) pb_request = request_type.pb(request) jsonified_request = json.loads( @@ -3671,21 +9703,21 @@ def test_detect_language_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).detect_language._get_unset_required_fields(jsonified_request) + ).delete_adaptive_mt_dataset._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present - jsonified_request["parent"] = "parent_value" + jsonified_request["name"] = "name_value" unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).detect_language._get_unset_required_fields(jsonified_request) + ).delete_adaptive_mt_dataset._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone - assert "parent" in jsonified_request - assert jsonified_request["parent"] == "parent_value" + assert "name" in jsonified_request + assert jsonified_request["name"] == "name_value" client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -3694,7 +9726,7 @@ def test_detect_language_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = translation_service.DetectLanguageResponse() + return_value = None # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -3706,40 +9738,36 @@ def test_detect_language_rest_required_fields( pb_request = request_type.pb(request) transcode_result = { "uri": "v1/sample_method", - "method": "post", + "method": "delete", "query_params": pb_request, } - transcode_result["body"] = pb_request transcode.return_value = transcode_result response_value = Response() response_value.status_code = 200 - - # Convert return value to protobuf type - return_value = translation_service.DetectLanguageResponse.pb(return_value) - json_return_value = json_format.MessageToJson(return_value) + json_return_value = "" response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.detect_language(request) + response = client.delete_adaptive_mt_dataset(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_detect_language_rest_unset_required_fields(): +def test_delete_adaptive_mt_dataset_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.detect_language._get_unset_required_fields({}) - assert set(unset_fields) == (set(()) & set(("parent",))) + unset_fields = transport.delete_adaptive_mt_dataset._get_unset_required_fields({}) + assert set(unset_fields) == (set(()) & set(("name",))) @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_detect_language_rest_interceptors(null_interceptor): +def test_delete_adaptive_mt_dataset_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -3752,14 +9780,11 @@ def test_detect_language_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_detect_language" - ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_detect_language" + transports.TranslationServiceRestInterceptor, "pre_delete_adaptive_mt_dataset" ) as pre: pre.assert_not_called() - post.assert_not_called() - pb_message = translation_service.DetectLanguageRequest.pb( - translation_service.DetectLanguageRequest() + pb_message = adaptive_mt.DeleteAdaptiveMtDatasetRequest.pb( + adaptive_mt.DeleteAdaptiveMtDatasetRequest() ) transcode.return_value = { "method": "post", @@ -3771,19 +9796,15 @@ def test_detect_language_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = translation_service.DetectLanguageResponse.to_json( - translation_service.DetectLanguageResponse() - ) - request = translation_service.DetectLanguageRequest() + request = adaptive_mt.DeleteAdaptiveMtDatasetRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = translation_service.DetectLanguageResponse() - client.detect_language( + client.delete_adaptive_mt_dataset( request, metadata=[ ("key", "val"), @@ -3792,11 +9813,10 @@ def test_detect_language_rest_interceptors(null_interceptor): ) pre.assert_called_once() - post.assert_called_once() -def test_detect_language_rest_bad_request( - transport: str = "rest", request_type=translation_service.DetectLanguageRequest +def test_delete_adaptive_mt_dataset_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.DeleteAdaptiveMtDatasetRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -3804,7 +9824,9 @@ def test_detect_language_rest_bad_request( ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } request = request_type(**request_init) # Mock the http request call within the method and fake a BadRequest error. @@ -3816,10 +9838,10 @@ def test_detect_language_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.detect_language(request) + client.delete_adaptive_mt_dataset(request) -def test_detect_language_rest_flattened(): +def test_delete_adaptive_mt_dataset_rest_flattened(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -3828,42 +9850,40 @@ def test_detect_language_rest_flattened(): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.DetectLanguageResponse() + return_value = None # get arguments that satisfy an http rule for this method - sample_request = {"parent": "projects/sample1/locations/sample2"} + sample_request = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } # get truthy value for each flattened field mock_args = dict( - parent="parent_value", - model="model_value", - mime_type="mime_type_value", + name="name_value", ) mock_args.update(sample_request) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 - # Convert return value to protobuf type - return_value = translation_service.DetectLanguageResponse.pb(return_value) - json_return_value = json_format.MessageToJson(return_value) + json_return_value = "" response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - client.detect_language(**mock_args) + client.delete_adaptive_mt_dataset(**mock_args) # Establish that the underlying call was made with the expected # request object values. assert len(req.mock_calls) == 1 _, args, _ = req.mock_calls[0] assert path_template.validate( - "%s/v3/{parent=projects/*/locations/*}:detectLanguage" + "%s/v3/{name=projects/*/locations/*/adaptiveMtDatasets/*}" % client.transport._host, args[1], ) -def test_detect_language_rest_flattened_error(transport: str = "rest"): +def test_delete_adaptive_mt_dataset_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, @@ -3872,16 +9892,13 @@ def test_detect_language_rest_flattened_error(transport: str = "rest"): # Attempting to call a method with both a request object and flattened # fields is an error. with pytest.raises(ValueError): - client.detect_language( - translation_service.DetectLanguageRequest(), - parent="parent_value", - model="model_value", - mime_type="mime_type_value", - content="content_value", + client.delete_adaptive_mt_dataset( + adaptive_mt.DeleteAdaptiveMtDatasetRequest(), + name="name_value", ) -def test_detect_language_rest_error(): +def test_delete_adaptive_mt_dataset_rest_error(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest" ) @@ -3890,47 +9907,60 @@ def test_detect_language_rest_error(): @pytest.mark.parametrize( "request_type", [ - translation_service.GetSupportedLanguagesRequest, + adaptive_mt.GetAdaptiveMtDatasetRequest, dict, ], ) -def test_get_supported_languages_rest(request_type): +def test_get_adaptive_mt_dataset_rest(request_type): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } request = request_type(**request_init) # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.SupportedLanguages() + return_value = adaptive_mt.AdaptiveMtDataset( + name="name_value", + display_name="display_name_value", + source_language_code="source_language_code_value", + target_language_code="target_language_code_value", + example_count=1396, + ) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.SupportedLanguages.pb(return_value) + return_value = adaptive_mt.AdaptiveMtDataset.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.get_supported_languages(request) + response = client.get_adaptive_mt_dataset(request) # Establish that the response is the type that we expect. - assert isinstance(response, translation_service.SupportedLanguages) + assert isinstance(response, adaptive_mt.AdaptiveMtDataset) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.source_language_code == "source_language_code_value" + assert response.target_language_code == "target_language_code_value" + assert response.example_count == 1396 -def test_get_supported_languages_rest_required_fields( - request_type=translation_service.GetSupportedLanguagesRequest, +def test_get_adaptive_mt_dataset_rest_required_fields( + request_type=adaptive_mt.GetAdaptiveMtDatasetRequest, ): transport_class = transports.TranslationServiceRestTransport request_init = {} - request_init["parent"] = "" + request_init["name"] = "" request = request_type(**request_init) pb_request = request_type.pb(request) jsonified_request = json.loads( @@ -3945,28 +9975,21 @@ def test_get_supported_languages_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).get_supported_languages._get_unset_required_fields(jsonified_request) + ).get_adaptive_mt_dataset._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present - jsonified_request["parent"] = "parent_value" + jsonified_request["name"] = "name_value" unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).get_supported_languages._get_unset_required_fields(jsonified_request) - # Check that path parameters and body parameters are not mixing in. - assert not set(unset_fields) - set( - ( - "display_language_code", - "model", - ) - ) + ).get_adaptive_mt_dataset._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone - assert "parent" in jsonified_request - assert jsonified_request["parent"] == "parent_value" + assert "name" in jsonified_request + assert jsonified_request["name"] == "name_value" client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -3975,7 +9998,7 @@ def test_get_supported_languages_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = translation_service.SupportedLanguages() + return_value = adaptive_mt.AdaptiveMtDataset() # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -3996,38 +10019,30 @@ def test_get_supported_languages_rest_required_fields( response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.SupportedLanguages.pb(return_value) + return_value = adaptive_mt.AdaptiveMtDataset.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.get_supported_languages(request) + response = client.get_adaptive_mt_dataset(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_get_supported_languages_rest_unset_required_fields(): +def test_get_adaptive_mt_dataset_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.get_supported_languages._get_unset_required_fields({}) - assert set(unset_fields) == ( - set( - ( - "displayLanguageCode", - "model", - ) - ) - & set(("parent",)) - ) + unset_fields = transport.get_adaptive_mt_dataset._get_unset_required_fields({}) + assert set(unset_fields) == (set(()) & set(("name",))) @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_get_supported_languages_rest_interceptors(null_interceptor): +def test_get_adaptive_mt_dataset_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -4040,14 +10055,14 @@ def test_get_supported_languages_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_get_supported_languages" + transports.TranslationServiceRestInterceptor, "post_get_adaptive_mt_dataset" ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_get_supported_languages" + transports.TranslationServiceRestInterceptor, "pre_get_adaptive_mt_dataset" ) as pre: pre.assert_not_called() post.assert_not_called() - pb_message = translation_service.GetSupportedLanguagesRequest.pb( - translation_service.GetSupportedLanguagesRequest() + pb_message = adaptive_mt.GetAdaptiveMtDatasetRequest.pb( + adaptive_mt.GetAdaptiveMtDatasetRequest() ) transcode.return_value = { "method": "post", @@ -4059,19 +10074,19 @@ def test_get_supported_languages_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = translation_service.SupportedLanguages.to_json( - translation_service.SupportedLanguages() + req.return_value._content = adaptive_mt.AdaptiveMtDataset.to_json( + adaptive_mt.AdaptiveMtDataset() ) - request = translation_service.GetSupportedLanguagesRequest() + request = adaptive_mt.GetAdaptiveMtDatasetRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = translation_service.SupportedLanguages() + post.return_value = adaptive_mt.AdaptiveMtDataset() - client.get_supported_languages( + client.get_adaptive_mt_dataset( request, metadata=[ ("key", "val"), @@ -4083,9 +10098,8 @@ def test_get_supported_languages_rest_interceptors(null_interceptor): post.assert_called_once() -def test_get_supported_languages_rest_bad_request( - transport: str = "rest", - request_type=translation_service.GetSupportedLanguagesRequest, +def test_get_adaptive_mt_dataset_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.GetAdaptiveMtDatasetRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -4093,7 +10107,9 @@ def test_get_supported_languages_rest_bad_request( ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } request = request_type(**request_init) # Mock the http request call within the method and fake a BadRequest error. @@ -4105,10 +10121,10 @@ def test_get_supported_languages_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.get_supported_languages(request) + client.get_adaptive_mt_dataset(request) -def test_get_supported_languages_rest_flattened(): +def test_get_adaptive_mt_dataset_rest_flattened(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -4117,16 +10133,16 @@ def test_get_supported_languages_rest_flattened(): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.SupportedLanguages() + return_value = adaptive_mt.AdaptiveMtDataset() # get arguments that satisfy an http rule for this method - sample_request = {"parent": "projects/sample1/locations/sample2"} + sample_request = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } # get truthy value for each flattened field mock_args = dict( - parent="parent_value", - model="model_value", - display_language_code="display_language_code_value", + name="name_value", ) mock_args.update(sample_request) @@ -4134,25 +10150,25 @@ def test_get_supported_languages_rest_flattened(): response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.SupportedLanguages.pb(return_value) + return_value = adaptive_mt.AdaptiveMtDataset.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - client.get_supported_languages(**mock_args) + client.get_adaptive_mt_dataset(**mock_args) # Establish that the underlying call was made with the expected # request object values. assert len(req.mock_calls) == 1 _, args, _ = req.mock_calls[0] assert path_template.validate( - "%s/v3/{parent=projects/*/locations/*}/supportedLanguages" + "%s/v3/{name=projects/*/locations/*/adaptiveMtDatasets/*}" % client.transport._host, args[1], ) -def test_get_supported_languages_rest_flattened_error(transport: str = "rest"): +def test_get_adaptive_mt_dataset_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, @@ -4160,16 +10176,14 @@ def test_get_supported_languages_rest_flattened_error(transport: str = "rest"): # Attempting to call a method with both a request object and flattened # fields is an error. - with pytest.raises(ValueError): - client.get_supported_languages( - translation_service.GetSupportedLanguagesRequest(), - parent="parent_value", - model="model_value", - display_language_code="display_language_code_value", + with pytest.raises(ValueError): + client.get_adaptive_mt_dataset( + adaptive_mt.GetAdaptiveMtDatasetRequest(), + name="name_value", ) -def test_get_supported_languages_rest_error(): +def test_get_adaptive_mt_dataset_rest_error(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest" ) @@ -4178,11 +10192,11 @@ def test_get_supported_languages_rest_error(): @pytest.mark.parametrize( "request_type", [ - translation_service.TranslateDocumentRequest, + adaptive_mt.ListAdaptiveMtDatasetsRequest, dict, ], ) -def test_translate_document_rest(request_type): +def test_list_adaptive_mt_datasets_rest(request_type): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -4195,34 +10209,33 @@ def test_translate_document_rest(request_type): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.TranslateDocumentResponse( - model="model_value", + return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse( + next_page_token="next_page_token_value", ) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.TranslateDocumentResponse.pb(return_value) + return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.translate_document(request) + response = client.list_adaptive_mt_datasets(request) # Establish that the response is the type that we expect. - assert isinstance(response, translation_service.TranslateDocumentResponse) - assert response.model == "model_value" + assert isinstance(response, pagers.ListAdaptiveMtDatasetsPager) + assert response.next_page_token == "next_page_token_value" -def test_translate_document_rest_required_fields( - request_type=translation_service.TranslateDocumentRequest, +def test_list_adaptive_mt_datasets_rest_required_fields( + request_type=adaptive_mt.ListAdaptiveMtDatasetsRequest, ): transport_class = transports.TranslationServiceRestTransport request_init = {} request_init["parent"] = "" - request_init["target_language_code"] = "" request = request_type(**request_init) pb_request = request_type.pb(request) jsonified_request = json.loads( @@ -4237,24 +10250,29 @@ def test_translate_document_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).translate_document._get_unset_required_fields(jsonified_request) + ).list_adaptive_mt_datasets._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present jsonified_request["parent"] = "parent_value" - jsonified_request["targetLanguageCode"] = "target_language_code_value" unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).translate_document._get_unset_required_fields(jsonified_request) + ).list_adaptive_mt_datasets._get_unset_required_fields(jsonified_request) + # Check that path parameters and body parameters are not mixing in. + assert not set(unset_fields) - set( + ( + "filter", + "page_size", + "page_token", + ) + ) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone assert "parent" in jsonified_request assert jsonified_request["parent"] == "parent_value" - assert "targetLanguageCode" in jsonified_request - assert jsonified_request["targetLanguageCode"] == "target_language_code_value" client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -4263,7 +10281,7 @@ def test_translate_document_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = translation_service.TranslateDocumentResponse() + return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse() # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -4275,51 +10293,48 @@ def test_translate_document_rest_required_fields( pb_request = request_type.pb(request) transcode_result = { "uri": "v1/sample_method", - "method": "post", + "method": "get", "query_params": pb_request, } - transcode_result["body"] = pb_request transcode.return_value = transcode_result response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.TranslateDocumentResponse.pb( - return_value - ) + return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.translate_document(request) + response = client.list_adaptive_mt_datasets(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_translate_document_rest_unset_required_fields(): +def test_list_adaptive_mt_datasets_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.translate_document._get_unset_required_fields({}) + unset_fields = transport.list_adaptive_mt_datasets._get_unset_required_fields({}) assert set(unset_fields) == ( - set(()) - & set( + set( ( - "parent", - "targetLanguageCode", - "documentInputConfig", + "filter", + "pageSize", + "pageToken", ) ) + & set(("parent",)) ) @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_translate_document_rest_interceptors(null_interceptor): +def test_list_adaptive_mt_datasets_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -4332,14 +10347,14 @@ def test_translate_document_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_translate_document" + transports.TranslationServiceRestInterceptor, "post_list_adaptive_mt_datasets" ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_translate_document" + transports.TranslationServiceRestInterceptor, "pre_list_adaptive_mt_datasets" ) as pre: pre.assert_not_called() post.assert_not_called() - pb_message = translation_service.TranslateDocumentRequest.pb( - translation_service.TranslateDocumentRequest() + pb_message = adaptive_mt.ListAdaptiveMtDatasetsRequest.pb( + adaptive_mt.ListAdaptiveMtDatasetsRequest() ) transcode.return_value = { "method": "post", @@ -4351,21 +10366,19 @@ def test_translate_document_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = ( - translation_service.TranslateDocumentResponse.to_json( - translation_service.TranslateDocumentResponse() - ) + req.return_value._content = adaptive_mt.ListAdaptiveMtDatasetsResponse.to_json( + adaptive_mt.ListAdaptiveMtDatasetsResponse() ) - request = translation_service.TranslateDocumentRequest() + request = adaptive_mt.ListAdaptiveMtDatasetsRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = translation_service.TranslateDocumentResponse() + post.return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse() - client.translate_document( + client.list_adaptive_mt_datasets( request, metadata=[ ("key", "val"), @@ -4377,8 +10390,8 @@ def test_translate_document_rest_interceptors(null_interceptor): post.assert_called_once() -def test_translate_document_rest_bad_request( - transport: str = "rest", request_type=translation_service.TranslateDocumentRequest +def test_list_adaptive_mt_datasets_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.ListAdaptiveMtDatasetsRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -4398,23 +10411,137 @@ def test_translate_document_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.translate_document(request) + client.list_adaptive_mt_datasets(request) -def test_translate_document_rest_error(): +def test_list_adaptive_mt_datasets_rest_flattened(): client = TranslationServiceClient( - credentials=ga_credentials.AnonymousCredentials(), transport="rest" + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse() + + # get arguments that satisfy an http rule for this method + sample_request = {"parent": "projects/sample1/locations/sample2"} + + # get truthy value for each flattened field + mock_args = dict( + parent="parent_value", + ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = adaptive_mt.ListAdaptiveMtDatasetsResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value + + client.list_adaptive_mt_datasets(**mock_args) + + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{parent=projects/*/locations/*}/adaptiveMtDatasets" + % client.transport._host, + args[1], + ) + + +def test_list_adaptive_mt_datasets_rest_flattened_error(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.list_adaptive_mt_datasets( + adaptive_mt.ListAdaptiveMtDatasetsRequest(), + parent="parent_value", + ) + + +def test_list_adaptive_mt_datasets_rest_pager(transport: str = "rest"): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, ) + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # TODO(kbandes): remove this mock unless there's a good reason for it. + # with mock.patch.object(path_template, 'transcode') as transcode: + # Set the response as a series of pages + response = ( + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtDatasetsResponse( + adaptive_mt_datasets=[ + adaptive_mt.AdaptiveMtDataset(), + adaptive_mt.AdaptiveMtDataset(), + ], + ), + ) + # Two responses for two calls + response = response + response + + # Wrap the values into proper Response objs + response = tuple( + adaptive_mt.ListAdaptiveMtDatasetsResponse.to_json(x) for x in response + ) + return_values = tuple(Response() for i in response) + for return_val, response_val in zip(return_values, response): + return_val._content = response_val.encode("UTF-8") + return_val.status_code = 200 + req.side_effect = return_values + + sample_request = {"parent": "projects/sample1/locations/sample2"} + + pager = client.list_adaptive_mt_datasets(request=sample_request) + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtDataset) for i in results) + + pages = list(client.list_adaptive_mt_datasets(request=sample_request).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + @pytest.mark.parametrize( "request_type", [ - translation_service.BatchTranslateTextRequest, + adaptive_mt.AdaptiveMtTranslateRequest, dict, ], ) -def test_batch_translate_text_rest(request_type): +def test_adaptive_mt_translate_rest(request_type): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -4427,30 +10554,35 @@ def test_batch_translate_text_rest(request_type): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = adaptive_mt.AdaptiveMtTranslateResponse( + language_code="language_code_value", + ) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 + # Convert return value to protobuf type + return_value = adaptive_mt.AdaptiveMtTranslateResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.batch_translate_text(request) + response = client.adaptive_mt_translate(request) # Establish that the response is the type that we expect. - assert response.operation.name == "operations/spam" + assert isinstance(response, adaptive_mt.AdaptiveMtTranslateResponse) + assert response.language_code == "language_code_value" -def test_batch_translate_text_rest_required_fields( - request_type=translation_service.BatchTranslateTextRequest, +def test_adaptive_mt_translate_rest_required_fields( + request_type=adaptive_mt.AdaptiveMtTranslateRequest, ): transport_class = transports.TranslationServiceRestTransport request_init = {} request_init["parent"] = "" - request_init["source_language_code"] = "" - request_init["target_language_codes"] = "" + request_init["dataset"] = "" + request_init["content"] = "" request = request_type(**request_init) pb_request = request_type.pb(request) jsonified_request = json.loads( @@ -4465,27 +10597,27 @@ def test_batch_translate_text_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).batch_translate_text._get_unset_required_fields(jsonified_request) + ).adaptive_mt_translate._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present jsonified_request["parent"] = "parent_value" - jsonified_request["sourceLanguageCode"] = "source_language_code_value" - jsonified_request["targetLanguageCodes"] = "target_language_codes_value" + jsonified_request["dataset"] = "dataset_value" + jsonified_request["content"] = "content_value" unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).batch_translate_text._get_unset_required_fields(jsonified_request) + ).adaptive_mt_translate._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone assert "parent" in jsonified_request assert jsonified_request["parent"] == "parent_value" - assert "sourceLanguageCode" in jsonified_request - assert jsonified_request["sourceLanguageCode"] == "source_language_code_value" - assert "targetLanguageCodes" in jsonified_request - assert jsonified_request["targetLanguageCodes"] == "target_language_codes_value" + assert "dataset" in jsonified_request + assert jsonified_request["dataset"] == "dataset_value" + assert "content" in jsonified_request + assert jsonified_request["content"] == "content_value" client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -4494,7 +10626,7 @@ def test_batch_translate_text_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = adaptive_mt.AdaptiveMtTranslateResponse() # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -4514,40 +10646,41 @@ def test_batch_translate_text_rest_required_fields( response_value = Response() response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = adaptive_mt.AdaptiveMtTranslateResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.batch_translate_text(request) + response = client.adaptive_mt_translate(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_batch_translate_text_rest_unset_required_fields(): +def test_adaptive_mt_translate_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.batch_translate_text._get_unset_required_fields({}) + unset_fields = transport.adaptive_mt_translate._get_unset_required_fields({}) assert set(unset_fields) == ( set(()) & set( ( "parent", - "sourceLanguageCode", - "targetLanguageCodes", - "inputConfigs", - "outputConfig", + "dataset", + "content", ) ) ) @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_batch_translate_text_rest_interceptors(null_interceptor): +def test_adaptive_mt_translate_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -4560,16 +10693,14 @@ def test_batch_translate_text_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - operation.Operation, "_set_result_from_operation" - ), mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_batch_translate_text" + transports.TranslationServiceRestInterceptor, "post_adaptive_mt_translate" ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_batch_translate_text" + transports.TranslationServiceRestInterceptor, "pre_adaptive_mt_translate" ) as pre: pre.assert_not_called() post.assert_not_called() - pb_message = translation_service.BatchTranslateTextRequest.pb( - translation_service.BatchTranslateTextRequest() + pb_message = adaptive_mt.AdaptiveMtTranslateRequest.pb( + adaptive_mt.AdaptiveMtTranslateRequest() ) transcode.return_value = { "method": "post", @@ -4581,55 +10712,114 @@ def test_batch_translate_text_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = json_format.MessageToJson( - operations_pb2.Operation() + req.return_value._content = adaptive_mt.AdaptiveMtTranslateResponse.to_json( + adaptive_mt.AdaptiveMtTranslateResponse() + ) + + request = adaptive_mt.AdaptiveMtTranslateRequest() + metadata = [ + ("key", "val"), + ("cephalopod", "squid"), + ] + pre.return_value = request, metadata + post.return_value = adaptive_mt.AdaptiveMtTranslateResponse() + + client.adaptive_mt_translate( + request, + metadata=[ + ("key", "val"), + ("cephalopod", "squid"), + ], + ) + + pre.assert_called_once() + post.assert_called_once() + + +def test_adaptive_mt_translate_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.AdaptiveMtTranslateRequest +): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # send a request that will satisfy transcoding + request_init = {"parent": "projects/sample1/locations/sample2"} + request = request_type(**request_init) + + # Mock the http request call within the method and fake a BadRequest error. + with mock.patch.object(Session, "request") as req, pytest.raises( + core_exceptions.BadRequest + ): + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 400 + response_value.request = Request() + req.return_value = response_value + client.adaptive_mt_translate(request) + + +def test_adaptive_mt_translate_rest_flattened(): + client = TranslationServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # Mock the http request call within the method and fake a response. + with mock.patch.object(type(client.transport._session), "request") as req: + # Designate an appropriate value for the returned response. + return_value = adaptive_mt.AdaptiveMtTranslateResponse() + + # get arguments that satisfy an http rule for this method + sample_request = {"parent": "projects/sample1/locations/sample2"} + + # get truthy value for each flattened field + mock_args = dict( + parent="parent_value", + content=["content_value"], ) + mock_args.update(sample_request) + + # Wrap the value into a proper Response obj + response_value = Response() + response_value.status_code = 200 + # Convert return value to protobuf type + return_value = adaptive_mt.AdaptiveMtTranslateResponse.pb(return_value) + json_return_value = json_format.MessageToJson(return_value) + response_value._content = json_return_value.encode("UTF-8") + req.return_value = response_value - request = translation_service.BatchTranslateTextRequest() - metadata = [ - ("key", "val"), - ("cephalopod", "squid"), - ] - pre.return_value = request, metadata - post.return_value = operations_pb2.Operation() + client.adaptive_mt_translate(**mock_args) - client.batch_translate_text( - request, - metadata=[ - ("key", "val"), - ("cephalopod", "squid"), - ], + # Establish that the underlying call was made with the expected + # request object values. + assert len(req.mock_calls) == 1 + _, args, _ = req.mock_calls[0] + assert path_template.validate( + "%s/v3/{parent=projects/*/locations/*}:adaptiveMtTranslate" + % client.transport._host, + args[1], ) - pre.assert_called_once() - post.assert_called_once() - -def test_batch_translate_text_rest_bad_request( - transport: str = "rest", request_type=translation_service.BatchTranslateTextRequest -): +def test_adaptive_mt_translate_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, ) - # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} - request = request_type(**request_init) - - # Mock the http request call within the method and fake a BadRequest error. - with mock.patch.object(Session, "request") as req, pytest.raises( - core_exceptions.BadRequest - ): - # Wrap the value into a proper Response obj - response_value = Response() - response_value.status_code = 400 - response_value.request = Request() - req.return_value = response_value - client.batch_translate_text(request) + # Attempting to call a method with both a request object and flattened + # fields is an error. + with pytest.raises(ValueError): + client.adaptive_mt_translate( + adaptive_mt.AdaptiveMtTranslateRequest(), + parent="parent_value", + content=["content_value"], + ) -def test_batch_translate_text_rest_error(): +def test_adaptive_mt_translate_rest_error(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest" ) @@ -4638,47 +10828,56 @@ def test_batch_translate_text_rest_error(): @pytest.mark.parametrize( "request_type", [ - translation_service.BatchTranslateDocumentRequest, + adaptive_mt.GetAdaptiveMtFileRequest, dict, ], ) -def test_batch_translate_document_rest(request_type): +def test_get_adaptive_mt_file_rest(request_type): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } request = request_type(**request_init) # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = adaptive_mt.AdaptiveMtFile( + name="name_value", + display_name="display_name_value", + entry_count=1210, + ) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 + # Convert return value to protobuf type + return_value = adaptive_mt.AdaptiveMtFile.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.batch_translate_document(request) + response = client.get_adaptive_mt_file(request) # Establish that the response is the type that we expect. - assert response.operation.name == "operations/spam" + assert isinstance(response, adaptive_mt.AdaptiveMtFile) + assert response.name == "name_value" + assert response.display_name == "display_name_value" + assert response.entry_count == 1210 -def test_batch_translate_document_rest_required_fields( - request_type=translation_service.BatchTranslateDocumentRequest, +def test_get_adaptive_mt_file_rest_required_fields( + request_type=adaptive_mt.GetAdaptiveMtFileRequest, ): transport_class = transports.TranslationServiceRestTransport request_init = {} - request_init["parent"] = "" - request_init["source_language_code"] = "" - request_init["target_language_codes"] = "" + request_init["name"] = "" request = request_type(**request_init) pb_request = request_type.pb(request) jsonified_request = json.loads( @@ -4693,27 +10892,21 @@ def test_batch_translate_document_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).batch_translate_document._get_unset_required_fields(jsonified_request) + ).get_adaptive_mt_file._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present - jsonified_request["parent"] = "parent_value" - jsonified_request["sourceLanguageCode"] = "source_language_code_value" - jsonified_request["targetLanguageCodes"] = "target_language_codes_value" + jsonified_request["name"] = "name_value" unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).batch_translate_document._get_unset_required_fields(jsonified_request) + ).get_adaptive_mt_file._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone - assert "parent" in jsonified_request - assert jsonified_request["parent"] == "parent_value" - assert "sourceLanguageCode" in jsonified_request - assert jsonified_request["sourceLanguageCode"] == "source_language_code_value" - assert "targetLanguageCodes" in jsonified_request - assert jsonified_request["targetLanguageCodes"] == "target_language_codes_value" + assert "name" in jsonified_request + assert jsonified_request["name"] == "name_value" client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -4722,7 +10915,7 @@ def test_batch_translate_document_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = adaptive_mt.AdaptiveMtFile() # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -4734,48 +10927,39 @@ def test_batch_translate_document_rest_required_fields( pb_request = request_type.pb(request) transcode_result = { "uri": "v1/sample_method", - "method": "post", + "method": "get", "query_params": pb_request, } - transcode_result["body"] = pb_request transcode.return_value = transcode_result response_value = Response() response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = adaptive_mt.AdaptiveMtFile.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.batch_translate_document(request) + response = client.get_adaptive_mt_file(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_batch_translate_document_rest_unset_required_fields(): +def test_get_adaptive_mt_file_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.batch_translate_document._get_unset_required_fields({}) - assert set(unset_fields) == ( - set(()) - & set( - ( - "parent", - "sourceLanguageCode", - "targetLanguageCodes", - "inputConfigs", - "outputConfig", - ) - ) - ) + unset_fields = transport.get_adaptive_mt_file._get_unset_required_fields({}) + assert set(unset_fields) == (set(()) & set(("name",))) @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_batch_translate_document_rest_interceptors(null_interceptor): +def test_get_adaptive_mt_file_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -4788,16 +10972,14 @@ def test_batch_translate_document_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - operation.Operation, "_set_result_from_operation" - ), mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_batch_translate_document" + transports.TranslationServiceRestInterceptor, "post_get_adaptive_mt_file" ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_batch_translate_document" + transports.TranslationServiceRestInterceptor, "pre_get_adaptive_mt_file" ) as pre: pre.assert_not_called() post.assert_not_called() - pb_message = translation_service.BatchTranslateDocumentRequest.pb( - translation_service.BatchTranslateDocumentRequest() + pb_message = adaptive_mt.GetAdaptiveMtFileRequest.pb( + adaptive_mt.GetAdaptiveMtFileRequest() ) transcode.return_value = { "method": "post", @@ -4809,19 +10991,19 @@ def test_batch_translate_document_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = json_format.MessageToJson( - operations_pb2.Operation() + req.return_value._content = adaptive_mt.AdaptiveMtFile.to_json( + adaptive_mt.AdaptiveMtFile() ) - request = translation_service.BatchTranslateDocumentRequest() + request = adaptive_mt.GetAdaptiveMtFileRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = operations_pb2.Operation() + post.return_value = adaptive_mt.AdaptiveMtFile() - client.batch_translate_document( + client.get_adaptive_mt_file( request, metadata=[ ("key", "val"), @@ -4833,9 +11015,8 @@ def test_batch_translate_document_rest_interceptors(null_interceptor): post.assert_called_once() -def test_batch_translate_document_rest_bad_request( - transport: str = "rest", - request_type=translation_service.BatchTranslateDocumentRequest, +def test_get_adaptive_mt_file_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.GetAdaptiveMtFileRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -4843,7 +11024,9 @@ def test_batch_translate_document_rest_bad_request( ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } request = request_type(**request_init) # Mock the http request call within the method and fake a BadRequest error. @@ -4855,10 +11038,10 @@ def test_batch_translate_document_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.batch_translate_document(request) + client.get_adaptive_mt_file(request) -def test_batch_translate_document_rest_flattened(): +def test_get_adaptive_mt_file_rest_flattened(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -4867,52 +11050,42 @@ def test_batch_translate_document_rest_flattened(): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = adaptive_mt.AdaptiveMtFile() # get arguments that satisfy an http rule for this method - sample_request = {"parent": "projects/sample1/locations/sample2"} + sample_request = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } # get truthy value for each flattened field mock_args = dict( - parent="parent_value", - source_language_code="source_language_code_value", - target_language_codes=["target_language_codes_value"], - input_configs=[ - translation_service.BatchDocumentInputConfig( - gcs_source=translation_service.GcsSource( - input_uri="input_uri_value" - ) - ) - ], - output_config=translation_service.BatchDocumentOutputConfig( - gcs_destination=translation_service.GcsDestination( - output_uri_prefix="output_uri_prefix_value" - ) - ), + name="name_value", ) mock_args.update(sample_request) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 + # Convert return value to protobuf type + return_value = adaptive_mt.AdaptiveMtFile.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - client.batch_translate_document(**mock_args) + client.get_adaptive_mt_file(**mock_args) # Establish that the underlying call was made with the expected # request object values. assert len(req.mock_calls) == 1 _, args, _ = req.mock_calls[0] assert path_template.validate( - "%s/v3/{parent=projects/*/locations/*}:batchTranslateDocument" + "%s/v3/{name=projects/*/locations/*/adaptiveMtDatasets/*/adaptiveMtFiles/*}" % client.transport._host, args[1], ) -def test_batch_translate_document_rest_flattened_error(transport: str = "rest"): +def test_get_adaptive_mt_file_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, @@ -4921,27 +11094,13 @@ def test_batch_translate_document_rest_flattened_error(transport: str = "rest"): # Attempting to call a method with both a request object and flattened # fields is an error. with pytest.raises(ValueError): - client.batch_translate_document( - translation_service.BatchTranslateDocumentRequest(), - parent="parent_value", - source_language_code="source_language_code_value", - target_language_codes=["target_language_codes_value"], - input_configs=[ - translation_service.BatchDocumentInputConfig( - gcs_source=translation_service.GcsSource( - input_uri="input_uri_value" - ) - ) - ], - output_config=translation_service.BatchDocumentOutputConfig( - gcs_destination=translation_service.GcsDestination( - output_uri_prefix="output_uri_prefix_value" - ) - ), + client.get_adaptive_mt_file( + adaptive_mt.GetAdaptiveMtFileRequest(), + name="name_value", ) -def test_batch_translate_document_rest_error(): +def test_get_adaptive_mt_file_rest_error(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest" ) @@ -4950,127 +11109,47 @@ def test_batch_translate_document_rest_error(): @pytest.mark.parametrize( "request_type", [ - translation_service.CreateGlossaryRequest, + adaptive_mt.DeleteAdaptiveMtFileRequest, dict, ], ) -def test_create_glossary_rest(request_type): +def test_delete_adaptive_mt_file_rest(request_type): client = TranslationServiceClient( - credentials=ga_credentials.AnonymousCredentials(), - transport="rest", - ) - - # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} - request_init["glossary"] = { - "name": "name_value", - "language_pair": { - "source_language_code": "source_language_code_value", - "target_language_code": "target_language_code_value", - }, - "language_codes_set": { - "language_codes": ["language_codes_value1", "language_codes_value2"] - }, - "input_config": {"gcs_source": {"input_uri": "input_uri_value"}}, - "entry_count": 1210, - "submit_time": {"seconds": 751, "nanos": 543}, - "end_time": {}, - "display_name": "display_name_value", - } - # The version of a generated dependency at test runtime may differ from the version used during generation. - # Delete any fields which are not present in the current runtime dependency - # See https://github.com/googleapis/gapic-generator-python/issues/1748 - - # Determine if the message type is proto-plus or protobuf - test_field = translation_service.CreateGlossaryRequest.meta.fields["glossary"] - - def get_message_fields(field): - # Given a field which is a message (composite type), return a list with - # all the fields of the message. - # If the field is not a composite type, return an empty list. - message_fields = [] - - if hasattr(field, "message") and field.message: - is_field_type_proto_plus_type = not hasattr(field.message, "DESCRIPTOR") - - if is_field_type_proto_plus_type: - message_fields = field.message.meta.fields.values() - # Add `# pragma: NO COVER` because there may not be any `*_pb2` field types - else: # pragma: NO COVER - message_fields = field.message.DESCRIPTOR.fields - return message_fields - - runtime_nested_fields = [ - (field.name, nested_field.name) - for field in get_message_fields(test_field) - for nested_field in get_message_fields(field) - ] - - subfields_not_in_runtime = [] - - # For each item in the sample request, create a list of sub fields which are not present at runtime - # Add `# pragma: NO COVER` because this test code will not run if all subfields are present at runtime - for field, value in request_init["glossary"].items(): # pragma: NO COVER - result = None - is_repeated = False - # For repeated fields - if isinstance(value, list) and len(value): - is_repeated = True - result = value[0] - # For fields where the type is another message - if isinstance(value, dict): - result = value - - if result and hasattr(result, "keys"): - for subfield in result.keys(): - if (field, subfield) not in runtime_nested_fields: - subfields_not_in_runtime.append( - { - "field": field, - "subfield": subfield, - "is_repeated": is_repeated, - } - ) - - # Remove fields from the sample request which are not present in the runtime version of the dependency - # Add `# pragma: NO COVER` because this test code will not run if all subfields are present at runtime - for subfield_to_delete in subfields_not_in_runtime: # pragma: NO COVER - field = subfield_to_delete.get("field") - field_repeated = subfield_to_delete.get("is_repeated") - subfield = subfield_to_delete.get("subfield") - if subfield: - if field_repeated: - for i in range(0, len(request_init["glossary"][field])): - del request_init["glossary"][field][i][subfield] - else: - del request_init["glossary"][field][subfield] + credentials=ga_credentials.AnonymousCredentials(), + transport="rest", + ) + + # send a request that will satisfy transcoding + request_init = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } request = request_type(**request_init) # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = None # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 - json_return_value = json_format.MessageToJson(return_value) + json_return_value = "" response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.create_glossary(request) + response = client.delete_adaptive_mt_file(request) # Establish that the response is the type that we expect. - assert response.operation.name == "operations/spam" + assert response is None -def test_create_glossary_rest_required_fields( - request_type=translation_service.CreateGlossaryRequest, +def test_delete_adaptive_mt_file_rest_required_fields( + request_type=adaptive_mt.DeleteAdaptiveMtFileRequest, ): transport_class = transports.TranslationServiceRestTransport request_init = {} - request_init["parent"] = "" + request_init["name"] = "" request = request_type(**request_init) pb_request = request_type.pb(request) jsonified_request = json.loads( @@ -5085,21 +11164,21 @@ def test_create_glossary_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).create_glossary._get_unset_required_fields(jsonified_request) + ).delete_adaptive_mt_file._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present - jsonified_request["parent"] = "parent_value" + jsonified_request["name"] = "name_value" unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).create_glossary._get_unset_required_fields(jsonified_request) + ).delete_adaptive_mt_file._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone - assert "parent" in jsonified_request - assert jsonified_request["parent"] == "parent_value" + assert "name" in jsonified_request + assert jsonified_request["name"] == "name_value" client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -5108,7 +11187,7 @@ def test_create_glossary_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = None # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -5120,45 +11199,36 @@ def test_create_glossary_rest_required_fields( pb_request = request_type.pb(request) transcode_result = { "uri": "v1/sample_method", - "method": "post", + "method": "delete", "query_params": pb_request, } - transcode_result["body"] = pb_request transcode.return_value = transcode_result response_value = Response() response_value.status_code = 200 - json_return_value = json_format.MessageToJson(return_value) + json_return_value = "" response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.create_glossary(request) + response = client.delete_adaptive_mt_file(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_create_glossary_rest_unset_required_fields(): +def test_delete_adaptive_mt_file_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.create_glossary._get_unset_required_fields({}) - assert set(unset_fields) == ( - set(()) - & set( - ( - "parent", - "glossary", - ) - ) - ) + unset_fields = transport.delete_adaptive_mt_file._get_unset_required_fields({}) + assert set(unset_fields) == (set(()) & set(("name",))) @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_create_glossary_rest_interceptors(null_interceptor): +def test_delete_adaptive_mt_file_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -5171,16 +11241,11 @@ def test_create_glossary_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - operation.Operation, "_set_result_from_operation" - ), mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_create_glossary" - ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_create_glossary" + transports.TranslationServiceRestInterceptor, "pre_delete_adaptive_mt_file" ) as pre: pre.assert_not_called() - post.assert_not_called() - pb_message = translation_service.CreateGlossaryRequest.pb( - translation_service.CreateGlossaryRequest() + pb_message = adaptive_mt.DeleteAdaptiveMtFileRequest.pb( + adaptive_mt.DeleteAdaptiveMtFileRequest() ) transcode.return_value = { "method": "post", @@ -5192,19 +11257,15 @@ def test_create_glossary_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = json_format.MessageToJson( - operations_pb2.Operation() - ) - request = translation_service.CreateGlossaryRequest() + request = adaptive_mt.DeleteAdaptiveMtFileRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = operations_pb2.Operation() - client.create_glossary( + client.delete_adaptive_mt_file( request, metadata=[ ("key", "val"), @@ -5213,11 +11274,10 @@ def test_create_glossary_rest_interceptors(null_interceptor): ) pre.assert_called_once() - post.assert_called_once() -def test_create_glossary_rest_bad_request( - transport: str = "rest", request_type=translation_service.CreateGlossaryRequest +def test_delete_adaptive_mt_file_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.DeleteAdaptiveMtFileRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -5225,7 +11285,9 @@ def test_create_glossary_rest_bad_request( ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } request = request_type(**request_init) # Mock the http request call within the method and fake a BadRequest error. @@ -5237,10 +11299,10 @@ def test_create_glossary_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.create_glossary(request) + client.delete_adaptive_mt_file(request) -def test_create_glossary_rest_flattened(): +def test_delete_adaptive_mt_file_rest_flattened(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -5249,38 +11311,40 @@ def test_create_glossary_rest_flattened(): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = None # get arguments that satisfy an http rule for this method - sample_request = {"parent": "projects/sample1/locations/sample2"} + sample_request = { + "name": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } # get truthy value for each flattened field mock_args = dict( - parent="parent_value", - glossary=translation_service.Glossary(name="name_value"), + name="name_value", ) mock_args.update(sample_request) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 - json_return_value = json_format.MessageToJson(return_value) + json_return_value = "" response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - client.create_glossary(**mock_args) + client.delete_adaptive_mt_file(**mock_args) # Establish that the underlying call was made with the expected # request object values. assert len(req.mock_calls) == 1 _, args, _ = req.mock_calls[0] assert path_template.validate( - "%s/v3/{parent=projects/*/locations/*}/glossaries" % client.transport._host, + "%s/v3/{name=projects/*/locations/*/adaptiveMtDatasets/*/adaptiveMtFiles/*}" + % client.transport._host, args[1], ) -def test_create_glossary_rest_flattened_error(transport: str = "rest"): +def test_delete_adaptive_mt_file_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, @@ -5289,14 +11353,13 @@ def test_create_glossary_rest_flattened_error(transport: str = "rest"): # Attempting to call a method with both a request object and flattened # fields is an error. with pytest.raises(ValueError): - client.create_glossary( - translation_service.CreateGlossaryRequest(), - parent="parent_value", - glossary=translation_service.Glossary(name="name_value"), + client.delete_adaptive_mt_file( + adaptive_mt.DeleteAdaptiveMtFileRequest(), + name="name_value", ) -def test_create_glossary_rest_error(): +def test_delete_adaptive_mt_file_rest_error(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest" ) @@ -5305,45 +11368,44 @@ def test_create_glossary_rest_error(): @pytest.mark.parametrize( "request_type", [ - translation_service.ListGlossariesRequest, + adaptive_mt.ImportAdaptiveMtFileRequest, dict, ], ) -def test_list_glossaries_rest(request_type): +def test_import_adaptive_mt_file_rest(request_type): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } request = request_type(**request_init) # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.ListGlossariesResponse( - next_page_token="next_page_token_value", - ) + return_value = adaptive_mt.ImportAdaptiveMtFileResponse() # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.ListGlossariesResponse.pb(return_value) + return_value = adaptive_mt.ImportAdaptiveMtFileResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.list_glossaries(request) + response = client.import_adaptive_mt_file(request) # Establish that the response is the type that we expect. - assert isinstance(response, pagers.ListGlossariesPager) - assert response.next_page_token == "next_page_token_value" + assert isinstance(response, adaptive_mt.ImportAdaptiveMtFileResponse) -def test_list_glossaries_rest_required_fields( - request_type=translation_service.ListGlossariesRequest, +def test_import_adaptive_mt_file_rest_required_fields( + request_type=adaptive_mt.ImportAdaptiveMtFileRequest, ): transport_class = transports.TranslationServiceRestTransport @@ -5363,7 +11425,7 @@ def test_list_glossaries_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).list_glossaries._get_unset_required_fields(jsonified_request) + ).import_adaptive_mt_file._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present @@ -5372,15 +11434,7 @@ def test_list_glossaries_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).list_glossaries._get_unset_required_fields(jsonified_request) - # Check that path parameters and body parameters are not mixing in. - assert not set(unset_fields) - set( - ( - "filter", - "page_size", - "page_token", - ) - ) + ).import_adaptive_mt_file._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone @@ -5394,7 +11448,7 @@ def test_list_glossaries_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = translation_service.ListGlossariesResponse() + return_value = adaptive_mt.ImportAdaptiveMtFileResponse() # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -5406,48 +11460,40 @@ def test_list_glossaries_rest_required_fields( pb_request = request_type.pb(request) transcode_result = { "uri": "v1/sample_method", - "method": "get", + "method": "post", "query_params": pb_request, } + transcode_result["body"] = pb_request transcode.return_value = transcode_result response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.ListGlossariesResponse.pb(return_value) + return_value = adaptive_mt.ImportAdaptiveMtFileResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.list_glossaries(request) + response = client.import_adaptive_mt_file(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_list_glossaries_rest_unset_required_fields(): +def test_import_adaptive_mt_file_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.list_glossaries._get_unset_required_fields({}) - assert set(unset_fields) == ( - set( - ( - "filter", - "pageSize", - "pageToken", - ) - ) - & set(("parent",)) - ) + unset_fields = transport.import_adaptive_mt_file._get_unset_required_fields({}) + assert set(unset_fields) == (set(()) & set(("parent",))) @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_list_glossaries_rest_interceptors(null_interceptor): +def test_import_adaptive_mt_file_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -5460,14 +11506,14 @@ def test_list_glossaries_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_list_glossaries" + transports.TranslationServiceRestInterceptor, "post_import_adaptive_mt_file" ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_list_glossaries" + transports.TranslationServiceRestInterceptor, "pre_import_adaptive_mt_file" ) as pre: pre.assert_not_called() post.assert_not_called() - pb_message = translation_service.ListGlossariesRequest.pb( - translation_service.ListGlossariesRequest() + pb_message = adaptive_mt.ImportAdaptiveMtFileRequest.pb( + adaptive_mt.ImportAdaptiveMtFileRequest() ) transcode.return_value = { "method": "post", @@ -5479,19 +11525,19 @@ def test_list_glossaries_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = translation_service.ListGlossariesResponse.to_json( - translation_service.ListGlossariesResponse() + req.return_value._content = adaptive_mt.ImportAdaptiveMtFileResponse.to_json( + adaptive_mt.ImportAdaptiveMtFileResponse() ) - request = translation_service.ListGlossariesRequest() + request = adaptive_mt.ImportAdaptiveMtFileRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = translation_service.ListGlossariesResponse() + post.return_value = adaptive_mt.ImportAdaptiveMtFileResponse() - client.list_glossaries( + client.import_adaptive_mt_file( request, metadata=[ ("key", "val"), @@ -5503,8 +11549,8 @@ def test_list_glossaries_rest_interceptors(null_interceptor): post.assert_called_once() -def test_list_glossaries_rest_bad_request( - transport: str = "rest", request_type=translation_service.ListGlossariesRequest +def test_import_adaptive_mt_file_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.ImportAdaptiveMtFileRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -5512,7 +11558,9 @@ def test_list_glossaries_rest_bad_request( ) # send a request that will satisfy transcoding - request_init = {"parent": "projects/sample1/locations/sample2"} + request_init = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } request = request_type(**request_init) # Mock the http request call within the method and fake a BadRequest error. @@ -5524,10 +11572,10 @@ def test_list_glossaries_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.list_glossaries(request) + client.import_adaptive_mt_file(request) -def test_list_glossaries_rest_flattened(): +def test_import_adaptive_mt_file_rest_flattened(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -5536,10 +11584,12 @@ def test_list_glossaries_rest_flattened(): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.ListGlossariesResponse() + return_value = adaptive_mt.ImportAdaptiveMtFileResponse() # get arguments that satisfy an http rule for this method - sample_request = {"parent": "projects/sample1/locations/sample2"} + sample_request = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } # get truthy value for each flattened field mock_args = dict( @@ -5551,24 +11601,25 @@ def test_list_glossaries_rest_flattened(): response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.ListGlossariesResponse.pb(return_value) + return_value = adaptive_mt.ImportAdaptiveMtFileResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - client.list_glossaries(**mock_args) + client.import_adaptive_mt_file(**mock_args) # Establish that the underlying call was made with the expected # request object values. assert len(req.mock_calls) == 1 _, args, _ = req.mock_calls[0] assert path_template.validate( - "%s/v3/{parent=projects/*/locations/*}/glossaries" % client.transport._host, + "%s/v3/{parent=projects/*/locations/*/adaptiveMtDatasets/*}:importAdaptiveMtFile" + % client.transport._host, args[1], ) -def test_list_glossaries_rest_flattened_error(transport: str = "rest"): +def test_import_adaptive_mt_file_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, @@ -5577,126 +11628,67 @@ def test_list_glossaries_rest_flattened_error(transport: str = "rest"): # Attempting to call a method with both a request object and flattened # fields is an error. with pytest.raises(ValueError): - client.list_glossaries( - translation_service.ListGlossariesRequest(), + client.import_adaptive_mt_file( + adaptive_mt.ImportAdaptiveMtFileRequest(), parent="parent_value", ) -def test_list_glossaries_rest_pager(transport: str = "rest"): +def test_import_adaptive_mt_file_rest_error(): client = TranslationServiceClient( - credentials=ga_credentials.AnonymousCredentials(), - transport=transport, + credentials=ga_credentials.AnonymousCredentials(), transport="rest" ) - # Mock the http request call within the method and fake a response. - with mock.patch.object(Session, "request") as req: - # TODO(kbandes): remove this mock unless there's a good reason for it. - # with mock.patch.object(path_template, 'transcode') as transcode: - # Set the response as a series of pages - response = ( - translation_service.ListGlossariesResponse( - glossaries=[ - translation_service.Glossary(), - translation_service.Glossary(), - translation_service.Glossary(), - ], - next_page_token="abc", - ), - translation_service.ListGlossariesResponse( - glossaries=[], - next_page_token="def", - ), - translation_service.ListGlossariesResponse( - glossaries=[ - translation_service.Glossary(), - ], - next_page_token="ghi", - ), - translation_service.ListGlossariesResponse( - glossaries=[ - translation_service.Glossary(), - translation_service.Glossary(), - ], - ), - ) - # Two responses for two calls - response = response + response - - # Wrap the values into proper Response objs - response = tuple( - translation_service.ListGlossariesResponse.to_json(x) for x in response - ) - return_values = tuple(Response() for i in response) - for return_val, response_val in zip(return_values, response): - return_val._content = response_val.encode("UTF-8") - return_val.status_code = 200 - req.side_effect = return_values - - sample_request = {"parent": "projects/sample1/locations/sample2"} - - pager = client.list_glossaries(request=sample_request) - - results = list(pager) - assert len(results) == 6 - assert all(isinstance(i, translation_service.Glossary) for i in results) - - pages = list(client.list_glossaries(request=sample_request).pages) - for page_, token in zip(pages, ["abc", "def", "ghi", ""]): - assert page_.raw_page.next_page_token == token - @pytest.mark.parametrize( "request_type", [ - translation_service.GetGlossaryRequest, + adaptive_mt.ListAdaptiveMtFilesRequest, dict, ], ) -def test_get_glossary_rest(request_type): +def test_list_adaptive_mt_files_rest(request_type): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", ) # send a request that will satisfy transcoding - request_init = {"name": "projects/sample1/locations/sample2/glossaries/sample3"} + request_init = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } request = request_type(**request_init) # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.Glossary( - name="name_value", - entry_count=1210, - display_name="display_name_value", + return_value = adaptive_mt.ListAdaptiveMtFilesResponse( + next_page_token="next_page_token_value", ) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.Glossary.pb(return_value) + return_value = adaptive_mt.ListAdaptiveMtFilesResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.get_glossary(request) + response = client.list_adaptive_mt_files(request) # Establish that the response is the type that we expect. - assert isinstance(response, translation_service.Glossary) - assert response.name == "name_value" - assert response.entry_count == 1210 - assert response.display_name == "display_name_value" + assert isinstance(response, pagers.ListAdaptiveMtFilesPager) + assert response.next_page_token == "next_page_token_value" -def test_get_glossary_rest_required_fields( - request_type=translation_service.GetGlossaryRequest, +def test_list_adaptive_mt_files_rest_required_fields( + request_type=adaptive_mt.ListAdaptiveMtFilesRequest, ): transport_class = transports.TranslationServiceRestTransport request_init = {} - request_init["name"] = "" + request_init["parent"] = "" request = request_type(**request_init) pb_request = request_type.pb(request) jsonified_request = json.loads( @@ -5711,21 +11703,28 @@ def test_get_glossary_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).get_glossary._get_unset_required_fields(jsonified_request) + ).list_adaptive_mt_files._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present - jsonified_request["name"] = "name_value" + jsonified_request["parent"] = "parent_value" unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).get_glossary._get_unset_required_fields(jsonified_request) + ).list_adaptive_mt_files._get_unset_required_fields(jsonified_request) + # Check that path parameters and body parameters are not mixing in. + assert not set(unset_fields) - set( + ( + "page_size", + "page_token", + ) + ) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone - assert "name" in jsonified_request - assert jsonified_request["name"] == "name_value" + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -5734,7 +11733,7 @@ def test_get_glossary_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = translation_service.Glossary() + return_value = adaptive_mt.ListAdaptiveMtFilesResponse() # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -5755,30 +11754,38 @@ def test_get_glossary_rest_required_fields( response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.Glossary.pb(return_value) + return_value = adaptive_mt.ListAdaptiveMtFilesResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.get_glossary(request) + response = client.list_adaptive_mt_files(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_get_glossary_rest_unset_required_fields(): +def test_list_adaptive_mt_files_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.get_glossary._get_unset_required_fields({}) - assert set(unset_fields) == (set(()) & set(("name",))) - + unset_fields = transport.list_adaptive_mt_files._get_unset_required_fields({}) + assert set(unset_fields) == ( + set( + ( + "pageSize", + "pageToken", + ) + ) + & set(("parent",)) + ) + @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_get_glossary_rest_interceptors(null_interceptor): +def test_list_adaptive_mt_files_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -5791,14 +11798,14 @@ def test_get_glossary_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_get_glossary" + transports.TranslationServiceRestInterceptor, "post_list_adaptive_mt_files" ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_get_glossary" + transports.TranslationServiceRestInterceptor, "pre_list_adaptive_mt_files" ) as pre: pre.assert_not_called() post.assert_not_called() - pb_message = translation_service.GetGlossaryRequest.pb( - translation_service.GetGlossaryRequest() + pb_message = adaptive_mt.ListAdaptiveMtFilesRequest.pb( + adaptive_mt.ListAdaptiveMtFilesRequest() ) transcode.return_value = { "method": "post", @@ -5810,19 +11817,19 @@ def test_get_glossary_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = translation_service.Glossary.to_json( - translation_service.Glossary() + req.return_value._content = adaptive_mt.ListAdaptiveMtFilesResponse.to_json( + adaptive_mt.ListAdaptiveMtFilesResponse() ) - request = translation_service.GetGlossaryRequest() + request = adaptive_mt.ListAdaptiveMtFilesRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = translation_service.Glossary() + post.return_value = adaptive_mt.ListAdaptiveMtFilesResponse() - client.get_glossary( + client.list_adaptive_mt_files( request, metadata=[ ("key", "val"), @@ -5834,8 +11841,8 @@ def test_get_glossary_rest_interceptors(null_interceptor): post.assert_called_once() -def test_get_glossary_rest_bad_request( - transport: str = "rest", request_type=translation_service.GetGlossaryRequest +def test_list_adaptive_mt_files_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.ListAdaptiveMtFilesRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -5843,7 +11850,9 @@ def test_get_glossary_rest_bad_request( ) # send a request that will satisfy transcoding - request_init = {"name": "projects/sample1/locations/sample2/glossaries/sample3"} + request_init = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } request = request_type(**request_init) # Mock the http request call within the method and fake a BadRequest error. @@ -5855,10 +11864,10 @@ def test_get_glossary_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.get_glossary(request) + client.list_adaptive_mt_files(request) -def test_get_glossary_rest_flattened(): +def test_list_adaptive_mt_files_rest_flattened(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -5867,16 +11876,16 @@ def test_get_glossary_rest_flattened(): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = translation_service.Glossary() + return_value = adaptive_mt.ListAdaptiveMtFilesResponse() # get arguments that satisfy an http rule for this method sample_request = { - "name": "projects/sample1/locations/sample2/glossaries/sample3" + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" } # get truthy value for each flattened field mock_args = dict( - name="name_value", + parent="parent_value", ) mock_args.update(sample_request) @@ -5884,24 +11893,25 @@ def test_get_glossary_rest_flattened(): response_value = Response() response_value.status_code = 200 # Convert return value to protobuf type - return_value = translation_service.Glossary.pb(return_value) + return_value = adaptive_mt.ListAdaptiveMtFilesResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - client.get_glossary(**mock_args) + client.list_adaptive_mt_files(**mock_args) # Establish that the underlying call was made with the expected # request object values. assert len(req.mock_calls) == 1 _, args, _ = req.mock_calls[0] assert path_template.validate( - "%s/v3/{name=projects/*/locations/*/glossaries/*}" % client.transport._host, + "%s/v3/{parent=projects/*/locations/*/adaptiveMtDatasets/*}/adaptiveMtFiles" + % client.transport._host, args[1], ) -def test_get_glossary_rest_flattened_error(transport: str = "rest"): +def test_list_adaptive_mt_files_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, @@ -5910,60 +11920,126 @@ def test_get_glossary_rest_flattened_error(transport: str = "rest"): # Attempting to call a method with both a request object and flattened # fields is an error. with pytest.raises(ValueError): - client.get_glossary( - translation_service.GetGlossaryRequest(), - name="name_value", + client.list_adaptive_mt_files( + adaptive_mt.ListAdaptiveMtFilesRequest(), + parent="parent_value", ) -def test_get_glossary_rest_error(): +def test_list_adaptive_mt_files_rest_pager(transport: str = "rest"): client = TranslationServiceClient( - credentials=ga_credentials.AnonymousCredentials(), transport="rest" + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, ) + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # TODO(kbandes): remove this mock unless there's a good reason for it. + # with mock.patch.object(path_template, 'transcode') as transcode: + # Set the response as a series of pages + response = ( + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtFilesResponse( + adaptive_mt_files=[ + adaptive_mt.AdaptiveMtFile(), + adaptive_mt.AdaptiveMtFile(), + ], + ), + ) + # Two responses for two calls + response = response + response + + # Wrap the values into proper Response objs + response = tuple( + adaptive_mt.ListAdaptiveMtFilesResponse.to_json(x) for x in response + ) + return_values = tuple(Response() for i in response) + for return_val, response_val in zip(return_values, response): + return_val._content = response_val.encode("UTF-8") + return_val.status_code = 200 + req.side_effect = return_values + + sample_request = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3" + } + + pager = client.list_adaptive_mt_files(request=sample_request) + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtFile) for i in results) + + pages = list(client.list_adaptive_mt_files(request=sample_request).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + @pytest.mark.parametrize( "request_type", [ - translation_service.DeleteGlossaryRequest, + adaptive_mt.ListAdaptiveMtSentencesRequest, dict, ], ) -def test_delete_glossary_rest(request_type): +def test_list_adaptive_mt_sentences_rest(request_type): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", ) # send a request that will satisfy transcoding - request_init = {"name": "projects/sample1/locations/sample2/glossaries/sample3"} + request_init = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } request = request_type(**request_init) # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = adaptive_mt.ListAdaptiveMtSentencesResponse( + next_page_token="next_page_token_value", + ) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 + # Convert return value to protobuf type + return_value = adaptive_mt.ListAdaptiveMtSentencesResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.delete_glossary(request) + response = client.list_adaptive_mt_sentences(request) # Establish that the response is the type that we expect. - assert response.operation.name == "operations/spam" + assert isinstance(response, pagers.ListAdaptiveMtSentencesPager) + assert response.next_page_token == "next_page_token_value" -def test_delete_glossary_rest_required_fields( - request_type=translation_service.DeleteGlossaryRequest, +def test_list_adaptive_mt_sentences_rest_required_fields( + request_type=adaptive_mt.ListAdaptiveMtSentencesRequest, ): transport_class = transports.TranslationServiceRestTransport request_init = {} - request_init["name"] = "" + request_init["parent"] = "" request = request_type(**request_init) pb_request = request_type.pb(request) jsonified_request = json.loads( @@ -5978,21 +12054,28 @@ def test_delete_glossary_rest_required_fields( unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).delete_glossary._get_unset_required_fields(jsonified_request) + ).list_adaptive_mt_sentences._get_unset_required_fields(jsonified_request) jsonified_request.update(unset_fields) # verify required fields with default values are now present - jsonified_request["name"] = "name_value" + jsonified_request["parent"] = "parent_value" unset_fields = transport_class( credentials=ga_credentials.AnonymousCredentials() - ).delete_glossary._get_unset_required_fields(jsonified_request) + ).list_adaptive_mt_sentences._get_unset_required_fields(jsonified_request) + # Check that path parameters and body parameters are not mixing in. + assert not set(unset_fields) - set( + ( + "page_size", + "page_token", + ) + ) jsonified_request.update(unset_fields) # verify required fields with non-default values are left alone - assert "name" in jsonified_request - assert jsonified_request["name"] == "name_value" + assert "parent" in jsonified_request + assert jsonified_request["parent"] == "parent_value" client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -6001,7 +12084,7 @@ def test_delete_glossary_rest_required_fields( request = request_type(**request_init) # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = adaptive_mt.ListAdaptiveMtSentencesResponse() # Mock the http request call within the method and fake a response. with mock.patch.object(Session, "request") as req: # We need to mock transcode() because providing default values @@ -6013,36 +12096,47 @@ def test_delete_glossary_rest_required_fields( pb_request = request_type.pb(request) transcode_result = { "uri": "v1/sample_method", - "method": "delete", + "method": "get", "query_params": pb_request, } transcode.return_value = transcode_result response_value = Response() response_value.status_code = 200 + + # Convert return value to protobuf type + return_value = adaptive_mt.ListAdaptiveMtSentencesResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - response = client.delete_glossary(request) + response = client.list_adaptive_mt_sentences(request) expected_params = [("$alt", "json;enum-encoding=int")] actual_params = req.call_args.kwargs["params"] assert expected_params == actual_params -def test_delete_glossary_rest_unset_required_fields(): +def test_list_adaptive_mt_sentences_rest_unset_required_fields(): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials ) - unset_fields = transport.delete_glossary._get_unset_required_fields({}) - assert set(unset_fields) == (set(()) & set(("name",))) + unset_fields = transport.list_adaptive_mt_sentences._get_unset_required_fields({}) + assert set(unset_fields) == ( + set( + ( + "pageSize", + "pageToken", + ) + ) + & set(("parent",)) + ) @pytest.mark.parametrize("null_interceptor", [True, False]) -def test_delete_glossary_rest_interceptors(null_interceptor): +def test_list_adaptive_mt_sentences_rest_interceptors(null_interceptor): transport = transports.TranslationServiceRestTransport( credentials=ga_credentials.AnonymousCredentials(), interceptor=None @@ -6055,16 +12149,14 @@ def test_delete_glossary_rest_interceptors(null_interceptor): ) as req, mock.patch.object( path_template, "transcode" ) as transcode, mock.patch.object( - operation.Operation, "_set_result_from_operation" - ), mock.patch.object( - transports.TranslationServiceRestInterceptor, "post_delete_glossary" + transports.TranslationServiceRestInterceptor, "post_list_adaptive_mt_sentences" ) as post, mock.patch.object( - transports.TranslationServiceRestInterceptor, "pre_delete_glossary" + transports.TranslationServiceRestInterceptor, "pre_list_adaptive_mt_sentences" ) as pre: pre.assert_not_called() post.assert_not_called() - pb_message = translation_service.DeleteGlossaryRequest.pb( - translation_service.DeleteGlossaryRequest() + pb_message = adaptive_mt.ListAdaptiveMtSentencesRequest.pb( + adaptive_mt.ListAdaptiveMtSentencesRequest() ) transcode.return_value = { "method": "post", @@ -6076,19 +12168,19 @@ def test_delete_glossary_rest_interceptors(null_interceptor): req.return_value = Response() req.return_value.status_code = 200 req.return_value.request = PreparedRequest() - req.return_value._content = json_format.MessageToJson( - operations_pb2.Operation() + req.return_value._content = adaptive_mt.ListAdaptiveMtSentencesResponse.to_json( + adaptive_mt.ListAdaptiveMtSentencesResponse() ) - request = translation_service.DeleteGlossaryRequest() + request = adaptive_mt.ListAdaptiveMtSentencesRequest() metadata = [ ("key", "val"), ("cephalopod", "squid"), ] pre.return_value = request, metadata - post.return_value = operations_pb2.Operation() + post.return_value = adaptive_mt.ListAdaptiveMtSentencesResponse() - client.delete_glossary( + client.list_adaptive_mt_sentences( request, metadata=[ ("key", "val"), @@ -6100,8 +12192,8 @@ def test_delete_glossary_rest_interceptors(null_interceptor): post.assert_called_once() -def test_delete_glossary_rest_bad_request( - transport: str = "rest", request_type=translation_service.DeleteGlossaryRequest +def test_list_adaptive_mt_sentences_rest_bad_request( + transport: str = "rest", request_type=adaptive_mt.ListAdaptiveMtSentencesRequest ): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), @@ -6109,7 +12201,9 @@ def test_delete_glossary_rest_bad_request( ) # send a request that will satisfy transcoding - request_init = {"name": "projects/sample1/locations/sample2/glossaries/sample3"} + request_init = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } request = request_type(**request_init) # Mock the http request call within the method and fake a BadRequest error. @@ -6121,10 +12215,10 @@ def test_delete_glossary_rest_bad_request( response_value.status_code = 400 response_value.request = Request() req.return_value = response_value - client.delete_glossary(request) + client.list_adaptive_mt_sentences(request) -def test_delete_glossary_rest_flattened(): +def test_list_adaptive_mt_sentences_rest_flattened(): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport="rest", @@ -6133,39 +12227,42 @@ def test_delete_glossary_rest_flattened(): # Mock the http request call within the method and fake a response. with mock.patch.object(type(client.transport._session), "request") as req: # Designate an appropriate value for the returned response. - return_value = operations_pb2.Operation(name="operations/spam") + return_value = adaptive_mt.ListAdaptiveMtSentencesResponse() # get arguments that satisfy an http rule for this method sample_request = { - "name": "projects/sample1/locations/sample2/glossaries/sample3" + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" } # get truthy value for each flattened field mock_args = dict( - name="name_value", + parent="parent_value", ) mock_args.update(sample_request) # Wrap the value into a proper Response obj response_value = Response() response_value.status_code = 200 + # Convert return value to protobuf type + return_value = adaptive_mt.ListAdaptiveMtSentencesResponse.pb(return_value) json_return_value = json_format.MessageToJson(return_value) response_value._content = json_return_value.encode("UTF-8") req.return_value = response_value - client.delete_glossary(**mock_args) + client.list_adaptive_mt_sentences(**mock_args) # Establish that the underlying call was made with the expected # request object values. assert len(req.mock_calls) == 1 _, args, _ = req.mock_calls[0] assert path_template.validate( - "%s/v3/{name=projects/*/locations/*/glossaries/*}" % client.transport._host, + "%s/v3/{parent=projects/*/locations/*/adaptiveMtDatasets/*/adaptiveMtFiles/*}/adaptiveMtSentences" + % client.transport._host, args[1], ) -def test_delete_glossary_rest_flattened_error(transport: str = "rest"): +def test_list_adaptive_mt_sentences_rest_flattened_error(transport: str = "rest"): client = TranslationServiceClient( credentials=ga_credentials.AnonymousCredentials(), transport=transport, @@ -6174,17 +12271,76 @@ def test_delete_glossary_rest_flattened_error(transport: str = "rest"): # Attempting to call a method with both a request object and flattened # fields is an error. with pytest.raises(ValueError): - client.delete_glossary( - translation_service.DeleteGlossaryRequest(), - name="name_value", + client.list_adaptive_mt_sentences( + adaptive_mt.ListAdaptiveMtSentencesRequest(), + parent="parent_value", ) -def test_delete_glossary_rest_error(): +def test_list_adaptive_mt_sentences_rest_pager(transport: str = "rest"): client = TranslationServiceClient( - credentials=ga_credentials.AnonymousCredentials(), transport="rest" + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, ) + # Mock the http request call within the method and fake a response. + with mock.patch.object(Session, "request") as req: + # TODO(kbandes): remove this mock unless there's a good reason for it. + # with mock.patch.object(path_template, 'transcode') as transcode: + # Set the response as a series of pages + response = ( + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="abc", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[], + next_page_token="def", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + ], + next_page_token="ghi", + ), + adaptive_mt.ListAdaptiveMtSentencesResponse( + adaptive_mt_sentences=[ + adaptive_mt.AdaptiveMtSentence(), + adaptive_mt.AdaptiveMtSentence(), + ], + ), + ) + # Two responses for two calls + response = response + response + + # Wrap the values into proper Response objs + response = tuple( + adaptive_mt.ListAdaptiveMtSentencesResponse.to_json(x) for x in response + ) + return_values = tuple(Response() for i in response) + for return_val, response_val in zip(return_values, response): + return_val._content = response_val.encode("UTF-8") + return_val.status_code = 200 + req.side_effect = return_values + + sample_request = { + "parent": "projects/sample1/locations/sample2/adaptiveMtDatasets/sample3/adaptiveMtFiles/sample4" + } + + pager = client.list_adaptive_mt_sentences(request=sample_request) + + results = list(pager) + assert len(results) == 6 + assert all(isinstance(i, adaptive_mt.AdaptiveMtSentence) for i in results) + + pages = list(client.list_adaptive_mt_sentences(request=sample_request).pages) + for page_, token in zip(pages, ["abc", "def", "ghi", ""]): + assert page_.raw_page.next_page_token == token + def test_credentials_transport_error(): # It is an error to provide credentials and a transport instance. @@ -6335,6 +12491,16 @@ def test_translation_service_base_transport(): "list_glossaries", "get_glossary", "delete_glossary", + "create_adaptive_mt_dataset", + "delete_adaptive_mt_dataset", + "get_adaptive_mt_dataset", + "list_adaptive_mt_datasets", + "adaptive_mt_translate", + "get_adaptive_mt_file", + "delete_adaptive_mt_file", + "import_adaptive_mt_file", + "list_adaptive_mt_files", + "list_adaptive_mt_sentences", ) for method in methods: with pytest.raises(NotImplementedError): @@ -6659,6 +12825,36 @@ def test_translation_service_client_transport_session_collision(transport_name): session1 = client1.transport.delete_glossary._session session2 = client2.transport.delete_glossary._session assert session1 != session2 + session1 = client1.transport.create_adaptive_mt_dataset._session + session2 = client2.transport.create_adaptive_mt_dataset._session + assert session1 != session2 + session1 = client1.transport.delete_adaptive_mt_dataset._session + session2 = client2.transport.delete_adaptive_mt_dataset._session + assert session1 != session2 + session1 = client1.transport.get_adaptive_mt_dataset._session + session2 = client2.transport.get_adaptive_mt_dataset._session + assert session1 != session2 + session1 = client1.transport.list_adaptive_mt_datasets._session + session2 = client2.transport.list_adaptive_mt_datasets._session + assert session1 != session2 + session1 = client1.transport.adaptive_mt_translate._session + session2 = client2.transport.adaptive_mt_translate._session + assert session1 != session2 + session1 = client1.transport.get_adaptive_mt_file._session + session2 = client2.transport.get_adaptive_mt_file._session + assert session1 != session2 + session1 = client1.transport.delete_adaptive_mt_file._session + session2 = client2.transport.delete_adaptive_mt_file._session + assert session1 != session2 + session1 = client1.transport.import_adaptive_mt_file._session + session2 = client2.transport.import_adaptive_mt_file._session + assert session1 != session2 + session1 = client1.transport.list_adaptive_mt_files._session + session2 = client2.transport.list_adaptive_mt_files._session + assert session1 != session2 + session1 = client1.transport.list_adaptive_mt_sentences._session + session2 = client2.transport.list_adaptive_mt_sentences._session + assert session1 != session2 def test_translation_service_grpc_transport_channel(): @@ -6821,6 +13017,101 @@ def test_translation_service_grpc_lro_async_client(): assert transport.operations_client is transport.operations_client +def test_adaptive_mt_dataset_path(): + project = "squid" + location = "clam" + dataset = "whelk" + expected = ( + "projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}".format( + project=project, + location=location, + dataset=dataset, + ) + ) + actual = TranslationServiceClient.adaptive_mt_dataset_path( + project, location, dataset + ) + assert expected == actual + + +def test_parse_adaptive_mt_dataset_path(): + expected = { + "project": "octopus", + "location": "oyster", + "dataset": "nudibranch", + } + path = TranslationServiceClient.adaptive_mt_dataset_path(**expected) + + # Check that the path construction is reversible. + actual = TranslationServiceClient.parse_adaptive_mt_dataset_path(path) + assert expected == actual + + +def test_adaptive_mt_file_path(): + project = "cuttlefish" + location = "mussel" + dataset = "winkle" + file = "nautilus" + expected = "projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}".format( + project=project, + location=location, + dataset=dataset, + file=file, + ) + actual = TranslationServiceClient.adaptive_mt_file_path( + project, location, dataset, file + ) + assert expected == actual + + +def test_parse_adaptive_mt_file_path(): + expected = { + "project": "scallop", + "location": "abalone", + "dataset": "squid", + "file": "clam", + } + path = TranslationServiceClient.adaptive_mt_file_path(**expected) + + # Check that the path construction is reversible. + actual = TranslationServiceClient.parse_adaptive_mt_file_path(path) + assert expected == actual + + +def test_adaptive_mt_sentence_path(): + project = "whelk" + location = "octopus" + dataset = "oyster" + file = "nudibranch" + sentence = "cuttlefish" + expected = "projects/{project}/locations/{location}/adaptiveMtDatasets/{dataset}/adaptiveMtFiles/{file}/adaptiveMtSentences/{sentence}".format( + project=project, + location=location, + dataset=dataset, + file=file, + sentence=sentence, + ) + actual = TranslationServiceClient.adaptive_mt_sentence_path( + project, location, dataset, file, sentence + ) + assert expected == actual + + +def test_parse_adaptive_mt_sentence_path(): + expected = { + "project": "mussel", + "location": "winkle", + "dataset": "nautilus", + "file": "scallop", + "sentence": "abalone", + } + path = TranslationServiceClient.adaptive_mt_sentence_path(**expected) + + # Check that the path construction is reversible. + actual = TranslationServiceClient.parse_adaptive_mt_sentence_path(path) + assert expected == actual + + def test_glossary_path(): project = "squid" location = "clam" diff --git a/packages/google-cloud-translate/tests/unit/gapic/translate_v3beta1/test_translation_service.py b/packages/google-cloud-translate/tests/unit/gapic/translate_v3beta1/test_translation_service.py index 1c98eacc1adb..e728b8570084 100644 --- a/packages/google-cloud-translate/tests/unit/gapic/translate_v3beta1/test_translation_service.py +++ b/packages/google-cloud-translate/tests/unit/gapic/translate_v3beta1/test_translation_service.py @@ -26,14 +26,6 @@ import json import math -import grpc -from grpc.experimental import aio -from proto.marshal.rules import wrappers -from proto.marshal.rules.dates import DurationRule, TimestampRule -import pytest -from requests import PreparedRequest, Request, Response -from requests.sessions import Session - from google.api_core import ( future, gapic_v1, @@ -49,6 +41,18 @@ import google.auth from google.auth import credentials as ga_credentials from google.auth.exceptions import MutualTLSChannelError +from google.longrunning import operations_pb2 # type: ignore +from google.oauth2 import service_account +from google.protobuf import json_format +from google.protobuf import timestamp_pb2 # type: ignore +import grpc +from grpc.experimental import aio +from proto.marshal.rules import wrappers +from proto.marshal.rules.dates import DurationRule, TimestampRule +import pytest +from requests import PreparedRequest, Request, Response +from requests.sessions import Session + from google.cloud.translate_v3beta1.services.translation_service import ( TranslationServiceAsyncClient, TranslationServiceClient, @@ -56,10 +60,6 @@ transports, ) from google.cloud.translate_v3beta1.types import translation_service -from google.longrunning import operations_pb2 # type: ignore -from google.oauth2 import service_account -from google.protobuf import json_format -from google.protobuf import timestamp_pb2 # type: ignore def client_cert_source_callback(): diff --git a/packages/google-cloud-translate/tests/unit/v2/test_client.py b/packages/google-cloud-translate/tests/unit/v2/test_client.py index d032fe1baa92..0a33d0406e7a 100644 --- a/packages/google-cloud-translate/tests/unit/v2/test_client.py +++ b/packages/google-cloud-translate/tests/unit/v2/test_client.py @@ -27,6 +27,7 @@ def _make_one(self, *args, **kw): def test_constructor_defaults(self): from google.cloud._http import ClientInfo + from google.cloud.translate_v2._http import Connection from google.cloud.translate_v2.client import ENGLISH_ISO_639 @@ -40,6 +41,7 @@ def test_constructor_defaults(self): def test_constructor_explicit(self): from google.cloud._http import ClientInfo + from google.cloud.translate_v2._http import Connection http = object()