flare.udp

Built on flare.net POSIX socket primitives. Provides connectionless, best-effort datagram delivery. Use flare.tcp for reliable ordered delivery.

Public API

from flare.udp import UdpSocket, DatagramTooLarge

• UdpSocket — A UDP socket for send_to / recv_from operations.
• DatagramTooLarge — Raised when a payload exceeds the 65,507-byte UDP limit.

Example

from flare.udp import UdpSocket
from flare.net import SocketAddr

def main() raises:
    # Sender (no bind needed for outbound-only sockets)
    var tx = UdpSocket.unbound()
    tx.send_to("hello".as_bytes(), SocketAddr.localhost(9001))
    tx.close()

    # Receiver
    var rx = UdpSocket.bind(SocketAddr.localhost(9001))
    var buf = List[UInt8](capacity=65535)
    buf.resize(65535, 0)
    var (n, from_addr) = rx.recv_from(Span[UInt8, _](buf))
    print(String(buf[:n])) # hello
    rx.close()