i>dZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZmZdd lmZmZdd lmZerdd lmZGdde ZGdde ZGddeZGddeZGddeZ Gdde Z!Gdde Z"Gdde Z#Gdde Z$dS) zDThis module contains the classes that represent Telegram ChatBoosts.N)Sequence) TYPE_CHECKINGFinal) constants)Chat)TelegramObject)User)enum)de_json_optionalde_list_optionalparse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)JSONDict)Botc@eZdZdZdZdddededzddffdZxZS) ChatBoostAddeda This object represents a service message about a user boosting a chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`boost_count` are equal. .. versionadded:: 21.0 Args: boost_count (:obj:`int`): Number of boosts added by the user. Attributes: boost_count (:obj:`int`): Number of boosts added by the user. ) boost_countN api_kwargsrrreturnct|||_|jf|_|dSNr)super__init__r _id_attrs_freeze)selfrr __class__s S/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_chatboost.pyrzChatBoostAdded.__init__:sF J/// +*, ) __name__ __module__ __qualname____doc__ __slots__intrr __classcell__rs@r rr&s}"!I '+    tO            r!rceZdZUdZdZejjZee e d< ejj Z ee e d< ejj Z ee e d< ddde d e dzffd Zedd e d d ddffd ZxZS)ChatBoostSourcea| Base class for Telegram ChatBoostSource objects. It can be one of: * :class:`telegram.ChatBoostSourcePremium` * :class:`telegram.ChatBoostSourceGiftCode` * :class:`telegram.ChatBoostSourceGiveaway` Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`source` is equal. .. versionadded:: 20.8 Args: source (:obj:`str`): The source of the chat boost. Can be one of: :attr:`~telegram.ChatBoostSource.PREMIUM`, :attr:`~telegram.ChatBoostSource.GIFT_CODE`, or :attr:`~telegram.ChatBoostSource.GIVEAWAY`. Attributes: source (:obj:`str`): The source of the chat boost. Can be one of: :attr:`~telegram.ChatBoostSource.PREMIUM`, :attr:`~telegram.ChatBoostSource.GIFT_CODE`, or :attr:`~telegram.ChatBoostSource.GIVEAWAY`. )sourcePREMIUM GIFT_CODEGIVEAWAYNrr,rct|tjtj|||_|jf|_|dSr) rrr get_memberrChatBoostSourcesr,rr)rr,rrs r rzChatBoostSource.__init__hsT J/// ?9+EvvVV + r!databot Bot | Nonerc||}|jt|jt|jt i}|turG|d|vr0|| d ||Sd|vr,t|dt||d<t ||S),See :meth:`telegram.TelegramObject.de_json`.r,r3r4user) _parse_datar-ChatBoostSourcePremiumr.ChatBoostSourceGiftCoder/ChatBoostSourceGiveawayr+getpopde_jsonr r r)clsr3r4_class_mappingrs r r@zChatBoostSource.de_jsonqst$$ K/ M2 L1<  / ! !dhhx&8&8N&J&J!$((8"4"45==4S=QQ Q T>>+DHHV,<,%6@IuSz@@@@$5>HeCj>>>?EIs8d?3383,3BS33333[33333r!r+c<eZdZdZdZdddededzffdZxZS)r;a The boost was obtained by subscribing to Telegram Premium or by gifting a Telegram Premium subscription to another user. .. versionadded:: 20.8 Args: user (:class:`telegram.User`): User that boosted the chat. Attributes: source (:obj:`str`): The source of the chat boost. Always :attr:`~telegram.ChatBoostSource.PREMIUM`. user (:class:`telegram.User`): User that boosted the chat. r9Nrr9rct|j||5||_ddddS#1swxYwYdSN)r,r)rrr- _unfrozenr9rr9rrs r rzChatBoostSourcePremium.__init__s  DDD ^^   # #"DI # # # # # # # # # # # # # # # # # #AAA r"r#r$r%r&r rrr(r)s@r r;r;sm  IDH###T#(T/##########r!r;c<eZdZdZdZdddededzffdZxZS)r<a) The boost was obtained by the creation of Telegram Premium gift codes to boost a chat. Each such code boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription. .. versionadded:: 20.8 Args: user (:class:`telegram.User`): User for which the gift code was created. Attributes: source (:obj:`str`): The source of the chat boost. Always :attr:`~telegram.ChatBoostSource.GIFT_CODE`. user (:class:`telegram.User`): User for which the gift code was created. rHNrr9rct|j||5||_ddddS#1swxYwYdSrJ)rrr.rKr9rLs r rz ChatBoostSourceGiftCode.__init__s :FFF ^^   # #"DI # # # # # # # # # # # # # # # # # #rMrNr)s@r r<r<sm IDH###T#(T/##########r!r<c beZdZdZdZ d dddededzdedzdedzd edzf fd Z xZ S) r=a  The boost was obtained by the creation of a Telegram Premium giveaway or a Telegram Star. This boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription for Telegram Premium giveaways and :attr:`prize_star_count` / 500 times for one year for Telegram Star giveaways. .. versionadded:: 20.8 Args: giveaway_message_id (:obj:`int`): Identifier of a message in the chat with the giveaway; the message could have been deleted already. May be 0 if the message isn't sent yet. user (:class:`telegram.User`, optional): User that won the prize in the giveaway if any; for Telegram Premium giveaways only. 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 is_unclaimed (:obj:`bool`, optional): :obj:`True`, if the giveaway was completed, but there was no user to win the prize. Attributes: source (:obj:`str`): Source of the boost. Always :attr:`~telegram.ChatBoostSource.GIVEAWAY`. giveaway_message_id (:obj:`int`): Identifier of a message in the chat with the giveaway; the message could have been deleted already. May be 0 if the message isn't sent yet. user (:class:`telegram.User`): Optional. User that won the prize in the giveaway if any. 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 is_unclaimed (:obj:`bool`): Optional. :obj:`True`, if the giveaway was completed, but there was no user to win the prize. )giveaway_message_id is_unclaimedprize_star_countr9NrrRr9rSrTrct|j||5||_||_||_||_ddddS#1swxYwYdSrJ)rrr/rKrRr9rTrS)rrRr9rSrTrrs r rz ChatBoostSourceGiveaway.__init__s  *EEE ^^   : :,?D $%)DI0@D !-9D   : : : : : : : : : : : : : : : : : :sA((A,/A,)NNN) r"r#r$r%r&r'r boolrrr(r)s@r r=r=s  DTI !$('+ :'+::: :Tk:Tk : * :tO::::::::::r!r=c eZdZdZdZdddedejdejded e dzf fd Z e dd e d d ddffd Z xZ S) ChatBoosta This object contains information about a chat boost. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`boost_id`, :attr:`add_date`, :attr:`expiration_date`, and :attr:`source` are equal. .. versionadded:: 20.8 Args: boost_id (:obj:`str`): Unique identifier of the boost. add_date (:obj:`datetime.datetime`): Point in time when the chat was boosted. expiration_date (:obj:`datetime.datetime`): Point in time when the boost will automatically expire, unless the booster's Telegram Premium subscription is prolonged. source (:class:`telegram.ChatBoostSource`): Source of the added boost. Attributes: boost_id (:obj:`str`): Unique identifier of the boost. add_date (:obj:`datetime.datetime`): Point in time when the chat was boosted. |datetime_localization| expiration_date (:obj:`datetime.datetime`): Point in time when the boost will automatically expire, unless the booster's Telegram Premium subscription is prolonged. |datetime_localization| source (:class:`telegram.ChatBoostSource`): Source of the added boost. )add_dateboost_idexpiration_dater,NrrZrYr[r,rct|||_||_||_||_|j|j|j|jf|_|dSr)rrrZrYr[r,rr)rrZrYr[r,rrs r rzChatBoost.__init__ sg J///% &. -<'- -8LdkZ r!r3r4r5rc||}t|dt||d<t |}t |d||d<t |d||d<t ||S)r7r,rYtzinfor[r8)r:r r>r+rrrr@rAr3r4 loc_tzinfors r r@zChatBoost.de_json st$$)$((8*<**>zRRRZ"0:K1L1LU_"`"`"` wwDc222r!rC)r"r#r$r%r&rDdtmdatetimer+rrrFr@r(r)s@r rXrXs6FI'+,   tO& 3 38 3, 3+ 3 3 3 3 3[ 3 3 3 3 3r!rXcjeZdZdZdZdddedededzffdZe dd ed d d dffd Z xZ S)ChatBoostUpdateda;This object represents a boost added to a chat or changed. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`chat`, and :attr:`boost` are equal. .. versionadded:: 20.8 Args: chat (:class:`telegram.Chat`): Chat which was boosted. boost (:class:`telegram.ChatBoost`): Information about the chat boost. Attributes: chat (:class:`telegram.Chat`): Chat which was boosted. boost (:class:`telegram.ChatBoost`): Information about the chat boost. )boostchatNrrgrfrct|||_||_|jj|jf|_|dSr)rrrgrfidrr)rrgrfrrs r rzChatBoostUpdated.__init__@sQ J/// % ), 3 r!r3r4r5rc$||}t|dt||d<t|dt||d<t ||S)r7rgrfr8)r:r r>rrXrr@rAr3r4rs r r@zChatBoostUpdated.de_jsonOsrt$$'(8(8$DDV ('):):IsKKW wwDc222r!rC) r"r#r$r%r&rrXrrrFr@r(r)s@r rere-s "I'+      tO      3383,3BT33333[33333r!rec |eZdZdZdZdddededejde d e dzf fd Z e dd e d d ddffd Z xZS)ChatBoostRemoveda This object represents a boost removed from a chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`chat`, :attr:`boost_id`, :attr:`remove_date`, and :attr:`source` are equal. Args: chat (:class:`telegram.Chat`): Chat which was boosted. boost_id (:obj:`str`): Unique identifier of the boost. remove_date (:obj:`datetime.datetime`): Point in time when the boost was removed. source (:class:`telegram.ChatBoostSource`): Source of the removed boost. Attributes: chat (:class:`telegram.Chat`): Chat which was boosted. boost_id (:obj:`str`): Unique identifier of the boost. remove_date (:obj:`datetime.datetime`): Point in time when the boost was removed. |datetime_localization| source (:class:`telegram.ChatBoostSource`): Source of the removed boost. )rZrg remove_dater,NrrgrZrnr,rct|||_||_||_||_|j|j|j|jf|_|dSr)rrrgrZrnr,rr)rrgrZrnr,rrs r rzChatBoostRemoved.__init__rsg J/// % )4'- )T]D4DdkR r!r3r4r5rc||}t|dt||d<t|dt||d<t |}t |d||d<t||S)r7rgr,rnr^r8) r:r r>rr+rrrr@r`s r r@zChatBoostRemoved.de_jsonst$$'(8(8$DDV )$((8*<*I'+\   tO& 3 38 3, 3BT 3 3 3 3 3[ 3 3 3 3 3r!rmcreZdZdZdZdddeededzffdZe d ded d d dffd Z xZ S)UserChatBoostsaThis object represents a list of boosts added to a chat by a user. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`boosts` are equal. .. versionadded:: 20.8 Args: boosts (Sequence[:class:`telegram.ChatBoost`]): List of boosts added to the chat by the user. Attributes: boosts (tuple[:class:`telegram.ChatBoost`]): List of boosts added to the chat by the user. )boostsNrrsrct|t||_|jf|_|dSr)rrr rsrr)rrsrrs r rzUserChatBoosts.__init__sK J///-?-G-G + r!r3r4r5rc||}t|dt||d<t ||S)r7rsr8)r:r r>rXrr@rks r r@zUserChatBoosts.de_jsonsQt$$)$((8*<*rs&KJ$$$$$$''''''''333333 bbbbbbbbbbQQQQQQQQ******^B;3;3;3;3;3n;3;3;3|#####_###2#####o###44:4:4:4:4:o4:4:4:n;3;3;3;3;3;3;3;3|*3*3*3*3*3~*3*3*3Z5353535353~535353p&3&3&3&3&3^&3&3&3&3&3r!