+
    ÁFñj+B  ã                   óö   € R t ^ RIt^ RIHt ^ RIHt ^ RIHt ^ RI	H
t
 ^ RIHt ^ RIHtHtHt ^ RIHtHt ^ R	IHt ]'       d	   ^ R
IHtHt  ! R R]
4      t ! R R]
4      t ! R R]
4      t ! R R]
4      tR# )zGThis module contains an objects that are related to Telegram giveaways.N)ÚSequence)ÚTYPE_CHECKING)ÚChat)ÚTelegramObject)ÚUser)Úde_json_optionalÚde_list_optionalÚparse_sequence_arg)Úextract_tzinfo_from_defaultsÚfrom_timestamp©ÚJSONDict)ÚBotÚMessagec                   óx   a a€ ] tR t^$t oRtR	tR
RR/V3R lV 3R llllt]RV3R lV 3R lll4       tRt	Vt
V ;t# )ÚGiveawayaù  This object represents a message about a scheduled giveaway.

Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`chats`, :attr:`winners_selection_date` and
:attr:`winner_count` are equal.

.. versionadded:: 20.8

Args:
    chats (tuple[:class:`telegram.Chat`]): The list of chats which the user must join to
        participate in the giveaway.
    winners_selection_date (:class:`datetime.datetime`): The date when the giveaway winner will
        be selected. |datetime_localization|
    winner_count (:obj:`int`): The number of users which are supposed to be selected as winners
        of the giveaway.
    only_new_members (:obj:`True`, optional): If :obj:`True`, only users who join the chats
        after the giveaway started should be eligible to win.
    has_public_winners (:obj:`True`, optional): :obj:`True`, if the list of giveaway winners
        will be visible to everyone
    prize_description (:obj:`str`, optional): Description of additional giveaway prize
    country_codes (Sequence[:obj:`str`]): A list of two-letter ISO 3166-1 alpha-2
        country codes indicating the countries from which eligible users for the giveaway must
        come. If empty, then all users can participate in the giveaway. Users with a phone
        number that was bought on Fragment can always participate in giveaways.
    prize_star_count (:obj:`int`, optional): The number of Telegram Stars to be split between
        giveaway winners; for Telegram Star giveaways only.

        .. versionadded:: 21.6
    premium_subscription_month_count (:obj:`int`, optional): The number of months the Telegram
        Premium subscription won from the giveaway will be active for; for Telegram Premium
        giveaways only.

Attributes:
    chats (Sequence[:class:`telegram.Chat`]): The list of chats which the user must join to
        participate in the giveaway.
    winners_selection_date (:class:`datetime.datetime`): The date when the giveaway winner will
        be selected. |datetime_localization|
    winner_count (:obj:`int`): The number of users which are supposed to be selected as winners
        of the giveaway.
    only_new_members (:obj:`True`): Optional. If :obj:`True`, only users who join the chats
        after the giveaway started should be eligible to win.
    has_public_winners (:obj:`True`): Optional. :obj:`True`, if the list of giveaway winners
        will be visible to everyone
    prize_description (:obj:`str`): Optional. Description of additional giveaway prize
    country_codes (tuple[:obj:`str`]): Optional. A tuple of two-letter ISO 3166-1 alpha-2
        country codes indicating the countries from which eligible users for the giveaway must
        come. If empty, then all users can participate in the giveaway. Users with a phone
        number that was bought on Fragment can always participate in giveaways.
    prize_star_count (:obj:`int`): Optional. The number of Telegram Stars to be split between
        giveaway winners; for Telegram Star giveaways only.

        .. versionadded:: 21.6
    premium_subscription_month_count (:obj:`int`): Optional. The number of months the Telegram
        Premium subscription won from the giveaway will be active for; for Telegram Premium
        giveaways only.
