Unix Sockets

Unix domain sockets bypass the TCP/IP stack entirely, making them significantly faster for same-machine communication. Use them when your Service and Client(s) run on the same host.

Platform support

Unix sockets are supported on Linux and macOS only.

---

Service

Pass unix_sock_path instead of host/port:

from daffi import Service, callback

SOCK = "/tmp/daffi_example.sock"

@callback
def ping(msg: str) -> str:
    print(f"[service] ping({msg!r})")
    return f"pong: {msg}"

if __name__ == "__main__":
    svc = Service(app_name="unix-service", unix_sock_path=SOCK)
    svc.start()
    print(f"Service listening on unix://{SOCK} — press Ctrl+C to stop.")
    svc.join()

---

Client

from daffi import Client

SOCK = "/tmp/daffi_example.sock"

if __name__ == "__main__":
    client = Client(app_name="unix-client", unix_sock_path=SOCK)
    conn = client.connect()

    for msg in ["hello", "world", "unix sockets are fast"]:
        result = conn.rpc(timeout=5).ping(msg)
        print(f"ping({msg!r}) → {result!r}")

    client.stop()

The API is identical to TCP — only the constructor argument changes.

---

Router with Unix socket

The Router also supports unix_sock_path:

router = Router(unix_sock_path="/tmp/my_router.sock")
router.start()
router.join()

Workers and Callers connect using the same path.

---

Example

Full working example: examples/service/08_unix_socket/