# Pyrogram - Telegram MTProto API Client Library for Python # Copyright (C) 2017-2019 Dan Tès # # 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, List import pyrogram from pyrogram.api import functions, types from pyrogram.client.ext import utils from ...ext import BaseClient class GetProfilePhotos(BaseClient): def get_profile_photos( self, chat_id: Union[int, str], offset: int = 0, limit: int = 100 ) -> List["pyrogram.Photo"]: """Get a list of profile pictures for a user or a chat. 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). offset (``int``, *optional*): Sequential number of the first photo to be returned. By default, all photos are returned. limit (``int``, *optional*): Limits the number of photos to be retrieved. Values between 1—100 are accepted. Defaults to 100. Returns: List of :obj:`Photo`: On success, a list of profile photos is returned. Example: .. code-block:: python # Get the first 100 profile photos of a user app.get_profile_photos("haskell") # Get only the first profile photo of a user app.get_profile_photos("haskell", limit=1) # Get 3 profile photos of a user, skip the first 5 app.get_profile_photos("haskell", limit=3, offset=5) """ peer_id = self.resolve_peer(chat_id) if isinstance(peer_id, types.InputPeerChannel): r = utils.parse_messages( self, self.send( functions.messages.Search( peer=peer_id, q="", filter=types.InputMessagesFilterChatPhotos(), min_date=0, max_date=0, offset_id=0, add_offset=offset, limit=limit, max_id=0, min_id=0, hash=0 ) ) ) return pyrogram.List([message.new_chat_photo for message in r][:limit]) else: r = self.send( functions.photos.GetUserPhotos( user_id=peer_id, offset=offset, max_id=0, limit=limit ) ) return pyrogram.List(pyrogram.Photo._parse(self, photo) for photo in r.photos)