o Zzj@sdZddlZddlmZddlmZmZddlm 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;erddlmZ>Gddde!Z?Gddde!Z@Gd d!d!e!ZAGd"d#d#e!ZBGd$d%d%e!ZCGd&d'd'e!ZDGd(d)d)e!ZEdS)*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)BotInputPollOptionMediaMaybeInaccessibleMessagecseZdZdZdZ         ddddedBdedBdedBdedBd e dBd e e dBd e dBd e dBd edBdedBffddZeddeddddffdd ZZS) 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-r.r/r1c  s~tj| d||_||_||_||_||_t||_||_ ||_ | |_ |j|j|j|j|j|j|j |j |j f |_ | dSNr0)super__init__r'r(r)r*r+rr,r-r.r/ _id_attrs_freeze) selfr'r(r)r*r+r,r-r.r/r1 __class__I/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_poll.pyr4ws*  zPollMedia.__init__databot Bot | Nonereturncs||}t|dt||d<t|dt||d<t|dt||d<t|dt||d<t|dt||d<t|dt ||d<t|dt ||d<t|dt ||d<t|d t ||d <t j||d S) ,See :meth:`telegram.TelegramObject.de_json`.r'r(r)r*r+r,r-r.r/r<r=) _parse_datargetrrr r r rr r rrr3de_jsonclsr<r=r8r:r;rDs zPollMedia.de_json) NNNNNNNNNN)__name__ __module__ __qualname____doc__ __slots__rrr r r rr r rrrr4 classmethodrD __classcell__r:r:r8r;r&=sJ-     '&r&c sxeZdZdZdZeddfdddedeedee dBdd d e dBf fd d Z e dd e ddddffdd Z ZS)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_modeNr0rQrSrRrPzInputPollOptionMedia | Noner1cs@tj|d||_||_t||_||_|jf|_|dSr2) r3r4rQrSrrRrPr5r6)r7rQrSrRrPr1r8r:r;r4s    zInputPollOption.__init__r<r=r>r?csBttdddd||}t|dt||d<tj||dS)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. stacklevelrRrA)r!r"rBrrCrr3rDrEr8r:r;rDs zInputPollOption.de_jsonrG)rHrIrJrKrLrstrrrrrr4rMrDrNr:r:r8r;rOs*' &rOcseZdZUdZdZ      ddddededeedBde dBd e dBd e j dBd e dBd edBd edBffddZeddeddddffdd ZdedefddZddeedBdeeeffddZejjZeeed< ejjZeeed<ZS) PollOptiona 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`, :attr:`voter_count` and :attr:`persistent_id` are equal. .. versionchanged:: 22.8 Added attribute :attr:`persistent_id` to equality checks. Args: persistent_id (:obj:`str`): Unique identifier of the option, persistent on option addition and deletion. .. versionadded:: 22.8 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 media (:class:`telegram.PollMedia`, optional): Media added to the poll option. .. versionadded:: 22.8 added_by_user (:class:`telegram.User`, optional): User who added the option; omitted if the option wasn't added by a user after poll creation. .. versionadded:: 22.8 added_by_chat (:class:`telegram.Chat`, optional): Chat that added the option; omitted if the option wasn't added by a chat after poll creation. .. versionadded:: 22.8 addition_date (:obj:`datetime.datetime`, optional): Point in time when the option was added; omitted if the option existed in the original poll. .. versionadded:: 22.8 Attributes: persistent_id (:obj:`str`): Unique identifier of the option, persistent on option addition and deletion. .. versionadded:: 22.8 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 media (:class:`telegram.PollMedia`): Optional. Media added to the poll option. .. versionadded:: 22.8 added_by_user (:class:`telegram.User`): Optional. User who added the option; omitted if the option wasn't added by a user after poll creation. .. versionadded:: 22.8 added_by_chat (:class:`telegram.Chat`): Optional. Chat that added the option; omitted if the option wasn't added by a chat after poll creation. .. versionadded:: 22.8 addition_date (:obj:`datetime.datetime`): Optional. Point in time when the option was added; omitted if the option existed in the original poll. .. versionadded:: 22.8 ) added_by_chat added_by_user addition_daterP persistent_idrQrR voter_countNr0rQr^rRr[rZr\rPr]r1c  sp|durtdtj| d||_||_||_||_||_||_||_ t ||_ |j|j|jf|_ | dS)Nz8`persistent_id` is a required argument since Bot API 9.6r0) TypeErrorr3r4rQr^r[rZr\r]rPrrRr5r6) r7rQr^rRr[rZr\rPr]r1r8r:r;r4[s  zPollOption.__init__r<r=r>r?cs||}t|}t|dt||d<t|dt||d<t|dt||d<t|d|d|d<t|dt ||d<t j ||dS)r@rRr[rZr\tzinforPrA) rBrrrCrrrrrr&r3rDrFr<r= loc_tzinfor8r:r;rD|s zPollOption.de_jsonentitycC 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. )rrQr7rdr:r:r; parse_entity zPollOption.parse_entitytypescCt|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. )rrQrRr7rir:r:r;parse_entitieszPollOption.parse_entities MIN_LENGTH MAX_LENGTH)NNNNNNrG)rHrIrJrKrLrXintrrrrdtmdatetimer&rr4rMrDrglistdictrlr PollLimitMIN_OPTION_LENGTHrnr__annotations__MAX_OPTION_LENGTHrorNr:r:r8r;rYsL I    !$rYcseZdZdZdZ   ddddedeededBde dBd eedBd e dBf fd d Z e dd e ddddffdd Z ZS) 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_chatNr0r|rzr}r~r{r1csf|durtdtj|d||_||_t||_||_t||_|j|j|j|jf|_ | dS)Nz@`option_persistent_ids` is a required argument since Bot API 9.6r0) r_r3r4r|r~rrzr}r{r5r6)r7r|rzr}r~r{r1r8r:r;r4s    zPollAnswer.__init__r<r=r>r?csF||}t|dt||d<t|dt||d<tj||dS)r@r}r~rA)rBrrCrrr3rDrEr8r:r;rD!s zPollAnswer.de_json)NNNrG)rHrIrJrKrLrXrrprrrr4rMrDrNr:r:r8r;rys.;   &ryc eZdZdZdZ  ddddededdd eedBd edBf fd d Z e dd eddddffdd Z dedefddZ dde edBdeeeffddZZS)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_messageNr0rrrMaybeInaccessibleMessage | Nonerr1cDtj|d||_||_||_t||_|j|jf|_|dSr2 r3r4rrrrrr5r6r7rrrrr1r8r:r;r4L  zPollOptionAdded.__init__r<r=r>r?cRddlm}||}t|d|||d<t|dt||d<tj||dSr@r)r%rrrA telegram._messager%rBrrCrrr3rDrFr<r=r%r8r:r;rDb    zPollOptionAdded.de_jsonrdcCreaReturns 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. rrrfr:r:r;parse_option_text_entityt z(PollOptionAdded.parse_option_text_entityricCrja 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. rrrrkr:r:r;parse_option_text_entitiesrmz*PollOptionAdded.parse_option_text_entitiesNNrGrHrIrJrKrLrXrrrr4rMrDrrsrtrrNr:r:r8r;r,6   rc r)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. rNr0rrrrrr1crr2rrr8r:r;r4rzPollOptionDeleted.__init__r<r=r>r?crrrrr8r:r;rDrzPollOptionDeleted.de_jsonrdcCrerrrfr:r:r;rrz*PollOptionDeleted.parse_option_text_entityricCrjrrrkr:r:r;rrmz,PollOptionDeleted.parse_option_text_entitiesrrGrr:r:r8r;rrrc1s(eZdZUdZdZ              dDdddededeeded e d e d ed e d edBdedBdee dBde dBde j dBdee dBde dBde dBdeedBdedBdee dBdeedBdedBdedBdedBf.fddZedee jBdBfdd ZedEd!ed"d#ddffd$d% Zd&e defd'd(Z dEd)eedBdee effd*d+Zd&e defd,d-ZdEd)eedBdee effd.d/Zd&e defd0d1Z dEd)eedBdee effd2d3ZededBfd4d5Zej j!Z!e"ee#d6< ej j$Z$e"ee#d7< ej%j&Z&e"ee#d8< ej%j'Z'e"ee#d9< ej%j(Z(e"ee#d:< ej%j)Z)e"ee#d;< ej%j*Z*e"ee#d<< ej%j+Z+e"ee#d=< ej%j,Z,e"ee#d>< ej%j-Z-e"ee#d?< ej%j.Z.e"ee#d@< ej%j/Z/e"ee#dA< ej%j0Z0e"ee#dB< ej%j1Z1e"ee#dC<Z2S)FPolla#" 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_closedrP members_onlyoptionsquestionquestion_entitiestotal_voter_counttypeNr0rrrrrrrrcorrect_option_idrr open_periodrrrrrrrrrPrr1cs|durtd|durtdtj|d||_||_t||_||_||_||_ t t j |||_||_||_||_| durQttdddd|durQ| g}t||_||_t||_| |_t| |_t| |_| |_t||_t||_||_||_|jf|_ |!dS)Nz:`allows_revoting` is a required argument since Bot API 9.6z8`members_only` is a required argument since Bot API 10.0r0rTzRThe parameter `correct_option_id` is deprecated. Use `correct_option_ids` instead.rUrV)"r_r3r4rrrrrrrr get_memberrPollTyperrrrr!r"rrrrrrrrrrrPrr5r6)r7rrrrrrrrrrrrrrrrrrrrrPrr1r8r:r;r4sT!       z Poll.__init__r?cCst|jddS)Nr) attribute)rrr7r:r:r;r*szPoll.open_periodr<r=r>cs||}t|}t|dt||d<t|dt||d<t|d|d|d<t|dt||d<t|dt||d<t|dt||d<t|dt||d<t j ||d S) r@rrrr`rrrPrrA) rBrrrCrYrrrr&r3rDrbr8r:r;rD.s    z Poll.de_jsonrdcC|jstdt|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 RuntimeErrorrrfr:r:r;parse_explanation_entityFs zPoll.parse_explanation_entityricC|jstdt|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)rrrrrkr:r:r;parse_explanation_entities_szPoll.parse_explanation_entitiescCre)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. )rrrfr:r:r;parse_question_entity~rhzPoll.parse_question_entitycCrj)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. )rrrrkr:r:r;parse_question_entitiesszPoll.parse_question_entitiescCr)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'.)rrrrfr:r:r;parse_description_entitys zPoll.parse_description_entitycCr)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)rrrrrkr:r:r;parse_description_entitiesszPoll.parse_description_entitiescCs&ttdddd|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. rTzRThe attribute `correct_option_id` is deprecated. Use `correct_option_ids` instead.rUrVrN)r!r"rrr:r:r;rs zPoll.correct_option_idREGULARQUIZMAX_EXPLANATION_LENGTHMAX_EXPLANATION_LINE_FEEDSMIN_OPEN_PERIODMAX_OPEN_PERIODMIN_QUESTION_LENGTHMAX_QUESTION_LENGTHrvrxMIN_OPTION_NUMBERMAX_OPTION_NUMBERMAX_DESCRIPTION_CHARACTERSMIN_MEMBERSHIP_HOURS)NNNNNNNNNNNNNNrG)3rHrIrJrKrLrXrrYrpboolrr rqrrr&rr4property timedeltarrMrDrrsrtrrrrrrrrrrrwrrurrrrrrrvrxrrrrrNr:r:r8r;rs ,$       T   $   r)FrKrrrqcollections.abcrtypingrrtelegramrtelegram._chatrtelegram._files.animationrtelegram._files.audiortelegram._files.documentr telegram._files.livephotor telegram._files.locationr telegram._files.photosizer telegram._files.stickerr telegram._files.venuertelegram._files.videortelegram._messageentityrtelegram._telegramobjectrtelegram._userrtelegram._utilsrtelegram._utils.argumentparsingrrrrtelegram._utils.datetimerrrtelegram._utils.defaultvaluertelegram._utils.entitiesrrtelegram._utils.typesrrr telegram._utils.warningsr!telegram.warningsr"r#r$r%r&rOrYryrrrr:r:r:r;sH                   sV?hss