feat(translate): add region tag 'import_client_library' and refactor sample (GoogleCloudPlatform#13255)

* chore(translate): delete remaining markdown files from repo migration

* feat(translate): add region tag 'import_client_library' and style fixing

* fix(translate): refactor sample 'translate_v3_translate_text' and its test

* fix(translate): apply feedback from 'glasnt'

- Comment: GoogleCloudPlatform#13255 (review)

* fix(translate): restore comment related to supported MIME types

GoogleCloudPlatform#13255 (comment)

* fix(translate): restore import to 'translate_v3' after testing compatibility with '_v3beta1'

* fix(translate): update to latest dependencies, and allow testing on Python 3.9+

* fix(translate): revert updating to latest dependencies, as it's breaking compatibility with vertexai

* fix(translate): remove comment about library not compatible with Python 3.12 even when it was tested locally

Author: eapl-gemugami

translate/samples/AUTHORING_GUIDE.md

@@ -22,8 +22,7 @@
 
 TEST_CONFIG_OVERRIDE = {
     # You can opt out from the test for specific Python versions.
-    # Google-cloud-translate doesn't work with Python 3.12 for now.
-    "ignored_versions": ["2.7", "3.7", "3.8", "3.10", "3.12", "3.13"],
+    "ignored_versions": ["2.7", "3.7", "3.8"],
     # Old samples are opted out of enforcing Python type hints
     # All new samples should feature them
     "enforce_type_hints": True,

translate/samples/CONTRIBUTING.md

@@ -13,49 +13,62 @@
 # limitations under the License.
 
 # [START translate_v3_translate_text]
-# Imports the Google Cloud Translation library
 import os
 
+# Import the Google Cloud Translation library.
+# [START translate_v3_import_client_library]
 from google.cloud import translate_v3
+# [END translate_v3_import_client_library]
 
 PROJECT_ID = os.environ.get("GOOGLE_CLOUD_PROJECT")
 
 
-# Initialize Translation client
 def translate_text(
     text: str = "YOUR_TEXT_TO_TRANSLATE",
-    language_code: str = "fr",
+    source_language_code: str = "en-US",
+    target_language_code: str = "fr",
 ) -> translate_v3.TranslationServiceClient:
-    """Translating Text from English.
+    """Translate Text from a Source language to a Target language.
     Args:
         text: The content to translate.
-        language_code: The language code for the translation.
-            E.g. "fr" for French, "es" for Spanish, etc.
-            Available languages: https://cloud.google.com/translate/docs/languages#neural_machine_translation_model
+        source_language_code: The code of the source language.
+        target_language_code: The code of the target language.
+            For example: "fr" for French, "es" for Spanish, etc.
+            Find available languages and codes here:
+            https://cloud.google.com/translate/docs/languages#neural_machine_translation_model
     """
 
+    # Initialize Translation client.
     client = translate_v3.TranslationServiceClient()
     parent = f"projects/{PROJECT_ID}/locations/global"
-    # Translate text from English to chosen language
-    # Supported mime types: # https://cloud.google.com/translate/docs/supported-formats
+
+    # MIME type of the content to translate.
+    # Supported MIME types:
+    # https://cloud.google.com/translate/docs/supported-formats
+    mime_type = "text/plain"
+
+    # Translate text from the source to the target language.
     response = client.translate_text(
         contents=[text],
-        target_language_code=language_code,
         parent=parent,
-        mime_type="text/plain",
-        source_language_code="en-US",
+        mime_type=mime_type,
+        source_language_code=source_language_code,
+        target_language_code=target_language_code,
     )
 
-    # Display the translation for each input text provided
+    # Display the translation for the text.
+    # For example, for "Hello! How are you doing today?":
+    # Translated text: Bonjour comment vas-tu aujourd'hui?
     for translation in response.translations:
         print(f"Translated text: {translation.translated_text}")
-    # Example response:
-    # Translated text: Bonjour comment vas-tu aujourd'hui?
 
     return response
-
-
 # [END translate_v3_translate_text]
 
+
 if __name__ == "__main__":
-    translate_text(text="Hello! How are you doing today?", language_code="fr")
+    translate_text(
+        text="Hello! How are you doing today?",
+        source_language_code="en-US",
+        target_language_code="fr"
+    )

translate/samples/snippets/noxfile_config.py

@@ -12,12 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import pytest
-
 import translate_v3_translate_text
 
 
-def test_translate_text(capsys: pytest.LogCaptureFixture) -> None:
-    response = translate_v3_translate_text.translate_text("Hello World!", "fr")
-    out, _ = capsys.readouterr()
+def test_translate_text() -> None:
+    response = translate_v3_translate_text.translate_text("Hello World!", "en-US", "fr")
     assert "Bonjour le monde" in response.translations[0].translated_text