# 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)