Clean up docstrings

pyrogram/client/methods/bots/request_callback_answer.py

@@ -29,8 +29,8 @@ class RequestCallbackAnswer(BaseClient):
         message_id: int,
         callback_data: bytes
     ):
-        """Use this method to request a callback answer from bots. This is the equivalent of clicking an
+        """Use this method to request a callback answer from bots.
-        inline button containing callback data.
+        This is the equivalent of clicking an inline button containing callback data.
 
         Args:
             chat_id (``int`` | ``str``):

pyrogram/client/methods/chats/get_chat.py

@@ -28,8 +28,9 @@ class GetChat(BaseClient):
         self,
         chat_id: Union[int, str]
     ) -> "pyrogram.Chat":
-        """Use this method to get up to date information about the chat (current name of the user for
+        """Use this method to get up to date information about the chat.
-        one-on-one conversations, current username of a user, group or channel, etc.)
+        Information include current name of the user for one-on-one conversations, current username of a user, group or
+        channel, etc.
 
         Args:
             chat_id (``int`` | ``str``):

pyrogram/client/methods/chats/get_dialogs.py

@@ -34,7 +34,7 @@ class GetDialogs(BaseClient):
         limit: int = 100,
         pinned_only: bool = False
     ) -> "pyrogram.Dialogs":
-        """Use this method to get a chunk of the user's dialogs
+        """Use this method to get a chunk of the user's dialogs.
 
         You can get up to 100 dialogs at once.
         For a more convenient way of getting a user's dialogs see :meth:`iter_dialogs`.

pyrogram/client/methods/chats/restrict_chat_member.py

@@ -38,9 +38,10 @@ class RestrictChatMember(BaseClient):
         can_invite_users: bool = False,
         can_pin_messages: bool = False
     ) -> Chat:
-        """Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for
+        """Use this method to restrict a user in a supergroup.
-        this to work and must have the appropriate admin rights. Pass True for all boolean parameters to lift
+
-        restrictions from a user.
+        The bot must be an administrator in the supergroup for this to work and must have the appropriate admin rights.
+        Pass True for all boolean parameters to lift restrictions from a user.
 
         Args:
             chat_id (``int`` | ``str``):

pyrogram/client/methods/contacts/delete_contacts.py

@@ -28,7 +28,7 @@ class DeleteContacts(BaseClient):
         self,
         ids: List[int]
     ):
-        """Use this method to delete contacts from your Telegram address book
+        """Use this method to delete contacts from your Telegram address book.
 
         Args:
             ids (List of ``int``):

pyrogram/client/methods/decorators/on_callback_query.py

@@ -30,9 +30,8 @@ class OnCallbackQuery(BaseClient):
         filters=None,
         group: int = 0
     ) -> callable:
-        """Use this decorator to automatically register a function for handling
+        """Use this decorator to automatically register a function for handling callback queries.
-        callback queries. This does the same thing as :meth:`add_handler` using the
+        This does the same thing as :meth:`add_handler` using the :class:`CallbackQueryHandler`.
-        :class:`CallbackQueryHandler`.
 
         .. note::
             This decorator will wrap your defined function in a tuple consisting of *(Handler, group)*.

pyrogram/client/methods/decorators/on_deleted_messages.py

@@ -30,9 +30,8 @@ class OnDeletedMessages(BaseClient):
         filters=None,
         group: int = 0
     ) -> callable:
-        """Use this decorator to automatically register a function for handling
+        """Use this decorator to automatically register a function for handling deleted messages.
-        deleted messages. This does the same thing as :meth:`add_handler` using the
+        This does the same thing as :meth:`add_handler` using the :class:`DeletedMessagesHandler`.
-        :class:`DeletedMessagesHandler`.
 
         .. note::
             This decorator will wrap your defined function in a tuple consisting of *(Handler, group)*.

pyrogram/client/methods/decorators/on_disconnect.py

@@ -23,9 +23,8 @@ from ...ext import BaseClient
 
 class OnDisconnect(BaseClient):
     def on_disconnect(self=None) -> callable:
