diff --git a/translation/samples/snippets/translate_v3_detect_language.py b/translation/samples/snippets/translate_v3_detect_language.py new file mode 100644 index 000000000000..9b92853cfca1 --- /dev/null +++ b/translation/samples/snippets/translate_v3_detect_language.py @@ -0,0 +1,43 @@ +# 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_detect_language] +from google.cloud import translate + + +def sample_detect_language(project_id="YOUR_PROJECT_ID"): + """Detecting the language of a text string.""" + + client = translate.TranslationServiceClient() + + 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.detect_language( + content="Hello, world!", + parent=parent, + mime_type="text/plain", # mime types: text/plain, text/html + ) + + # Display list of detected languages sorted by detection confidence. + # The most probable language is first. + for language in response.languages: + # The language detected + print(u"Language code: {}".format(language.language_code)) + # Confidence of detection result for this language + print(u"Confidence: {}".format(language.confidence)) + + +# [END translate_v3_detect_language] diff --git a/translation/samples/snippets/translate_v3_detect_language_test.py b/translation/samples/snippets/translate_v3_detect_language_test.py new file mode 100644 index 000000000000..82620bc550c1 --- /dev/null +++ b/translation/samples/snippets/translate_v3_detect_language_test.py @@ -0,0 +1,24 @@ +# 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_detect_language + +PROJECT_ID = os.environ["GCLOUD_PROJECT"] + + +def test_detect_language(capsys): + translate_v3_detect_language.sample_detect_language(PROJECT_ID) + out, _ = capsys.readouterr() + assert "en" in out diff --git a/translation/samples/snippets/translate_v3_get_supported_languages.py b/translation/samples/snippets/translate_v3_get_supported_languages.py new file mode 100644 index 000000000000..9a2df58dacce --- /dev/null +++ b/translation/samples/snippets/translate_v3_get_supported_languages.py @@ -0,0 +1,34 @@ +# 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_get_supported_languages] +from google.cloud import translate + + +def sample_get_supported_languages(project_id="YOUR_PROJECT_ID"): + """Getting a list of supported language codes.""" + + client = translate.TranslationServiceClient() + + parent = client.location_path(project_id, "global") + + response = client.get_supported_languages(parent=parent) + + # List language codes of supported languages. + print("Supported Languages:") + for language in response.languages: + print(u"Language Code: {}".format(language.language_code)) + + +# [END translate_v3_get_supported_languages] diff --git a/translation/samples/snippets/translate_v3_get_supported_languages_test.py b/translation/samples/snippets/translate_v3_get_supported_languages_test.py new file mode 100644 index 000000000000..b4ba4cd22b30 --- /dev/null +++ b/translation/samples/snippets/translate_v3_get_supported_languages_test.py @@ -0,0 +1,24 @@ +# 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_get_supported_languages + +PROJECT_ID = os.environ["GCLOUD_PROJECT"] + + +def test_list_languages(capsys): + translate_v3_get_supported_languages.sample_get_supported_languages(PROJECT_ID) + out, _ = capsys.readouterr() + assert "zh-CN" in out