MTPyroger/pyrogram/client/methods/chats/get_dialogs.py

108 lines
3.4 KiB
Python
Raw Normal View History

2020-03-21 14:43:32 +00:00
# Pyrogram - Telegram MTProto API Client Library for Python
# Copyright (C) 2017-2020 Dan <https://github.com/delivrance>
2018-07-04 19:05:43 +00:00
#
2020-03-21 14:43:32 +00:00
# This file is part of Pyrogram.
2018-07-04 19:05:43 +00:00
#
2020-03-21 14:43:32 +00:00
# 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.
2018-07-04 19:05:43 +00:00
#
2020-03-21 14:43:32 +00:00
# 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.
2018-07-04 19:05:43 +00:00
#
2020-03-21 14:43:32 +00:00
# You should have received a copy of the GNU Lesser General Public License
# along with Pyrogram. If not, see <http://www.gnu.org/licenses/>.
2018-07-04 19:05:43 +00:00
import logging
2019-06-08 12:00:00 +00:00
from typing import List
2018-07-04 19:05:43 +00:00
import pyrogram
from pyrogram.api import functions, types
from ...ext import BaseClient, utils
2018-07-04 19:05:43 +00:00
log = logging.getLogger(__name__)
2018-07-04 19:05:43 +00:00
class GetDialogs(BaseClient):
2019-03-16 18:23:23 +00:00
def get_dialogs(
self,
offset_date: int = 0,
limit: int = 100,
pinned_only: bool = False
2019-06-08 12:00:00 +00:00
) -> List["pyrogram.Dialog"]:
"""Get a chunk of the user's dialogs.
2018-08-20 09:24:00 +00:00
You can get up to 100 dialogs at once.
2019-05-30 13:23:43 +00:00
For a more convenient way of getting a user's dialogs see :meth:`~Client.iter_dialogs`.
2018-08-20 09:24:00 +00:00
Parameters:
offset_date (``int``):
The offset date in Unix time taken from the top message of a :obj:`Dialog`.
Defaults to 0. Valid for non-pinned dialogs only.
2018-08-20 09:24:00 +00:00
limit (``str``, *optional*):
Limits the number of dialogs to be retrieved.
Defaults to 100. Valid for non-pinned dialogs only.
2018-08-20 09:24:00 +00:00
pinned_only (``bool``, *optional*):
Pass True if you want to get only pinned dialogs.
Defaults to False.
Returns:
2019-06-08 12:00:00 +00:00
List of :obj:`Dialog`: On success, a list of dialogs is returned.
2018-08-20 09:24:00 +00:00
2019-07-25 09:22:14 +00:00
Example:
.. code-block:: python
# Get first 100 dialogs
app.get_dialogs()
# Get pinned dialogs
app.get_dialogs(pinned_only=True)
2018-08-20 09:24:00 +00:00
"""
if pinned_only:
r = self.send(functions.messages.GetPinnedDialogs(folder_id=0))
else:
r = self.send(
functions.messages.GetDialogs(
offset_date=offset_date,
offset_id=0,
offset_peer=types.InputPeerEmpty(),
limit=limit,
hash=0,
exclude_pinned=True
)
)
2018-07-04 19:05:43 +00:00
2019-06-08 12:00:00 +00:00
users = {i.id: i for i in r.users}
chats = {i.id: i for i in r.chats}
messages = {}
for message in r.messages:
to_id = message.to_id
if isinstance(to_id, types.PeerUser):
if message.out:
chat_id = to_id.user_id
else:
chat_id = message.from_id
else:
chat_id = utils.get_peer_id(to_id)
2019-06-08 12:00:00 +00:00
messages[chat_id] = pyrogram.Message._parse(self, message, users, chats)
parsed_dialogs = []
for dialog in r.dialogs:
if not isinstance(dialog, types.Dialog):
continue
parsed_dialogs.append(pyrogram.Dialog._parse(self, dialog, messages, users, chats))
2019-06-08 12:00:00 +00:00
return pyrogram.List(parsed_dialogs)