
    ՟f>                         d Z ddlmZmZ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.    )TYPE_CHECKINGFinalOptionalSequenceTuple)	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                    R/var/www/cvtools/html/venv/lib/python3.12/site-packages/telegram/_files/sticker.pyr'   zSticker.__init__   s    ( 	)! 	 	
 ^^ 	E#DJ%DK%0D"*DM!__Y-B-BD$ODI(-DJ+3DM9FD5FD"2AD 4DD!	E 	E 	E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r1   r2   r   )	_parse_datar   de_jsongetr#   r
   popr&   _de_json)clsr1   r2   r   r,   s       r-   r9   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/   r0   classmethodr9   __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   rN   rQ   rP   rO   r$   r   c                    t         |   |       || _        || _        t	        |      | _        || _        || _        | j                  f| _        | j                          y Nr   )
r&   r'   rN   rQ   r   rP   rO   r$   	_id_attrs_freeze)r+   rN   rQ   rP   rO   r$   r   r,   s          r-   r'   zStickerSet.__init__  sT     	J/	
-?-I!-.7))r>   r1   r2   r   r3   c                    |syt        j                  |j                  d      |      |d<   t        j	                  |j                  d      |      |d<   i }dD ]  }||v s|j                  |      ||<    t        |   |||      S )r5   Nr$   rP   )contains_masksr6   r   r   r7   )r   r9   r:   r   de_listr;   r&   r<   )r=   r1   r2   r   deprecated_fieldr,   s        r-   r9   zStickerSet.de_json3  s    
 %--dhh{.CSI["??488J+?EZ
 !W 	J4'/3xx8H/I
+,	J wTszJJr>   r?   )r@   rA   rB   rC   rD   rE   r   r   r   r   r   r'   rI   r9   rJ   rK   s   @r-   rM   rM      s    ;zI *. *.  7#	
  I& X&* >BKH%K,4UOK	,	K Kr>   rM   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   r[   r]   r^   r\   r   c                    t         |   |       || _        || _        || _        || _        | j                  | j                  | j                  | j
                  f| _        | j                          y rS   )r&   r'   r[   r]   r^   r\   rT   rU   )r+   r[   r]   r^   r\   r   r,   s         r-   r'   zMaskPosition.__init__r  sZ     	J/
%%!
**dllDLL$**Mr>   )r@   rA   rB   rC   rD   r   r#   r_   r   rE   rH   r`   ra   rb   floatr   r   r'   rJ   rK   s   @r-   r#   r#   H  s    < 9I$11::HeCj:; --22D%*27!..44E5:48 --22D%*27 *.  	
  X& r>   r#   N)rC   typingr   r   r   r   r   telegramr   "telegram._files._basethumbedmediumr	   telegram._files.filer
   telegram._files.photosizer   telegram._telegramobjectr   telegram._utilsr   telegram._utils.argumentparsingr   telegram._utils.typesr   r   r   rM   r#    r>   r-   <module>ro      s]   & < B B  A % / 3   > *rK  rKjmK mK`;> ;r>   