mirror of
https://github.com/LonamiWebs/Telethon.git
synced 2024-11-23 18:03:46 +03:00
b716c4fe67
- Made the documentation even more friendly towards newbies. - Eased the usage of methods like get history which now set a default empty message for message actions and vice versa. - Fixed some docstring documentations too. - Updated the old normal docs/ to link back and forth RTD. - Fixed the version of the documentation, now auto-loaded.
83 lines
2.7 KiB
Python
83 lines
2.7 KiB
Python
from ..functions.messages import SaveDraftRequest
|
|
from ..types import UpdateDraftMessage, DraftMessage
|
|
|
|
|
|
class Draft:
|
|
"""
|
|
Custom class that encapsulates a draft on the Telegram servers, providing
|
|
an abstraction to change the message conveniently. The library will return
|
|
instances of this class when calling ``client.get_drafts()``.
|
|
"""
|
|
def __init__(self, client, peer, draft):
|
|
self._client = client
|
|
self._peer = peer
|
|
if not draft:
|
|
draft = DraftMessage('', None, None, None, None)
|
|
|
|
self.text = draft.message
|
|
self.date = draft.date
|
|
self.no_webpage = draft.no_webpage
|
|
self.reply_to_msg_id = draft.reply_to_msg_id
|
|
self.entities = draft.entities
|
|
|
|
@classmethod
|
|
def _from_update(cls, client, update):
|
|
if not isinstance(update, UpdateDraftMessage):
|
|
raise TypeError(
|
|
'You can only create a new `Draft` from a corresponding '
|
|
'`UpdateDraftMessage` object.'
|
|
)
|
|
|
|
return cls(client=client, peer=update.peer, draft=update.draft)
|
|
|
|
@property
|
|
def entity(self):
|
|
return self._client.get_entity(self._peer)
|
|
|
|
@property
|
|
def input_entity(self):
|
|
return self._client.get_input_entity(self._peer)
|
|
|
|
def set_message(self, text, no_webpage=None, reply_to_msg_id=None, entities=None):
|
|
"""
|
|
Changes the draft message on the Telegram servers. The changes are
|
|
reflected in this object. Changing only individual attributes like for
|
|
example the `reply_to_msg_id` should be done by providing the current
|
|
values of this object, like so:
|
|
|
|
draft.set_message(
|
|
draft.text,
|
|
no_webpage=draft.no_webpage,
|
|
reply_to_msg_id=NEW_VALUE,
|
|
entities=draft.entities
|
|
)
|
|
|
|
:param str text: New text of the draft
|
|
:param bool no_webpage: Whether to attach a web page preview
|
|
:param int reply_to_msg_id: Message id to reply to
|
|
:param list entities: A list of formatting entities
|
|
:return bool: `True` on success
|
|
"""
|
|
result = self._client(SaveDraftRequest(
|
|
peer=self._peer,
|
|
message=text,
|
|
no_webpage=no_webpage,
|
|
reply_to_msg_id=reply_to_msg_id,
|
|
entities=entities
|
|
))
|
|
|
|
if result:
|
|
self.text = text
|
|
self.no_webpage = no_webpage
|
|
self.reply_to_msg_id = reply_to_msg_id
|
|
self.entities = entities
|
|
|
|
return result
|
|
|
|
def delete(self):
|
|
"""
|
|
Deletes this draft
|
|
:return bool: `True` on success
|
|
"""
|
|
return self.set_message(text='')
|