-
-
Notifications
You must be signed in to change notification settings - Fork 48
Expand file tree
/
Copy pathget_users.py
More file actions
71 lines (54 loc) · 2.56 KB
/
get_users.py
File metadata and controls
71 lines (54 loc) · 2.56 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
# 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 asyncio
from typing import TYPE_CHECKING
import hydrogram
from hydrogram import raw, types
if TYPE_CHECKING:
from collections.abc import Iterable
class GetUsers:
async def get_users(
self: hydrogram.Client, user_ids: int | str | Iterable[int | str]
) -> types.User | list[types.User]:
"""Get information about a user.
You can retrieve up to 200 users at once.
.. include:: /_includes/usable-by/users-bots.rst
Parameters:
user_ids (``int`` | ``str`` | Iterable of ``int`` or ``str``):
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).
Returns:
:obj:`~hydrogram.types.User` | List of :obj:`~hydrogram.types.User`: In case *user_ids* was not a list,
a single user is returned, otherwise a list of users is returned.
Example:
.. code-block:: python
# Get information about one user
await app.get_users("me")
# Get information about multiple users at once
await app.get_users([user_id1, user_id2, user_id3])
"""
is_iterable = not isinstance(user_ids, (int, str))
user_ids = list(user_ids) if is_iterable else [user_ids]
user_ids = await asyncio.gather(*[self.resolve_peer(i) for i in user_ids])
r = await self.invoke(raw.functions.users.GetUsers(id=user_ids))
users = types.List()
for i in r:
users.append(types.User._parse(self, i))
return users if is_iterable else users[0]