starpc 0.52.0 → 0.52.2

package/echo/main.rs

@@ -4,6 +4,8 @@
 //! echo service that supports unary, server streaming, client streaming,
 //! and bidirectional streaming RPCs.
 
+// This example uses only part of the generated service surface.
+#[allow(dead_code)]
 mod gen;
 
 use std::sync::Arc;
@@ -19,22 +21,13 @@ struct EchoServerImpl;
 
 #[async_trait]
 impl EchoerServer for EchoServerImpl {
-    async fn echo(&self, request: EchoMsg) -> Result<EchoMsg> {
+    async fn echo(&self, _context: &starpc::Context, request: EchoMsg) -> Result<EchoMsg> {
         println!("Server: received echo request: {:?}", request.body);
-        Ok(EchoMsg {
-            body: request.body,
-        })
+        Ok(EchoMsg { body: request.body })
     }
 
-    async fn echo_server_stream(
-        &self,
-        request: EchoMsg,
-        stream: Box<dyn Stream>,
-    ) -> Result<()> {
-        println!(
-            "Server: received server stream request: {:?}",
-            request.body
-        );
+    async fn echo_server_stream(&self, request: EchoMsg, stream: Box<dyn Stream>) -> Result<()> {
+        println!("Server: received server stream request: {:?}", request.body);
 
         // Send multiple responses.
         for i in 0..5 {
@@ -65,11 +58,9 @@ impl EchoerServer for EchoServerImpl {
         }
 
         // Return combined response (the handler will send it automatically).
-        let response = EchoMsg {
+        Ok(EchoMsg {
             body: messages.join(", "),
-        };
-
-        Ok(response)
+        })
     }
 
     async fn echo_bidi_stream(&self, stream: Box<dyn Stream>) -> Result<()> {
@@ -95,53 +86,42 @@ impl EchoerServer for EchoServerImpl {
         Err(Error::Unimplemented)
     }
 
-    async fn do_nothing(&self, _request: gen::Empty) -> Result<gen::Empty> {
+    async fn do_nothing(
+        &self,
+        _context: &starpc::Context,
+        _request: gen::Empty,
+    ) -> Result<gen::Empty> {
         Ok(gen::Empty {})
     }
 }
 
+/// Binds the server before connecting and retains both operations until their call completes.
 #[tokio::main]
 async fn main() -> Result<()> {
-    let addr = "127.0.0.1:8080";
-
-    // Spawn the server.
-    let server_handle = tokio::spawn(run_server(addr.to_string()));
-
-    // Wait for the server to start.
-    tokio::time::sleep(tokio::time::Duration::from_millis(100)).await;
-
-    // Run the client.
-    run_client(addr).await?;
-
-    // Stop the server.
-    server_handle.abort();
+    // Listener construction is the readiness capability used by the client.
+    let listener = TcpListener::bind("127.0.0.1:0").await?;
+    let address = listener.local_addr()?.to_string();
 
+    // Both futures remain owned here, so failure or cancellation releases the other side.
+    tokio::try_join!(run_server(listener), run_client(&address))?;
     println!("Example completed successfully!");
     Ok(())
 }
 
-async fn run_server(addr: String) -> Result<()> {
-    let listener = TcpListener::bind(&addr).await?;
-    println!("Server listening on {}", addr);
-
-    // Create the mux and register our handler.
+/// Serves the one connection used by this example through the ordinary server owner.
+async fn run_server(listener: TcpListener) -> Result<()> {
+    // Publish the handler before accepting the paired client's connection.
+    println!("Server listening on {}", listener.local_addr()?);
     let mux = Arc::new(Mux::new());
     mux.register(Arc::new(EchoerHandler::new(EchoServerImpl)))?;
 
-    // Accept connections.
-    loop {
-        let (stream, peer_addr) = listener.accept().await?;
-        println!("Server: accepted connection from {}", peer_addr);
-
-        let server = Server::with_arc(mux.clone());
-        tokio::spawn(async move {
-            if let Err(e) = server.handle_stream(stream).await {
-                eprintln!("Server error: {}", e);
-            }
-        });
-    }
+    // Return only after the actual call and its packet reader have finished.
+    let (stream, peer_address) = listener.accept().await?;
+    println!("Server: accepted connection from {}", peer_address);
+    Server::with_arc(mux).handle_stream(stream).await
 }
 
+/// Runs a unary call over one connection and verifies its exact response.
 async fn run_client(addr: &str) -> Result<()> {
     println!("\nClient: connecting to {}", addr);
 

package/go.mod

@@ -3,7 +3,7 @@ module github.com/aperturerobotics/starpc
 go 1.25.0
 
 require (
-	github.com/aperturerobotics/common v0.35.0 // latest
+	github.com/aperturerobotics/common v0.35.1-0.20260808123156-c77af26f63bd // latest
 	github.com/aperturerobotics/protobuf-go-lite v0.16.0 // latest
 	github.com/aperturerobotics/util v1.34.9 // latest
 )
@@ -12,7 +12,7 @@ require (
 	github.com/aperturerobotics/abseil-cpp v0.0.0-20260131110040-4bb56e2f9017 // aperture-2
 	github.com/aperturerobotics/cli v1.1.0 // indirect
 	github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260705010911-9f53feac967b // indirect
-	github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260712054757-d8078c296c17 // indirect
+	github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260808023521-7b1595380c3f // indirect
 	github.com/aperturerobotics/go-websocket v1.8.15-0.20260619192713-a096778f08c1 // master
 	github.com/aperturerobotics/json-iterator-lite v1.1.0 // indirect
 	github.com/aperturerobotics/protobuf v0.0.0-20260203024654-8201686529c4 // wasi
@@ -29,6 +29,6 @@ require (
 	github.com/libp2p/go-buffer-pool v0.1.0 // indirect
 	github.com/tetratelabs/wazero v1.12.0 // indirect
 	github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 // indirect
-	golang.org/x/mod v0.38.0 // indirect
+	golang.org/x/mod v0.40.0 // indirect
 	golang.org/x/sys v0.47.0 // indirect
 )

package/go.sum

@@ -2,14 +2,12 @@ github.com/aperturerobotics/abseil-cpp v0.0.0-20260131110040-4bb56e2f9017 h1:3U7
 github.com/aperturerobotics/abseil-cpp v0.0.0-20260131110040-4bb56e2f9017/go.mod h1:lNSJTKECIUFAnfeSqy01kXYTYe1BHubW7198jNX3nEw=
 github.com/aperturerobotics/cli v1.1.0 h1:7a+YRC+EY3npAnTzhHV5gLCiw91KS0Ts3XwLILGOsT8=
 github.com/aperturerobotics/cli v1.1.0/go.mod h1:M7BFP9wow5ytTzMyJQOOO991fGfsUqdTI7gGEsHfTQ8=
-github.com/aperturerobotics/common v0.34.4 h1:RQTOm6LxEnucXkED/kruhKKAOL6tbaPzMgfHPKaES4k=
-github.com/aperturerobotics/common v0.34.4/go.mod h1:xnb1VBRs3x2o1PaKg0OlP7SqDaC9Hmrmt9xH85rOS+A=
-github.com/aperturerobotics/common v0.35.0 h1:VU4OPMXJyqT37lTOtNEMa3QLW5tR8YIBAKbjgxSzuZs=
-github.com/aperturerobotics/common v0.35.0/go.mod h1:xnb1VBRs3x2o1PaKg0OlP7SqDaC9Hmrmt9xH85rOS+A=
+github.com/aperturerobotics/common v0.35.1-0.20260808123156-c77af26f63bd h1:BTfB1V2X+u3/56negSjrx+AWg+Uk84rFFryvpGTj7f4=
+github.com/aperturerobotics/common v0.35.1-0.20260808123156-c77af26f63bd/go.mod h1:sPjrQZeS/yr9kBro4rN2BrYvG9TCn1eIGk7dMH/E2NQ=
 github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260705010911-9f53feac967b h1:MMk+AbWPCMfqc2Lm2bJl8lCCsuvlM2+C0CP10fpE3bc=
 github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260705010911-9f53feac967b/go.mod h1:OBb/beWmr/pDIZAUfi86j/4tBh2v5ctTxKMqSnh9c/4=
-github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260712054757-d8078c296c17 h1:WT1YmZjJf8fUF1zKbeNNKXFA+t8Wtbr8AVMAmdKcrUU=
-github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260712054757-d8078c296c17/go.mod h1:vEq8i7EKb32+KXGtIEZjjhNns+BdsL2dUMw4uhy3578=
+github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260808023521-7b1595380c3f h1:UszdpmKBfQd0LdOZjypeRGrHz2tcPpmKpw6SV3DYyN0=
+github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260808023521-7b1595380c3f/go.mod h1:vEq8i7EKb32+KXGtIEZjjhNns+BdsL2dUMw4uhy3578=
 github.com/aperturerobotics/go-websocket v1.8.15-0.20260619192713-a096778f08c1 h1:q2qkdNOrnhAFf6B7TBeUoAYstYWxPvozN+3vJi2jgp0=
 github.com/aperturerobotics/go-websocket v1.8.15-0.20260619192713-a096778f08c1/go.mod h1:9KnSGuqxSXbdB/Oi0I6vvfPLkclfJwMGAQaDDGVgGow=
 github.com/aperturerobotics/json-iterator-lite v1.1.0 h1:ZLLqHhHTKYlmCAP873ras2e/yVU/THtwC+ji3tXLMMg=
@@ -40,8 +38,8 @@ github.com/tetratelabs/wazero v1.12.0 h1:DuWcpNu/FzgEXgGBDp8J1Spc+CWOvvtvVyjKlaZ
 github.com/tetratelabs/wazero v1.12.0/go.mod h1:LvKtzl2RqO4gyF27BiXU+nKAjcV8f38U+kP/q2vgxh0=
 github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 h1:FnBeRrxr7OU4VvAzt5X7s6266i6cSVkkFPS0TuXWbIg=
 github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342/go.mod h1:Ohn+xnUBiLI6FVj/9LpzZWtj1/D6lUovWYBkxHVV3aM=
-golang.org/x/mod v0.38.0 h1:MECBjubtXD7yj4HrhIUcywNaGeNVUdfVnxmPajOk4yk=
-golang.org/x/mod v0.38.0/go.mod h1:V6Xz0pq8TQ3dGqVQ1FVHuelZpAL0uNhSkk9ogYP3c40=
+golang.org/x/mod v0.40.0 h1:hUv+3cXcdRHz08UmSiOob7sadHig73uo5bkXxQ/tvUs=
+golang.org/x/mod v0.40.0/go.mod h1:0/weTWkPWGBikyTWAX3dkjVztMmBA5hM0DH6BElSupE=
 golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
 golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
 google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=