
    Qi0>                         d Z ddlmZ ddlmZmZmZ ddlmZ ddl	m
Z
 ddlmZ ddlmZ ddlmZ dd	lmZ dd
lmZ ddlmZ erddlmZ  G d de
      Z G d de      Z G d de      Zy)z5This module contains objects that represent stickers.    )Sequence)TYPE_CHECKINGFinalOptional)	constants)_BaseThumbedMedium)File)	PhotoSize)TelegramObject)enum)parse_sequence_arg)JSONDict)Botc            #           e Zd ZU dZdZ	 	 	 	 	 	 	 	 d dddedededed	ed
ededee   dee   dee   ded   ded   dee   dee	   dee   dee
   f  fdZej                  j                  Zee   ed<   	 ej                  j"                  Zee   ed<   	 ej                  j$                  Zee   ed<   	 ed!dee
   ded   ded    f fd       Z xZS )"Stickeraj  This 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_idemojiheightis_animatedis_videomask_positionneeds_repaintingpremium_animationset_nametypewidthN
api_kwargsfile_idfile_unique_idr   r   r   r   r   r   	file_sizer   r   MaskPositionr   r	   r   	thumbnailr   r   c                X   t         |   |||	||       | j                         5  || _        || _        || _        || _        t        j                  t        j                  ||      | _        || _        |
| _        || _        || _        || _        || _        d d d        y # 1 sw Y   y xY w)N)r   r    r!   r#   r   )super__init__	_unfrozenr   r   r   r   r   
get_memberr   StickerTyper   r   r   r   r   r   r   )selfr   r    r   r   r   r   r   r   r!   r   r   r   r   r#   r   r   	__class__s                    B/app/.venv/lib/python3.12/site-packages/telegram/_files/sticker.pyr&   zSticker.__init__   s    ( 	)! 	 	
 ^^#DJ%DK%0D"*DM!__Y-B-BD$ODI(-DJ+3DM9FD5FD"2AD 4DD! s   A1B  B)REGULARMASKCUSTOM_EMOJIdatabotr   returnc                    | j                  |      }|syt        j                  |j                  d      |      |d<   t        j                  |j                  d      |      |d<   t        j                  |j                  d      |      |d<   i }|j                  d      |j                  d      |d<   t        | !  |||      S ),See :meth:`telegram.TelegramObject.de_json`.Nr#   r   r   thumbr0   r1   r   )	_parse_datar
   de_jsongetr"   r	   popr%   _de_json)clsr0   r1   r   r+   s       r,   r8   zSticker.de_json   s     t$%--dhh{.CSI[ , 4 4TXXo5NPS T_$(LL:M1NPS$T !
 88G("&((7"3JwwTszJJ    )NNNNNNNNN)__name__
__module____qualname____doc__	__slots__strintboolr   r
   r   r&   r   r)   r-   r   __annotations__r.   r/   classmethodr8   __classcell__r+   s   @r,   r   r   $   s   ^@I.  $#'"&26.2)-)-+/!(E$ *.%(E(E (E 	(E
 (E (E (E (E }(E C=(E 3-(E  /(E $F+(E "#(E I&(E  #4.!(E$ X&%(ET $//77GU3Z79 ,,11D%*16(44AAL%*A>K8H- KHUO KxXaOb K Kr=   r   c                        e Zd ZdZdZ	 ddddededee   ded	ee	   d
ee
   f fdZe	 ddee
   ded   ded    f fd       Z xZS )
StickerSeta  This 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_typestickersr#   titleNr   rM   rP   rO   rN   r#   r   c                    t         |   |       || _        || _        t	        |      | _        || _        || _        | j                  f| _        | j                          y Nr   )
r%   r&   rM   rP   r   rO   rN   r#   	_id_attrs_freeze)r*   rM   rP   rO   rN   r#   r   r+   s          r,   r&   zStickerSet.__init__  sT     	J/	
-?-I!-.7))r=   r0   r1   r   r2   c                    |syt        j                  |j                  d      |      |d<   t        j	                  |j                  d      |      |d<   i }dD ]  }||v s|j                  |      ||<    t        |   |||      S )r4   Nr#   rO   )contains_masksr5   r   r   r6   )r
   r8   r9   r   de_listr:   r%   r;   )r<   r0   r1   r   deprecated_fieldr+   s        r,   r8   zStickerSet.de_json4  s    
 %--dhh{.CSI["??488J+?EZ
 !W4'/3xx8H/I
+, !W wTszJJr=   r>   )r?   r@   rA   rB   rC   rD   r   r   r   r
   r   r&   rH   r8   rI   rJ   s   @r,   rL   rL      s    ;zI *. *.  7#	
  I& X&* >BKH%K,4UOK	,	K Kr=   rL   c                   B    e Zd ZU dZdZej                  j                  Zee	   e
d<   	 ej                  j                  Zee	   e
d<   	 ej                  j                  Zee	   e
d<   	 ej                  j                  Zee	   e
d<   	 ddd	e	d
edededee   f
 fdZ xZS )r"   a  This 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.

    )pointscalex_shifty_shiftFOREHEADEYESMOUTHCHINNr   rZ   r\   r]   r[   r   c                    t         |   |       || _        || _        || _        || _        | j                  | j                  | j                  | j
                  f| _        | j                          y rR   )r%   r&   rZ   r\   r]   r[   rS   rT   )r*   rZ   r\   r]   r[   r   r+   s         r,   r&   zMaskPosition.__init__s  sZ     	J/
%%!
**dllDLL$**Mr=   )r?   r@   rA   rB   rC   r   r"   r^   r   rD   rG   r_   r`   ra   floatr   r   r&   rI   rJ   s   @r,   r"   r"   I  s    < 9I$11::HeCj:; --22D%*27!..44E5:48 --22D%*27 *.  	
  X& r=   r"   N)rB   collections.abcr   typingr   r   r   telegramr   "telegram._files._basethumbedmediumr   telegram._files.filer	   telegram._files.photosizer
   telegram._telegramobjectr   telegram._utilsr   telegram._utils.argumentparsingr   telegram._utils.typesr   r   r   rL   r"    r=   r,   <module>ro      s`   & < $ 1 1  A % / 3   > *rK  rKjmK mK`;> ;r=   