feat(channel): Make channel feature additive (#1574)

* feat(channel): Make channel feature additive

* chore(channel): Move add_origin service module to channel module

* chore(channel): Move user_agent service to channel module

* chore(channel): Move reconnect service to channel module

* chore(channel): Move connection service to channel module

* chore(channel): Move discover service to channel module

* feat(channel): Remove unused Connected implement for BoxedIo

* chore(channel): Move channel part of io service to channel module

* chore(channel): Move channel part of tls service to channel module

* chore(channel): Move connector service to channel module

* chore(channel): Move executor service to channel module

* chore(channel): Clean up scope of channel service module

* chore(channel): Clean up importing in channel service

* chore(doc): Update feature flag document about transport and channel

Author: tottoto

examples/Cargo.toml

@@ -276,13 +276,13 @@ tracing = ["dep:tracing", "dep:tracing-subscriber"]
 uds = ["tokio-stream/net", "dep:tower", "dep:hyper", "dep:hyper-util"]
 streaming = ["tokio-stream", "dep:h2"]
 mock = ["tokio-stream", "dep:tower", "dep:hyper-util"]
-tower = ["dep:hyper", "dep:hyper-util", "dep:tower", "dep:http"]
+tower = ["dep:hyper", "dep:hyper-util", "dep:tower", "tower?/timeout", "dep:http"]
 json-codec = ["dep:serde", "dep:serde_json", "dep:bytes"]
 compression = ["tonic/gzip"]
 tls = ["tonic/tls"]
 tls-rustls = ["dep:hyper", "dep:hyper-util", "dep:hyper-rustls", "dep:tower", "tower-http/util", "tower-http/add-extension", "dep:rustls-pemfile", "dep:tokio-rustls", "dep:pin-project", "dep:http-body-util"]
 dynamic-load-balance = ["dep:tower"]
-timeout = ["tokio/time", "dep:tower"]
+timeout = ["tokio/time", "dep:tower", "tower?/timeout"]
 tls-client-auth = ["tonic/tls"]
 types = ["dep:tonic-types"]
 h2c = ["dep:hyper", "dep:tower", "dep:http", "dep:hyper-util"]

tonic/Cargo.toml

@@ -26,24 +26,29 @@ version = "0.11.0"
 codegen = ["dep:async-trait"]
 gzip = ["dep:flate2"]
 zstd = ["dep:zstd"]
-default = ["transport", "codegen", "prost"]
+default = ["channel", "codegen", "prost"]
 prost = ["dep:prost"]
 tls = ["dep:rustls-pemfile", "transport", "dep:tokio-rustls", "dep:tokio", "tokio?/rt", "tokio?/macros"]
 tls-roots = ["tls-roots-common", "dep:rustls-native-certs"]
-tls-roots-common = ["tls"]
+tls-roots-common = ["tls", "channel"]
 tls-webpki-roots = ["tls-roots-common", "dep:webpki-roots"]
 router = ["dep:axum"]
 transport = [
   "router",
   "dep:async-stream",
-  "channel",
   "dep:h2",
-  "dep:hyper", "dep:hyper-util", "dep:hyper-timeout",
+  "dep:hyper", "dep:hyper-util",
   "dep:socket2",
   "dep:tokio", "tokio?/macros", "tokio?/net", "tokio?/time",
-  "dep:tower",
+  "dep:tower", "tower?/util", "tower?/limit",
+]
+channel = [
+  "transport",
+  "dep:hyper", "hyper?/client",
+  "dep:hyper-util", "hyper-util?/client-legacy",
+  "dep:tower", "tower?/balance", "tower?/buffer", "tower?/discover", "tower?/load", "tower?/make",
+  "dep:hyper-timeout",
 ]
-channel = []
 
 # [[bench]]
 # name = "bench_main"
@@ -71,13 +76,12 @@ async-trait = {version = "0.1.13", optional = true}
 # transport
 async-stream = {version = "0.3", optional = true}
 h2 = {version = "0.4", optional = true}
-hyper = {version = "1", features = ["full"], optional = true}
-hyper-util = { version = ">=0.1.4, <0.2", features = ["full"], optional = true }
-hyper-timeout = {version = "0.5", optional = true}
+hyper = {version = "1", features = ["http1", "http2", "server"], optional = true}
+hyper-util = { version = ">=0.1.4, <0.2", features = ["service", "server-auto", "tokio"], optional = true }
 socket2 = { version = ">=0.4.7, <0.6.0", optional = true, features = ["all"] }
 tokio = {version = "1", default-features = false, optional = true}
 tokio-stream = { version = "0.1", features = ["net"] }
-tower = {version = "0.4.7", default-features = false, features = ["balance", "buffer", "discover", "limit", "load", "make", "timeout", "util"], optional = true}
+tower = {version = "0.4.7", default-features = false, optional = true}
 axum = {version = "0.7", default-features = false, optional = true}
 
 # rustls
@@ -90,6 +94,9 @@ webpki-roots = { version = "0.26", optional = true }
 flate2 = {version = "1.0", optional = true}
 zstd = { version = "0.13.0", optional = true }
 
+# channel
+hyper-timeout = {version = "0.5", optional = true}
+
 [dev-dependencies]
 bencher = "0.1.5"
 quickcheck = "1.0"

tonic/src/lib.rs

@@ -16,10 +16,9 @@
 //!
 //! # Feature Flags
 //!
-//! - `transport`: Enables the fully featured, batteries included client and server
-//!     implementation based on [`hyper`], [`tower`] and [`tokio`]. Enabled by default.
-//! - `channel`: Enables just the full featured channel/client portion of the `transport`
-//!     feature.
+//! - `transport`: Enables just the full featured server portion of the `channel` feature.
+//! - `channel`: Enables the fully featured, batteries included client and server
+//! implementation based on [`hyper`], [`tower`] and [`tokio`]. Enabled by default.
 //! - `codegen`: Enables all the required exports and optional dependencies required
 //! for [`tonic-build`]. Enabled by default.
 //! - `tls`: Enables the `rustls` based TLS options for the `transport` feature. Not

tonic/src/status.rs

@@ -617,8 +617,10 @@ fn find_status_in_source_chain(err: &(dyn Error + 'static)) -> Option<Status> {
         // matches the spec of:
         // > The service is currently unavailable. This is most likely a transient condition that
         // > can be corrected if retried with a backoff.
-        #[cfg(feature = "transport")]
-        if let Some(connect) = err.downcast_ref::<crate::transport::ConnectError>() {
+        #[cfg(feature = "channel")]
+        if let Some(connect) =
+            err.downcast_ref::<crate::transport::channel::service::ConnectError>()
+        {
             return Some(Status::unavailable(connect.to_string()));
         }
 

tonic/src/transport/channel/endpoint.rs

@@ -1,10 +1,10 @@
-use super::super::service;
+#[cfg(feature = "tls")]
+use super::service::TlsConnector;
+use super::service::{self, Executor, SharedExec};
 use super::Channel;
 #[cfg(feature = "tls")]
 use super::ClientTlsConfig;
-#[cfg(feature = "tls")]
-use crate::transport::service::TlsConnector;
-use crate::transport::{service::SharedExec, Error, Executor};
+use crate::transport::Error;
 use bytes::Bytes;
 use http::{uri::Uri, HeaderValue};
 use hyper::rt;

tonic/src/transport/channel/mod.rs

@@ -1,6 +1,7 @@
 //! Client implementation and builder.
 
 mod endpoint;
+pub(crate) mod service;
 #[cfg(feature = "tls")]
 #[cfg_attr(docsrs, doc(cfg(feature = "tls")))]
 mod tls;
@@ -9,9 +10,8 @@ pub use endpoint::Endpoint;
 #[cfg(feature = "tls")]
 pub use tls::ClientTlsConfig;
 
-use super::service::{Connection, DynamicServiceStream, SharedExec};
+use self::service::{Connection, DynamicServiceStream, Executor, SharedExec};
 use crate::body::BoxBody;
-use crate::transport::Executor;
 use bytes::Bytes;
 use http::{
     uri::{InvalidUri, Uri},

tonic/src/transport/service/add_origin.rs …/transport/channel/service/add_origin.rstonic/src/transport/service/add_origin.rs renamed to tonic/src/transport/channel/service/add_origin.rs tonic/src/transport/service/add_origin.rs renamed to tonic/src/transport/channel/service/add_origin.rs

@@ -1,8 +1,7 @@
-use super::SharedExec;
-use super::{grpc_timeout::GrpcTimeout, reconnect::Reconnect, AddOrigin, UserAgent};
+use super::{AddOrigin, Reconnect, SharedExec, UserAgent};
 use crate::{
     body::{boxed, BoxBody},
-    transport::{BoxFuture, Endpoint},
+    transport::{service::GrpcTimeout, BoxFuture, Endpoint},
 };
 use http::Uri;
 use hyper::rt;
@@ -36,7 +35,7 @@ impl Connection {
         C::Future: Unpin + Send,
         C::Response: rt::Read + rt::Write + Unpin + Send + 'static,
     {
-        let mut settings: Builder<super::SharedExec> = Builder::new(endpoint.executor.clone())
+        let mut settings: Builder<SharedExec> = Builder::new(endpoint.executor.clone())
             .initial_stream_window_size(endpoint.init_stream_window_size)
             .initial_connection_window_size(endpoint.init_connection_window_size)
             .keep_alive_interval(endpoint.http2_keep_alive_interval)
@@ -158,12 +157,12 @@ impl tower::Service<http::Request<BoxBody>> for SendRequest {
 
 struct MakeSendRequestService<C> {
     connector: C,
-    executor: super::SharedExec,
-    settings: Builder<super::SharedExec>,
+    executor: SharedExec,
+    settings: Builder<SharedExec>,
 }
 
 impl<C> MakeSendRequestService<C> {
-    fn new(connector: C, executor: SharedExec, settings: Builder<super::SharedExec>) -> Self {
+    fn new(connector: C, executor: SharedExec, settings: Builder<SharedExec>) -> Self {
         Self {
             connector,
             executor,

tonic/src/transport/service/connection.rs …/transport/channel/service/connection.rstonic/src/transport/service/connection.rs renamed to tonic/src/transport/channel/service/connection.rs tonic/src/transport/service/connection.rs renamed to tonic/src/transport/channel/service/connection.rs

@@ -1,7 +1,7 @@
-use super::super::BoxFuture;
-use super::io::BoxedIo;
+use super::BoxedIo;
 #[cfg(feature = "tls")]
-use super::tls::TlsConnector;
+use super::TlsConnector;
+use crate::transport::BoxFuture;
 use http::Uri;
 use std::fmt;
 use std::task::{Context, Poll};

tonic/src/transport/service/connector.rs …c/transport/channel/service/connector.rstonic/src/transport/service/connector.rs renamed to tonic/src/transport/channel/service/connector.rs tonic/src/transport/service/connector.rs renamed to tonic/src/transport/channel/service/connector.rs

@@ -1,5 +1,4 @@
-use super::connection::Connection;
-use crate::transport::Endpoint;
+use super::super::{Connection, Endpoint};
 
 use hyper_util::client::legacy::connect::HttpConnector;
 use std::{