-        """Use this decorator to automatically register a function for handling
+        """Use this decorator to automatically register a function for handling disconnections.
-        disconnections. This does the same thing as :meth:`add_handler` using the
+        This does the same thing as :meth:`add_handler` using the :class:`DisconnectHandler`.
-        :class:`DisconnectHandler`.
         """
 
         def decorator(func: callable) -> Handler:

pyrogram/client/methods/decorators/on_inline_query.py

@@ -30,9 +30,8 @@ class OnInlineQuery(BaseClient):
         filters=None,
         group: int = 0
     ) -> callable:
-        """Use this decorator to automatically register a function for handling
+        """Use this decorator to automatically register a function for handling inline queries.
-        inline queries. This does the same thing as :meth:`add_handler` using the
+        This does the same thing as :meth:`add_handler` using the :class:`InlineQueryHandler`.
-        :class:`InlineQueryHandler`.
 
         Args:
             filters (:obj:`Filters <pyrogram.Filters>`):

pyrogram/client/methods/decorators/on_message.py

@@ -30,9 +30,8 @@ class OnMessage(BaseClient):
         filters=None,
         group: int = 0
     ) -> callable:
-        """Use this decorator to automatically register a function for handling
+        """Use this decorator to automatically register a function for handling messages.
-        messages. This does the same thing as :meth:`add_handler` using the
+        This does the same thing as :meth:`add_handler` using the :class:`MessageHandler`.
-        :class:`MessageHandler`.
 
         .. note::
             This decorator will wrap your defined function in a tuple consisting of *(Handler, group)*.

pyrogram/client/methods/decorators/on_raw_update.py

@@ -28,9 +28,8 @@ class OnRawUpdate(BaseClient):
         self=None,
         group: int = 0
     ) -> callable:
-        """Use this decorator to automatically register a function for handling
+        """Use this decorator to automatically register a function for handling raw updates.
-        raw updates. This does the same thing as :meth:`add_handler` using the
+        This does the same thing as :meth:`add_handler` using the :class:`RawUpdateHandler`.
-        :class:`RawUpdateHandler`.
 
         .. note::
             This decorator will wrap your defined function in a tuple consisting of *(Handler, group)*.

pyrogram/client/methods/decorators/on_user_status.py

@@ -30,9 +30,8 @@ class OnUserStatus(BaseClient):
         filters=None,
         group: int = 0
     ) -> callable:
-        """Use this decorator to automatically register a function for handling
+        """Use this decorator to automatically register a function for handling user status updates.
-        user status updates. This does the same thing as :meth:`add_handler` using the
+        This does the same thing as :meth:`add_handler` using the :class:`UserStatusHandler`.
-        :class:`UserStatusHandler`.
 
         .. note::
             This decorator will wrap your defined function in a tuple consisting of *(Handler, group)*.

pyrogram/client/methods/messages/delete_messages.py

@@ -29,7 +29,9 @@ class DeleteMessages(BaseClient):
         message_ids: Iterable[int],
         revoke: bool = True
     ) -> bool:
-        """Use this method to delete messages, including service messages, with the following limitations:
+        """Use this method to delete messages, including service messages.
+
+        Deleting messages have the following limitations:
 
         - A message can only be deleted if it was sent less than 48 hours ago.
         - Users can delete outgoing messages in groups and supergroups.

pyrogram/client/methods/messages/download_media.py

@@ -32,7 +32,7 @@ class DownloadMedia(BaseClient):
         progress: callable = None,
         progress_args: tuple = ()
     ) -> Union[str, None]:
-        """Use this method to download the media from a Message.
+        """Use this method to download the media from a message.
 
         Args:
             message (:obj:`Message <pyrogram.Message>` | ``str``):

pyrogram/client/methods/users/delete_user_profile_photos.py

@@ -29,7 +29,7 @@ class DeleteUserProfilePhotos(BaseClient):
         self,
         id: Union[str, List[str]]
     ) -> bool:
-        """Use this method to delete your own profile photos
+        """Use this method to delete your own profile photos.
 
         Args:
             id (``str`` | ``list``):

pyrogram/client/types/bots/force_reply.py

@@ -21,8 +21,9 @@ from ..pyrogram_type import PyrogramType
 
 
 class ForceReply(PyrogramType):
-    """Upon receiving a message with this object, Telegram clients will display a reply interface to the user
+    """Upon receiving a message with this object, Telegram clients will display a reply interface to the user.
-    (act as if the user has selected the bot's message and tapped 'Reply').
+
+    This acts as if the user has selected the bot's message and tapped "Reply".
     This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to
     sacrifice privacy mode.
 

pyrogram/client/types/bots/reply_keyboard_remove.py

@@ -21,10 +21,9 @@ from ..pyrogram_type import PyrogramType
 
 
 class ReplyKeyboardRemove(PyrogramType):
-    """Upon receiving a message with this object, Telegram clients will remove the current custom keyboard and
+    """Upon receiving a message with this object, Telegram clients will remove the current custom keyboard and display the default letter-keyboard.
-    display the default letter-keyboard. By default, custom keyboards are displayed until a new keyboard is sent
+    By default, custom keyboards are displayed until a new keyboard is sent by a bot. An exception is made for one-time
-    by a bot. An exception is made for one-time keyboards that are hidden immediately after the user presses a
+    keyboards that are hidden immediately after the user presses a button (see ReplyKeyboardMarkup).
-    button (see ReplyKeyboardMarkup).
 
     Args:
         selective (``bool``, *optional*):

pyrogram/client/types/input_media/input_media.py

@@ -16,16 +16,23 @@
 # You should have received a copy of the GNU Lesser General Public License
 # along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
+from ..pyrogram_type import PyrogramType
 
-class InputMedia:
+
+class InputMedia(PyrogramType):
+    """This object represents the content of a media message to be sent. It should be one of:
+
+    - :obj:`InputMediaAnimation <pyrogram.InputMediaAnimation>`
+    - :obj:`InputMediaDocument <pyrogram.InputMediaDocument>`
+    - :obj:`InputMediaAudio <pyrogram.InputMediaAudio>`
+    - :obj:`InputMediaPhoto <pyrogram.InputMediaPhoto>`
+    - :obj:`InputMediaVideo <pyrogram.InputMediaVideo>`
+    """
     __slots__ = ["media", "caption", "parse_mode"]
 
-    def __init__(
+    def __init__(self, media: str, caption: str, parse_mode: str):
-        self,
+        super().__init__(None)
-        media: str,
+
-        caption: str,
-        parse_mode: str
-    ):
         self.media = media
         self.caption = caption
         self.parse_mode = parse_mode

pyrogram/client/types/input_media/input_phone_contact.py

@@ -18,9 +18,10 @@
 
 from pyrogram.api.types import InputPhoneContact as RawInputPhoneContact
 from pyrogram.session.internals import MsgId
+from ..pyrogram_type import PyrogramType
 
 
-class InputPhoneContact:
+class InputPhoneContact(PyrogramType):
     """This object represents a Phone Contact to be added in your Telegram address book.
     It is intended to be used with :meth:`add_contacts() <pyrogram.Client.add_contacts>`
 
@@ -37,13 +38,8 @@ class InputPhoneContact:
 
     __slots__ = []
 
-    def __init__(
+    def __init__(self, phone: str, first_name: str, last_name: str = ""):
-        self,
+        super().__init__(None)
-        phone: str,
-        first_name: str,
-        last_name: str = ""
-    ):
-        pass
 
     def __new__(cls,
                 phone: str,

pyrogram/client/types/messages_and_media/video_note.py

@@ -26,7 +26,7 @@ from ...ext.utils import encode
 
 
 class VideoNote(PyrogramType):
-    """This object represents a video message (available in Telegram apps as of v.4.0).
+    """This object represents a video note.
 
     Args:
         file_id (``str``):

pyrogram/client/types/user_and_chats/dialogs.py

@@ -26,7 +26,7 @@ from ..pyrogram_type import PyrogramType
 
 
 class Dialogs(PyrogramType):
-    """This object represents a user's dialogs chunk
+    """This object represents a user's dialogs chunk.
 
     Args:
         total_count (``int``):