Add missing fields to Sticker class

Author: KurimuzonAkuma

compiler/docs/compiler.py

@@ -665,6 +665,7 @@ def get_title_list(s: str) -> list:
             VideoNote
             Contact
             Location
+            MaskPosition
             MediaArea
             Venue
             Sticker
@@ -1094,6 +1095,8 @@ def get_title_list(s: str) -> list:
             PrivacyRuleType
             GiftForResaleOrder
             PaymentFormType
+            StickerType
+            MaskPointType
         """,
     )
 

pyrogram/enums/__init__.py

@@ -41,8 +41,10 @@
 from .profile_color import ProfileColor
 from .reply_color import ReplyColor
 from .sent_code_type import SentCodeType
+from .sticker_type import StickerType
 from .gift_attribute_type import GiftAttributeType
 from .gift_for_resale_order import GiftForResaleOrder
+from .mask_point_type import MaskPointType
 from .media_area_type import MediaAreaType
 from .stories_privacy_rules import StoriesPrivacyRules
 from .user_status import UserStatus
@@ -73,8 +75,10 @@
     'ProfileColor',
     'ReplyColor',
     'SentCodeType',
+    'StickerType',
     'GiftAttributeType',
     'GiftForResaleOrder',
+    'MaskPointType',
     'MediaAreaType',
     'StoriesPrivacyRules',
     'UserStatus'

pyrogram/enums/mask_point_type.py

@@ -0,0 +1,35 @@
+#  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 .auto_name import AutoName
+
+
+class MaskPointType(AutoName):
+    """Mask point type enumeration used in :obj:`~pyrogram.types.MaskPosition`."""
+
+    FOREHEAD = 0
+    "Mask point relative to the forehead."
+
+    EYES = 1
+    "Mask point relative to the eyes."
+
+    MOUTH = 2
+    "Mask point relative to the mouth."
+
+    CHIN = 3
+    "Mask point relative to the chin."

pyrogram/enums/sticker_type.py

@@ -0,0 +1,34 @@
+#  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 StickerType(AutoName):
+    """Sticker type enumeration used in :obj:`~pyrogram.types.Sticker`."""
+
+    REGULAR = auto()
+    "The sticker is a regular sticker"
+
+    MASK = auto()
+    "The sticker is a mask in WEBP format to be placed on photos or videos."
+
+    CUSTOM_EMOJI = auto()
+    "The sticker is a custom emoji to be used inside message text and caption."

pyrogram/types/messages_and_media/__init__.py

@@ -57,6 +57,7 @@
 from .giveaway_prize_stars import GiveawayPrizeStars
 from .giveaway_winners import GiveawayWinners
 from .location import Location
+from .mask_position import MaskPosition
 from .media_area import MediaArea
 from .message import Message
 from .message_entity import MessageEntity
@@ -151,6 +152,7 @@
     "GiveawayPrizeStars",
     "GiveawayWinners",
     "Location",
+    "MaskPosition",
     "MediaArea",
     "Message",
     "MessageEntity",

pyrogram/types/messages_and_media/mask_position.py

@@ -0,0 +1,70 @@
+#  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 pyrogram import enums, raw
+
+from ..object import Object
+
+
+class MaskPosition(Object):
+    """This object describes the position on faces where a mask should be placed by default.
+
+    Parameters:
+        point (:obj:`~pyrogram.enums.MaskPointType`):
+            The part of the face relative to which the mask should be placed.
+
+        x_shift (``float``):
+            Shift by X-axis measured in widths of the mask scaled to the face size, from left to right.
+            For example, choosing -1.0 will place mask just to the left of the default mask position.
+
+        y_shift (``float``):
+            Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom.
+            For example, 1.0 will place the mask just below the default mask position.
+
+        scale (``float``):
+            Mask scaling coefficient. For example, 2.0 means double size.
+    """
+    def __init__(
+        self,
+        *,
+        point: "enums.MaskPointType",
+        x_shift: float,
+        y_shift: float,
+        scale: float
+    ):
+        super().__init__()
+
+        self.point = point
+        self.x_shift = x_shift
+        self.y_shift = y_shift
+        self.scale = scale
+
+    @staticmethod
+    def _parse(
+        coords: "raw.types.MaskCoords"
+    ) -> "MaskPosition":
+        if not coords:
+            return None
+
+        return MaskPosition(
+            point=enums.MaskPointType(coords.n),
+            x_shift=coords.x,
+            y_shift=coords.y,
+            scale=coords.zoom
+        )