WPyrogram 2.0.124__tar.gz → 2.0.126__tar.gz

{WPyrogram-2.0.124 → WPyrogram-2.0.126}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: WPyrogram
-Version: 2.0.124
-Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots - Amano's experimental fork
+Version: 2.0.126
+Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots - Woto's experimental fork
 Home-page: https://github.com/ALiwoto/WPyrogram
-Download-URL: https://github.com/AmanoTeam/pyrogram
+Download-URL: https://github.com/ALiwoto/WPyrogram
 Author: Dan
 Author-email: dan@pyrogram.org
 License: LGPLv3
@@ -111,14 +111,15 @@ If you'd like to support Pyrogram, you can consider:
 ### Installing
 
 #### From git (recommended)
+
+> NOTE: in order to use WPyrogram, please uninstall pyrogram first.
+
 ```sh
-pip install 'pyrogram @ git+https://github.com/AmanoTeam/pyrogram.git@v2.0.106+amn7'
-```
-#### From tag tarball
-```sh
-pip install 'pyrogram @ https://github.com/AmanoTeam/pyrogram/archive/refs/tags/v2.0.106+amn7.tar.gz'
+pip uninstall pyrogram
+pip install 'wpyrogram'
 ```
 
+
 ### Resources
 
 - Check out the docs at https://docs.pyrogram.org to learn more about Pyrogram, get started right

{WPyrogram-2.0.124 → WPyrogram-2.0.126}/README.md

@@ -68,14 +68,15 @@ If you'd like to support Pyrogram, you can consider:
 ### Installing
 
 #### From git (recommended)
+
+> NOTE: in order to use WPyrogram, please uninstall pyrogram first.
+
 ```sh
-pip install 'pyrogram @ git+https://github.com/AmanoTeam/pyrogram.git@v2.0.106+amn7'
-```
-#### From tag tarball
-```sh
-pip install 'pyrogram @ https://github.com/AmanoTeam/pyrogram/archive/refs/tags/v2.0.106+amn7.tar.gz'
+pip uninstall pyrogram
+pip install 'wpyrogram'
 ```
 
+
 ### Resources
 
 - Check out the docs at https://docs.pyrogram.org to learn more about Pyrogram, get started right

{WPyrogram-2.0.124 → WPyrogram-2.0.126}/WPyrogram.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: WPyrogram
-Version: 2.0.124
-Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots - Amano's experimental fork
+Version: 2.0.126
+Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots - Woto's experimental fork
 Home-page: https://github.com/ALiwoto/WPyrogram
-Download-URL: https://github.com/AmanoTeam/pyrogram
+Download-URL: https://github.com/ALiwoto/WPyrogram
 Author: Dan
 Author-email: dan@pyrogram.org
 License: LGPLv3
@@ -111,14 +111,15 @@ If you'd like to support Pyrogram, you can consider:
 ### Installing
 
 #### From git (recommended)
+
+> NOTE: in order to use WPyrogram, please uninstall pyrogram first.
+
 ```sh
-pip install 'pyrogram @ git+https://github.com/AmanoTeam/pyrogram.git@v2.0.106+amn7'
-```
-#### From tag tarball
-```sh
-pip install 'pyrogram @ https://github.com/AmanoTeam/pyrogram/archive/refs/tags/v2.0.106+amn7.tar.gz'
+pip uninstall pyrogram
+pip install 'wpyrogram'
 ```
 
+
 ### Resources
 
 - Check out the docs at https://docs.pyrogram.org to learn more about Pyrogram, get started right

{WPyrogram-2.0.124 → WPyrogram-2.0.126}/WPyrogram.egg-info/SOURCES.txt

@@ -76,6 +76,7 @@ pyrogram/enums/next_code_type.py
 pyrogram/enums/parse_mode.py
 pyrogram/enums/poll_type.py
 pyrogram/enums/sent_code_type.py
+pyrogram/enums/stories_privacy_rules.py
 pyrogram/enums/user_status.py
 pyrogram/errors/__init__.py
 pyrogram/errors/rpc_error.py
@@ -93,6 +94,7 @@ pyrogram/handlers/inline_query_handler.py
 pyrogram/handlers/message_handler.py
 pyrogram/handlers/poll_handler.py
 pyrogram/handlers/raw_update_handler.py
+pyrogram/handlers/story_handler.py
 pyrogram/handlers/user_status_handler.py
 pyrogram/helpers/__init__.py
 pyrogram/helpers/helpers.py
