Synchronous Usage¶

Pyrofork is an asynchronous framework and as such is subject to the asynchronous rules. It can, however, run in synchronous mode (also known as non-asynchronous or sync/non-async for short). This mode exists mainly as a convenience way for invoking methods without the need of async/await keywords and the extra boilerplate, but it’s not the intended way to use the framework.

You can use Pyrofork in this synchronous mode when you want to write something short and contained without the async boilerplate or in case you want to combine Pyrofork with other libraries that are not async.

Synchronous Invocations¶

The following is a standard example of running asynchronous functions with Python’s asyncio. Pyrofork is being used inside the main function with its asynchronous interface.

import asyncio
from pyrogram import Client


async def main():
    app = Client("my_account")

    async with app:
        await app.send_message("me", "Hi!")


asyncio.run(main())

To run Pyrofork synchronously, use the non-async context manager as shown in the following example. As you can see, the non-async example becomes less cluttered.

from pyrogram import Client

app = Client("my_account")

with app:
    app.send_message("me", "Hi!")

Synchronous handlers¶

You can also have synchronous handlers; you only need to define the callback function without using async def and invoke API methods by not placing await in front of them. Mixing def and async def handlers together is also possible.

@app.on_message()
async def handler1(client, message):
    await message.forward("me")

@app.on_edited_message()
def handler2(client, message):
    message.forward("me")

uvloop usage¶

When using Pyrofork in its synchronous mode combined with uvloop, you need to call uvloop.install() before importing Pyrofork.

import uvloop
uvloop.install()

from pyrogram import Client

...