mirror of
https://gitlab.com/MoonTestUse1/AdministrationItDepartmens.git
synced 2025-08-14 00:25:46 +02:00
Все подряд
This commit is contained in:
MoonTestUse1
529
.venv2/Lib/site-packages/telethon/tl/custom/conversation.py
Normal file
529
.venv2/Lib/site-packages/telethon/tl/custom/conversation.py
Normal file
@@ -0,0 +1,529 @@
|
||||
import asyncio
|
||||
import functools
|
||||
import inspect
|
||||
import itertools
|
||||
import time
|
||||
|
||||
from .chatgetter import ChatGetter
|
||||
from ... import helpers, utils, errors
|
||||
|
||||
# Sometimes the edits arrive very fast (within the same second).
|
||||
# In that case we add a small delta so that the age is older, for
|
||||
# comparision purposes. This value is enough for up to 1000 messages.
|
||||
_EDIT_COLLISION_DELTA = 0.001
|
||||
|
||||
|
||||
def _checks_cancelled(f):
|
||||
@functools.wraps(f)
|
||||
def wrapper(self, *args, **kwargs):
|
||||
if self._cancelled:
|
||||
raise asyncio.CancelledError('The conversation was cancelled before')
|
||||
|
||||
return f(self, *args, **kwargs)
|
||||
return wrapper
|
||||
|
||||
|
||||
class Conversation(ChatGetter):
|
||||
"""
|
||||
Represents a conversation inside an specific chat.
|
||||
|
||||
A conversation keeps track of new messages since it was
|
||||
created until its exit and easily lets you query the
|
||||
current state.
|
||||
|
||||
If you need a conversation across two or more chats,
|
||||
you should use two conversations and synchronize them
|
||||
as you better see fit.
|
||||
"""
|
||||
_id_counter = 0
|
||||
_custom_counter = 0
|
||||
|
||||
def __init__(self, client, input_chat,
|
||||
*, timeout, total_timeout, max_messages,
|
||||
exclusive, replies_are_responses):
|
||||
# This call resets the client
|
||||
ChatGetter.__init__(self, input_chat=input_chat)
|
||||
|
||||
self._id = Conversation._id_counter
|
||||
Conversation._id_counter += 1
|
||||
|
||||
self._client = client
|
||||
self._timeout = timeout
|
||||
self._total_timeout = total_timeout
|
||||
self._total_due = None
|
||||
|
||||
self._outgoing = set()
|
||||
self._last_outgoing = 0
|
||||
self._incoming = []
|
||||
self._last_incoming = 0
|
||||
self._max_incoming = max_messages
|
||||
self._last_read = None
|
||||
self._custom = {}
|
||||
|
||||
self._pending_responses = {}
|
||||
self._pending_replies = {}
|
||||
self._pending_edits = {}
|
||||
self._pending_reads = {}
|
||||
|
||||
self._exclusive = exclusive
|
||||
self._cancelled = False
|
||||
|
||||
# The user is able to expect two responses for the same message.
|
||||
# {desired message ID: next incoming index}
|
||||
self._response_indices = {}
|
||||
if replies_are_responses:
|
||||
self._reply_indices = self._response_indices
|
||||
else:
|
||||
self._reply_indices = {}
|
||||
|
||||
self._edit_dates = {}
|
||||
|
||||
@_checks_cancelled
|
||||
async def send_message(self, *args, **kwargs):
|
||||
"""
|
||||
Sends a message in the context of this conversation. Shorthand
|
||||
for `telethon.client.messages.MessageMethods.send_message` with
|
||||
``entity`` already set.
|
||||
"""
|
||||
sent = await self._client.send_message(
|
||||
self._input_chat, *args, **kwargs)
|
||||
|
||||
# Albums will be lists, so handle that
|
||||
ms = sent if isinstance(sent, list) else (sent,)
|
||||
self._outgoing.update(m.id for m in ms)
|
||||
self._last_outgoing = ms[-1].id
|
||||
return sent
|
||||
|
||||
@_checks_cancelled
|
||||
async def send_file(self, *args, **kwargs):
|
||||
"""
|
||||
Sends a file in the context of this conversation. Shorthand
|
||||
for `telethon.client.uploads.UploadMethods.send_file` with
|
||||
``entity`` already set.
|
||||
"""
|
||||
sent = await self._client.send_file(
|
||||
self._input_chat, *args, **kwargs)
|
||||
|
||||
# Albums will be lists, so handle that
|
||||
ms = sent if isinstance(sent, list) else (sent,)
|
||||
self._outgoing.update(m.id for m in ms)
|
||||
self._last_outgoing = ms[-1].id
|
||||
return sent
|
||||
|
||||
@_checks_cancelled
|
||||
def mark_read(self, message=None):
|
||||
"""
|
||||
Marks as read the latest received message if ``message is None``.
|
||||
Otherwise, marks as read until the given message (or message ID).
|
||||
|
||||
This is equivalent to calling `client.send_read_acknowledge
|
||||
<telethon.client.messages.MessageMethods.send_read_acknowledge>`.
|
||||
"""
|
||||
if message is None:
|
||||
if self._incoming:
|
||||
message = self._incoming[-1].id
|
||||
else:
|
||||
message = 0
|
||||
elif not isinstance(message, int):
|
||||
message = message.id
|
||||
|
||||
return self._client.send_read_acknowledge(
|
||||
self._input_chat, max_id=message)
|
||||
|
||||
def get_response(self, message=None, *, timeout=None):
|
||||
"""
|
||||
Gets the next message that responds to a previous one. This is
|
||||
the method you need most of the time, along with `get_edit`.
|
||||
|
||||
Args:
|
||||
message (`Message <telethon.tl.custom.message.Message>` | `int`, optional):
|
||||
The message (or the message ID) for which a response
|
||||
is expected. By default this is the last sent message.
|
||||
|
||||
timeout (`int` | `float`, optional):
|
||||
If present, this `timeout` (in seconds) will override the
|
||||
per-action timeout defined for the conversation.
|
||||
|
||||
.. code-block:: python
|
||||
|
||||
async with client.conversation(...) as conv:
|
||||
await conv.send_message('Hey, what is your name?')
|
||||
|
||||
response = await conv.get_response()
|
||||
name = response.text
|
||||
|
||||
await conv.send_message('Nice to meet you, {}!'.format(name))
|
||||
"""
|
||||
return self._get_message(
|
||||
message, self._response_indices, self._pending_responses, timeout,
|
||||
lambda x, y: True
|
||||
)
|
||||
|
||||
def get_reply(self, message=None, *, timeout=None):
|
||||
"""
|
||||
Gets the next message that explicitly replies to a previous one.
|
||||
"""
|
||||
return self._get_message(
|
||||
message, self._reply_indices, self._pending_replies, timeout,
|
||||
lambda x, y: x.reply_to and x.reply_to.reply_to_msg_id == y
|
||||
)
|
||||
|
||||
def _get_message(
|
||||
self, target_message, indices, pending, timeout, condition):
|
||||
"""
|
||||
Gets the next desired message under the desired condition.
|
||||
|
||||
Args:
|
||||
target_message (`object`):
|
||||
The target message for which we want to find another
|
||||
response that applies based on `condition`.
|
||||
|
||||
indices (`dict`):
|
||||
This dictionary remembers the last ID chosen for the
|
||||
input `target_message`.
|
||||
|
||||
pending (`dict`):
|
||||
This dictionary remembers {msg_id: Future} to be set
|
||||
once `condition` is met.
|
||||
|
||||
timeout (`int`):
|
||||
The timeout (in seconds) override to use for this operation.
|
||||
|
||||
condition (`callable`):
|
||||
The condition callable that checks if an incoming
|
||||
message is a valid response.
|
||||
"""
|
||||
start_time = time.time()
|
||||
target_id = self._get_message_id(target_message)
|
||||
|
||||
# If there is no last-chosen ID, make sure to pick one *after*
|
||||
# the input message, since we don't want responses back in time
|
||||
if target_id not in indices:
|
||||
for i, incoming in enumerate(self._incoming):
|
||||
if incoming.id > target_id:
|
||||
indices[target_id] = i
|
||||
break
|
||||
else:
|
||||
indices[target_id] = len(self._incoming)
|
||||
|
||||
# We will always return a future from here, even if the result
|
||||
# can be set immediately. Otherwise, needing to await only
|
||||
# sometimes is an annoying edge case (i.e. we would return
|
||||
# a `Message` but `get_response()` always `await`'s).
|
||||
future = self._client.loop.create_future()
|
||||
|
||||
# If there are enough responses saved return the next one
|
||||
last_idx = indices[target_id]
|
||||
if last_idx < len(self._incoming):
|
||||
incoming = self._incoming[last_idx]
|
||||
if condition(incoming, target_id):
|
||||
indices[target_id] += 1
|
||||
future.set_result(incoming)
|
||||
return future
|
||||
|
||||
# Otherwise the next incoming response will be the one to use
|
||||
#
|
||||
# Note how we fill "pending" before giving control back to the
|
||||
# event loop through "await". We want to register it as soon as
|
||||
# possible, since any other task switch may arrive with the result.
|
||||
pending[target_id] = future
|
||||
return self._get_result(future, start_time, timeout, pending, target_id)
|
||||
|
||||
def get_edit(self, message=None, *, timeout=None):
|
||||
"""
|
||||
Awaits for an edit after the last message to arrive.
|
||||
The arguments are the same as those for `get_response`.
|
||||
"""
|
||||
start_time = time.time()
|
||||
target_id = self._get_message_id(message)
|
||||
|
||||
target_date = self._edit_dates.get(target_id, 0)
|
||||
earliest_edit = min(
|
||||
(x for x in self._incoming
|
||||
if x.edit_date
|
||||
and x.id > target_id
|
||||
and x.edit_date.timestamp() > target_date
|
||||
),
|
||||
key=lambda x: x.edit_date.timestamp(),
|
||||
default=None
|
||||
)
|
||||
|
||||
future = self._client.loop.create_future()
|
||||
if earliest_edit and earliest_edit.edit_date.timestamp() > target_date:
|
||||
self._edit_dates[target_id] = earliest_edit.edit_date.timestamp()
|
||||
future.set_result(earliest_edit)
|
||||
return future # we should always return something we can await
|
||||
|
||||
# Otherwise the next incoming response will be the one to use
|
||||
self._pending_edits[target_id] = future
|
||||
return self._get_result(future, start_time, timeout, self._pending_edits, target_id)
|
||||
|
||||
def wait_read(self, message=None, *, timeout=None):
|
||||
"""
|
||||
Awaits for the sent message to be marked as read. Note that
|
||||
receiving a response doesn't imply the message was read, and
|
||||
this action will also trigger even without a response.
|
||||
"""
|
||||
start_time = time.time()
|
||||
future = self._client.loop.create_future()
|
||||
target_id = self._get_message_id(message)
|
||||
|
||||
if self._last_read is None:
|
||||
self._last_read = target_id - 1
|
||||
|
||||
if self._last_read >= target_id:
|
||||
return
|
||||
|
||||
self._pending_reads[target_id] = future
|
||||
return self._get_result(future, start_time, timeout, self._pending_reads, target_id)
|
||||
|
||||
async def wait_event(self, event, *, timeout=None):
|
||||
"""
|
||||
Waits for a custom event to occur. Timeouts still apply.
|
||||
|
||||
.. note::
|
||||
|
||||
**Only use this if there isn't another method available!**
|
||||
For example, don't use `wait_event` for new messages,
|
||||
since `get_response` already exists, etc.
|
||||
|
||||
Unless you're certain that your code will run fast enough,
|
||||
generally you should get a "handle" of this special coroutine
|
||||
before acting. In this example you will see how to wait for a user
|
||||
to join a group with proper use of `wait_event`:
|
||||
|
||||
.. code-block:: python
|
||||
|
||||
from telethon import TelegramClient, events
|
||||
|
||||
client = TelegramClient(...)
|
||||
group_id = ...
|
||||
|
||||
async def main():
|
||||
# Could also get the user id from an event; this is just an example
|
||||
user_id = ...
|
||||
|
||||
async with client.conversation(user_id) as conv:
|
||||
# Get a handle to the future event we'll wait for
|
||||
handle = conv.wait_event(events.ChatAction(
|
||||
group_id,
|
||||
func=lambda e: e.user_joined and e.user_id == user_id
|
||||
))
|
||||
|
||||
# Perform whatever action in between
|
||||
await conv.send_message('Please join this group before speaking to me!')
|
||||
|
||||
# Wait for the event we registered above to fire
|
||||
event = await handle
|
||||
|
||||
# Continue with the conversation
|
||||
await conv.send_message('Thanks!')
|
||||
|
||||
This way your event can be registered before acting,
|
||||
since the response may arrive before your event was
|
||||
registered. It depends on your use case since this
|
||||
also means the event can arrive before you send
|
||||
a previous action.
|
||||
"""
|
||||
start_time = time.time()
|
||||
if isinstance(event, type):
|
||||
event = event()
|
||||
|
||||
await event.resolve(self._client)
|
||||
|
||||
counter = Conversation._custom_counter
|
||||
Conversation._custom_counter += 1
|
||||
|
||||
future = self._client.loop.create_future()
|
||||
self._custom[counter] = (event, future)
|
||||
try:
|
||||
return await self._get_result(future, start_time, timeout, self._custom, counter)
|
||||
finally:
|
||||
# Need to remove it from the dict if it times out, else we may
|
||||
# try and fail to set the result later (#1618).
|
||||
self._custom.pop(counter, None)
|
||||
|
||||
async def _check_custom(self, built):
|
||||
for key, (ev, fut) in list(self._custom.items()):
|
||||
ev_type = type(ev)
|
||||
inst = built[ev_type]
|
||||
|
||||
if inst:
|
||||
filter = ev.filter(inst)
|
||||
if inspect.isawaitable(filter):
|
||||
filter = await filter
|
||||
|
||||
if filter:
|
||||
fut.set_result(inst)
|
||||
del self._custom[key]
|
||||
|
||||
def _on_new_message(self, response):
|
||||
response = response.message
|
||||
if response.chat_id != self.chat_id or response.out:
|
||||
return
|
||||
|
||||
if len(self._incoming) == self._max_incoming:
|
||||
self._cancel_all(ValueError('Too many incoming messages'))
|
||||
return
|
||||
|
||||
self._incoming.append(response)
|
||||
|
||||
# Most of the time, these dictionaries will contain just one item
|
||||
# TODO In fact, why not make it be that way? Force one item only.
|
||||
# How often will people want to wait for two responses at
|
||||
# the same time? It's impossible, first one will arrive
|
||||
# and then another, so they can do that.
|
||||
for msg_id, future in list(self._pending_responses.items()):
|
||||
self._response_indices[msg_id] = len(self._incoming)
|
||||
future.set_result(response)
|
||||
del self._pending_responses[msg_id]
|
||||
|
||||
for msg_id, future in list(self._pending_replies.items()):
|
||||
if response.reply_to and msg_id == response.reply_to.reply_to_msg_id:
|
||||
self._reply_indices[msg_id] = len(self._incoming)
|
||||
future.set_result(response)
|
||||
del self._pending_replies[msg_id]
|
||||
|
||||
def _on_edit(self, message):
|
||||
message = message.message
|
||||
if message.chat_id != self.chat_id or message.out:
|
||||
return
|
||||
|
||||
# We have to update our incoming messages with the new edit date
|
||||
for i, m in enumerate(self._incoming):
|
||||
if m.id == message.id:
|
||||
self._incoming[i] = message
|
||||
break
|
||||
|
||||
for msg_id, future in list(self._pending_edits.items()):
|
||||
if msg_id < message.id:
|
||||
edit_ts = message.edit_date.timestamp()
|
||||
|
||||
# We compare <= because edit_ts resolution is always to
|
||||
# seconds, but we may have increased _edit_dates before.
|
||||
# Since the dates are ever growing this is not a problem.
|
||||
if edit_ts <= self._edit_dates.get(msg_id, 0):
|
||||
self._edit_dates[msg_id] += _EDIT_COLLISION_DELTA
|
||||
else:
|
||||
self._edit_dates[msg_id] = message.edit_date.timestamp()
|
||||
|
||||
future.set_result(message)
|
||||
del self._pending_edits[msg_id]
|
||||
|
||||
def _on_read(self, event):
|
||||
if event.chat_id != self.chat_id or event.inbox:
|
||||
return
|
||||
|
||||
self._last_read = event.max_id
|
||||
|
||||
for msg_id, pending in list(self._pending_reads.items()):
|
||||
if msg_id >= self._last_read:
|
||||
pending.set_result(True)
|
||||
del self._pending_reads[msg_id]
|
||||
|
||||
def _get_message_id(self, message):
|
||||
if message is not None: # 0 is valid but false-y, check for None
|
||||
return message if isinstance(message, int) else message.id
|
||||
elif self._last_outgoing:
|
||||
return self._last_outgoing
|
||||
else:
|
||||
raise ValueError('No message was sent previously')
|
||||
|
||||
@_checks_cancelled
|
||||
def _get_result(self, future, start_time, timeout, pending, target_id):
|
||||
due = self._total_due
|
||||
if timeout is None:
|
||||
timeout = self._timeout
|
||||
|
||||
if timeout is not None:
|
||||
due = min(due, start_time + timeout)
|
||||
|
||||
# NOTE: We can't try/finally to pop from pending here because
|
||||
# the event loop needs to get back to us, but it might
|
||||
# dispatch another update before, and in that case a
|
||||
# response could be set twice. So responses must be
|
||||
# cleared when their futures are set to a result.
|
||||
return asyncio.wait_for(
|
||||
future,
|
||||
timeout=None if due == float('inf') else due - time.time()
|
||||
)
|
||||
|
||||
def _cancel_all(self, exception=None):
|
||||
self._cancelled = True
|
||||
for pending in itertools.chain(
|
||||
self._pending_responses.values(),
|
||||
self._pending_replies.values(),
|
||||
self._pending_edits.values()):
|
||||
if exception:
|
||||
pending.set_exception(exception)
|
||||
else:
|
||||
pending.cancel()
|
||||
|
||||
for _, fut in self._custom.values():
|
||||
if exception:
|
||||
fut.set_exception(exception)
|
||||
else:
|
||||
fut.cancel()
|
||||
|
||||
async def __aenter__(self):
|
||||
self._input_chat = \
|
||||
await self._client.get_input_entity(self._input_chat)
|
||||
|
||||
self._chat_peer = utils.get_peer(self._input_chat)
|
||||
|
||||
# Make sure we're the only conversation in this chat if it's exclusive
|
||||
chat_id = utils.get_peer_id(self._chat_peer)
|
||||
conv_set = self._client._conversations[chat_id]
|
||||
if self._exclusive and conv_set:
|
||||
raise errors.AlreadyInConversationError()
|
||||
|
||||
conv_set.add(self)
|
||||
self._cancelled = False
|
||||
|
||||
self._last_outgoing = 0
|
||||
self._last_incoming = 0
|
||||
for d in (
|
||||
self._outgoing, self._incoming,
|
||||
self._pending_responses, self._pending_replies,
|
||||
self._pending_edits, self._response_indices,
|
||||
self._reply_indices, self._edit_dates, self._custom):
|
||||
d.clear()
|
||||
|
||||
if self._total_timeout:
|
||||
self._total_due = time.time() + self._total_timeout
|
||||
else:
|
||||
self._total_due = float('inf')
|
||||
|
||||
return self
|
||||
|
||||
def cancel(self):
|
||||
"""
|
||||
Cancels the current conversation. Pending responses and subsequent
|
||||
calls to get a response will raise ``asyncio.CancelledError``.
|
||||
|
||||
This method is synchronous and should not be awaited.
|
||||
"""
|
||||
self._cancel_all()
|
||||
|
||||
async def cancel_all(self):
|
||||
"""
|
||||
Calls `cancel` on *all* conversations in this chat.
|
||||
|
||||
Note that you should ``await`` this method, since it's meant to be
|
||||
used outside of a context manager, and it needs to resolve the chat.
|
||||
"""
|
||||
chat_id = await self._client.get_peer_id(self._input_chat)
|
||||
for conv in self._client._conversations[chat_id]:
|
||||
conv.cancel()
|
||||
|
||||
async def __aexit__(self, exc_type, exc_val, exc_tb):
|
||||
chat_id = utils.get_peer_id(self._chat_peer)
|
||||
conv_set = self._client._conversations[chat_id]
|
||||
conv_set.discard(self)
|
||||
if not conv_set:
|
||||
del self._client._conversations[chat_id]
|
||||
|
||||
self._cancel_all()
|
||||
|
||||
__enter__ = helpers._sync_enter
|
||||
__exit__ = helpers._sync_exit
|
||||
Reference in New Issue
Block a user