@@ -192,6 +194,7 @@ pyrogram/methods/decorators/on_inline_query.py
 pyrogram/methods/decorators/on_message.py
 pyrogram/methods/decorators/on_poll.py
 pyrogram/methods/decorators/on_raw_update.py
+pyrogram/methods/decorators/on_story.py
 pyrogram/methods/decorators/on_user_status.py
 pyrogram/methods/invite_links/__init__.py
 pyrogram/methods/invite_links/approve_all_chat_join_requests.py
@@ -268,6 +271,22 @@ pyrogram/methods/password/change_cloud_password.py
 pyrogram/methods/password/enable_cloud_password.py
 pyrogram/methods/password/remove_cloud_password.py
 pyrogram/methods/stories/__init__.py
+pyrogram/methods/stories/apply_boost.py
+pyrogram/methods/stories/can_send_story.py
+pyrogram/methods/stories/copy_story.py
+pyrogram/methods/stories/delete_stories.py
+pyrogram/methods/stories/edit_story.py
+pyrogram/methods/stories/export_story_link.py
+pyrogram/methods/stories/forward_story.py
+pyrogram/methods/stories/get_all_stories.py
+pyrogram/methods/stories/get_peer_stories.py
+pyrogram/methods/stories/get_pinned_stories.py
+pyrogram/methods/stories/get_stories.py
+pyrogram/methods/stories/get_stories_archive.py
+pyrogram/methods/stories/hide_stories.py
+pyrogram/methods/stories/increment_story_views.py
+pyrogram/methods/stories/pin_stories.py
+pyrogram/methods/stories/read_stories.py
 pyrogram/methods/stories/send_story.py
 pyrogram/methods/users/__init__.py
 pyrogram/methods/users/block_user.py
@@ -395,26 +414,54 @@ pyrogram/types/input_media/input_media_video.py
 pyrogram/types/input_media/input_phone_contact.py
 pyrogram/types/input_message_content/__init__.py
 pyrogram/types/input_message_content/input_message_content.py
+pyrogram/types/input_message_content/input_reply_to_message.py
+pyrogram/types/input_message_content/input_reply_to_story.py
 pyrogram/types/input_message_content/input_text_message_content.py
 pyrogram/types/messages_and_media/__init__.py
 pyrogram/types/messages_and_media/animation.py
 pyrogram/types/messages_and_media/audio.py
+pyrogram/types/messages_and_media/auto_name.py
+pyrogram/types/messages_and_media/chat_action.py
+pyrogram/types/messages_and_media/chat_event_action.py
+pyrogram/types/messages_and_media/chat_member_status.py
+pyrogram/types/messages_and_media/chat_members_filter.py
+pyrogram/types/messages_and_media/chat_type.py
 pyrogram/types/messages_and_media/contact.py
 pyrogram/types/messages_and_media/dice.py
 pyrogram/types/messages_and_media/document.py
+pyrogram/types/messages_and_media/forum_topic.py
+pyrogram/types/messages_and_media/forum_topic_closed.py
+pyrogram/types/messages_and_media/forum_topic_created.py
+pyrogram/types/messages_and_media/forum_topic_edited.py
+pyrogram/types/messages_and_media/forum_topic_reopened.py
 pyrogram/types/messages_and_media/game.py
+pyrogram/types/messages_and_media/general_forum_topic_hidden.py
+pyrogram/types/messages_and_media/general_forum_topic_unhidden.py
 pyrogram/types/messages_and_media/location.py
 pyrogram/types/messages_and_media/message.py
 pyrogram/types/messages_and_media/message_entity.py
+pyrogram/types/messages_and_media/message_entity_type.py
+pyrogram/types/messages_and_media/message_media_type.py
 pyrogram/types/messages_and_media/message_reactions.py
+pyrogram/types/messages_and_media/message_service_type.py
+pyrogram/types/messages_and_media/message_story.py
+pyrogram/types/messages_and_media/messages_filter.py
+pyrogram/types/messages_and_media/next_code_type.py
+pyrogram/types/messages_and_media/parse_mode.py
 pyrogram/types/messages_and_media/photo.py
 pyrogram/types/messages_and_media/poll.py
 pyrogram/types/messages_and_media/poll_option.py
+pyrogram/types/messages_and_media/poll_type.py
 pyrogram/types/messages_and_media/reaction.py
+pyrogram/types/messages_and_media/sent_code_type.py
 pyrogram/types/messages_and_media/sticker.py
 pyrogram/types/messages_and_media/story.py
