From b0cde7d51c2e2a2670889f3b1c78015c0c3decb9 Mon Sep 17 00:00:00 2001 From: Michelle Casbon Date: Fri, 31 Jan 2020 00:49:52 +0000 Subject: [PATCH 1/3] Migrate published samples Migrate from tmp-generated-samples branch 615c08e Remove boilerplate Update copyright date Blacken Remove unused imports Shorten docstrings Remove CLI Set defaults in function definition --- .../translate_v3_translate_text.py | 41 +++++++++++++++++++ .../translate_v3_translate_text_test.py | 26 ++++++++++++ 2 files changed, 67 insertions(+) create mode 100644 translate/cloud-client/translate_v3_translate_text.py create mode 100644 translate/cloud-client/translate_v3_translate_text_test.py diff --git a/translate/cloud-client/translate_v3_translate_text.py b/translate/cloud-client/translate_v3_translate_text.py new file mode 100644 index 000000000000..1776dfaddd9c --- /dev/null +++ b/translate/cloud-client/translate_v3_translate_text.py @@ -0,0 +1,41 @@ +# Copyright 2020 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 +# +# https://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. + +# [START translate_v3_translate_text] +from google.cloud import translate + + +def sample_translate_text( + text="Hello, world!", target_language="fr", project_id="[Google Cloud Project ID]" +): + """Translating Text.""" + + client = translate.TranslationServiceClient() + + contents = [text] + parent = client.location_path(project_id, "global") + + response = client.translate_text( + parent=parent, + contents=contents, + mime_type="text/plain", # mime types: text/plain, text/html + source_language_code="en-US", + target_language_code=target_language, + ) + # Display the translation for each input text provided + for translation in response.translations: + print(u"Translated text: {}".format(translation.translated_text)) + + +# [END translate_v3_translate_text] diff --git a/translate/cloud-client/translate_v3_translate_text_test.py b/translate/cloud-client/translate_v3_translate_text_test.py new file mode 100644 index 000000000000..9cecf56adfef --- /dev/null +++ b/translate/cloud-client/translate_v3_translate_text_test.py @@ -0,0 +1,26 @@ +# Copyright 2020 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. + +import os +import translate_v3_translate_text + +PROJECT_ID = os.environ["GCLOUD_PROJECT"] + + +def test_translate_text(capsys): + translate_v3_translate_text.sample_translate_text( + "Hello world", "sr-Latn", PROJECT_ID + ) + out, _ = capsys.readouterr() + assert "Zdravo svet" in out or "Pozdrav svijetu" in out or "Zdravo svijete" in out From 09c6a30a9298ed647d6d62e97a4ab1191216416e Mon Sep 17 00:00:00 2001 From: Michelle Casbon Date: Fri, 31 Jan 2020 18:03:08 +0000 Subject: [PATCH 2/3] Add link to supported types guide Inline function arguments --- translate/cloud-client/translate_v3_translate_text.py | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/translate/cloud-client/translate_v3_translate_text.py b/translate/cloud-client/translate_v3_translate_text.py index 1776dfaddd9c..b6820aaffee8 100644 --- a/translate/cloud-client/translate_v3_translate_text.py +++ b/translate/cloud-client/translate_v3_translate_text.py @@ -16,22 +16,21 @@ from google.cloud import translate -def sample_translate_text( - text="Hello, world!", target_language="fr", project_id="[Google Cloud Project ID]" -): +def sample_translate_text(project_id="[Google Cloud Project ID]"): """Translating Text.""" client = translate.TranslationServiceClient() - contents = [text] parent = client.location_path(project_id, "global") + # Detail on supported types can be found here: + # https://cloud.google.com/translate/docs/supported-formats response = client.translate_text( parent=parent, - contents=contents, + contents=["Hello, world!"], mime_type="text/plain", # mime types: text/plain, text/html source_language_code="en-US", - target_language_code=target_language, + target_language_code="fr", ) # Display the translation for each input text provided for translation in response.translations: From 11cba82238a70739ea06692a9c3f80eff4da8108 Mon Sep 17 00:00:00 2001 From: Michelle Casbon Date: Fri, 31 Jan 2020 19:07:25 +0000 Subject: [PATCH 3/3] Update tests to match argument removal --- translate/cloud-client/translate_v3_translate_text_test.py | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/translate/cloud-client/translate_v3_translate_text_test.py b/translate/cloud-client/translate_v3_translate_text_test.py index 9cecf56adfef..e4f8acfb14aa 100644 --- a/translate/cloud-client/translate_v3_translate_text_test.py +++ b/translate/cloud-client/translate_v3_translate_text_test.py @@ -19,8 +19,6 @@ def test_translate_text(capsys): - translate_v3_translate_text.sample_translate_text( - "Hello world", "sr-Latn", PROJECT_ID - ) + translate_v3_translate_text.sample_translate_text(PROJECT_ID) out, _ = capsys.readouterr() - assert "Zdravo svet" in out or "Pozdrav svijetu" in out or "Zdravo svijete" in out + assert "Bonjour le monde" in out