U g>@sdZddlmZmZmZmZmZddlmZddl m Z ddl m Z ddl mZddlmZddlmZdd lmZdd lmZerdd lmZGd d d e ZGdddeZGdddeZdS)z5This module contains objects that represent stickers.) TYPE_CHECKINGFinalOptionalSequenceTuple) constants)_BaseThumbedMedium)File) PhotoSize)TelegramObject)enum)parse_sequence_arg)JSONDict)BotcseZdZUdZdZdddeeeeeeeeeeeeeededeeee eeee dfdd Z e j jZeeed <e j jZeeed <e j jZeeed <edee ed eddfdd ZZS)StickerajThis object represents a sticker. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`file_unique_id` is equal. Note: As of v13.11 :paramref:`is_video` is a required argument and therefore the order of the arguments had to be changed. Use keyword arguments to make sure that the arguments are passed correctly. .. versionchanged:: 20.5 |removed_thumb_note| Args: file_id (:obj:`str`): Identifier for this file, which can be used to download or reuse the file. file_unique_id (:obj:`str`): Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. width (:obj:`int`): Sticker width. height (:obj:`int`): Sticker height. is_animated (:obj:`bool`): :obj:`True`, if the sticker is animated. is_video (:obj:`bool`): :obj:`True`, if the sticker is a video sticker. .. versionadded:: 13.11 type (:obj:`str`): Type of the sticker. Currently one of :attr:`REGULAR`, :attr:`MASK`, :attr:`CUSTOM_EMOJI`. The type of the sticker is independent from its format, which is determined by the fields :attr:`is_animated` and :attr:`is_video`. .. versionadded:: 20.0 emoji (:obj:`str`, optional): Emoji associated with the sticker set_name (:obj:`str`, optional): Name of the sticker set to which the sticker belongs. mask_position (:class:`telegram.MaskPosition`, optional): For mask stickers, the position where the mask should be placed. file_size (:obj:`int`, optional): File size in bytes. premium_animation (:class:`telegram.File`, optional): For premium regular stickers, premium animation for the sticker. .. versionadded:: 20.0 custom_emoji_id (:obj:`str`, optional): For custom emoji stickers, unique identifier of the custom emoji. .. versionadded:: 20.0 thumbnail (:class:`telegram.PhotoSize`, optional): Sticker thumbnail in the ``.WEBP`` or ``.JPG`` format. .. versionadded:: 20.2 needs_repainting (:obj:`bool`, optional): :obj:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places. .. versionadded:: 20.2 Attributes: file_id (:obj:`str`): Identifier for this file, which can be used to download or reuse the file. file_unique_id (:obj:`str`): Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. width (:obj:`int`): Sticker width. height (:obj:`int`): Sticker height. is_animated (:obj:`bool`): :obj:`True`, if the sticker is animated. is_video (:obj:`bool`): :obj:`True`, if the sticker is a video sticker. .. versionadded:: 13.11 type (:obj:`str`): Type of the sticker. Currently one of :attr:`REGULAR`, :attr:`MASK`, :attr:`CUSTOM_EMOJI`. The type of the sticker is independent from its format, which is determined by the fields :attr:`is_animated` and :attr:`is_video`. .. versionadded:: 20.0 emoji (:obj:`str`): Optional. Emoji associated with the sticker. set_name (:obj:`str`): Optional. Name of the sticker set to which the sticker belongs. mask_position (:class:`telegram.MaskPosition`): Optional. For mask stickers, the position where the mask should be placed. file_size (:obj:`int`): Optional. File size in bytes. premium_animation (:class:`telegram.File`): Optional. For premium regular stickers, premium animation for the sticker. .. versionadded:: 20.0 custom_emoji_id (:obj:`str`): Optional. For custom emoji stickers, unique identifier of the custom emoji. .. versionadded:: 20.0 thumbnail (:class:`telegram.PhotoSize`): Optional. Sticker thumbnail in the ``.WEBP`` or ``.JPG`` format. .. versionadded:: 20.2 needs_repainting (:obj:`bool`): Optional. :obj:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places. .. versionadded:: 20.2 ) custom_emoji_idemojiheight is_animatedis_video mask_positionneeds_repaintingpremium_animationset_nametypewidthN api_kwargs MaskPositionr )file_idfile_unique_idrrrrrr file_sizerrrr thumbnailrrc s|tj||| ||d|T||_||_||_||_tt j |||_ ||_ | |_ | |_| |_| |_||_W5QRXdS)N)rr r!r"r)super__init__Z _unfrozenrrrrr Z get_memberr StickerTyperrrrrrr)selfrr rrrrrrr!rrrrr"rr __class__;/tmp/pip-unpacked-wheel-swnnwir2/telegram/_files/sticker.pyr$s& zSticker.__init__REGULARMASK CUSTOM_EMOJIrdatabotreturncs||}|sdSt|d||d<t|d||d<t|d||d<i}|ddk rt|d|d<tj|||dS),See :meth:`telegram.TelegramObject.de_json`.Nr"rrthumbr/r0r) Z _parse_datar de_jsongetrr popr#_de_json)clsr/r0rr'r)r*r5s zSticker.de_json)NNNNNNNN)N)__name__ __module__ __qualname____doc__ __slots__strintboolrr rr$rr%r+r__annotations__r,r- classmethodr5 __classcell__r)r)r'r*r#sF `*rc speZdZdZdZd ddeeeeeee ee dfddZ e d ee ededd fd d Z ZS) StickerSetaThis object represents a sticker set. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`name` is equal. Note: As of v13.11 :paramref:`is_video` is a required argument and therefore the order of the arguments had to be changed. Use keyword arguments to make sure that the arguments are passed correctly. .. versionchanged:: 20.0 The parameter ``contains_masks`` has been removed. Use :paramref:`sticker_type` instead. .. versionchanged:: 21.1 The parameters ``is_video`` and ``is_animated`` are deprecated and now made optional. Thus, the order of the arguments had to be changed. .. versionchanged:: 20.5 |removed_thumb_note| .. versionremoved:: 21.2 Removed the deprecated arguments and attributes ``is_animated`` and ``is_video``. Args: name (:obj:`str`): Sticker set name. title (:obj:`str`): Sticker set title. stickers (Sequence[:class:`telegram.Sticker`]): List of all set stickers. .. versionchanged:: 20.0 |sequenceclassargs| sticker_type (:obj:`str`): Type of stickers in the set, currently one of :attr:`telegram.Sticker.REGULAR`, :attr:`telegram.Sticker.MASK`, :attr:`telegram.Sticker.CUSTOM_EMOJI`. .. versionadded:: 20.0 thumbnail (:class:`telegram.PhotoSize`, optional): Sticker set thumbnail in the ``.WEBP``, ``.TGS``, or ``.WEBM`` format. .. versionadded:: 20.2 Attributes: name (:obj:`str`): Sticker set name. title (:obj:`str`): Sticker set title. stickers (Tuple[:class:`telegram.Sticker`]): List of all set stickers. .. versionchanged:: 20.0 |tupleclassattrs| sticker_type (:obj:`str`): Type of stickers in the set, currently one of :attr:`telegram.Sticker.REGULAR`, :attr:`telegram.Sticker.MASK`, :attr:`telegram.Sticker.CUSTOM_EMOJI`. .. versionadded:: 20.0 thumbnail (:class:`telegram.PhotoSize`): Optional. Sticker set thumbnail in the ``.WEBP``, ``.TGS``, or ``.WEBM`` format. .. versionadded:: 20.2 )name sticker_typestickersr"titleNr)rFrIrHrGr"rcsFtj|d||_||_t||_||_||_|jf|_| dSNr) r#r$rFrIr rHrGr" _id_attrs_freeze)r&rFrIrHrGr"rr'r)r*r$s   zStickerSet.__init__rr.csj|sdSt|d||d<t|d||d<i}dD]}||kr<||||<qr?rrrr rr$rCr5rDr)r)r'r*rEs(=rEcseZdZUdZdZejjZee e d<ejj Z ee e d<ejj Z ee e d<ejj Z ee e d<dde eeeeed fd d ZZS) raThis object describes the position on faces where a mask should be placed by default. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`point`, :attr:`x_shift`, :attr:`y_shift` and, :attr:`scale` are equal. Args: point (:obj:`str`): The part of the face relative to which the mask should be placed. One of :attr:`FOREHEAD`, :attr:`EYES`, :attr:`MOUTH`, or :attr:`CHIN`. x_shift (:obj:`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 (:obj:`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 (:obj:`float`): Mask scaling coefficient. For example, ``2.0`` means double size. Attributes: point (:obj:`str`): The part of the face relative to which the mask should be placed. One of :attr:`FOREHEAD`, :attr:`EYES`, :attr:`MOUTH`, or :attr:`CHIN`. x_shift (:obj:`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 (:obj:`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 (:obj:`float`): Mask scaling coefficient. For example, ``2.0`` means double size. )pointscalex_shifty_shiftFOREHEADEYESMOUTHCHINNr)rMrOrPrNrcsHtj|d||_||_||_||_|j|j|j|jf|_|dSrJ)r#r$rMrOrPrNrKrL)r&rMrOrPrNrr'r)r*r$rs zMaskPosition.__init__)r:r;r<r=r>rrrQrr?rBrRrSrTfloatrrr$rDr)r)r'r*rHs  rN)r=typingrrrrrZtelegramrZ"telegram._files._basethumbedmediumrZtelegram._files.filer Ztelegram._files.photosizer Ztelegram._telegramobjectr Ztelegram._utilsr Ztelegram._utils.argumentparsingr Ztelegram._utils.typesrrrrErr)r)r)r*s         6p