+pyrogram/types/messages_and_media/story_deleted.py
+pyrogram/types/messages_and_media/story_skipped.py
+pyrogram/types/messages_and_media/story_views.py
 pyrogram/types/messages_and_media/stripped_thumbnail.py
 pyrogram/types/messages_and_media/thumbnail.py
+pyrogram/types/messages_and_media/user_status.py
 pyrogram/types/messages_and_media/venue.py
 pyrogram/types/messages_and_media/video.py
 pyrogram/types/messages_and_media/video_note.py

{WPyrogram-2.0.124 → WPyrogram-2.0.126}/pyrogram/__init__.py

@@ -16,7 +16,7 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>
 
-__version__ = "2.0.124"
+__version__ = "2.0.126"
 __license__ = "GNU Lesser General Public License v3.0 (LGPL-3.0)"
 __copyright__ = "Copyright (C) 2017-present Dan <https://github.com/delivrance>"
 

{WPyrogram-2.0.124 → WPyrogram-2.0.126}/pyrogram/enums/__init__.py

@@ -29,21 +29,23 @@ from .next_code_type import NextCodeType
 from .parse_mode import ParseMode
 from .poll_type import PollType
 from .sent_code_type import SentCodeType
+from .stories_privacy_rules import StoriesPrivacyRules
 from .user_status import UserStatus
 
 __all__ = [
-    'ChatAction', 
-    'ChatEventAction', 
-    'ChatMemberStatus', 
-    'ChatMembersFilter', 
-    'ChatType', 
-    'MessageEntityType', 
-    'MessageMediaType', 
-    'MessageServiceType', 
-    'MessagesFilter', 
-    'NextCodeType', 
-    'ParseMode', 
-    'PollType', 
-    'SentCodeType', 
+    'ChatAction',
+    'ChatEventAction',
+    'ChatMemberStatus',
+    'ChatMembersFilter',
+    'ChatType',
+    'MessageEntityType',
+    'MessageMediaType',
+    'MessageServiceType',
+    'MessagesFilter',
+    'NextCodeType',
+    'ParseMode',
+    'PollType',
+    'SentCodeType',
+    'StoriesPrivacyRules',
     'UserStatus'
-]
+]

WPyrogram-2.0.126/pyrogram/enums/chat_event_action.py

