o "hA@sdZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZmZmZdd lmZmZdd lmZmZdd lmZdd lmZerVdd lmZmZGddde ZGddde Z Gddde Z!Gddde Z"dS)z?This module contains an objects related to Telegram checklists.N)Sequence) TYPE_CHECKINGOptional) MessageEntity)TelegramObject)User)de_json_optionalde_list_optionalparse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)parse_message_entitiesparse_message_entity)JSONDict) ZERO_DATE)BotMessagecseZdZdZdZ   ddddededeee dee d ee j d ee f fd d Zedd e dedddffdd Zde defddZddeeedee effddZZS) ChecklistTaska Describes a task in a checklist. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if all their :attr:`id` is equal. .. versionadded:: 22.3 Args: id (:obj:`int`): Unique identifier of the task. text (:obj:`str`): Text of the task. text_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities that appear in the task text. completed_by_user (:class:`telegram.User`, optional): User that completed the task; omitted if the task wasn't completed completion_date (:class:`datetime.datetime`, optional): Point in time when the task was completed; :attr:`~telegram.constants.ZERO_DATE` if the task wasn't completed |datetime_localization| Attributes: id (:obj:`int`): Unique identifier of the task. text (:obj:`str`): Text of the task. text_entities (Tuple[:class:`telegram.MessageEntity`]): Optional. Special entities that appear in the task text. completed_by_user (:class:`telegram.User`): Optional. User that completed the task; omitted if the task wasn't completed completion_date (:class:`datetime.datetime`): Optional. Point in time when the task was completed; :attr:`~telegram.constants.ZERO_DATE` if the task wasn't completed |datetime_localization| )completed_by_usercompletion_dateidtext text_entitiesN api_kwargsrrrrrrcsFtj|d||_||_t||_||_||_|jf|_| dSNr) super__init__rrr rrr _id_attrs_freeze)selfrrrrrr __class__G/var/www/html/venv/lib/python3.10/site-packages/telegram/_checklists.pyrQs    zChecklistTask.__init__databotrreturncsz||}t|}|d}dkrt|d<nt||d|d<t|dt||d<t|dt||d<t j ||dS),See :meth:`telegram.TelegramObject.de_json`.rr)tzinforrr%r&) _parse_datar getrr rrr rrde_json)clsr%r& loc_tzinfodater!r#r$r-fs  zChecklistTask.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 ``ChecklistTask.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:`text_entities`. Returns: :obj:`str`: The text of the given entity. )rrr r1r#r#r$ parse_entityx zChecklistTask.parse_entitytypescCt|j|j|S)a Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this checklist task 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. 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. )r rrr r6r#r#r$parse_entitieszChecklistTask.parse_entitiesNNNN)__name__ __module__ __qualname____doc__ __slots__intstrrrrrdtmdatetimerr classmethodr-r4listdictr9 __classcell__r#r#r!r$r%s2#  ",rcseZdZdZdZ   ddddedeedeee dee d ee d ee f fd d Z e dd e dedddffdd Zde defddZddeeedee effddZZS) Checklista Describes a checklist. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if all their :attr:`tasks` are equal. .. versionadded:: 22.3 Args: title (:obj:`str`): Title of the checklist. title_entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities that appear in the checklist title. tasks (Sequence[:class:`telegram.ChecklistTask`]): List of tasks in the checklist. others_can_add_tasks (:obj:`bool`, optional): :obj:`True` if users other than the creator of the list can add tasks to the list others_can_mark_tasks_as_done (:obj:`bool`, optional): :obj:`True` if users other than the creator of the list can mark tasks as done or not done Attributes: title (:obj:`str`): Title of the checklist. title_entities (Tuple[:class:`telegram.MessageEntity`]): Optional. Special entities that appear in the checklist title. tasks (Tuple[:class:`telegram.ChecklistTask`]): List of tasks in the checklist. others_can_add_tasks (:obj:`bool`): Optional. :obj:`True` if users other than the creator of the list can add tasks to the list others_can_mark_tasks_as_done (:obj:`bool`): Optional. :obj:`True` if users other than the creator of the list can mark tasks as done or not done )others_can_add_tasksothers_can_mark_tasks_as_donetaskstitletitle_entitiesNrrNrMrOrKrLrcsJtj|d||_t||_t||_||_||_|jf|_| dSr) rrrNr rOrMrKrLrr)r rNrMrOrKrLrr!r#r$rs     zChecklist.__init__r%r&rr'csF||}t|dt||d<t|dt||d<tj||dS)r(rOrMr*)r+r r,rrrr-)r.r%r&r!r#r$r-s zChecklist.de_jsonr1cCr2)aReturns the text in :attr:`title` from a given :class:`telegram.MessageEntity` of :attr:`title_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 :attr:`title` 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:`title_entities`. Returns: :obj:`str`: The text of the given entity. )rrNr3r#r#r$r4r5zChecklist.parse_entityr6cCr7)a  Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this checklist's title 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:`title_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. )r rNrOr8r#r#r$r9r:zChecklist.parse_entitiesr;r<)r=r>r?r@rArCrrrrboolrrrFr-r4rGrHr9rIr#r#r!r$rJs2  " ,rJc seZdZdZdZ   ddddeddeeedeeed eeffd d Z e dd ed edddffdd Z Z S)ChecklistTasksDonea Describes a service message about checklist tasks marked as done or not done. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`marked_as_done_task_ids` and :attr:`marked_as_not_done_task_ids` are equal. .. versionadded:: 22.3 Args: checklist_message (:class:`telegram.Message`, optional): Message containing the checklist whose tasks were marked as done or not done. Note that the ~:class:`telegram.Message` object in this field will not contain the :attr:`~telegram.Message.reply_to_message` field even if it itself is a reply. marked_as_done_task_ids (Sequence[:obj:`int`], optional): Identifiers of the tasks that were marked as done marked_as_not_done_task_ids (Sequence[:obj:`int`], optional): Identifiers of the tasks that were marked as not done Attributes: checklist_message (:class:`telegram.Message`): Optional. Message containing the checklist whose tasks were marked as done or not done. Note that the ~:class:`telegram.Message` object in this field will not contain the :attr:`~telegram.Message.reply_to_message` field even if it itself is a reply. marked_as_done_task_ids (Tuple[:obj:`int`]): Optional. Identifiers of the tasks that were marked as done marked_as_not_done_task_ids (Tuple[:obj:`int`]): Optional. Identifiers of the tasks that were marked as not done )checklist_messagemarked_as_done_task_idsmarked_as_not_done_task_idsNrrRrrSrTrcsBtj|d||_t||_t||_|j|jf|_|dSr)rrrRr rSrTrr)r rRrSrTrr!r#r$r4s  zChecklistTasksDone.__init__r%r&rr'cs<||}ddlm}t|d|||d<tj||dS)r(rrrRr*)r+telegramrrr,rr-r.r%r&rr!r#r$r-Gs  zChecklistTasksDone.de_jsonr;r<) r=r>r?r@rArrrBrrrFr-rIr#r#r!r$rQs&  *rQc sleZdZdZdZ ddddeededdeeffd d Z e dd ed ed ddffdd Z Z S)ChecklistTasksAddedaX Describes a service message about tasks added to a checklist. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`tasks` are equal. .. versionadded:: 22.3 Args: checklist_message (:class:`telegram.Message`, optional): Message containing the checklist to which tasks were added. Note that the ~:class:`telegram.Message` object in this field will not contain the :attr:`~telegram.Message.reply_to_message` field even if it itself is a reply. tasks (Sequence[:class:`telegram.ChecklistTask`]): List of tasks added to the checklist Attributes: checklist_message (:class:`telegram.Message`): Optional. Message containing the checklist to which tasks were added. Note that the ~:class:`telegram.Message` object in this field will not contain the :attr:`~telegram.Message.reply_to_message` field even if it itself is a reply. tasks (Tuple[:class:`telegram.ChecklistTask`]): List of tasks added to the checklist )rRrMNrrMrRrrcs4tj|d||_t||_|jf|_|dSr)rrrRr rMrr)r rMrRrr!r#r$rns    zChecklistTasksAdded.__init__r%r&rr'csT||}ddlm}t|d|||d<t|dg||d<tj||dS)r(rrUrRrMr*) r+rVrrr,rde_listrr-rWr!r#r$r-}s  zChecklistTasksAdded.de_jsonr<) r=r>r?r@rArrrrrrFr-rIr#r#r!r$rXTs*rX)#r@rErDcollections.abcrtypingrrtelegram._messageentityrtelegram._telegramobjectrtelegram._userrtelegram._utils.argumentparsingrr r telegram._utils.datetimer r telegram._utils.entitiesr rtelegram._utils.typesrtelegram.constantsrrVrrrrJrQrXr#r#r#r$s$      |nE