Skip to content

ThatXliner/aioudp

Repository files navigation

AioUDP

Poetry Code style: black Ruff Imports: isort Checked with mypy codecov

Documentation Status CI PyPI - Python Version PyPI PyPI - License

A better API for asynchronous UDP

A websockets-like API for UDP

Here's an example echo server:

import asyncio
import signal

import aioudp


async def main():
    async def handler(connection):
        async for message in connection:
            await connection.send(message)

    # Optional. This is for properly exiting the server when Ctrl-C is pressed
    # or when the process is killed/terminated
    loop = asyncio.get_running_loop()
    stop = loop.create_future()
    loop.add_signal_handler(signal.SIGTERM, stop.set_result, None)
    loop.add_signal_handler(signal.SIGINT, stop.set_result, None)

    # Serve the server
    async with aioudp.serve("localhost", 9999, handler):
        await stop  # Serve forever

if __name__ == '__main__':
    asyncio.run(main())

And a client to connect to the server:

import asyncio

import aioudp


async def main():
    async with aioudp.connect("localhost", 9999) as connection:
        await connection.send(b"Hello world!")
        assert await connection.recv() == b"Hello world!"

if __name__ == '__main__':
    asyncio.run(main())

Installation

You can get this project via pip

$ pip install aioudp

Or, if you're using Poetry

$ poetry add aioudp

Note

This library provides no other abstractions over the existing UDP interface in asyncio other than the async/await-based API. This means there is no implicit protocol handled in this library such as QUIC. You must write your own, or find another library.

See also

  • AnyIO, a broader asynchronous networking and concurrency library for abstracting over any async IO implementation. It has a similar API (which I didn't know about before I wrote this library)
  • WebSockets, a library for Python to interact with WebSockets. Its API heavily inspired the design of AioUDP.
  • QUIC, a faster protocol similar to TCP, built on UDP.
  • AioQUIC, a Python implementation of QUIC.

License

Copyright © 2021, Bryan Hu

This project is licensed under the GNU GPL v3+.

In short, this means you can do anything with it (distribute, modify, sell) but if you were to publish your changes, you must make the source code and build instructions readily available.

If you are a company using this project and want an exception, email me at [email protected] and we can discuss.