@@ -0,0 +1,136 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  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 <http://www.gnu.org/licenses/>.
+
+from enum import auto
+
+from .auto_name import AutoName
+
+
+class ChatEventAction(AutoName):
+    """Chat event action enumeration used in :meth:`~pyrogram.Client.get_chat_event_log`."""
+
+    DESCRIPTION_CHANGED = auto()
+    "The chat description has been changed (see ``old_description`` and ``new_description``)"
+
+    HISTORY_TTL_CHANGED = auto()
+    "The history time-to-live has been changed (see ``old_history_ttl`` and ``new_history_ttl``)"
+
+    LINKED_CHAT_CHANGED = auto()
+    "The linked chat has been changed (see ``old_linked_chat`` and ``new_linked_chat``)"
+
+    # LOCATION_CHANGED = auto()
+    ""
+
+    PHOTO_CHANGED = auto()
+    "The chat photo has been changed (see ``old_photo`` and ``new_photo``)"
+
+    # STICKER_SET_CHANGED = auto()
+    ""
+
+    TITLE_CHANGED = auto()
+    "the chat title has been changed (see ``old_title`` and ``new_title``)"
+
+    USERNAME_CHANGED = auto()
+    "the chat username has been changed (see ``old_username`` and ``new_username``)"
+
+    CHAT_PERMISSIONS_CHANGED = auto()
+    "the default chat permissions has been changed (see ``old_chat_permissions`` and ``new_chat_permissions``)"
+
+    MESSAGE_DELETED = auto()
+    "a message has been deleted (see ``deleted_message``)"
+
+    # VOICE_CHAT_DISCARDED = auto()
+    ""
+
+    MESSAGE_EDITED = auto()
+    "a message has been edited (see ``old_message`` and ``new_message``)"
+
+    INVITE_LINK_EDITED = auto()
+    "An invite link has been edited (see ``old_invite_link`` and ``new_invite`` link)"
+
+    INVITE_LINK_REVOKED = auto()
+    "An invite link has been revoked (see ``revoked_invite_link``)"
+
+    INVITE_LINK_DELETED = auto()
+    "An invite link has been deleted (see ``deleted_invite_link``)"
+
+    MEMBER_INVITED = auto()
+    "a member has been invited by someone (see ``invited_member``)"
+
+    MEMBER_JOINED = auto()
+    "a member joined by themselves. (see ``user``)"
+
+    # MEMBER_JOINED_BY_LINK = auto()
+    ""
+
+    MEMBER_LEFT = auto()
+    "a member left by themselves. (see ``user``)"
+
+    # MEMBER_MUTED = auto()
+    ""
+
+    ADMINISTRATOR_PRIVILEGES_CHANGED = auto()
+    "a chat member has been promoted/demoted or their administrator privileges has changed (see ``old_administrator_privileges`` and ``new_administrator_privileges``)"
+
+    MEMBER_PERMISSIONS_CHANGED = auto()
+    "a chat member has been restricted/unrestricted or banned/unbanned, or their permissions has changed (see ``old_member_permissions`` and ``new_member_permissions``)"
+
+    # MEMBER_UNMUTED = auto()
+    ""
+
+    # MEMBER_VOLUME_CHANGED = auto()
+    ""
+
+    # VIDEO_CHAT_STARTED = auto()
+    ""
+
+    POLL_STOPPED = auto()
+    "a poll has been stopped (see ``stopped_poll``)"
+
+    # VOICE_CHAT_SETTINGS_CHANGED = auto()
+    ""
+
+    INVITES_ENABLED = auto()
+    "the chat invitation has been enabled or disabled (see ``invites_enabled``)"
+
+    HISTORY_HIDDEN = auto()
+    "the chat history has been hidden or unhidden (see ``history_hidden``)"
+
+    SIGNATURES_ENABLED = auto()
+    "the message signatures have been enabled or disabled (see ``signatures_enabled``)"
+
+    SLOW_MODE_CHANGED = auto()
+    "the slow mode has been changes (see ``old_slow_mode`` and ``new_slow_mode``)"
+
+    MESSAGE_PINNED = auto()
+    "a message has been pinned (see ``pinned_message``)"
+
+    MESSAGE_UNPINNED = auto()
+    "a message has been unpinned (see ``unpinned_message``)"
+
+    CREATED_FORUM_TOPIC = auto()
+    "a new forum topic has been created (see `created_forum_topic`)"
+
+    EDITED_FORUM_TOPIC = auto()
+    "a forum topic has been edited (see `old_forum_topic` and `new_forum_topic`)"
+
+    DELETED_FORUM_TOPIC = auto()
+    "a forum topic has been deleted (see `deleted_forum_topic`)"
+
+    UNKNOWN = auto()
+    "Unknown chat event action"

WPyrogram-2.0.126/pyrogram/enums/message_media_type.py

@@ -0,0 +1,73 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  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 <http://www.gnu.org/licenses/>.
+
+from enum import auto
+
+from .auto_name import AutoName
+
+
+class MessageMediaType(AutoName):
+    """Message media type enumeration used in :obj:`~pyrogram.types.Message`."""
+
+    AUDIO = auto()
+    "Audio media"
+
+    DOCUMENT = auto()
+    "Document media"
+
+    PHOTO = auto()
+    "Photo media"
+
+    STICKER = auto()
+    "Sticker media"
+
+    VIDEO = auto()
+    "Video media"
+
+    ANIMATION = auto()
+    "Animation media"
+
+    VOICE = auto()
+    "Voice media"
+
+    VIDEO_NOTE = auto()
+    "Video note media"
+
+    CONTACT = auto()
+    "Contact media"
+
+    LOCATION = auto()
+    "Location media"
+
+    VENUE = auto()
+    "Venue media"
+
+    POLL = auto()
+    "Poll media"
+
+    WEB_PAGE = auto()
+    "Web page media"
+
+    DICE = auto()
+    "Dice media"
+
+    GAME = auto()
+    "Game media"
+
+    STORY = auto()
+    "Story media"

WPyrogram-2.0.126/pyrogram/enums/message_service_type.py

