՟fBi,dZddlZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZdd lmZmZdd lmZdd lmZmZddl m!Z!m"Z"erddl m#Z#GddeZ$GddeZ%GddeZ&GddeZ'y)z?This module contains an object that represents a Telegram Poll.N) TYPE_CHECKINGDictFinalListOptionalSequenceTuple) constants)Chat) MessageEntity)TelegramObject)User)enum)parse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp) DEFAULT_NONE)parse_message_entitiesparse_message_entity)JSONDictODVInput)Botc eZdZdZdZedfdddedeedee e dee ffd Z e dd ee d ed d edffd ZxZS)InputPollOptiona This object contains information about one answer option in a poll to be sent. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`text` is equal. .. versionadded:: 21.2 Args: text (:obj:`str`): Option text, :tg-const:`telegram.PollOption.MIN_LENGTH`-:tg-const:`telegram.PollOption.MAX_LENGTH` characters. text_parse_mode (:obj:`str`, optional): |parse_mode| Currently, only custom emoji entities are allowed. text_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities that appear in the option :paramref:`text`. It can be specified instead of :paramref:`text_parse_mode`. Currently, only custom emoji entities are allowed. This list is empty if the text does not contain entities. Attributes: text (:obj:`str`): Option text, :tg-const:`telegram.PollOption.MIN_LENGTH`-:tg-const:`telegram.PollOption.MAX_LENGTH` characters. text_parse_mode (:obj:`str`): Optional. |parse_mode| Currently, only custom emoji entities are allowed. text_entities (Sequence[:class:`telegram.MessageEntity`]): Special entities that appear in the option :paramref:`text`. It can be specified instead of :paramref:`text_parse_mode`. Currently, only custom emoji entities are allowed. This list is empty if the text does not contain entities. )text text_entitiestext_parse_modeN api_kwargsrrrrct||||_||_t ||_|jf|_|jyNr)super__init__rrrr _id_attrs_freeze)selfrrrr __class__s I/var/www/cvtools/html/venv/lib/python3.12/site-packages/telegram/_poll.pyr#zInputPollOption.__init__KsG J/ .=8J=8Y)) databotrreturnc|j|}|sytj|jd||d<t|||S,See :meth:`telegram.TelegramObject.de_json`.Nrr*r+ _parse_datar de_listgetr"de_jsonclsr*r+r's r(r5zInputPollOption.de_json\M t$ - 5 5dhh6OQT U_wDc22r)N)__name__ __module__ __qualname____doc__ __slots__rstrrrrr rr# classmethodr5 __classcell__r's@r(rr'sB=I *6;?  *. "#  78  X& ">B 3H% 3,4UO 3 # $ 3 3r)rc @eZdZUdZdZ ddddededeee dee ffd Z e dd ee d ed d edffd Z de d efdZddeeed ee effdZej&j(Zeeed< ej&j0Zeeed<xZS) PollOptiona8 This object contains information about one answer option in a poll. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`text` and :attr:`voter_count` are equal. Args: text (:obj:`str`): Option text, :tg-const:`telegram.PollOption.MIN_LENGTH`-:tg-const:`telegram.PollOption.MAX_LENGTH` characters. voter_count (:obj:`int`): Number of users that voted for this option. text_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities that appear in the option text. Currently, only custom emoji entities are allowed in poll option texts. .. versionadded:: 21.2 Attributes: text (:obj:`str`): Option text, :tg-const:`telegram.PollOption.MIN_LENGTH`-:tg-const:`telegram.PollOption.MAX_LENGTH` characters. voter_count (:obj:`int`): Number of users that voted for this option. text_entities (Tuple[:class:`telegram.MessageEntity`]): Special entities that appear in the option text. Currently, only custom emoji entities are allowed in poll option texts. This list is empty if the question does not contain entities. .. versionadded:: 21.2 )rr voter_countNrrrErrct||||_||_t ||_|j|jf|_|jyr!)r"r#rrErrr$r%)r&rrErrr's r(r#zPollOption.__init__sP J/ +8J=8Y))T%5%56 r)r*r+rr,c|j|}|sytj|jd||d<t|||Sr.r1r6s r(r5zPollOption.de_jsonr8r)entityc.t|j|S)aReturns the text in :attr:`text` from a given :class:`telegram.MessageEntity` of :attr:`text_entities`. Note: This method is present because Telegram calculates the offset and length in UTF-16 codepoint pairs, which some versions of Python don't handle automatically. (That is, you can't just slice ``Message.text`` with the offset and length.) .. versionadded:: 21.2 Args: entity (:class:`telegram.MessageEntity`): The entity to extract the text from. It must be an entity that belongs to :attr:`text_entities`. Returns: :obj:`str`: The text of the given entity. )rrr&rHs r( parse_entityzPollOption.parse_entitys$$DIIv66r)typescDt|j|j|S)a( Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this polls question filtered by their ``type`` attribute as the key, and the text that each entity belongs to as the value of the :obj:`dict`. Note: This method should always be used instead of the :attr:`text_entities` attribute, since it calculates the correct substring from the message text based on UTF-16 codepoints. See :attr:`parse_entity` for more info. .. versionadded:: 21.2 Args: types (List[:obj:`str`], optional): List of ``MessageEntity`` types as strings. If the ``type`` attribute of an entity is contained in this list, it will be returned. Defaults to :attr:`telegram.MessageEntity.ALL_TYPES`. Returns: Dict[:class:`telegram.MessageEntity`, :obj:`str`]: A dictionary of entities mapped to the text that belongs to them, calculated based on UTF-16 codepoints. )rrrr&rLs r(parse_entitieszPollOption.parse_entitiess,&dii1C1CUKKr) MIN_LENGTH MAX_LENGTHr9)r:r;r<r=r>r?intrrr rr#r@r5rKrrrOr PollLimitMIN_OPTION_LENGTHrPr__annotations__MAX_OPTION_LENGTHrQrArBs@r(rDrDks>9I <@  *.   78  X& ">B 3H% 3,4UO 3 ,  3 37=7S7(LHT#Y$7L4 WZHZC[L0'00BBJc B'00BBJc Br)rDc eZdZdZdZ ddddedeedee dee d ee f fd Z e dd ee d ed dedffd ZxZS) PollAnswera This object represents an answer of a user in a non-anonymous poll. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`poll_id`, :attr:`user` and :attr:`option_ids` are equal. .. versionchanged:: 20.5 The order of :paramref:`option_ids` and :paramref:`user` is changed in 20.5 as the latter one became optional. .. versionchanged:: 20.6 Backward compatiblity for changed order of :paramref:`option_ids` and :paramref:`user` was removed. Args: poll_id (:obj:`str`): Unique poll identifier. option_ids (Sequence[:obj:`int`]): Identifiers of answer options, chosen by the user. May be empty if the user retracted their vote. .. versionchanged:: 20.0 |sequenceclassargs| user (:class:`telegram.User`, optional): The user that changed the answer to the poll, if the voter isn't anonymous. If the voter is anonymous, this field will contain the user :tg-const:`telegram.constants.ChatID.FAKE_CHANNEL` for backwards compatibility. .. versionchanged:: 20.5 :paramref:`user` became optional. voter_chat (:class:`telegram.Chat`, optional): The chat that changed the answer to the poll, if the voter is anonymous. .. versionadded:: 20.5 Attributes: poll_id (:obj:`str`): Unique poll identifier. option_ids (Tuple[:obj:`int`]): Identifiers of answer options, chosen by the user. May be empty if the user retracted their vote. .. versionchanged:: 20.0 |tupleclassattrs| user (:class:`telegram.User`): Optional. The user, who changed the answer to the poll, if the voter isn't anonymous. If the voter is anonymous, this field will contain the user :tg-const:`telegram.constants.ChatID.FAKE_CHANNEL` for backwards compatibility .. versionchanged:: 20.5 :paramref:`user` became optional. voter_chat (:class:`telegram.Chat`): Optional. The chat that changed the answer to the poll, if the voter is anonymous. .. versionadded:: 20.5 ) option_idspoll_iduser voter_chatNrrZrYr[r\rct||||_||_t ||_||_|j|j |j |jf|_|jyr!) r"r#rZr\rrYr[r$r%)r&rZrYr[r\rr's r(r#zPollAnswer.__init__sh J/# *4+=j+I$(  LL OO II OO   r)r*r+rr,c|j|}|sytj|jd||d<t j|jd||d<t | ||S)r/Nr[r\r0)r2rr5r4r r"r6s r(r5zPollAnswer.de_json3sg t$||DHHV$4c:V !\\$((<*@#F\wDc22r))NNr9)r:r;r<r=r>r?rrRrrr rr#r@r5rArBs@r(rXrXs2h@I $%) *.SMtn  TN X&0>B 3H% 3,4UO 3 ,  3 3r)rXc!ZeZdZUdZdZ d,dddededeeded e d e d ed e d e ede ede ee de ede e jde ee de e ffdZed-de e de dde dffd Zde defdZ d-de eedee effdZde defdZ d-de eedee effdZej0j2Zeeed < ej0j8Zeeed!< ej:j<Zeeed"< ej:j>Zeeed#< ej:j@Z eeed$< ej:jBZ!eeed%< ej:jDZ"eeed&< ej:jFZ#eeed'< ej:jHZ$eeed(< ej:jJZ%eeed)< ej:jLZ&eeed*< ej:jNZ'eeed+<xZ(S).Pollap This object contains information about a poll. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`id` is equal. Examples: :any:`Poll Bot ` Args: id (:obj:`str`): Unique poll identifier. question (:obj:`str`): Poll question, :tg-const:`telegram.Poll.MIN_QUESTION_LENGTH`- :tg-const:`telegram.Poll.MAX_QUESTION_LENGTH` characters. options (Sequence[:class:`~telegram.PollOption`]): List of poll options. .. versionchanged:: 20.0 |sequenceclassargs| is_closed (:obj:`bool`): :obj:`True`, if the poll is closed. is_anonymous (:obj:`bool`): :obj:`True`, if the poll is anonymous. type (:obj:`str`): Poll type, currently can be :attr:`REGULAR` or :attr:`QUIZ`. allows_multiple_answers (:obj:`bool`): :obj:`True`, if the poll allows multiple answers. correct_option_id (:obj:`int`, optional): A zero based identifier of the correct answer option. Available only for closed polls in the quiz mode, which were sent (not forwarded), by the bot or to a private chat with the bot. explanation (:obj:`str`, optional): Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-:tg-const:`telegram.Poll.MAX_EXPLANATION_LENGTH` characters. explanation_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities like usernames, URLs, bot commands, etc. that appear in the :attr:`explanation`. This list is empty if the message does not contain explanation entities. .. versionchanged:: 20.0 * This attribute is now always a (possibly empty) list and never :obj:`None`. * |sequenceclassargs| open_period (:obj:`int`, optional): Amount of time in seconds the poll will be active after creation. close_date (:obj:`datetime.datetime`, optional): Point in time (Unix timestamp) when the poll will be automatically closed. Converted to :obj:`datetime.datetime`. .. versionchanged:: 20.3 |datetime_localization| question_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities that appear in the :attr:`question`. Currently, only custom emoji entities are allowed in poll questions. .. versionadded:: 21.2 Attributes: id (:obj:`str`): Unique poll identifier. question (:obj:`str`): Poll question, :tg-const:`telegram.Poll.MIN_QUESTION_LENGTH`- :tg-const:`telegram.Poll.MAX_QUESTION_LENGTH` characters. options (Tuple[:class:`~telegram.PollOption`]): List of poll options. .. versionchanged:: 20.0 |tupleclassattrs| total_voter_count (:obj:`int`): Total number of users that voted in the poll. is_closed (:obj:`bool`): :obj:`True`, if the poll is closed. is_anonymous (:obj:`bool`): :obj:`True`, if the poll is anonymous. type (:obj:`str`): Poll type, currently can be :attr:`REGULAR` or :attr:`QUIZ`. allows_multiple_answers (:obj:`bool`): :obj:`True`, if the poll allows multiple answers. correct_option_id (:obj:`int`): Optional. A zero based identifier of the correct answer option. Available only for closed polls in the quiz mode, which were sent (not forwarded), by the bot or to a private chat with the bot. explanation (:obj:`str`): Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-:tg-const:`telegram.Poll.MAX_EXPLANATION_LENGTH` characters. explanation_entities (Tuple[:class:`telegram.MessageEntity`]): Special entities like usernames, URLs, bot commands, etc. that appear in the :attr:`explanation`. This list is empty if the message does not contain explanation entities. .. versionchanged:: 20.0 |tupleclassattrs| .. versionchanged:: 20.0 This attribute is now always a (possibly empty) list and never :obj:`None`. open_period (:obj:`int`): Optional. Amount of time in seconds the poll will be active after creation. close_date (:obj:`datetime.datetime`): Optional. Point in time when the poll will be automatically closed. .. versionchanged:: 20.3 |datetime_localization| question_entities (Tuple[:class:`telegram.MessageEntity`]): Special entities that appear in the :attr:`question`. Currently, only custom emoji entities are allowed in poll questions. This list is empty if the question does not contain entities. .. versionadded:: 21.2 )allows_multiple_answers close_datecorrect_option_id explanationexplanation_entitiesid is_anonymous is_closed open_periodoptionsquestionquestion_entitiestotal_voter_counttypeNrrfrkrjrmrhrgrnrarcrdrerirbrlrct||||_||_t ||_||_||_||_tjtj|||_ ||_| |_| |_t | |_| |_| |_t ||_|jf|_|j-yr!)r"r#rfrkrrjrmrhrgr get_memberr PollTypernrarcrdrerirbrlr$r%)r&rfrkrjrmrhrgrnrarcrdrerirbrlrr's r(r#z Poll.__init__s& J/% /A'/J &7(".););T4H -D$0A*5?Q @ !+67Ar?rrDrRboolrr datetimerr#r@r5ryrrr{r}rr rqrrrUrrSrrrrrrrTrVrrrArBs@r(r`r`CsH[zI6,0%)BF%)26?C'"*.#' ''*% '  '  '''"&'$C='c]''x '>?'c]'X../'$H]$;<'"X&#'R38H-3HUO3xX^O_33">}>>4,0Zd3i(Z mS !Z>;M;c;*,0Td3i(T mS !T6$,,44GU3Z46 ))..D%*.3)2)<)<)S)SE#JS.7-@-@-[-[c [#,"5"5"E"EOU3ZE#,"5"5"E"EOU3ZE'0&9&9&M&MsM'0&9&9&M&MsM%.$7$7$I$IuSzI%.$7$7$I$IuSzI%.$7$7$I$IuSzI%.$7$7$I$IuSzIr)r`)(r=rtypingrrrrrrr telegramr telegram._chatr telegram._messageentityr telegram._telegramobjectr telegram._userrtelegram._utilsrtelegram._utils.argumentparsingrtelegram._utils.datetimerrtelegram._utils.defaultvaluertelegram._utils.entitiesrrtelegram._utils.typesrrrrrDrXr`r)r(rsy&FNNN13 >Q5Q4A3nA3Hvvr\3\3~F>Fr)