What is the best way to provide alternative listeners for Axum?

[vi]

Summary

Axum's most straightforward way to connect HTTP world to the socket world is axum::serve::serve function. It however uses tokio::net::TcpListener directly, without options to use e.g. tokio::net::UnixListener straightforwardly.

Even the official UNIX socket example is somewhat lengthy and involved.

My library tokio_listener is aimed at being something like a drop-in replacement of TcpListener, but where you can specify e.g. UNIX path or inetd-like mode as as an alternative; and axum::serve being TCP-specific interferes with providing a simple API like Axum 0.6 had. It is not practical to offer users users to bring in a big chunk of code similar to the UNIX socket example above.

Current (unpublished to crates.io so far) implementation just copies the code from axum:serve module, replacing TcpListener and SocketAddr with my types. This works, but results in a code duplication. For example, with_graceful_shutdown also get duplicated, though it is not directly related to socket type. This may complicate further eventual upgrades next Axum versions. Is there maybe a better way?

---

P.S. Why Tokio's unix::SocketAddr is not Clone? It results in additional ugliness to support Connected.

axum version

0.7.3

[davidpdrsn]

Even the official UNIX socket example is somewhat lengthy and involved.

That example is the best way even though it is a bit lengthy.

axum::serve intentionally only accepts TcpListener as that is the most common use case and greatly simplifies the API.

P.S. Why Tokio's unix::SocketAddr is not Clone? It results in additional ugliness to support Connected.

Dunno but it appears to be a wrapper around https://docs.rs/mio/latest/mio/net/struct.SocketAddr.html which is itself a wrapper around some libc stuff that I'm not familiar with.

[vi]

That example is the best way even though it is a bit lengthy.

Does it mean that to provide an axum::serve-like API one needs a copy of axum::serve?

[jplatte]

Yes. @davidpdrsn maybe we should add serve_uds to axum-extra?

[davidpdrsn]

@jplatte that's a good idea! I've made an issue for it #2474