iframe-proxy | Sunbelt Computer Software

History

71 lines (54 loc) · 2.56 KB

Raw

# Hydrogram - Telegram MTProto API Client Library for Python

# 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]

Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

Uh oh!

FilesExpand file tree

get_users.py

Latest commit

History

get_users.py

File metadata and controls