U dd~?@sdZddlZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZmZdd lmZerdd l mZGd ddeZGdddeZGdddeZdS)z?This module contains an object that represents a Telegram Poll.N) TYPE_CHECKINGClassVarDictListOptionalSequenceTuple) constants) MessageEntity)TelegramObject)User)enum)parse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)JSONDict)Botcs^eZdZUdZdZddeeedfddZe j j Z e eed<e j jZe eed <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` 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. 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. ) voter_counttextN api_kwargs)rrrcs4tj|d||_||_|j|jf|_|dSNr)super__init__rr _id_attrs_freeze)selfrrr __class__2/tmp/pip-unpacked-wheel-e3anp165/telegram/_poll.pyr;s zPollOption.__init__ MIN_LENGTH MAX_LENGTH)__name__ __module__ __qualname____doc__ __slots__strintrrr PollLimitMIN_OPTION_LENGTHr"r__annotations__MAX_OPTION_LENGTHr# __classcell__r r rr!r$s  rcs\eZdZdZdZddeeeee dfddZ e e e de dd fd d Z ZS) 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. Args: poll_id (:obj:`str`): Unique poll identifier. user (:class:`telegram.User`): The user, who changed the answer to the poll. option_ids (Sequence[:obj:`int`]): 0-based identifiers of answer options, chosen by the user. May be empty if the user retracted their vote. .. versionchanged:: 20.0 |sequenceclassargs| Attributes: poll_id (:obj:`str`): Unique poll identifier. user (:class:`telegram.User`): The user, who changed the answer to the poll. 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_idsuserpoll_idNr)r3r2r1rcsFtj|d||_||_t||_|j|jt|jf|_|dSr) rrr3r2rr1tuplerr)rr3r2r1rrr r!rms  zPollAnswer.__init__rdatabotreturncs8||}|sdSt|d||d<tj||dS),See :meth:`telegram.TelegramObject.de_json`.Nr2r6r7) _parse_datar de_jsongetr)clsr6r7rr r!r<ys  zPollAnswer.de_json)r$r%r&r'r(r)r rr*rr classmethodrr<r/r r rr!r0Ps r0cseZdZUdZdZdddeeeeee e ee eeee ee j e dfddZ eee dedd fd d Ze ed d dZdeeee efdddZejjZeeed<ejjZeeed<ejjZeeed<ejjZeeed<ejjZeeed<ejjZeeed<ejj Z eeed<ejj!Z!eeed<ejj"Z"eeed<ejj#Z#eeed<ejj$Z$eeed<ejj%Z%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. 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| 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| ) total_voter_countallows_multiple_answers open_periodoptionstypeexplanation_entities is_anonymous close_date is_closedid explanationquestioncorrect_option_idNr)rJrLrDrArIrGrErBrMrKrFrCrHrcstj|d||_||_t||_||_||_||_t t j |||_ ||_| |_| |_t| |_| |_| |_|jf|_|dSr)rrrJrLrrDrArIrGr Z get_memberr PollTyperErBrMrKrFrCrHrr)rrJrLrDrArIrGrErBrMrKrFrCrHrrr r!rs$  z Poll.__init__rr5csp||}|sdSt}fdd|dD|d<t|d|d<t|d|d|d<tj|dS) r9Ncsg|]}t|qSr )rr<).0optionr7r r! sz Poll.de_json..rDrFrH)tzinfor:)r;rr Zde_listr=rrr<)r>r6r7Z loc_tzinforrQr!r<s z Poll.de_json)entityr8cCsB|jstd|jd}||jd|j|jd}|dS)aReturns 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'.z utf-16-le)rK RuntimeErrorencodeoffsetlengthdecode)rrTZ entity_textr r r!parse_explanation_entity!s  zPoll.parse_explanation_entity)typesr8cs$dkrtjfddjDS)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|]}|jkr||qSr )rEr[)rOrTrr\r r! Ts z3Poll.parse_explanation_entities..)r Z ALL_TYPESrFr]r r]r!parse_explanation_entities<s  zPoll.parse_explanation_entitiesREGULARQUIZMAX_EXPLANATION_LENGTHMAX_EXPLANATION_LINE_FEEDSMIN_OPEN_PERIODMAX_OPEN_PERIODMIN_QUESTION_LENGTHMAX_QUESTION_LENGTHr,r.MIN_OPTION_NUMBERMAX_OPTION_NUMBER)NNNNN)N)'r$r%r&r'r(r)rrr*boolr datetimerrr?rr<r[rrr_r rNr`rr-rar+rbrcrdrerfrgr,r.rhrir/r r rr!r@sT R' r@)r'rktypingrrrrrrrZtelegramr Ztelegram._messageentityr Ztelegram._telegramobjectr Ztelegram._userr Ztelegram._utilsr Ztelegram._utils.argumentparsingrZtelegram._utils.datetimerrZtelegram._utils.typesrrrr0r@r r r r!s$        ,6