cymongoose: Python Bindings for the Mongoose Networking Library

cymongoose is a high-performance Cython-based Python wrapper around the Mongoose embedded networking library. It provides Pythonic bindings to Mongoose's comprehensive networking capabilities with C-level performance.

Key Features

• High Performance: Achieves 60k+ req/sec with nogil optimization (6-37x faster than pure Python frameworks)

• Comprehensive Protocol Support: HTTP/HTTPS, WebSocket/WSS, MQTT/MQTTS, TCP/UDP, DNS, SNTP

• TLS/SSL Support: Full certificate-based encryption for all protocols

• Production Ready: Signal handling, graceful shutdown, connection draining

• Zero-copy Design: Efficient memory usage with view objects over C structs

• Thread-safe Operations: 24 methods with GIL release for true parallel execution

• Pythonic API: Clean, intuitive interface with comprehensive type hints

Quick Example

from cymongoose import Manager, MG_EV_HTTP_MSG

def handler(conn, ev, data):
    if ev == MG_EV_HTTP_MSG:
        conn.reply(200, b'{"status": "ok"}')
        conn.drain()

mgr = Manager(handler)
mgr.listen("http://0.0.0.0:8000")
print("Server running on http://0.0.0.0:8000")
mgr.run()  # Blocks until SIGINT/SIGTERM, then cleans up

Performance Benchmarks

Benchmarked with wrk -t4 -c100 -d10s on an M1 Macbook Air laptop:

Framework	Req/sec	Latency (avg)	vs cymongoose
cymongoose	88,710	1.13ms	baseline
aiohttp	42,452	2.56ms	2.1x slower
FastAPI/uvicorn	9,989	9.96ms	8.9x slower
Flask (threaded)	1,627	22.15ms	54.5x slower

Project Links

• GitHub: https://github.com/shakfu/cymongoose

• PyPI: https://pypi.org/project/cymongoose/

• Issue Tracker: https://github.com/shakfu/cymongoose/issues

• Mongoose Library: https://github.com/cesanta/mongoose

License

This project is licensed under GPL-2.0-or-later, matching the Mongoose library's open-source license. Commercial licensing is available from Cesanta for proprietary use.