88 lines
3.0 KiB
Python
88 lines
3.0 KiB
Python
# Pyrogram - Telegram MTProto API Client Library for Python
|
|
# Copyright (C) 2017-2021 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/>.
|
|
|
|
import logging
|
|
|
|
from pyrogram import raw
|
|
from pyrogram.raw.core import TLObject
|
|
from pyrogram.scaffold import Scaffold
|
|
from pyrogram.session import Session
|
|
|
|
log = logging.getLogger(__name__)
|
|
|
|
|
|
class Send(Scaffold):
|
|
async def send(
|
|
self,
|
|
data: TLObject,
|
|
retries: int = Session.MAX_RETRIES,
|
|
timeout: float = Session.WAIT_TIMEOUT,
|
|
sleep_threshold: float = None
|
|
):
|
|
"""Send raw Telegram queries.
|
|
|
|
This method makes it possible to manually call every single Telegram API method in a low-level manner.
|
|
Available functions are listed in the :obj:`functions <pyrogram.api.functions>` package and may accept compound
|
|
data types from :obj:`types <pyrogram.api.types>` as well as bare types such as ``int``, ``str``, etc...
|
|
|
|
.. note::
|
|
|
|
This is a utility method intended to be used **only** when working with raw
|
|
:obj:`functions <pyrogram.api.functions>` (i.e: a Telegram API method you wish to use which is not
|
|
available yet in the Client class as an easy-to-use method).
|
|
|
|
Parameters:
|
|
data (``RawFunction``):
|
|
The API Schema function filled with proper arguments.
|
|
|
|
retries (``int``):
|
|
Number of retries.
|
|
|
|
timeout (``float``):
|
|
Timeout in seconds.
|
|
|
|
sleep_threshold (``float``):
|
|
Sleep threshold in seconds.
|
|
|
|
Returns:
|
|
``RawType``: The raw type response generated by the query.
|
|
|
|
Raises:
|
|
RPCError: In case of a Telegram RPC error.
|
|
"""
|
|
if not self.is_connected:
|
|
raise ConnectionError("Client has not been started yet")
|
|
|
|
if self.no_updates:
|
|
data = raw.functions.InvokeWithoutUpdates(query=data)
|
|
|
|
if self.takeout_id:
|
|
data = raw.functions.InvokeWithTakeout(takeout_id=self.takeout_id, query=data)
|
|
|
|
r = await self.session.send(
|
|
data, retries, timeout,
|
|
(sleep_threshold
|
|
if sleep_threshold is not None
|
|
else self.sleep_threshold)
|
|
)
|
|
|
|
await self.fetch_peers(getattr(r, "users", []))
|
|
await self.fetch_peers(getattr(r, "chats", []))
|
|
|
|
return r
|