# Pyrogram - Telegram MTProto API Client Library for Python # Copyright (C) 2017-2020 Dan # # 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 . from typing import Union from pyrogram.api import functions, types from ...ext import BaseClient class ReadHistory(BaseClient): async def read_history( self, chat_id: Union[int, str], max_id: int = 0 ) -> bool: """Mark a chat's message history as read. Parameters: chat_id (``int`` | ``str``): Unique identifier (int) or username (str) of the target chat. For your personal cloud (Saved Messages) you can simply use "me" or "self". For a contact that exists in your Telegram address book you can use his phone number (str). max_id (``int``, *optional*): The id of the last message you want to mark as read; all the messages before this one will be marked as read as well. Defaults to 0 (mark every unread message as read). Returns: ``bool`` - On success, True is returned. Example: .. code-block:: python # Mark the whole chat as read app.read_history("pyrogramlounge") # Mark messages as read only up to the given message id app.read_history("pyrogramlounge", 123456) """ peer = await self.resolve_peer(chat_id) if isinstance(peer, types.InputPeerChannel): q = functions.channels.ReadHistory( channel=peer, max_id=max_id ) else: q = functions.messages.ReadHistory( peer=peer, max_id=max_id ) await self.send(q) return True