FilesExpand file tree

develop

/

get_users.py

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

69 lines (56 loc) · 2.48 KB

develop

/

get_users.py

Copy path

Top

File metadata and controls

• Code
• Blame

69 lines (56 loc) · 2.48 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

# Pyrogram - Telegram MTProto API Client Library for Python

# Copyright (C) 2017-2019 Dan Tès <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 typing import Iterable, Union, List

import pyrogram

from pyrogram.api import functions

from ...ext import BaseClient

class GetUsers(BaseClient):

def get_users(

self,

user_ids: Union[Iterable[Union[int, str]], int, str]

) -> Union["pyrogram.User", List["pyrogram.User"]]:

"""Get information about a user.

You can retrieve up to 200 users at once.

Parameters:

user_ids (``iterable``):

A list of User identifiers (id or username) or a single user id/username.

For a contact that exists in your Telegram address book you can use his phone number (str).

Iterators and Generators are also accepted.

Returns:

:obj:`User` | List of :obj:`User`: In case *user_ids* was an integer or string the single requested user is

returned, otherwise, in case *user_ids* was an iterable a list of users is returned, even if the iterable

contained one item only.

Example:

.. code-block:: python

# Get information about one user

app.get_users("haskell")

# Get information about multiple users at once

app.get_users([user1, user2, user3])

"""

is_iterable = not isinstance(user_ids, (int, str))

user_ids = list(user_ids) if is_iterable else [user_ids]

user_ids = [self.resolve_peer(i) for i in user_ids]

r = self.send(

functions.users.GetUsers(

id=user_ids

)

)

users = pyrogram.List()

for i in r:

users.append(pyrogram.User._parse(self, i))

return users if is_iterable else users[0]