cfloop

An asyncio event loop on macOS’s CFRunLoop, so coroutines, Carbon events, and main-queue delegates share the main thread.

import asyncio, cfloop

async def main():
    await asyncio.sleep(1)  # while anything Carbon or main-queue keeps flowing

# the asyncio.run twin; must own the main thread
cfloop.run(main())
# or compose it yourself (also asyncio.Runner)
asyncio.run(main(), loop_factory=cfloop.new_event_loop)

That is the whole API. The loop is a stock asyncio.SelectorEventLoop whose selector waits inside a Carbon event pump instead of a bare kqueue, so whenever asyncio is idle, Carbon events dispatch (hotkeys included), CFRunLoop timers and sources fire, and the main dispatch queue drains. Everything asyncio provides - tasks, subprocesses, signal handling, debug mode’s slow-callback warnings - is inherited, not reimplemented. macOS only, Python 3.12+.

The substrate is a small pyo3 module: pump (manual ReceiveNextEvent dispatch, the part macOS won’t do for you; DEV.md has the probe history), FdWatch (a CFFileDescriptor source that pops the pump when a registered fd turns ready), post_wake, call_later (a CFRunLoopTimer that calls back into Python), and run_app/quit_app for callers who want Carbon’s own RunApplicationEventLoop to own the thread instead.

Development

pip install -e .[dev]
maturin develop && pytest -q

Build

ship-rs-build

Release

maturin develop && pytest -q
ship-release

ship-release tags the Cargo version, leaves wheel publication to GitHub Actions, then bumps the project.