Ii:SrSSKrSSKJrJrJrJr SSKJr SSK J r SSK J r SSK Jr SSKJrJr SS KJr \(aSS KJrJr "S S \ 5r"S S\ 5r"SS\ 5r"SS\ 5rg)zGThis module contains an objects that are related to Telegram giveaways.N) TYPE_CHECKINGOptionalSequenceTuple)Chat)TelegramObject)User)parse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)JSONDict)BotMessagec^\rSrSrSrSrSSS.S\\S\RS\ S \ \ S \ \ S \ \ S \ \\ S \ \ S\ \ 4U4Sjjjjr\S\ \ SSS\ S4U4Sjj5rSrU=r$)Giveaway"a+ 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. premium_subscription_month_count (:obj:`int`, optional): The number of months the Telegram Premium subscription won from the giveaway will be active for. 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. premium_subscription_month_count (:obj:`int`): Optional. The number of months the Telegram Premium subscription won from the giveaway will be active for. )chats country_codeshas_public_winnersonly_new_members premium_subscription_month_countprize_description winner_countwinners_selection_dateN api_kwargsrrrrrrrrrc >[T U]U S9 [U5UlX lX0lX@lXPlX`l[U5Ul Xl URURUR 4Ul UR5 gNr)super__init__tuplerrrrrrr rr _id_attrs_freeze) selfrrrrrrrrr __class__s 8/venv/lib/python3.13/site-packages/telegram/_giveaway.pyr Giveaway.__init__]s J/',U| 9O#!-0@2D0A.@.O?_- JJ  ' '     databotrreturnc>URU5nUcg[U5n[[R"UR S5U55US'[ UR S5US9US'[TU]!XS9$)+See :obj:`telegram.TelegramObject.de_json`.Nrrtzinfor)r*) _parse_datar r!rde_listgetr rde_jsonclsr)r* loc_tzinfor%s r&r4Giveaway.de_json}s{t$ <2#6 dll488G+*.~!) 1 1  #4.  %TN $C=  .+33-X&@38H-3E3hz>R33r(rcF^\rSrSrSrSrSS.S\\4U4SjjjrSr U=r $)GiveawayCreatedzuThis object represents a service message about the creation of a scheduled giveaway. Currently holds no information. Nrrc@>[TU]US9 UR5 gr)rr r#)r$rr%s r&r GiveawayCreated.__init__s J/ r() r9r:r;r<r=r>rr r rDrErFs@r&rHrHs(I;?hx&8r(rHc^\rSrSrSrSrSSS.S\S\S\RS \S \ \ S \ \S \ \S \ \S\ \ S\ \ S\ \ S\ \4U4Sjjjjr\S\ \SSS\ S4U4Sjj5rSrU=r$)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 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 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 ) additional_chat_countchatgiveaway_message_idrrrunclaimed_prize_count was_refundedrwinnersrNrrQrRrrrUrPrrSrrTrrc T>[T U]U S9 XlX lX0lX@l[ U5UlX`lXpl Xl Xl Xl Xl URURURUR UR4UlUR5 gr)rr rQrRrrr!rUrPrrSrrTrr"r#)r$rQrRrrrUrPrrSrrTrrr%s r&r GiveawayWinners.__init__s J/ (; 9O#!-).w 4I"?_-4I"0@,80A II  $ $  ' '    LL   r(r)r*rr+cL>URU5nUcg[U5n[R"UR S5U5US'[ [ R"UR S5U55US'[UR S5US9US'[TU] XS9$)r-NrQrUrr.r0) r1r rr4r3r!r r2r rr5s r&r4GiveawayWinners.de_jsonst$ <2#6 ||DHHV$4c:V  TXXi-@# FGY)7 HH- .z*  %&wD22r() r"rPrQrRrrrrSrTrrUr)NNNNNN)r9r:r;r<r=r>rr@r?rr rrArBr r rCr4rDrErFs@r&rNrNs -^ I*04:>/3+/'++/&*.&&!&!) 1 1 &  & $ & (}&+33-& (}&#4.&tn&$C=&X&&&P38H-3E3hGX>Y33r(rNc ^\rSrSrSrSrSSS.S\S\\S\S S \\4U4S jjjjr \ S \\S SS\S4U4Sjj5r Sr U=r $)GiveawayCompletediazThis 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 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 )giveaway_messagerSrNrrrSr\rrc>[TU]US9 XlX lX0lURUR4UlUR 5 gr)rr rrSr\r"r#)r$rrSr\rr%s r&r GiveawayCompleted.__init__0sO J/!-4I"5E     & &  r(r)r*rr+c>URU5nUcgSSKJn UR"UR S5U5US'[ TU] XS9$)r-Nr)rr\r0)r1telegram._messagerr4r3r)r6r)r*rr%s r&r4GiveawayCompleted.de_jsonEsRt$ < .#*??488r@rr r rCr4rDrErFs@r&r[r[s,NI 0404  *.  (}#9-  X& * 38H- 3E 3hGZ>[ 3 3r(r[)r=r?typingrrrrtelegram._chatrtelegram._telegramobjectrtelegram._userr telegram._utils.argumentparsingr telegram._utils.datetimer r telegram._utils.typesr telegramrrrrHrNr[rJr(r&rjsb&N;;3>Q*%k3~k3\ n w3nw3t;3;3r(