# Pyrogram - Telegram MTProto API Client Library for Python
# Copyright (C) 2017-present Dan <https://github.com/delivrance>
#
# This file is part of Pyrogram.
#
# Pyrogram is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published
# by the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Pyrogram is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with Pyrogram. If not, see <http://www.gnu.org/licenses/>.
from __future__ import annotations
import pyrogram
from pyrogram import raw, types
class ComposeTextWithAI:
async def compose_text_with_ai(
self: pyrogram.Client,
text: str | types.FormattedText,
translate_to_language_code: str | None = None,
style_name: str | None = None,
add_emojis: bool | None = None,
) -> types.FormattedText:
"""Changes text using an AI model.
.. include:: /_includes/usable-by/users.rst
Parameters:
text (``str`` | :obj:`~pyrogram.types.FormattedText`):
The original text.
translate_to_language_code (``str``, *optional*):
Pass a language code to which the text will be translated.
Must be one of "af", "sq", "am", "ar", "hy", "az", "eu", "be", "bn", "bs", "bg", "ca", "ceb", "zh-CN", "zh", "zh-Hans", "zh-TW", "zh-Hant", "co", "hr", "cs", "da", "nl", "en", "eo", "et",
"fi", "fr", "fy", "gl", "ka", "de", "el", "gu", "ht", "ha", "haw", "he", "iw", "hi", "hmn", "hu", "is", "ig", "id", "in", "ga", "it", "ja", "jv", "kn", "kk", "km", "rw", "ko",
"ku", "ky", "lo", "la", "lv", "lt", "lb", "mk", "mg", "ms", "ml", "mt", "mi", "mr", "mn", "my", "ne", "no", "ny", "or", "ps", "fa", "pl", "pt", "pa", "ro", "ru", "sm", "gd", "sr",
"st", "sn", "sd", "si", "sk", "sl", "so", "es", "su", "sw", "sv", "tl", "tg", "ta", "tt", "te", "th", "tr", "tk", "uk", "ur", "ug", "uz", "vi", "cy", "xh", "yi", "ji", "yo", "zu"
Defaults to the client's language code.
style_name (``str``, *optional*):
Name of the style of the resulted text.
add_emojis (``bool``, *optional*):
Pass True to add emoji to the text.
Returns:
:obj:`~pyrogram.types.FormattedText`: On success, information about the composed text is returned.
Example:
.. code-block:: python
await app.compose_text_with_ai(
"hello, how are you?",
translate_to_language_code="ru",
style_name="formal",
add_emojis=True
)
"""
if isinstance(text, str):
text = types.FormattedText(text=text)
r = await self.invoke(
raw.functions.messages.ComposeMessageWithAI(
text=await text.write(self),
translate_to_lang=translate_to_language_code,
tone=raw.types.InputAiComposeToneDefault(tone=style_name) if style_name else None,
emojify=add_emojis,
)
)
return types.FormattedText._parse(self, r.result_text)