U 2Òtcì/ã@s¬dZddlZddlZddlmZmZmZmZmZm Z ddl m Z m Z m Z mZddlmZmZddlmZerxddl mZGdd „d e ƒZGd d „d e ƒZGd d „d e ƒZdS)z?This module contains an object that represents a Telegram Poll.éN)Ú TYPE_CHECKINGÚAnyÚDictÚListÚOptionalÚClassVar)Ú MessageEntityÚTelegramObjectÚUserÚ constants)Úfrom_timestampÚ to_timestamp)ÚJSONDict)ÚBotc@s:eZdZUdZdZeeedœdd„Ze j Z e ee d<dS)Ú 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` and :attr:`voter_count` are equal. Args: text (:obj:`str`): Option text, 1-100 characters. voter_count (:obj:`int`): Number of users that voted for this option. Attributes: text (:obj:`str`): Option text, 1-100 characters. voter_count (:obj:`int`): Number of users that voted for this option. )Ú voter_countÚtextÚ _id_attrs)rrÚ_kwargscKs||_||_|j|jf|_dS©N)rrr)Úselfrrr©rú1/tmp/pip-unpacked-wheel-2u9rcp5s/telegram/poll.pyÚ__init__5szPollOption.__init__Ú MAX_LENGTHN)Ú__name__Ú __module__Ú __qualname__Ú__doc__Ú __slots__ÚstrÚintrrr ÚMAX_POLL_OPTION_LENGTHrrÚ__annotations__rrrrr"s rc@sJeZdZdZdZeeeee dœdd„Z e e e de ddœdd „ƒZd S) Ú PollAnswera5 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:`options_ids` are equal. Attributes: poll_id (:obj:`str`): Unique poll identifier. user (:class:`telegram.User`): The user, who changed the answer to the poll. option_ids (List[:obj:`int`]): Identifiers of answer options, chosen by the user. Args: poll_id (:obj:`str`): Unique poll identifier. user (:class:`telegram.User`): The user, who changed the answer to the poll. option_ids (List[:obj:`int`]): 0-based identifiers of answer options, chosen by the user. May be empty if the user retracted their vote. )Ú option_idsÚuserÚpoll_idr)r'r&r%rcKs,||_||_||_|j|jt|jƒf|_dSr)r'r&r%Útupler)rr'r&r%rrrrrUszPollAnswer.__init__r©ÚdataÚbotÚreturncCs2| |¡}|sdSt | d¡|¡|d<|f|ŽS)ú,See :meth:`telegram.TelegramObject.de_json`.Nr&)Ú _parse_datar Úde_jsonÚget©Úclsr*r+rrrr/\s  zPollAnswer.de_jsonN)rrrrrr r rr!rrÚ classmethodrrr/rrrrr$?s r$csôeZdZUdZdZdeeeeee e ee eeee ee j e dœdd„Z eeededdœd d „ƒZed œ‡fd d „ Ze edœdd„Zdeeee efdœdd„ZejZeeed<ejZeeed<ejZeeed<ejZ eeed<‡Z!S)Ú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. Attributes: id (:obj:`str`): Unique poll identifier. question (:obj:`str`): Poll question, 1-300 characters. options (List[:class:`PollOption`]): List of poll options. 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. Identifier of the correct answer option. 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. explanation_entities (List[:class:`telegram.MessageEntity`]): Optional. Special entities like usernames, URLs, bot commands, etc. that appear in the :attr:`explanation`. 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. Args: id (:obj:`str`): Unique poll identifier. question (:obj:`str`): Poll question, 1-300 characters. options (List[:class:`PollOption`]): List of poll options. 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): 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the 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-200 characters. explanation_entities (List[:class:`telegram.MessageEntity`], optional): Special entities like usernames, URLs, bot commands, etc. that appear in the :attr:`explanation`. 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`. )Útotal_voter_countÚallows_multiple_answersÚ open_periodÚoptionsÚtypeÚexplanation_entitiesÚ is_anonymousÚ close_dateÚ is_closedÚidÚ explanationÚquestionÚcorrect_option_idrN)r>r@r8r5r=r;r9r6rAr?r:r7r<rcKs\||_||_||_||_||_||_||_||_| |_| |_ | |_ | |_ | |_ |jf|_ dSr)r>r@r8r5r=r;r9r6rAr?r:r7r<r)rr>r@r8r5r=r;r9r6rAr?r:r7r<rrrrrªsz Poll.__init__rr)cs^| |¡}|sdS‡fdd„|dDƒ|d<t | d¡ˆ¡|d<t| d¡ƒ|d<|f|ŽS)r-Ncsg|]}t |ˆ¡‘qSr)rr/)Ú.0Úoption©r+rrÚ Ósz Poll.de_json..r8r:r<)r.rZde_listr0r r1rrDrr/Ës z Poll.de_json)r,csNtƒ ¡}dd„|jDƒ|d<|jr8dd„|jDƒ|d<t| d¡ƒ|d<|S)z,See :meth:`telegram.TelegramObject.to_dict`.cSsg|] }| ¡‘qSr©Úto_dict)rBÚxrrrrEÝsz Poll.to_dict..r8cSsg|] }| ¡‘qSrrF)rBÚerrrrEßsr:r<)ÚsuperrGr8r:r r0)rr*©Ú __class__rrrGÙs  z Poll.to_dict)Úentityr,cCsd|jstdƒ‚tjdkr0|j|j|j|j…S|j d¡}||jd|j|jd…}| d¡S)a¦Returns the text from a given :class:`telegram.MessageEntity`. 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 this message. Returns: :obj:`str`: The text of the given entity. Raises: RuntimeError: If the poll has no explanation. zThis Poll has no 'explanation'.iÿÿz utf-16-leé)r?Ú RuntimeErrorÚsysÚ maxunicodeÚoffsetÚlengthÚencodeÚdecode)rrMZ entity_textrrrÚparse_explanation_entityäs  zPoll.parse_explanation_entity)Útypesr,cs(ˆdkrtj‰‡‡fdd„ˆjp"gDƒS)a 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. Ncs"i|]}|jˆkr|ˆ |¡“qSr)r9rV)rBrM©rrWrrÚ s þz3Poll.parse_explanation_entities..)rZ ALL_TYPESr:rXrrXrÚparse_explanation_entitiess  þzPoll.parse_explanation_entitiesÚREGULARÚQUIZÚMAX_QUESTION_LENGTHÚMAX_OPTION_LENGTH)NNNNN)N)"rrrrrr rrr!ÚboolrÚdatetimerrr3rrr/rGrVrrZr Z POLL_REGULARr[rr#Z POLL_QUIZr\ZMAX_POLL_QUESTION_LENGTHr]r"r^Ú __classcell__rrrKrr4isB /òñ !  r4)rr`rPÚtypingrrrrrrZtelegramrr r r Ztelegram.utils.helpersr r Ztelegram.utils.typesrrrr$r4rrrrÚs   *