՟f?rdZddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZmZdd lmZerdd l mZGd deZGddeZGddeZGddeZGddeZ GddeZ!GddeZ"GddeZ#GddeZ$y) zDThis module contains the classes that represent Telegram ChatBoosts.)datetime) TYPE_CHECKINGDictFinalOptionalSequenceTupleType) constants)Chat)TelegramObject)User)enum)parse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)JSONDict)Botc@eZdZdZdZdddedeeddffdZxZ S) 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_kwargsrrreturncxt||||_|jf|_|j yNr)super__init__r _id_attrs_freeze)selfrr __class__s N/var/www/cvtools/html/venv/lib/python3.12/site-packages/telegram/_chatboost.pyrzChatBoostAdded.__init__9s6 J/ +**, ) __name__ __module__ __qualname____doc__ __slots__intrrr __classcell__r"s@r#rr%s?"!I *.  X&    r$rc 0eZdZUdZdZej jZee e d< ej jZ ee e d< ej jZ ee e d< ddde d e effd Ze dd e ed e d de dffd 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 |||_|j f|_|jyr) rrr get_memberr ChatBoostSourcesr/rr )r!r/rr"s r#rzChatBoostSource.__init__gsE J/ ??9+E+EvvV ++ r$databotrrc|j|}|sy|jt|jt|j t i}|tur8|jd|vr%||jdj||Sd|vr(tj|jd||d<t|)||S),See :meth:`telegram.TelegramObject.de_json`.Nr/r6r7user) _parse_datar0ChatBoostSourcePremiumr1ChatBoostSourceGiftCoder2ChatBoostSourceGiveawayr.getpopde_jsonrr)clsr6r7_class_mappingr"s r#rBzChatBoostSource.de_jsonps t$ KK/ MM2 LL1<  / !dhhx&8N&J!$((8"45==4S=Q Q T><<(8#>DLwDc22r$N)r%r&r'r(r)r r5r0rstr__annotations__r1r2rrr classmethodrBr+r,s@r#r.r.Fs.I#44<%66@@IuSz@@$55>>HeCj>?HLs8H3E>B3H%3,4UO3 # $33r$r.c<eZdZdZdZdddedeeffdZxZ S)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. r;Nrr;rct||j||j5||_dddy#1swYyxYwN)r/r)rrr0 _unfrozenr;r!r;rr"s r#rzChatBoostSourcePremium.__init__s?  D ^^  #"DI # # # >A r%r&r'r(r)rrrrr+r,s@r#r=r=s/ IGK#T#(82D##r$r=c<eZdZdZdZdddedeeffdZxZ S)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. rJNrr;rct||j||j5||_dddy#1swYyxYwrL)rrr1rMr;rNs r#rz ChatBoostSourceGiftCode.__init__s? :F ^^  #"DI # # #rOrPr,s@r#r>r>s/ IGK#T#(82D##r$r>c beZdZdZdZ d dddedeedeedeed ee f 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_countr;NrrTr;rUrVrct||j||j5||_||_||_||_dddy#1swYyxYwrL)rrr2rMrTr;rVrU)r!rTr;rUrVrr"s r#rz ChatBoostSourceGiveaway.__init__sY  *E ^^  =,?D $(,DI3CD !0B3H%3,4UO3 + 33r$rZc xeZdZdZdZdddededeeffdZ e dd eed ed d edffd 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|_|j yr)rrrgrfidrr )r!rgrfrr"s r#rzChatBoostUpdated.__init__IsD J/ % )),, 3 r$r6r7rrc|j|}|sytj|jd||d<tj|jd||d<t | ||S)r9Nrgrfr:)r<r rBr@rZrrCr6r7r"s r#rBzChatBoostUpdated.de_jsonXsh t$||DHHV$4c:V !))$((7*;SAW wDc22r$rE) r%r&r'r(r)r rZrrrrHrBr+r,s@r#rere6sx "I*.    X& >B 3H% 3,4UO 3 $ % 3 3r$rec eZdZdZdZdddedededed e e f fd Z e dd e e d e d de dffd 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. )r\rg remove_dater/Nrrgr\rnr/rct||||_||_||_||_|j|j|j|j f|_|jyr)rrrgr\rnr/rr )r!rgr\rnr/rr"s r#rzChatBoostRemoved.__init__s] J/ % %0'- ))T]]D4D4DdkkR r$r6r7rrc*|j|}|sytj|jd||d<tj|jd||d<t |}t |d||d<t| ||S)r9Nrgr/rnr`r:)r<r rBr@r.rrrrbs r#rBzChatBoostRemoved.de_jsons t$||DHHV$4c:V (00(1CSIX1#6 ,T--@T]wDc22r$rE)r%r&r'r(r)r rFrr.rrrrHrBr+r,s@r#rmrmhs*>I*.   X&&>B3H%3,4UO3 $ %33r$rmc zeZdZdZdZdddeedeeffdZ e d deed ed d edffd 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|_|j yr)rrrrsrr )r!rsrr"s r#rzUserChatBoosts.__init__s7 J/-?-G ++ r$r6r7rrc|j|}|sytj|jd||d<t|||S)r9Nrsr:)r<rZde_listr@rrBrks r#rBzUserChatBoosts.de_jsonsK t$"**488H+=sCXwDc22r$rE) r%r&r'r(r)rrZrrrrHrBr+r,s@r#rrrrss I *. # X& >B 3H% 3,4UO 3 " # 3 3r$rrN)%r(rtypingrrrrrr r telegramr telegram._chatr telegram._telegramobjectr telegram._userrtelegram._utilsrtelegram._utils.argumentparsingrtelegram._utils.datetimerrtelegram._utils.typesrrrr.r=r>r?rZrermrrr$r#rs&KNNN3 >Q*^B@3n@3F#_#2#o#44=o4=n@3@3F/3~/3d:3~:3z+3^+3r$