NÚ
api_kwargsc                óì   <€ V ^8„  d   QhRS[ S[,          RS[P                  RS[RS[R,          RS[R,          RS[R,          RS[ S[,          R,          R	S[R,          R
S[R,          RS[R,          /
# )é   ÚchatsÚwinners_selection_dateÚwinner_countÚonly_new_membersNÚhas_public_winnersÚprize_descriptionÚcountry_codesÚ premium_subscription_month_countÚprize_star_countr   )r   r   ÚdtmÚdatetimeÚintÚboolÚstrr   )ÚformatÚ__classdict__s   "€ÚH/opt/hermes-site/venv/lib/python3.14/site-packages/telegram/_giveaway.pyÚ__annotate__ÚGiveaway.__annotate__j   s˜   ø€ ÷  ñ  á™�~ð ñ !$§¡ð ñ ð	 ñ
  �+ð ñ ! 4�Kð ñ  �:ð ñ  ¡•} tÕ+ð ñ +.°­*ð ñ  �*ð ñ ˜t•Oñ ó    c
               ó,  <€ \         SV `  V
R 7       \        V4      V n        W n        W0n        W@n        WPn        W`n        \        V4      V n
        W€n        W�n        V P                  V P                  V P
                  3V n        V P                  4        R# ©)r   N)ÚsuperÚ__init__Útupler   r   r   r   r   r   r	   r   r   r   Ú	_id_attrsÚ_freeze)Úselfr   r   r   r   r   r   r   r   r   r   Ú	__class__s   &&&&&&&&&&$€r%   r,   ÚGiveaway.__init__j   s†   ø€ ô 	‰Ñ JÐÔ/ä',¨U£|ˆŒ
Ø4JÔ#Ø!-ÔØ-=ÔØ/AÔØ->ÔÜ.@ÀÓ.OˆÔØ<\Ô-Ø,<Ôð �J‰JØ×'Ñ'Ø×Ñð
ˆŒð 	�‰Žr(   c                ó(   <€ V ^8„  d   QhRS[ RRRR/# )r   ÚdataÚbotú
Bot | NoneÚreturnr   r   )r#   r$   s   "€r%   r&   r'   �   s"   ø€ ÷ 3ñ 3™8ð 3¨,ð 3À*ñ 3r(   c                óà   <€ V P                  V4      p\        V4      p\        VP                  R4      \        V4      VR&   \        VP                  R4      VR7      VR&   \        SV `  WR7      # )ú,See :meth:`telegram.TelegramObject.de_json`.r   r   ©Útzinfo©r4   r5   )Ú_parse_datar
   r   Úgetr   r   r+   Úde_json©Úclsr4   r5   Ú
loc_tzinfor1   s   &&& €r%   r?   ÚGiveaway.de_jsonŒ   sl   ø€ ð �‰˜tÓ$ˆô 2°#Ó6ˆ
ä(¨¯©°'Ó):¼DÀ#ÓFˆˆW‰Ü)7Ø�H‰HÐ-Ó.°zô*
ˆÐ%Ñ&ô ‰w‰ DˆÓ2Ð2r(   )
r.   r   r   r   r   r   r   r   r   r   )	r   r   r   r   r   r   r   r   r   )NNNNNN©N©Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__Ú	__slots__r,   Úclassmethodr?   Ú__static_attributes__Ú__classdictcell__Ú__classcell__©r1   r$   s   @@r%   r   r   $   sE   ù‡ € ñ7ðr
€Iñ ð '+÷ ö  ðD ÷3ô 3ó ÷3ð 3r(   r   c                   óR   a a€ ] tR t^œt oRtRtRRR/V3R lV 3R lllltRtVtV ;t	# )ÚGiveawayCreatedaÞ  This object represents a service message about the creation of a scheduled giveaway.

Args:
    prize_star_count (:obj:`int`, optional): The number of Telegram Stars to be
        split between giveaway winners; for Telegram Star giveaways only.

        .. versionadded:: 21.6

Attributes:
    prize_star_count (:obj:`int`): Optional. The number of Telegram Stars to be
        split between giveaway winners; for Telegram Star giveaways only.

        .. versionadded:: 21.6

Nr   c                óB   <€ V ^8„  d   QhRS[ R,          RS[R,          /# )r   r   Nr   )r    r   )r#   r$   s   "€r%   r&   ÚGiveawayCreated.__annotate__¯   s$   ø€ ÷ ñ ©¨t­ð É8ÐVZÍ?ñ r(   c               óT   <€ \         SV `  VR 7       Wn        V P                  4        R# r*   )r+   r,   r   r/   )r0   r   r   r1   s   &&$€r%   r,   ÚGiveawayCreated.__init__¯   s"   ø€ Ü‰Ñ JÐÔ/Ø,<Ôà�‰Žr(   )r   rD   )
rF   rG   rH   rI   rJ   rK   r,   rM   rN   rO   rP   s   @@r%   rR   rR   œ   s(   ù‡ € ñð  &€IñÐ]a÷ ÷ ö r(   rR   c                   óx   a a€ ] tR t^¶t oRtR	tR
RR/V3R lV 3R llllt]RV3R lV 3R lll4       tRt	Vt
V ;t# )ÚGiveawayWinnersa  This object represents a message about the completion of a giveaway with public winners.

Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`chat`, :attr:`giveaway_message_id`,
:attr:`winners_selection_date`, :attr:`winner_count` and :attr:`winners` are equal.

.. versionadded:: 20.8

Args:
    chat (:class:`telegram.Chat`): The chat that created the giveaway
    giveaway_message_id (:obj:`int`): Identifier of the message with the giveaway in the chat
    winners_selection_date (:class:`datetime.datetime`): Point in time when winners of the
        giveaway were selected. |datetime_localization|
    winner_count (:obj:`int`): Total number of winners in the giveaway
    winners (Sequence[:class:`telegram.User`]): List of up to
        :tg-const:`telegram.constants.GiveawayLimit.MAX_WINNERS` winners of the giveaway
    prize_star_count (:obj:`int`, optional): The number of Telegram Stars to be split between
        giveaway winners; for Telegram Star giveaways only.

        .. versionadded:: 21.6
    additional_chat_count (:obj:`int`, optional): The number of other chats the user had to
        join in order to be eligible for the giveaway
    premium_subscription_month_count (:obj:`int`, optional): The number of months the Telegram
        Premium subscription won from the giveaway will be active for
    unclaimed_prize_count (:obj:`int`, optional): Number of undistributed prizes
    only_new_members (:obj:`True`, optional): :obj:`True`, if only users who had joined the
        chats after the giveaway started were eligible to win
    was_refunded (:obj:`True`, optional): :obj:`True`, if the giveaway was canceled because the
        payment for it was refunded
    prize_description (:obj:`str`, optional): Description of additional giveaway prize

Attributes:
    chat (:class:`telegram.Chat`): The chat that created the giveaway
    giveaway_message_id (:obj:`int`): Identifier of the message with the giveaway in the chat
    winners_selection_date (:class:`datetime.datetime`): Point in time when winners of the
        giveaway were selected. |datetime_localization|
    winner_count (:obj:`int`): Total number of winners in the giveaway
    winners (tuple[:class:`telegram.User`]): tuple of up to
        :tg-const:`telegram.constants.GiveawayLimit.MAX_WINNERS` winners of the giveaway
    additional_chat_count (:obj:`int`): Optional. The number of other chats the user had to
        join in order to be eligible for the giveaway
    prize_star_count (:obj:`int`): Optional. The number of Telegram Stars to be split between
        giveaway winners; for Telegram Star giveaways only.

        .. versionadded:: 21.6
    premium_subscription_month_count (:obj:`int`): Optional. The number of months the Telegram
        Premium subscription won from the giveaway will be active for
    unclaimed_prize_count (:obj:`int`): Optional. Number of undistributed prizes
    only_new_members (:obj:`True`): Optional. :obj:`True`, if only users who had joined the
        chats after the giveaway started were eligible to win
    was_refunded (:obj:`True`): Optional. :obj:`True`, if the giveaway was canceled because the
        payment for it was refunded
    prize_description (:obj:`str`): Optional. Description of additional giveaway prize
Nr   c                óü   <€ V ^8„  d   QhRS[ RS[RS[P                  RS[RS[S[,          RS[R,          RS[R,          R	S[R,          R
S[R,          RS[R,          RS[R,          RS[R,          RS[R,          /# )r   ÚchatÚgiveaway_message_idr   r   ÚwinnersÚadditional_chat_countNr   Úunclaimed_prize_countr   Úwas_refundedr   r   r   )	r   r    r   r   r   r   r!   r"   r   )r#   r$   s   "€r%   r&   ÚGiveawayWinners.__annotate__ý   sµ   ø€ ÷ (ñ (áð(ñ !ð(ñ !$§¡ð	(ñ
 ð(ñ ™$•ð(ñ  # T�zð(ñ +.°­*ð(ñ  # T�zð(ñ  �+ð(ñ ˜T•kð(ñ  �:ð(ñ  �*ð(ñ ˜t•Oñ(r(   c               óh  <€ \         SV `  VR 7       Wn        W n        W0n        W@n        \        V4      V n        W`n        Wpn	        W€n
        W�n        W n        W°n        WÀn        V P                  V P                  V P                  V P
                  V P                  3V n        V P!                  4        R# r*   )r+   r,   rZ   r[   r   r   r-   r\   r]   r   r^   r   r_   r   r   r.   r/   )r0   rZ   r[   r   r   r\   r]   r   r^   r   r_   r   r   r   r1   s   &&&&&&&&&&&&&$€r%   r,   ÚGiveawayWinners.__init__ý   s    ø€ ô" 	‰Ñ JÐÔ/àŒ	Ø(;Ô Ø4JÔ#Ø!-ÔÜ).¨w«ˆŒØ1FÔ"Ø<\Ô-Ø1FÔ"Ø-=ÔØ)5ÔØ->ÔØ,<Ôð �I‰IØ×$Ñ$Ø×'Ñ'Ø×ÑØ�L‰Lð
ˆŒð 	�‰Žr(   c                ó(   <€ V ^8„  d   QhRS[ RRRR/# )r   r4   r5   r6   r7   rX   r   )r#   r$   s   "€r%   r&   r`   (  s#   ø€ ÷ 3ñ 3™8ð 3¨,ð 3ÐBSñ 3r(   c                ó&  <€ V P                  V4      p\        V4      p\        VP                  R4      \        V4      VR&   \        VP                  R4      \        V4      VR&   \        VP                  R4      VR7      VR&   \        SV `%  WR7      # )r9   rZ   r\   r   r:   r<   )
r=   r
   r   r>   r   r   r   r   r+   r?   r@   s   &&& €r%   r?   ÚGiveawayWinners.de_json'  s‡   ø€ ð �‰˜tÓ$ˆô 2°#Ó6ˆ
ä'¨¯©°Ó(8¼$ÀÓDˆˆV‰Ü*¨4¯8©8°IÓ+>ÄÀcÓJˆˆY‰Ü)7Ø�H‰HÐ-Ó.°zô*
ˆÐ%Ñ&ô ‰w‰ DˆÓ2Ð2r(   )r.   r]   rZ   r[   r   r   r   r   r^   r_   r   r\   r   )r]   rZ   r[   r   r   r   r   r^   r_   r   r\   r   )NNNNNNNrD   rE   rP   s   @@r%   rX   rX   ¶   sE   ù‡ € ñ5ðn€Iñ(ð '+÷(ö (ðT ÷3ô 3ó ÷3ð 3r(   rX   c                   óx   a a€ ] tR tRt oRtR
tRRR/V3R lV 3R llllt]RV3R lV 3R lll4       tR	t	Vt
V ;t# )ÚGiveawayCompletedi8  a  This object represents a service message about the completion of a giveaway without public
winners.

Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`winner_count` and :attr:`unclaimed_prize_count` are equal.

.. versionadded:: 20.8


Args:
    winner_count (:obj:`int`): Number of winners in the giveaway
    unclaimed_prize_count (:obj:`int`, optional): Number of undistributed prizes
    giveaway_message (:class:`telegram.Message`, optional): Message with the giveaway that was
        completed, if it wasn't deleted
    is_star_giveaway (:obj:`bool`, optional): :obj:`True`, if the giveaway is a Telegram Star
        giveaway. Otherwise, currently, the giveaway is a Telegram Premium giveaway.

        .. versionadded:: 21.6
Attributes:
    winner_count (:obj:`int`): Number of winners in the giveaway
    unclaimed_prize_count (:obj:`int`): Optional. Number of undistributed prizes
    giveaway_message (:class:`telegram.Message`): Optional. Message with the giveaway that was
        completed, if it wasn't deleted
    is_star_giveaway (:obj:`bool`): Optional. :obj:`True`, if the giveaway is a Telegram Star
        giveaway. Otherwise, currently, the giveaway is a Telegram Premium giveaway.

        .. versionadded:: 21.6
Nr   c                ó`   <€ V ^8„  d   QhRS[ RS[ R,          RRRS[R,          RS[R,          /# )r   r   r^   NÚgiveaway_messagezMessage | NoneÚis_star_giveawayr   )r    r!   r   )r#   r$   s   "€r%   r&   ÚGiveawayCompleted.__annotate__X  sI   ø€ ÷ ñ áðñ  # T�zðð +ð	ñ
  �+ðñ ˜t•Oñr(   c               ó²   <€ \         SV `  VR 7       Wn        W n        W0n        W@n        V P                  V P                  3V n        V P                  4        R# r*   )r+   r,   r   r^   ri   rj   r.   r/   )r0   r   r^   ri   rj   r   r1   s   &&&&&$€r%   r,   ÚGiveawayCompleted.__init__X  sU   ø€ ô 	‰Ñ JÐÔ/à!-ÔØ1FÔ"Ø0@ÔØ-=Ôð ×ÑØ×&Ñ&ð
ˆŒð
 	�‰Žr(   c                ó(   <€ V ^8„  d   QhRS[ RRRR/# )r   r4   r5   r6   r7   rg   r   )r#   r$   s   "€r%   r&   rk   p  s#   ø€ ÷ 3ñ 3™8ð 3¨,ð 3ÐBUñ 3r(   c                óŽ   <€ V P                  V4      p^ RIHp \        VP	                  R4      W24      VR&   \
        SV `  WR7      # )r9   )r   ri   r<   )r=   Útelegram._messager   r   r>   r+   r?   )rA   r4   r5   r   r1   s   &&& €r%   r?   ÚGiveawayCompleted.de_jsono  sH   ø€ ð �‰˜tÓ$ˆõ	
ô $4°D·H±HÐ=OÓ4PÐRYÓ#_ˆÐÑ ä‰w‰ DˆÓ2Ð2r(   )r.   ri   rj   r^   r   )ri   rj   r^   r   )NNNrD   rE   rP   s   @@r%   rg   rg   8  sD   ù‡ € ñð: b€Iñð '+÷ö ð. ÷3ô 3ó ÷3ð 3r(   rg   )rJ   r   r   Úcollections.abcr   Útypingr   Útelegram._chatr   Útelegram._telegramobjectr   Útelegram._userr   Útelegram._utils.argumentparsingr   r   r	   Útelegram._utils.datetimer
   r   Útelegram._utils.typesr   Útelegramr   r   r   rR   rX   rg   © r(   r%   Ú<module>r|      sg   ðñ& Nã Ý $Ý  å Ý 3Ý ß bÑ bß QÝ *çß%ôu3ˆ~ô u3ôp�nô ô43�nô 3ôDC3˜ö C3r(   