# the `send_*_await` methods, all normal Pyro methods still work:
print("Calling a normal `send_message` method...")
client.send_message(client.bot_under_test,
"Hello from Pyrogram") # Not waiting for response
# `send_*_await` methods automatically use the `bot_under_test` as peer:
res = client.send_message_await("Hello from TgIntegration",
max_wait=2,
raise_=False)
# If `raise_` is explicitly set to False, no exception is raised:
assert res.empty
# Note that when no response is expected and no validation thereof is necessary, ...
client.send_photo_await("_assets/photo.jpg", max_wait=0, raise_=False)
client.send_voice_await("_assets/voice.ogg", max_wait=0, raise_=False)
# ... it makes more sense to use the "unawaitable" methods:
client.send_photo(client.bot_under_test, "_assets/photo.jpg")
client.send_voice(client.bot_under_test, "_assets/voice.ogg")
# Custom awaitable Actions
from tgintegration import AwaitableAction, Response
from pyrogram import Filters
peer = '@BotListBot'
print("Constructing custom `AwaitableAction` object...")
action = AwaitableAction(
func=client.send_message,
kwargs=dict(chat_id=peer, text="🔄 Explore"),
num_expected=1,
# Wait for messages only by the peer we're interacting with
filters=Filters.user(peer) & Filters.incoming,
### The `BotIntegrationClient` is based off a regular Pyrogram Client, meaning that, in addition to
### the `send_*_await` methods, all normal Pyro methods still work:
client.send_message(client.bot_under_test,
"Hello from Pyrogram") # Not waiting for response
# `send_*_await` methods automatically use the `bot_under_test` as peer:
res = client.send_message_await("Hello from TgIntegration",
max_wait=2,
raise_=False)
# If `raise_` is explicitly set to False, no exception is raised:
assert res.empty
# Note that when no response is expected and no validation thereof is necessary, ...
client.send_photo_await("media/photo.jpg", max_wait=0, raise_=False)
client.send_voice_await("media/voice.ogg", max_wait=0, raise_=False)
# ... it makes more sense to use the "unawaitable" methods:
client.send_photo(client.bot_under_test, "media/photo.jpg")
client.send_voice(client.bot_under_test, "media/voice.ogg")
### Custom awaitable Actions
from tgintegration import AwaitableAction, Response
from pyrogram import Filters
peer = '@BotListChat'
action = AwaitableAction(
func=client.send_message,
kwargs=dict(chat_id=peer, text="**Hello World**", parse_mode='markdown'),
# Wait for messages only by the peer we're interacting with
filters=Filters.user(peer) & Filters.incoming,
# Time out and raise after 15 seconds
max_wait=15)