-
-
Notifications
You must be signed in to change notification settings - Fork 48
Expand file tree
/
Copy pathinvoke.py
More file actions
95 lines (73 loc) · 3.23 KB
/
invoke.py
File metadata and controls
95 lines (73 loc) · 3.23 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
# Hydrogram - Telegram MTProto API Client Library for Python
# Copyright (C) 2017-2023 Dan <https://github.com/delivrance>
# Copyright (C) 2023-present Hydrogram <https://hydrogram.org>
#
# This file is part of Hydrogram.
#
# Hydrogram 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.
#
# Hydrogram 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 Hydrogram. If not, see <http://www.gnu.org/licenses/>.
from __future__ import annotations
import logging
from typing import TYPE_CHECKING
import hydrogram
from hydrogram import raw
from hydrogram.session import Session
if TYPE_CHECKING:
from hydrogram.raw.core import TLObject
log = logging.getLogger(__name__)
class Invoke:
async def invoke(
self: hydrogram.Client,
query: TLObject,
retries: int = Session.MAX_RETRIES,
timeout: float = Session.WAIT_TIMEOUT,
sleep_threshold: float | None = None,
):
"""Invoke raw Telegram functions.
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 <hydrogram.api.functions>` package and may accept compound
data types from :obj:`types <hydrogram.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 <hydrogram.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).
.. include:: /_includes/usable-by/users-bots.rst
Parameters:
query (``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:
query = raw.functions.InvokeWithoutUpdates(query=query)
if self.takeout_id:
query = raw.functions.InvokeWithTakeout(takeout_id=self.takeout_id, query=query)
r = await self.session.invoke(
query,
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