@@ -0,0 +1,91 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  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 <http://www.gnu.org/licenses/>.
+
+from enum import auto
+
+from .auto_name import AutoName
+
+
+class MessageServiceType(AutoName):
+    """Message service type enumeration used in :obj:`~pyrogram.types.Message`."""
+
+    NEW_CHAT_MEMBERS = auto()
+    "New members join"
+
+    LEFT_CHAT_MEMBERS = auto()
+    "Left chat members"
+
+    NEW_CHAT_TITLE = auto()
+    "New chat title"
+
+    NEW_CHAT_PHOTO = auto()
+    "New chat photo"
+
+    DELETE_CHAT_PHOTO = auto()
+    "Deleted chat photo"
+
+    FORUM_TOPIC_CREATED = auto()
+    "a new forum topic created in the chat"
+
+    FORUM_TOPIC_CLOSED = auto()
+    "a new forum topic closed in the chat"
+
+    FORUM_TOPIC_REOPENED = auto()
+    "a new forum topic reopened in the chat"
+
+    FORUM_TOPIC_EDITED = auto()
+    "a new forum topic renamed in the chat"
+
+    GENERAL_TOPIC_HIDDEN = auto()
+    "a forum general topic hidden in the chat"
+
+    GENERAL_TOPIC_UNHIDDEN = auto()
+    "a forum general topic unhidden in the chat"
+
+    GROUP_CHAT_CREATED = auto()
+    "Group chat created"
+
+    CHANNEL_CHAT_CREATED = auto()
+    "Channel chat created"
+
+    MIGRATE_TO_CHAT_ID = auto()
+    "Migrated to chat id"
+
+    MIGRATE_FROM_CHAT_ID = auto()
+    "Migrated from chat id"
+
+    PINNED_MESSAGE = auto()
+    "Pinned message"
+
+    GAME_HIGH_SCORE = auto()
+    "Game high score"
+
+    VIDEO_CHAT_STARTED = auto()
+    "Video chat started"
+
+    VIDEO_CHAT_ENDED = auto()
+    "Video chat ended"
+
+    VIDEO_CHAT_SCHEDULED = auto()
+    "Video chat scheduled"
+
+    VIDEO_CHAT_MEMBERS_INVITED = auto()
+    "Video chat members invited"
+
+    WEB_APP_DATA = auto()
+    "Web app data"

WPyrogram-2.0.126/pyrogram/enums/stories_privacy_rules.py

@@ -0,0 +1,36 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  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 <http://www.gnu.org/licenses/>.
+
+from enum import auto
+from .auto_name import AutoName
+
+
+class StoriesPrivacyRules(AutoName):
+    """Stories privacy rules type enumeration used in :obj:`~pyrogram.method.SendStory`."""
+
+    PUBLIC = auto()
+    "Public stories"
+
+    CONTACTS = auto()
+    "Contacts only stories"
+
+    CLOSE_FRIENDS = auto()
+    "Close friends stories"
+
+    SELECTED_USERS = auto()
+    "Selected users stories"

{WPyrogram-2.0.124 → WPyrogram-2.0.126}/pyrogram/handlers/__init__.py

@@ -19,7 +19,6 @@
 from .callback_query_handler import CallbackQueryHandler
 from .chat_join_request_handler import ChatJoinRequestHandler
 from .chat_member_updated_handler import ChatMemberUpdatedHandler
-from .conversation_handler import ConversationHandler
 from .chosen_inline_result_handler import ChosenInlineResultHandler
 from .deleted_messages_handler import DeletedMessagesHandler
 from .disconnect_handler import DisconnectHandler
@@ -28,4 +27,5 @@ from .inline_query_handler import InlineQueryHandler
 from .message_handler import MessageHandler
 from .poll_handler import PollHandler
 from .raw_update_handler import RawUpdateHandler
-from .user_status_handler import UserStatusHandler
+from .story_handler import StoryHandler
+from .user_status_handler import UserStatusHandler

WPyrogram-2.0.126/pyrogram/handlers/story_handler.py

@@ -0,0 +1,49 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  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 <http://www.gnu.org/licenses/>.
+
+from typing import Callable
+
+from .handler import Handler
+
+
+class StoryHandler(Handler):
+    """The Story handler class. Used to handle new stories.
+    It is intended to be used with :meth:`~pyrogram.Client.add_handler`
+
+    For a nicer way to register this handler, have a look at the
+    :meth:`~pyrogram.Client.on_story` decorator.
+
+    Parameters:
+        callback (``Callable``):
+            Pass a function that will be called when a new Stories arrives. It takes *(client, story)*
+            as positional arguments (look at the section below for a detailed description).
+
+        filters (:obj:`Filters`):
+            Pass one or more filters to allow only a subset of stories to be passed
+            in your callback function.
+
+    Other parameters:
+        client (:obj:`~pyrogram.Client`):
+            The Client itself, useful when you want to call other API methods inside the story handler.
+
+        story (:obj:`~pyrogram.types.Story`):
+            The received story.
+    """
+
+    def __init__(self, callback: Callable, filters=None):
+        super().__init__(callback, filters)