🚚 Rename Translation to Translations

docs/resources/config.md

@@ -301,13 +301,13 @@ output style has been provided.
 You can customize `config.process_output`:
 
 ```python
-def process_output(translation):
+def process_output(translations):
     text = "\n".join(
         "\n".join(
             [rst["translator"] + ":", rst["paraphrase"] + rst["phonetic"]]
             + [k + " " + v for k, v in rst["explains"].items()]
         )
-        for rst in translation.results
+        for rst in translations.results
     )
     return text
 

src/translate_shell/config.py

@@ -6,7 +6,7 @@
 from argparse import Namespace
 from typing import Any, Literal
 
-from .translate import Translation
+from .translate import Translations
 
 
 class Configuration(Namespace):
@@ -64,16 +64,16 @@ def process_input(
         )
 
     @staticmethod
-    def process_output(translation: Translation) -> str:
+    def process_output(translations: Translations) -> str:
         """Process output.
 
-        :param translation:
-        :type translation: Translation
+        :param translations:
+        :type translations: Translations
         :rtype: str
         """
         from .utils.output import process_output
 
-        return process_output(translation)
+        return process_output(translations)
 
     @staticmethod
     def get_clipper() -> list[str]:

src/translate_shell/translate.py

@@ -14,7 +14,7 @@
 logger = logging.getLogger(__name__)
 
 
-class Translation(Namespace):
+class Translations(Namespace):
     """Translation."""
 
     def __init__(self, text: str, target_lang: str, source_lang: str) -> None:
@@ -39,27 +39,27 @@ def __init__(self, text: str, target_lang: str, source_lang: str) -> None:
 
 
 def translate_once(
-    translator: Translator, translation: Translation, option: dict[str, Any]
+    translator: Translator, translations: Translations, option: dict[str, Any]
 ) -> None:
     """Translate once.
 
     :param translator:
     :type translator: Translator
-    :param translation:
-    :type translation: Translation
+    :param translations:
+    :type translations: Translations
     :param option:
     :type option: dict[str, Any]
     :rtype: None
     """
     res = translator(
-        translation.text,
-        translation.to_lang,
-        translation.from_lang,
+        translations.text,
+        translations.to_lang,
+        translations.from_lang,
         option,
     )
     if res:
-        translation.results.append(deepcopy(res))
-        translation.status = 1
+        translations.results.append(deepcopy(res))
+        translations.status = 1
 
 
 def translate(
@@ -68,7 +68,7 @@ def translate(
     source_lang: str = "auto",
     translators: list[Callable[[], Translator]] | list[str] | None = None,
     options: dict[str, dict[str, Any]] | None = None,
-) -> Translation:
+) -> Translations:
     """Translate.
 
     :param text:
@@ -87,7 +87,7 @@ def translate(
         translators = ["google"]
     if options is None:
         options = {}
-    translation = Translation(text, target_lang, source_lang)
+    translations = Translations(text, target_lang, source_lang)
 
     true_translators = []
     for translator in translators:
@@ -100,7 +100,7 @@ def translate(
     if len(translators) == 1:
         translator = true_translators[0]
         translate_once(
-            translator, translation, options.get(translator.name, {})
+            translator, translations, options.get(translator.name, {})
         )
     else:
         threads = []
@@ -112,7 +112,7 @@ def translate(
                 target=translate_once,
                 args=(
                     translator,
-                    translation,
+                    translations,
                     options.get(translator.name, {}),
                 ),
             )
@@ -121,4 +121,4 @@ def translate(
         list(map(lambda x: x.start(), threads))
         list(map(lambda x: x.join(), threads))
 
-    return translation
+    return translations

src/translate_shell/ui/__init__.py

@@ -173,21 +173,21 @@ def get_processed_result_text(
         TRANSLATORS.get(translator, get_dummy(translator))
         for translator in translator_names
     ]
-    translation = translate(
+    translations = translate(
         text,
         target_lang,
         source_lang,
         translators,
         args.options,
     )
     if args.format == "json":
-        rst = json.dumps(vars(translation))
+        rst = json.dumps(vars(translations))
     elif args.format == "yaml":
         from ..external import yaml
 
-        rst = yaml.dump(vars(translation))
+        rst = yaml.dump(vars(translations))
     else:
-        rst = args.process_output(translation)
+        rst = args.process_output(translations)
         if rst and args.notification and is_sub_thread():
             args.notify(rst)
     return rst, text

src/translate_shell/utils/output.py

@@ -6,7 +6,7 @@
 
 from ..__main__ import ASSETS_PATH
 from ..external.colorama import Fore, Style
-from ..translate import Translation
+from ..translate import Translations
 from .misc import p10k_sections
 
 NUMBER = json.loads(
@@ -79,15 +79,15 @@ def process_output_pos(pos: str) -> str:
     return prompt
 
 
-def process_output_p10k(translation: Translation) -> str:
+def process_output_p10k(translations: Translations) -> str:
     """Process output p10k.
 
-    :param translation:
-    :type translation: Translation
+    :param translations:
+    :type translations: Translations
     :rtype: str
     """
     outputs = []
-    for rst in translation.results:
+    for rst in translations.results:
         outputs += [process_output_firstline(rst)]
         for i, explain in enumerate(rst["explains"].items(), 1):
             outputs += [process_output_explain(explain)]
@@ -112,14 +112,14 @@ def process_output_p10k(translation: Translation) -> str:
     return output
 
 
-def process_output(translation: Translation) -> str:
+def process_output(translations: Translations) -> str:
     """Process output.
 
-    :param translation:
-    :type translation: Translation
+    :param translations:
+    :type translations: Translations
     :rtype: str
     """
-    rst = process_output_p10k(translation)
+    rst = process_output_p10k(translations)
     with suppress(ImportError):
         from repl_python_wakatime import wakatime_hook