FilesExpand file tree

master

/

invoke.py

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

89 lines (69 loc) · 3.06 KB

master

/

invoke.py

Copy path

Top

File metadata and controls

• Code
• Blame

89 lines (69 loc) · 3.06 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

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

# 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/>.

import logging

import pyrogram

from pyrogram import raw

from pyrogram.raw.core import TLObject

from pyrogram.session import Session

log = logging.getLogger(__name__)

class Invoke:

async def invoke(

self: "pyrogram.Client",

query: TLObject,

retries: int = Session.MAX_RETRIES,

timeout: float = Session.WAIT_TIMEOUT,

sleep_threshold: float = 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 <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).

.. 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