[Text Translation] Rename the from_parameter (#35729)

* [Text Translation] Update the from_parameter

* Switch to prod typespec

---------

Co-authored-by: Michal Materna <[email protected]>

Author: MikeyMCZ

sdk/translation/azure-ai-translation-text/README.md

@@ -255,12 +255,12 @@ Returns equivalent words for the source term in the target language.
 
 ```python
 try:
-    from_parameter = "en"
+    from_language = "en"
     to = "es"
     input_text_elements = ["fly"]
 
     response = text_translator.lookup_dictionary_entries(
-        body=input_text_elements, from_parameter=from_parameter, to=to
+        body=input_text_elements, from_language=from_language, to=to
     )
     dictionary_entry = response[0] if response else None
 
@@ -291,12 +291,12 @@ Returns grammatical structure and context examples for the source term and targe
 
 ```python
 try:
-    from_parameter = "en"
+    from_language = "en"
     to = "es"
     input_text_elements = [DictionaryExampleTextItem(text="fly", translation="volar")]
 
     response = text_translator.lookup_dictionary_examples(
-        body=input_text_elements, from_parameter=from_parameter, to=to
+        body=input_text_elements, from_language=from_language, to=to
     )
     dictionary_entry = response[0] if response else None
 

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_operations/_operations.py

@@ -86,7 +86,7 @@ def build_text_translation_translate_request(
     *,
     to: List[str],
     client_trace_id: Optional[str] = None,
-    from_parameter: Optional[str] = None,
+    from_language: Optional[str] = None,
     text_type: Optional[Union[str, _models.TextType]] = None,
     category: Optional[str] = None,
     profanity_action: Optional[Union[str, _models.ProfanityAction]] = None,
@@ -111,8 +111,8 @@ def build_text_translation_translate_request(
 
     # Construct parameters
     _params["to"] = [_SERIALIZER.query("to", q, "str") if q is not None else "" for q in to]
-    if from_parameter is not None:
-        _params["from"] = _SERIALIZER.query("from_parameter", from_parameter, "str")
+    if from_language is not None:
+        _params["from"] = _SERIALIZER.query("from_language", from_language, "str")
     if text_type is not None:
         _params["textType"] = _SERIALIZER.query("text_type", text_type, "str")
     if category is not None:
@@ -209,7 +209,7 @@ def build_text_translation_find_sentence_boundaries_request(  # pylint: disable=
 
 
 def build_text_translation_lookup_dictionary_entries_request(  # pylint: disable=name-too-long
-    *, from_parameter: str, to: str, client_trace_id: Optional[str] = None, **kwargs: Any
+    *, from_language: str, to: str, client_trace_id: Optional[str] = None, **kwargs: Any
 ) -> HttpRequest:
     _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {})
     _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
@@ -222,7 +222,7 @@ def build_text_translation_lookup_dictionary_entries_request(  # pylint: disable
     _url = "/dictionary/lookup"
 
     # Construct parameters
-    _params["from"] = _SERIALIZER.query("from_parameter", from_parameter, "str")
+    _params["from"] = _SERIALIZER.query("from_language", from_language, "str")
     _params["to"] = _SERIALIZER.query("to", to, "str")
     _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str")
 
@@ -237,7 +237,7 @@ def build_text_translation_lookup_dictionary_entries_request(  # pylint: disable
 
 
 def build_text_translation_lookup_dictionary_examples_request(  # pylint: disable=name-too-long
-    *, from_parameter: str, to: str, client_trace_id: Optional[str] = None, **kwargs: Any
+    *, from_language: str, to: str, client_trace_id: Optional[str] = None, **kwargs: Any
 ) -> HttpRequest:
     _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {})
     _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
@@ -250,7 +250,7 @@ def build_text_translation_lookup_dictionary_examples_request(  # pylint: disabl
     _url = "/dictionary/examples"
 
     # Construct parameters
-    _params["from"] = _SERIALIZER.query("from_parameter", from_parameter, "str")
+    _params["from"] = _SERIALIZER.query("from_language", from_language, "str")
     _params["to"] = _SERIALIZER.query("to", to, "str")
     _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str")
 
@@ -462,7 +462,7 @@ def translate(
         *,
         to: List[str],
         client_trace_id: Optional[str] = None,
-        from_parameter: Optional[str] = None,
+        from_language: Optional[str] = None,
         text_type: Optional[Union[str, _models.TextType]] = None,
         category: Optional[str] = None,
         profanity_action: Optional[Union[str, _models.ProfanityAction]] = None,
@@ -493,7 +493,7 @@ def translate(
         :keyword client_trace_id: A client-generated GUID to uniquely identify the request. Default
          value is None.
         :paramtype client_trace_id: str
-        :keyword from_parameter: Specifies the language of the input text. Find which languages are
+        :keyword from_language: Specifies the language of the input text. Find which languages are
          available to translate from by
          looking up supported languages using the translation scope. If the from parameter isn't
          specified,
@@ -502,7 +502,7 @@ def translate(
          You must use the from parameter rather than autodetection when using the dynamic dictionary
          feature.
          Note: the dynamic dictionary feature is case-sensitive. Default value is None.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword text_type: Defines whether the text being translated is plain text or HTML text. Any
          HTML needs to be a well-formed,
          complete element. Possible values are: plain (default) or html. Known values are: "Plain" and
@@ -638,7 +638,7 @@ def translate(
         *,
         to: List[str],
         client_trace_id: Optional[str] = None,
-        from_parameter: Optional[str] = None,
+        from_language: Optional[str] = None,
         text_type: Optional[Union[str, _models.TextType]] = None,
         category: Optional[str] = None,
         profanity_action: Optional[Union[str, _models.ProfanityAction]] = None,
@@ -669,7 +669,7 @@ def translate(
         :keyword client_trace_id: A client-generated GUID to uniquely identify the request. Default
          value is None.
         :paramtype client_trace_id: str
-        :keyword from_parameter: Specifies the language of the input text. Find which languages are
+        :keyword from_language: Specifies the language of the input text. Find which languages are
          available to translate from by
          looking up supported languages using the translation scope. If the from parameter isn't
          specified,
@@ -678,7 +678,7 @@ def translate(
          You must use the from parameter rather than autodetection when using the dynamic dictionary
          feature.
          Note: the dynamic dictionary feature is case-sensitive. Default value is None.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword text_type: Defines whether the text being translated is plain text or HTML text. Any
          HTML needs to be a well-formed,
          complete element. Possible values are: plain (default) or html. Known values are: "Plain" and
@@ -807,7 +807,7 @@ def translate(
         *,
         to: List[str],
         client_trace_id: Optional[str] = None,
-        from_parameter: Optional[str] = None,
+        from_language: Optional[str] = None,
         text_type: Optional[Union[str, _models.TextType]] = None,
         category: Optional[str] = None,
         profanity_action: Optional[Union[str, _models.ProfanityAction]] = None,
@@ -838,7 +838,7 @@ def translate(
         :keyword client_trace_id: A client-generated GUID to uniquely identify the request. Default
          value is None.
         :paramtype client_trace_id: str
-        :keyword from_parameter: Specifies the language of the input text. Find which languages are
+        :keyword from_language: Specifies the language of the input text. Find which languages are
          available to translate from by
          looking up supported languages using the translation scope. If the from parameter isn't
          specified,
@@ -847,7 +847,7 @@ def translate(
          You must use the from parameter rather than autodetection when using the dynamic dictionary
          feature.
          Note: the dynamic dictionary feature is case-sensitive. Default value is None.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword text_type: Defines whether the text being translated is plain text or HTML text. Any
          HTML needs to be a well-formed,
          complete element. Possible values are: plain (default) or html. Known values are: "Plain" and
@@ -989,7 +989,7 @@ def translate(
         _request = build_text_translation_translate_request(
             to=to,
             client_trace_id=client_trace_id,
-            from_parameter=from_parameter,
+            from_language=from_language,
             text_type=text_type,
             category=category,
             profanity_action=profanity_action,
@@ -1514,7 +1514,7 @@ def lookup_dictionary_entries(
         self,
         body: List[_models.InputTextItem],
         *,
-        from_parameter: str,
+        from_language: str,
         to: str,
         client_trace_id: Optional[str] = None,
         content_type: str = "application/json",
@@ -1527,10 +1527,10 @@ def lookup_dictionary_entries(
 
         :param body: Defines the content of the request. Required.
         :type body: list[~azure.ai.translation.text.models.InputTextItem]
-        :keyword from_parameter: Specifies the language of the input text.
+        :keyword from_language: Specifies the language of the input text.
          The source language must be one of the supported languages included in the dictionary scope.
          Required.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword to: Specifies the language of the output text.
          The target language must be one of the supported languages included in the dictionary scope.
          Required.
@@ -1629,7 +1629,7 @@ def lookup_dictionary_entries(
         self,
         body: IO[bytes],
         *,
-        from_parameter: str,
+        from_language: str,
         to: str,
         client_trace_id: Optional[str] = None,
         content_type: str = "application/json",
@@ -1642,10 +1642,10 @@ def lookup_dictionary_entries(
 
         :param body: Defines the content of the request. Required.
         :type body: IO[bytes]
-        :keyword from_parameter: Specifies the language of the input text.
+        :keyword from_language: Specifies the language of the input text.
          The source language must be one of the supported languages included in the dictionary scope.
          Required.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword to: Specifies the language of the output text.
          The target language must be one of the supported languages included in the dictionary scope.
          Required.
@@ -1737,7 +1737,7 @@ def lookup_dictionary_entries(
         self,
         body: Union[List[_models.InputTextItem], IO[bytes]],
         *,
-        from_parameter: str,
+        from_language: str,
         to: str,
         client_trace_id: Optional[str] = None,
         **kwargs: Any
@@ -1750,10 +1750,10 @@ def lookup_dictionary_entries(
         :param body: Defines the content of the request. Is either a [InputTextItem] type or a
          IO[bytes] type. Required.
         :type body: list[~azure.ai.translation.text.models.InputTextItem] or IO[bytes]
-        :keyword from_parameter: Specifies the language of the input text.
+        :keyword from_language: Specifies the language of the input text.
          The source language must be one of the supported languages included in the dictionary scope.
          Required.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword to: Specifies the language of the output text.
          The target language must be one of the supported languages included in the dictionary scope.
          Required.
@@ -1858,7 +1858,7 @@ def lookup_dictionary_entries(
             _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True)  # type: ignore
 
         _request = build_text_translation_lookup_dictionary_entries_request(
-            from_parameter=from_parameter,
+            from_language=from_language,
             to=to,
             client_trace_id=client_trace_id,
             content_type=content_type,
@@ -1904,7 +1904,7 @@ def lookup_dictionary_examples(
         self,
         body: List[_models.DictionaryExampleTextItem],
         *,
-        from_parameter: str,
+        from_language: str,
         to: str,
         client_trace_id: Optional[str] = None,
         content_type: str = "application/json",
@@ -1917,10 +1917,10 @@ def lookup_dictionary_examples(
 
         :param body: Defines the content of the request. Required.
         :type body: list[~azure.ai.translation.text.models.DictionaryExampleTextItem]
-        :keyword from_parameter: Specifies the language of the input text.
+        :keyword from_language: Specifies the language of the input text.
          The source language must be one of the supported languages included in the dictionary scope.
          Required.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword to: Specifies the language of the output text.
          The target language must be one of the supported languages included in the dictionary scope.
          Required.
@@ -1991,7 +1991,7 @@ def lookup_dictionary_examples(
         self,
         body: IO[bytes],
         *,
-        from_parameter: str,
+        from_language: str,
         to: str,
         client_trace_id: Optional[str] = None,
         content_type: str = "application/json",
@@ -2004,10 +2004,10 @@ def lookup_dictionary_examples(
 
         :param body: Defines the content of the request. Required.
         :type body: IO[bytes]
-        :keyword from_parameter: Specifies the language of the input text.
+        :keyword from_language: Specifies the language of the input text.
          The source language must be one of the supported languages included in the dictionary scope.
          Required.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword to: Specifies the language of the output text.
          The target language must be one of the supported languages included in the dictionary scope.
          Required.
@@ -2066,7 +2066,7 @@ def lookup_dictionary_examples(
         self,
         body: Union[List[_models.DictionaryExampleTextItem], IO[bytes]],
         *,
-        from_parameter: str,
+        from_language: str,
         to: str,
         client_trace_id: Optional[str] = None,
         **kwargs: Any
@@ -2079,10 +2079,10 @@ def lookup_dictionary_examples(
         :param body: Defines the content of the request. Is either a [DictionaryExampleTextItem] type
          or a IO[bytes] type. Required.
         :type body: list[~azure.ai.translation.text.models.DictionaryExampleTextItem] or IO[bytes]
-        :keyword from_parameter: Specifies the language of the input text.
+        :keyword from_language: Specifies the language of the input text.
          The source language must be one of the supported languages included in the dictionary scope.
          Required.
-        :paramtype from_parameter: str
+        :paramtype from_language: str
         :keyword to: Specifies the language of the output text.
          The target language must be one of the supported languages included in the dictionary scope.
          Required.
@@ -2154,7 +2154,7 @@ def lookup_dictionary_examples(
             _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True)  # type: ignore
 
         _request = build_text_translation_lookup_dictionary_examples_request(
-            from_parameter=from_parameter,
+            from_language=from_language,
             to=to,
             client_trace_id=client_trace_id,
             content_type=content_type,