/jdZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddl m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,m-Z-m.Z.ddl/m0Z0ddl1m2Z2m3Z3ddl4m5Z5m6Z6m7Z7ddl8m9Z9ddl:m;Z;er ddlmZ>Gdde!Z?Gdde!Z@Gd d!e!ZAGd"d#e!ZBGd$d%e!ZCGd&d'e!ZDGd(d)e!ZEy)*z?This module contains an object that represents a Telegram Poll.N)Sequence) TYPE_CHECKINGFinal) constants)Chat) Animation)Audio)Document) LivePhoto)Location) PhotoSize)Sticker)Venue)Video) MessageEntity)TelegramObject)User)enum)de_json_optionalde_list_optionalparse_sequence_arg to_timedelta)extract_tzinfo_from_defaultsfrom_timestampget_timedelta_value) DEFAULT_NONE)parse_message_entitiesparse_message_entity)JSONDictODVInput TimePeriod)warn)PTBDeprecationWarning)BotInputPollOptionMediaMaybeInaccessibleMessageceZdZdZdZ ddddedzdedzdedzdedzd e dzd e e dzd e dzd e dzd edzdedzffdZeddeddddffd ZxZS) PollMediaaW At most one of the optional fields can be present in any given object. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if all of their attributes are equal. .. versionadded:: 22.8 Args: animation (:class:`telegram.Animation`, optional): Media is an animation, information about the animation audio (:class:`telegram.Audio`, optional): Media is an audio file, information about the file; currently, can't be received in a poll option document (:class:`telegram.Document`, optional): Media is a general file, information about the file; currently, can't be received in a poll option live_photo (:class:`telegram.LivePhoto`, optional): Media is a live photo, information about the live photo location (:class:`telegram.Location`, optional): Media is a shared location, information about the location photo (Sequence[:class:`telegram.PhotoSize`], optional): Media is a photo, available sizes of the photo sticker (:class:`telegram.Sticker`, optional): Media is a sticker, information about the sticker; currently, for poll options only venue (:class:`telegram.Venue`, optional): Media is a venue, information about the venue video (:class:`telegram.Video`, optional): Media is a video, information about the video Attributes: animation (:class:`telegram.Animation`): Optional. Media is an animation, information about the animation audio (:class:`telegram.Audio`): Optional. Media is an audio file, information about the file; currently, can't be received in a poll option document (:class:`telegram.Document`): Optional. Media is a general file, information about the file; currently, can't be received in a poll option live_photo (:class:`telegram.LivePhoto`, optional): Media is a live photo, information about the live photo location (:class:`telegram.Location`): Optional. Media is a shared location, information about the location photo (tuple[:class:`telegram.PhotoSize`]): Optional. Media is a photo, available sizes of the photo sticker (:class:`telegram.Sticker`): Optional. Media is a sticker, information about the sticker; currently, for poll options only venue (:class:`telegram.Venue`): Optional. Media is a venue, information about the venue video (:class:`telegram.Video`): Optional. Media is a video, information about the video ) animationaudiodocument live_photolocationphotostickervenuevideoN api_kwargsr)r*r+r,r-r.r/r0r1r3c  t || ||_||_||_||_||_t||_||_ ||_ | |_ |j|j|j|j |j |j|j|j|jf |_ |jyNr2)super__init__r)r*r+r,r-rr.r/r0r1 _id_attrs_freeze) selfr)r*r+r,r-r.r/r0r1r3 __class__s L/var/www/html/maxservice/venv/lib/python3.12/site-packages/telegram/_poll.pyr7zPollMedia.__init__ws J/+4#( )1 ,6)1 ,>u,E '. #( #(  NN JJ MM OO MM JJ LL JJ JJ   databot Bot | Nonereturnc|j|}t|jdt||d<t|jdt||d<t|jdt ||d<t|jdt ||d<t|jdt||d<t|jdt||d<t|jdt||d<t|jdt||d<t|jd t||d <t|9|| S) ,See :meth:`telegram.TelegramObject.de_json`.r)r*r+r,r-r.r/r0r1r>r?) _parse_datargetrr r r r rr rrrr6de_jsonclsr>r?r;s r<rGzPollMedia.de_jsonst$,TXXk-BIsS[('):E3GW +DHHZ,@(CPZ-dhh|.DiQTU\+DHHZ,@(CPZ('):IsKW *488I+>MY('):E3GW ('):E3GW wDc22r=) NNNNNNNNNN)__name__ __module__ __qualname____doc__ __slots__rr r r r rr rrrrr7 classmethodrG __classcell__r;s@r<r(r(=s+Z I'+"$('+$(,0"&""%'+%t#%t|%T/ % $ % T/ % "T)%4%t|%t|%tO%N383,3+33r=r(c eZdZdZdZeddfdddedeedee dzdd d e dzf fd Z e dd e d dddffd Z xZS)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. media (:class:`telegram.InputPollOptionMedia`, optional): Media added to the poll option. .. versionadded:: 22.8 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. media (:class:`telegram.InputPollOptionMedia`): Optional. Media added to the poll option. .. versionadded:: 22.8 )mediatext text_entitiestext_parse_modeNr2rVrXrWrUzInputPollOptionMedia | Noner3ct||||_||_t ||_||_|jf|_|jyr5) r6r7rVrXrrWrUr8r9)r:rVrXrWrUr3r;s r<r7zInputPollOption.__init__sN J/ .=8J=8Y27 )) r=r>r?r@rActtddd|j|}t|j dt ||d<t |||S)zSee :meth:`telegram.TelegramObject.de_json`. The :paramref:`media` field will not be included for deserialization. .. deprecated:: 22.8 This class is input only and will be removed in the next version. 22.8z`InputPollOption.de_json` is deprecated. This class is input only and will be removed in the next version. The `media` field will not be included for deserialization. stacklevelrWrD)r"r#rErrFrr6rGrHs r<rGzInputPollOption.de_jsonsb !#   t$ 0/1JM[^ __wDc22r=rJ)rKrLrMrNrOrstrr rrrr7rPrGrQrRs@r<rTrTs%NFI *68r?r@rAc|j|}t|}t|jdt||d<t |jdt ||d<t |jdt||d<t|jd||d<t |jdt||d<t|-||S)rCrWrcrbrdtzinforUrD) rErrrFrrrrrr(r6rGrIr>r? loc_tzinfor;s r<rGzPollOption.de_json|st$2#6 0/1JM[^ __ 0/1JDRU V_ 0/1JDRU V_ .txx/HQ[ \_('):IsKW wDc22r=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. )rrVr:rns 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. )rrVrWr:rrs r<parse_entitieszPollOption.parse_entitiess,&dii1C1CUKKr= MIN_LENGTH MAX_LENGTH)NNNNNNrJ)rKrLrMrNrOr_intrrrrdtmdatetimer(rr7rPrGrqlistdictrur PollLimitMIN_OPTION_LENGTHrvr__annotations__MAX_OPTION_LENGTHrwrQrRs@r<raras_GR I9=%)%)-1"&%)'+ .5  d{  d{ ||d*4TztOB 38 3, 3, 3 37=7S7(LDI$4L]TWEW@XL0'00BBJc B'00BBJc Br=raceZdZdZdZ ddddedeededzde dzd eedzd e dzf fd Z e dd e d dddffd Z xZS) PollAnsweraT 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| option_persistent_ids (Sequence[:obj:`str`]): Persistent identifiers of the chosen answer options. May be empty if the vote was retracted. .. versionadded:: 22.8 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| option_persistent_ids (tuple[:obj:`str`]): Persistent identifiers of the chosen answer options. May be empty if the vote was retracted. .. versionadded:: 22.8 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_idsoption_persistent_idspoll_iduser voter_chatNr2rrrrrr3c0| tdt| |||_||_t ||_||_t ||_|j|j |j|jf|_ |jy)Nz@`option_persistent_ids` is a required argument since Bot API 9.6r2) rhr6r7rrrrrrr8r9)r:rrrrrr3r;s r<r7zPollAnswer.__init__s ! (^_ _ J/# '1+=j+I!% 6HI^6_" LL OO II OO   r=r>r?r@rAc|j|}t|jdt||d<t|jdt||d<t |||S)rCrrrD)rErrFrrr6rGrHs r<rGzPollAnswer.de_json!s]t$'(8$DV -dhh|.DdCP\wDc22r=)NNNrJ)rKrLrMrNrOr_rrxrrrr7rPrGrQrRs@r<rrs9vYI !"&7;'+SMTk  4K  (}t3tO>383,3,33r=rc eZdZdZdZ ddddededdd eedzd edzf fd Z e dd ed dddffd Z dedefdZ dde edzdeeeffdZxZS)PollOptionAddeda Describes a service message about an option added to a poll. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`option_persistent_id`, and :attr:`option_text` are equal. .. versionadded:: 22.8 Args: option_persistent_id (:obj:`str`): Unique identifier of the added option. option_text (:obj:`str`): Option text. poll_message (:class:`telegram.MaybeInaccessibleMessage`, optional): Message containing the poll to which the option was added, if known. Note that the Message object in this field will not contain the :attr:`~telegram.Message.reply_to_message` field even if it itself is a reply. option_text_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities that appear in the :paramref:`option_text`. Attributes: option_persistent_id (:obj:`str`): Unique identifier of the added option. option_text (:obj:`str`): Option text. poll_message (:class:`telegram.MaybeInaccessibleMessage`): Optional. Message containing the poll to which the option was added, if known. Note that the Message object in this field will not contain the :attr:`~telegram.Message.reply_to_message` field even if it itself is a reply. option_text_entities (tuple[:class:`telegram.MessageEntity`]): Optional. Special entities that appear in the :paramref:`option_text`. option_persistent_id option_textoption_text_entities poll_messageNr2rrrMaybeInaccessibleMessage | Nonerr3ct||||_||_||_t ||_|j|jf|_|jyr5 r6r7rrrrrr8r9r:rrrrr3r;s r<r7zPollOptionAdded.__init__La J/)=! +=I?Q @ !33T5E5EF r=r>r?r@rAcddlm}|j|}t|j d|||d<t |j dt ||d<t|!||SrCr)r&rrrD telegram._messager&rErrFrrr6rGrIr>r?r&r;s r<rGzPollOptionAdded.de_jsonbp t$/ HH^ $&> ^(8 HH+ ,mS(  #$wDc22r=rnc.t|j|SaReturns the text in :attr:`option_text` from a given :class:`telegram.MessageEntity` of :attr:`option_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.) Args: entity (:class:`telegram.MessageEntity`): The entity to extract the text from. It must be an entity that belongs to :attr:`option_text_entities`. Returns: :obj:`str`: The text of the given entity. rrrps r<parse_option_text_entityz(PollOptionAdded.parse_option_text_entityt $D$4$4f==r=rrcDt|j|j|Sa Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this polls option text 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:`option_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. 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. rrrrts r<parse_option_text_entitiesz*PollOptionAdded.parse_option_text_entities ,&d&6&68Q8QSXYYr=NNrJrKrLrMrNrOr_rrrr7rPrGrr{r|rrQrRs@r<rr,s:`I ;??C '+!8  '}5< tO,383,3BS33">}>>&)-Z#Y%Z mS !Zr=rc eZdZdZdZ ddddededdd eedzd edzf fd Z e dd ed dddffd Z dedefdZ dde edzdeeeffdZxZS)PollOptionDeleteda Describes a service message about an option deleted from a poll. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`option_persistent_id`, :attr:`option_text` are equal. .. versionadded:: 22.8 Args: option_persistent_id (:obj:`str`): Unique identifier of the deleted option. option_text (:obj:`str`): Option text. poll_message (:class:`telegram.MaybeInaccessibleMessage`, optional): Message containing the poll to which the option was deleted, if known. Note that the Message object in this field will not contain the :attr:`~telegram.Message.reply_to_message` field even if it itself is a reply. option_text_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities that appear in the option_text. Attributes: option_persistent_id (:obj:`str`): Unique identifier of the deleted option. option_text (:obj:`str`): Option text. poll_message (:class:`telegram.MaybeInaccessibleMessage`): Optional. Message containing the poll to which the option was deleted, if known. Note that the Message object in this field will not contain the :attr:`~telegram.Message.reply_to_message` field even if it itself is a reply. option_text_entities (tuple[:class:`telegram.MessageEntity`]): Optional. Special entities that appear in the option_text. rNr2rrrrrr3ct||||_||_||_t ||_|j|jf|_|jyr5rrs r<r7zPollOptionDeleted.__init__rr=r>r?r@rAcddlm}|j|}t|j d|||d<t |j dt ||d<t|!||Srrrs r<rGzPollOptionDeleted.de_jsonrr=rnc.t|j|Srrrps r<rz*PollOptionDeleted.parse_option_text_entityrr=rrcDt|j|j|Srrrts r<rz,PollOptionDeleted.parse_option_text_entitiesrr=rrJrrRs@r<rrs:`I ;??C '+!8  '}5< tO,383,3BU33">}>>&)-Z#Y%Z mS !Zr=rc1eZdZUdZdZ d:dddededeeded e d e d ed e d edzdedzdee dzde dzde jdzdee dzde dzde dzdeedzdedzdee dzdeedzdedzdedzdedzf.fdZedee j$zdzfdZed;ded d!ddffd" Zd#e defd$Z d;d%eedzdee effd&Zd#e defd'Zd;d%eedzdee effd(Zd#e defd)Z d;d%eedzdee effd*Zededzfd+Zej@jBZ!e"ee#d,< ej@jHZ$e"ee#d-< ejJjLZ&e"ee#d.< ejJjNZ'e"ee#d/< ejJjPZ(e"ee#d0< ejJjRZ)e"ee#d1< ejJjTZ*e"ee#d2< ejJjVZ+e"ee#d3< ejJjXZ,e"ee#d4< ejJjZZ-e"ee#d5< ejJj\Z.e"ee#d6< ejJj^Z/e"ee#d7< ejJj`Z0e"ee#d8< ejJjbZ1e"ee#d9<xZ2S)<Polla#" 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. members_only (:obj:`bool`): :obj:`True`, if voting is limited to users who have been members of the chat where the poll was originally sent for more than :tg-const:`telegram.Poll.MIN_MEMBERSHIP_HOURS` hours. .. versionadded:: 22.8 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. .. deprecated:: 22.8 Use :paramref:`correct_option_ids` instead. 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| explanation_media (:class:`telegram.PollMedia`, optional): Media added to the quiz explanation. .. versionadded:: 22.8 open_period (:obj:`int` | :class:`datetime.timedelta`, optional): Amount of time in seconds the poll will be active after creation. .. versionchanged:: v22.2 |time-period-input| 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 allows_revoting (:obj:`bool`, optional): :obj:`True`, if the poll allows to change the chosenanswer options. .. versionadded:: 22.8 correct_option_ids (Sequence[:class:`int`], optional): Array of 0-based identifiers of the correct answer options. Available only for polls in quiz mode which are closed or were sent (not forwarded) by the bot or to the private chat with the bot. .. versionadded:: 22.8 country_codes (Sequence[:obj:`str`], optional): A list of two-letter ``ISO 3166-1 alpha-2`` country codes indicating the countries from which users can vote in the poll. The country code ``"FT"`` is used for users with anonymous numbers. If omitted, then users from any country can participate in the poll. .. versionadded:: 22.8 description (:obj:`str`, optional): Description of the poll; for polls inside the :class:`~telegram.Message` object only. .. versionadded:: 22.8 description_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities like usernames, URLs, bot commands, etc. that appear in the description .. versionadded:: 22.8 media (:class:`telegram.PollMedia`, optional): Media added to the poll description; for polls inside the :class:`~telegram.Message` object only. .. versionadded:: 22.8 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. members_only (:obj:`bool`): :obj:`True`, if voting is limited to users who have been members of the chat where the poll was originally sent for more than :tg-const:`telegram.Poll.MIN_MEMBERSHIP_HOURS` hours. .. versionadded:: 22.8 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`. explanation_media (:class:`telegram.PollMedia`): Optional. Media added to the quiz explanation. .. versionadded:: 22.8 open_period (:obj:`int` | :class:`datetime.timedelta`): Optional. Amount of time in seconds the poll will be active after creation. .. deprecated:: v22.2 |time-period-int-deprecated| 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_revoting (:obj:`bool`): :obj:`True`, if the poll allows to change the chosenanswer options .. versionadded:: 22.8 correct_option_ids (tuple[:class:`int`]): Array of 0-based identifiers of the correct answer options. Available only for polls in quiz mode which are closed or were sent (not forwarded) by the bot or to the private chat with the bot. .. versionadded:: 22.8 country_codes (tuple[:obj:`str`]): Optional. A list of two-letter ``ISO 3166-1 alpha-2`` country codes indicating the countries from which users can vote in the poll. The country code ``"FT"`` is used for users with anonymous numbers. If omitted, then users from any country can participate in the poll. .. versionadded:: 22.8 description (:obj:`str`): Optional. Description of the poll; for polls inside the Message object only .. versionadded:: 22.8 description_entities (tuple[:class:`telegram.MessageEntity`]): Special entities like usernames, URLs, bot commands, etc. that appear in the description .. versionadded:: 22.8 media (:class:`telegram.PollMedia`): Optional. Media added to the poll description; for polls inside the Message object only. .. versionadded:: 22.8 ) _open_periodallows_multiple_answersallows_revoting close_datecorrect_option_ids country_codes descriptiondescription_entities explanationexplanation_entitiesexplanation_mediaid is_anonymous is_closedrU members_onlyoptionsquestionquestion_entitiestotal_voter_counttypeNr2rrrrrrrrcorrect_option_idrr open_periodrrrrrrrrrUrr3c| td| tdt| |||_||_t ||_||_||_||_ tjtj|||_||_||_||_| t%t'ddd|| g}t ||_||_t ||_| |_t | |_t3| |_| |_t ||_t ||_||_||_|jf|_ |jCy)Nz:`allows_revoting` is a required argument since Bot API 9.6z8`members_only` is a required argument since Bot API 10.0r2r[zRThe parameter `correct_option_id` is deprecated. Use `correct_option_ids` instead.r\r])"rhr6r7rrrrrrrr get_memberrPollTyperrrrr"r#rrrrrrrrrrrUrr8r9)r:rrrrrrrrrrrrrrrrrrrrrUrr3r;s r<r7z Poll.__init__skB  "XY Y  VW W J/% /A'/J &7(".););T4H -D$%4".  ( %8   ")&7%8"3EFX3Y'2?Q @ !(3?Q @ !3?{2K/9r?r@c@|j|}t|}t|jdt||d<t|jdt ||d<t |jd||d<t|jdt ||d<t|jdt ||d<t|jdt||d<t|jdt||d<t|)|| S) rCrrrrjrrrUrrD) rErrrFrarrrr(r6rGrls r<rGz Poll.de_json.s t$2#6 *488I+> CPY'7 HH+ ,mS(  #$,DHH\,B:V\$4 HH( )=#%  !(8 HH+ ,mS(  #$)'):IsKW $4TXX>Q5RT]_b$c !wDc22r=rnc\|js tdt|j|S)aReturns the text in :attr:`explanation` from a given :class:`telegram.MessageEntity` of :attr:`explanation_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.) Args: entity (:class:`telegram.MessageEntity`): The entity to extract the text from. It must be an entity that belongs to :attr:`explanation_entities`. Returns: :obj:`str`: The text of the given entity. Raises: RuntimeError: If the poll has no explanation. This Poll has no 'explanation'.)r RuntimeErrorrrps r<parse_explanation_entityzPoll.parse_explanation_entityFs,(@A A#D$4$4f==r=rrcr|js tdt|j|j|S)aj Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this polls explanation 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:`explanation_entities` attribute, since it calculates the correct substring from the message text based on UTF-16 codepoints. See :attr:`parse_explanation_entity` for more info. 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. Raises: RuntimeError: If the poll has no explanation. r)rrrrrts r<parse_explanation_entitieszPoll.parse_explanation_entities_s54@A A%d&6&68Q8QSXYYr=c.t|j|S)aReturns the text in :attr:`question` from a given :class:`telegram.MessageEntity` of :attr:`question_entities`. .. versionadded:: 21.2 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.) Args: entity (:class:`telegram.MessageEntity`): The entity to extract the text from. It must be an entity that belongs to :attr:`question_entities`. Returns: :obj:`str`: The text of the given entity. )rrrps r<parse_question_entityzPoll.parse_question_entity~s$$DMM6::r=cDt|j|j|S)a6 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`. .. versionadded:: 21.2 Note: This method should always be used instead of the :attr:`question_entities` attribute, since it calculates the correct substring from the message text based on UTF-16 codepoints. See :attr:`parse_question_entity` for more info. 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. )rrrrts r<parse_question_entitieszPoll.parse_question_entitiess.&dmmT5K5KUSSr=c\|js tdt|j|S)aReturns the text in :attr:`description` from a given :class:`telegram.MessageEntity` of :attr:`description_entities`. .. versionadded:: 22.8 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.) Args: entity (:class:`telegram.MessageEntity`): The entity to extract the text from. It must be an entity that belongs to :attr:`description_entities`. Returns: :obj:`str`: The text of the given entity. Raises: RuntimeError: If the poll has no description. This Poll has no 'description'.)rrrrps r<parse_description_entityzPoll.parse_description_entitys,,@A A#D$4$4f==r=cr|js tdt|j|j|S)a Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this polls description filtered by their ``type`` attribute as the key, and the text that each entity belongs to as the value of the :obj:`dict`. .. versionadded:: 22.8 Note: This method should always be used instead of the :attr:`description_entities` attribute, since it calculates the correct substring from the message text based on UTF-16 codepoints. See :attr:`parse_description_entity` for more info. 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. Raises: RuntimeError: If the poll has no description. r)rrrrrts r<parse_description_entitieszPoll.parse_description_entitiess52@A A%d&6&68Q8QSXYYr=cjttddd|jr|jdSdS)a!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. .. deprecated:: 22.8 Use :attr:`correct_option_ids` instead. r[zRThe attribute `correct_option_id` is deprecated. Use `correct_option_ids` instead.r\r]rN)r"r#rrs r<rzPoll.correct_option_idsA !4    .2-D-Dt&&q)N$Nr=REGULARQUIZMAX_EXPLANATION_LENGTHMAX_EXPLANATION_LINE_FEEDSMIN_OPEN_PERIODMAX_OPEN_PERIODMIN_QUESTION_LENGTHMAX_QUESTION_LENGTHr~rMIN_OPTION_NUMBERMAX_OPTION_NUMBERMAX_DESCRIPTION_CHARACTERSMIN_MEMBERSHIP_HOURS)NNNNNNNNNNNNNNrJ)3rKrLrMrNrOr_rrarxboolrr!ryrzr(rr7property timedeltarrPrGrr{r|rrrrrrrrrrrrr}rrrrrrr~rrrrrrQrRs@r<rrsiVIH)-"&?C)-*.<@(,$(37"&?C.2"&.2;R>'+?R RR*% R  R  RRR"&R:R4ZR'}5<R  $&!R"LL4'#R$$M2T9%R*+R,Tk-R0%SMD01R24Z3R4'}5<5R6 }t+7R849R:%t+;R>tO?RhOS3==047OO383,3&33.>}>>4)-Z#Y%Z mS !Z>;M;c;(TT#Y-=Tm]`N`IaT2>}>>8)-Z#Y%Z mS !Z<O3:OO$$,,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$IuSzI.7-@-@-[-[c [(1':':'O'O%*Or=r)FrNrzrycollections.abcrtypingrrtelegramrtelegram._chatrtelegram._files.animationrtelegram._files.audior telegram._files.documentr telegram._files.livephotor telegram._files.locationr telegram._files.photosizer telegram._files.stickerrtelegram._files.venuertelegram._files.videortelegram._messageentityrtelegram._telegramobjectrtelegram._userrtelegram._utilsrtelegram._utils.argumentparsingrrrrtelegram._utils.datetimerrrtelegram._utils.defaultvaluertelegram._utils.entitiesrrtelegram._utils.typesrr r!telegram._utils.warningsr"telegram.warningsr#r$r%r&r(rTrarrrrr=r<rs&F$'/'-/-/+''13   6Q@@)3LLp3p3fS3nS3l{{|e3e3PpZnpZfpZpZfd>dr=