o Zzj>@s8dZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZmZdd lmZmZdd lmZerRdd lmZGddde ZGddde ZGdddeZGdddeZGdddeZ Gddde Z!Gddde Z"Gddde Z#Gddde 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)Botcs<eZdZdZdZdddededBddffdd ZZS) 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_kwargsrrreturncs*tj|d||_|jf|_|dSNr)super__init__r _id_attrs_freeze)selfrr __class__N/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_chatboost.pyr:s  zChatBoostAdded.__init__) __name__ __module__ __qualname____doc__ __slots__intrr __classcell__rrrrr&srcseZdZUdZdZejjZee e d< ejj Z ee e d< ejj Z ee e d< ddde d e dBffd d Zedd e d dddffdd ZZS)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(rcs6tj|dttj|||_|jf|_|dSr) rrr get_memberrChatBoostSourcesr(rr)rr(rrrrrhs  zChatBoostSource.__init__databot Bot | Nonercs|||}|jt|jt|jti}|tur'|d|vr'|| dj ||dSd|vr6t |dt ||d<t j ||dS),See :meth:`telegram.TelegramObject.de_json`.r(r.r/user) _parse_datar)ChatBoostSourcePremiumr*ChatBoostSourceGiftCoder+ChatBoostSourceGiveawayr'getpopde_jsonr rr)clsr.r/_class_mappingrrrr:qs zChatBoostSource.de_jsonN)r r!r"r#r$rr-r)rstr__annotations__r*r+rr classmethodr:r&rrrrr'Gs   &r'c8eZdZdZdZdddededBffddZZS) r5a 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. r3Nrr3rcFtj|j|d| ||_WddS1swYdSN)r(r)rrr) _unfrozenr3rr3rrrrr "zChatBoostSourcePremium.__init__ r r!r"r#r$rrrr&rrrrr5s(r5crA) r6a) 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. rBNrr3rcrCrD)rrr*rEr3rFrrrrrGz ChatBoostSourceGiftCode.__init__rHrrrrr6s(r6c sXeZdZdZdZ   d dddededBdedBdedBd edBf fd d Z Z S) r7a  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_countr3NrrIr3rJrKrcsXtj|j|d|||_||_||_||_WddS1s%wYdSrD)rrr+rErIr3rKrJ)rrIr3rJrKrrrrrs "z ChatBoostSourceGiveaway.__init__)NNN) r r!r"r#r$r%rboolrrr&rrrrr7s&"r7c sheZdZdZdZdddedejdejded e dBf fd d Z e dd e d dddffdd Z Z 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(NrrOrNrPr(rcHtj|d||_||_||_||_|j|j|j|jf|_|dSr)rrrOrNrPr(rr)rrOrNrPr(rrrrr   zChatBoost.__init__r.r/r0rcsd||}t|dt||d<t|}t|d|d|d<t|d|d|d<tj||dS)r1r(rNtzinforPr2)r4r r8r'r rrr:r;r.r/ loc_tzinforrrr: s zChatBoost.de_jsonr=)r r!r"r#r$r>dtmdatetimer'rrr@r:r&rrrrrMs" &rMcs\eZdZdZdZdddedededBffdd Ze dd ed d d dffdd Z Z 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. )boostchatNrr[rZrcs6tj|d||_||_|jj|jf|_|dSr)rrr[rZidrr)rr[rZrrrrr@s  zChatBoostUpdated.__init__r.r/r0rcsF||}t|dt||d<t|dt||d<tj||dS)r1r[rZr2)r4r r8rrMrr:r;r.r/rrrr:Os zChatBoostUpdated.de_jsonr=) r r!r"r#r$rrMrrr@r:r&rrrrrY-s&rYc sfeZdZdZdZdddededejde d e dBf fd d Z e dd e d dddffdd Z ZS)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. )rOr[ remove_dater(Nrr[rOr_r(rcrQr)rrr[rOr_r(rr)rr[rOr_r(rrrrrrrRzChatBoostRemoved.__init__r.r/r0rcsd||}t|dt||d<t|dt||d<t|}t|d|d|d<tj||dS)r1r[r(r_rSr2) r4r r8rr'r rrr:rUrrrr:s zChatBoostRemoved.de_jsonr=)r r!r"r#r$rr>rWrXr'rrr@r:r&rrrrr^Zs" &r^cs\eZdZdZdZdddeededBffddZe dd ed d d dffd d Z Z 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. )boostsNrrarcs.tj|dt||_|jf|_|dSr)rrr rarr)rrarrrrrs   zUserChatBoosts.__init__r.r/r0rcs0||}t|dt||d<tj||dS)r1rar2)r4r r8rMrr:r]rrrr:s zUserChatBoosts.de_jsonr=) r r!r"r#r$rrMrrr@r:r&rrrrr`s &r`)%r#rXrWcollections.abcrtypingrrtelegramrtelegram._chatrtelegram._telegramobjectrtelegram._userrtelegram._utilsr telegram._utils.argumentparsingr r r telegram._utils.datetimer rtelegram._utils.typesrrrr'r5r6r7rMrYr^r`rrrrs.        !>7>-8