miku_hyper/client/conn/
http2.rs

1//! HTTP/2 client connections
2
3use std::error::Error;
4use std::fmt;
5use std::future::Future;
6use std::marker::PhantomData;
7use std::pin::Pin;
8use std::sync::Arc;
9use std::task::{Context, Poll};
10use std::time::Duration;
11
12use crate::rt::{Read, Write};
13use futures_util::ready;
14use http::{Request, Response};
15
16use super::super::dispatch::{self, TrySendError};
17use crate::body::{Body, Incoming as IncomingBody};
18use crate::common::time::Time;
19use crate::proto;
20use crate::rt::bounds::Http2ClientConnExec;
21use crate::rt::Timer;
22
23/// The sender side of an established connection.
24pub struct SendRequest<B> {
25    dispatch: dispatch::UnboundedSender<Request<B>, Response<IncomingBody>>,
26}
27
28impl<B> Clone for SendRequest<B> {
29    fn clone(&self) -> SendRequest<B> {
30        SendRequest {
31            dispatch: self.dispatch.clone(),
32        }
33    }
34}
35
36/// A future that processes all HTTP state for the IO object.
37///
38/// In most cases, this should just be spawned into an executor, so that it
39/// can process incoming and outgoing messages, notice hangups, and the like.
40///
41/// Instances of this type are typically created via the [`handshake`] function
42#[must_use = "futures do nothing unless polled"]
43pub struct Connection<T, B, E>
44where
45    T: Read + Write + Unpin,
46    B: Body + 'static,
47    E: Http2ClientConnExec<B, T> + Unpin,
48    B::Error: Into<Box<dyn Error + Send + Sync>>,
49{
50    inner: (PhantomData<T>, proto::h2::ClientTask<B, E, T>),
51}
52
53/// A builder to configure an HTTP connection.
54///
55/// After setting options, the builder is used to create a handshake future.
56///
57/// **Note**: The default values of options are *not considered stable*. They
58/// are subject to change at any time.
59#[derive(Clone, Debug)]
60pub struct Builder<Ex> {
61    pub(super) exec: Ex,
62    pub(super) timer: Time,
63    h2_builder: proto::h2::client::Config,
64}
65
66/// Returns a handshake future over some IO.
67///
68/// This is a shortcut for `Builder::new(exec).handshake(io)`.
69/// See [`client::conn`](crate::client::conn) for more.
70pub async fn handshake<E, T, B>(
71    exec: E,
72    io: T,
73) -> crate::Result<(SendRequest<B>, Connection<T, B, E>)>
74where
75    T: Read + Write + Unpin,
76    B: Body + 'static,
77    B::Data: Send,
78    B::Error: Into<Box<dyn Error + Send + Sync>>,
79    E: Http2ClientConnExec<B, T> + Unpin + Clone,
80{
81    Builder::new(exec).handshake(io).await
82}
83
84// ===== impl SendRequest
85
86impl<B> SendRequest<B> {
87    /// Polls to determine whether this sender can be used yet for a request.
88    ///
89    /// If the associated connection is closed, this returns an Error.
90    pub fn poll_ready(&mut self, _cx: &mut Context<'_>) -> Poll<crate::Result<()>> {
91        if self.is_closed() {
92            Poll::Ready(Err(crate::Error::new_closed()))
93        } else {
94            Poll::Ready(Ok(()))
95        }
96    }
97
98    /// Waits until the dispatcher is ready
99    ///
100    /// If the associated connection is closed, this returns an Error.
101    pub async fn ready(&mut self) -> crate::Result<()> {
102        futures_util::future::poll_fn(|cx| self.poll_ready(cx)).await
103    }
104
105    /// Checks if the connection is currently ready to send a request.
106    ///
107    /// # Note
108    ///
109    /// This is mostly a hint. Due to inherent latency of networks, it is
110    /// possible that even after checking this is ready, sending a request
111    /// may still fail because the connection was closed in the meantime.
112    pub fn is_ready(&self) -> bool {
113        self.dispatch.is_ready()
114    }
115
116    /// Checks if the connection side has been closed.
117    pub fn is_closed(&self) -> bool {
118        self.dispatch.is_closed()
119    }
120}
121
122impl<B> SendRequest<B>
123where
124    B: Body + 'static,
125{
126    /// Sends a `Request` on the associated connection.
127    ///
128    /// Returns a future that if successful, yields the `Response`.
129    ///
130    /// `req` must have a `Host` header.
131    ///
132    /// Absolute-form `Uri`s are not required. If received, they will be serialized
133    /// as-is.
134    pub fn send_request(
135        &mut self,
136        req: Request<B>,
137    ) -> impl Future<Output = crate::Result<Response<IncomingBody>>> {
138        let sent = self.dispatch.send(req);
139
140        async move {
141            match sent {
142                Ok(rx) => match rx.await {
143                    Ok(Ok(resp)) => Ok(resp),
144                    Ok(Err(err)) => Err(err),
145                    // this is definite bug if it happens, but it shouldn't happen!
146                    Err(_canceled) => panic!("dispatch dropped without returning error"),
147                },
148                Err(_req) => {
149                    debug!("connection was not ready");
150
151                    Err(crate::Error::new_canceled().with("connection was not ready"))
152                }
153            }
154        }
155    }
156
157    /// Sends a `Request` on the associated connection.
158    ///
159    /// Returns a future that if successful, yields the `Response`.
160    ///
161    /// # Error
162    ///
163    /// If there was an error before trying to serialize the request to the
164    /// connection, the message will be returned as part of this error.
165    pub fn try_send_request(
166        &mut self,
167        req: Request<B>,
168    ) -> impl Future<Output = Result<Response<IncomingBody>, TrySendError<Request<B>>>> {
169        let sent = self.dispatch.try_send(req);
170        async move {
171            match sent {
172                Ok(rx) => match rx.await {
173                    Ok(Ok(res)) => Ok(res),
174                    Ok(Err(err)) => Err(err),
175                    // this is definite bug if it happens, but it shouldn't happen!
176                    Err(_) => panic!("dispatch dropped without returning error"),
177                },
178                Err(req) => {
179                    debug!("connection was not ready");
180                    let error = crate::Error::new_canceled().with("connection was not ready");
181                    Err(TrySendError {
182                        error,
183                        message: Some(req),
184                    })
185                }
186            }
187        }
188    }
189}
190
191impl<B> fmt::Debug for SendRequest<B> {
192    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
193        f.debug_struct("SendRequest").finish()
194    }
195}
196
197// ===== impl Connection
198
199impl<T, B, E> Connection<T, B, E>
200where
201    T: Read + Write + Unpin + 'static,
202    B: Body + Unpin + 'static,
203    B::Data: Send,
204    B::Error: Into<Box<dyn Error + Send + Sync>>,
205    E: Http2ClientConnExec<B, T> + Unpin,
206{
207    /// Returns whether the [extended CONNECT protocol][1] is enabled or not.
208    ///
209    /// This setting is configured by the server peer by sending the
210    /// [`SETTINGS_ENABLE_CONNECT_PROTOCOL` parameter][2] in a `SETTINGS` frame.
211    /// This method returns the currently acknowledged value received from the
212    /// remote.
213    ///
214    /// [1]: https://datatracker.ietf.org/doc/html/rfc8441#section-4
215    /// [2]: https://datatracker.ietf.org/doc/html/rfc8441#section-3
216    pub fn is_extended_connect_protocol_enabled(&self) -> bool {
217        self.inner.1.is_extended_connect_protocol_enabled()
218    }
219}
220
221impl<T, B, E> fmt::Debug for Connection<T, B, E>
222where
223    T: Read + Write + fmt::Debug + 'static + Unpin,
224    B: Body + 'static,
225    E: Http2ClientConnExec<B, T> + Unpin,
226    B::Error: Into<Box<dyn Error + Send + Sync>>,
227{
228    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
229        f.debug_struct("Connection").finish()
230    }
231}
232
233impl<T, B, E> Future for Connection<T, B, E>
234where
235    T: Read + Write + Unpin + 'static,
236    B: Body + 'static + Unpin,
237    B::Data: Send,
238    E: Unpin,
239    B::Error: Into<Box<dyn Error + Send + Sync>>,
240    E: Http2ClientConnExec<B, T> + Unpin,
241{
242    type Output = crate::Result<()>;
243
244    fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> {
245        match ready!(Pin::new(&mut self.inner.1).poll(cx))? {
246            proto::Dispatched::Shutdown => Poll::Ready(Ok(())),
247            #[cfg(feature = "http1")]
248            proto::Dispatched::Upgrade(_pending) => unreachable!("http2 cannot upgrade"),
249        }
250    }
251}
252
253// ===== impl Builder
254
255impl<Ex> Builder<Ex>
256where
257    Ex: Clone,
258{
259    /// Creates a new connection builder.
260    #[inline]
261    pub fn new(exec: Ex) -> Builder<Ex> {
262        Builder {
263            exec,
264            timer: Time::Empty,
265            h2_builder: Default::default(),
266        }
267    }
268
269    /// Provide a timer to execute background HTTP2 tasks.
270    pub fn timer<M>(&mut self, timer: M) -> &mut Builder<Ex>
271    where
272        M: Timer + Send + Sync + 'static,
273    {
274        self.timer = Time::Timer(Arc::new(timer));
275        self
276    }
277
278    /// Sets the [`SETTINGS_INITIAL_WINDOW_SIZE`][spec] option for HTTP2
279    /// stream-level flow control.
280    ///
281    /// Passing `None` will do nothing.
282    ///
283    /// If not set, hyper will use a default.
284    ///
285    /// [spec]: https://httpwg.org/specs/rfc9113.html#SETTINGS_INITIAL_WINDOW_SIZE
286    pub fn initial_stream_window_size(&mut self, sz: impl Into<Option<u32>>) -> &mut Self {
287        if let Some(sz) = sz.into() {
288            self.h2_builder.adaptive_window = false;
289            self.h2_builder.initial_stream_window_size = sz;
290        }
291        self
292    }
293
294    /// Sets the max connection-level flow control for HTTP2
295    ///
296    /// Passing `None` will do nothing.
297    ///
298    /// If not set, hyper will use a default.
299    pub fn initial_connection_window_size(&mut self, sz: impl Into<Option<u32>>) -> &mut Self {
300        if let Some(sz) = sz.into() {
301            self.h2_builder.adaptive_window = false;
302            self.h2_builder.initial_conn_window_size = sz;
303        }
304        self
305    }
306
307    /// Sets the initial maximum of locally initiated (send) streams.
308    ///
309    /// This value will be overwritten by the value included in the initial
310    /// SETTINGS frame received from the peer as part of a [connection preface].
311    ///
312    /// Passing `None` will do nothing.
313    ///
314    /// If not set, hyper will use a default.
315    ///
316    /// [connection preface]: https://httpwg.org/specs/rfc9113.html#preface
317    pub fn initial_max_send_streams(&mut self, initial: impl Into<Option<usize>>) -> &mut Self {
318        if let Some(initial) = initial.into() {
319            self.h2_builder.initial_max_send_streams = initial;
320        }
321        self
322    }
323
324    /// Sets whether to use an adaptive flow control.
325    ///
326    /// Enabling this will override the limits set in
327    /// `initial_stream_window_size` and
328    /// `initial_connection_window_size`.
329    pub fn adaptive_window(&mut self, enabled: bool) -> &mut Self {
330        use proto::h2::SPEC_WINDOW_SIZE;
331
332        self.h2_builder.adaptive_window = enabled;
333        if enabled {
334            self.h2_builder.initial_conn_window_size = SPEC_WINDOW_SIZE;
335            self.h2_builder.initial_stream_window_size = SPEC_WINDOW_SIZE;
336        }
337        self
338    }
339
340    /// Sets the maximum frame size to use for HTTP2.
341    ///
342    /// Default is currently 16KB, but can change.
343    pub fn max_frame_size(&mut self, sz: impl Into<Option<u32>>) -> &mut Self {
344        self.h2_builder.max_frame_size = sz.into();
345        self
346    }
347
348    /// Sets the max size of received header frames.
349    ///
350    /// Default is currently 16KB, but can change.
351    pub fn max_header_list_size(&mut self, max: u32) -> &mut Self {
352        self.h2_builder.max_header_list_size = max;
353        self
354    }
355
356    /// Sets the header table size.
357    ///
358    /// This setting informs the peer of the maximum size of the header compression
359    /// table used to encode header blocks, in octets. The encoder may select any value
360    /// equal to or less than the header table size specified by the sender.
361    ///
362    /// The default value of crate `h2` is 4,096.
363    pub fn header_table_size(&mut self, size: impl Into<Option<u32>>) -> &mut Self {
364        self.h2_builder.header_table_size = size.into();
365        self
366    }
367
368    /// Sets the maximum number of concurrent streams.
369    ///
370    /// The maximum concurrent streams setting only controls the maximum number
371    /// of streams that can be initiated by the remote peer. In other words,
372    /// when this setting is set to 100, this does not limit the number of
373    /// concurrent streams that can be created by the caller.
374    ///
375    /// It is recommended that this value be no smaller than 100, so as to not
376    /// unnecessarily limit parallelism. However, any value is legal, including
377    /// 0. If `max` is set to 0, then the remote will not be permitted to
378    /// initiate streams.
379    ///
380    /// Note that streams in the reserved state, i.e., push promises that have
381    /// been reserved but the stream has not started, do not count against this
382    /// setting.
383    ///
384    /// Also note that if the remote *does* exceed the value set here, it is not
385    /// a protocol level error. Instead, the `h2` library will immediately reset
386    /// the stream.
387    ///
388    /// See [Section 5.1.2] in the HTTP/2 spec for more details.
389    ///
390    /// [Section 5.1.2]: https://http2.github.io/http2-spec/#rfc.section.5.1.2
391    pub fn max_concurrent_streams(&mut self, max: impl Into<Option<u32>>) -> &mut Self {
392        self.h2_builder.max_concurrent_streams = max.into();
393        self
394    }
395
396    /// Sets an interval for HTTP2 Ping frames should be sent to keep a
397    /// connection alive.
398    ///
399    /// Pass `None` to disable HTTP2 keep-alive.
400    ///
401    /// Default is currently disabled.
402    pub fn keep_alive_interval(&mut self, interval: impl Into<Option<Duration>>) -> &mut Self {
403        self.h2_builder.keep_alive_interval = interval.into();
404        self
405    }
406
407    /// Sets a timeout for receiving an acknowledgement of the keep-alive ping.
408    ///
409    /// If the ping is not acknowledged within the timeout, the connection will
410    /// be closed. Does nothing if `keep_alive_interval` is disabled.
411    ///
412    /// Default is 20 seconds.
413    pub fn keep_alive_timeout(&mut self, timeout: Duration) -> &mut Self {
414        self.h2_builder.keep_alive_timeout = timeout;
415        self
416    }
417
418    /// Sets whether HTTP2 keep-alive should apply while the connection is idle.
419    ///
420    /// If disabled, keep-alive pings are only sent while there are open
421    /// request/responses streams. If enabled, pings are also sent when no
422    /// streams are active. Does nothing if `keep_alive_interval` is
423    /// disabled.
424    ///
425    /// Default is `false`.
426    pub fn keep_alive_while_idle(&mut self, enabled: bool) -> &mut Self {
427        self.h2_builder.keep_alive_while_idle = enabled;
428        self
429    }
430
431    /// Sets the maximum number of HTTP2 concurrent locally reset streams.
432    ///
433    /// See the documentation of [`h2::client::Builder::max_concurrent_reset_streams`] for more
434    /// details.
435    ///
436    /// The default value is determined by the `h2` crate.
437    ///
438    /// [`h2::client::Builder::max_concurrent_reset_streams`]: https://docs.rs/h2/client/struct.Builder.html#method.max_concurrent_reset_streams
439    pub fn max_concurrent_reset_streams(&mut self, max: usize) -> &mut Self {
440        self.h2_builder.max_concurrent_reset_streams = Some(max);
441        self
442    }
443
444    /// Set the maximum write buffer size for each HTTP/2 stream.
445    ///
446    /// Default is currently 1MB, but may change.
447    ///
448    /// # Panics
449    ///
450    /// The value must be no larger than `u32::MAX`.
451    pub fn max_send_buf_size(&mut self, max: usize) -> &mut Self {
452        assert!(max <= u32::MAX as usize);
453        self.h2_builder.max_send_buffer_size = max;
454        self
455    }
456
457    /// Configures the maximum number of pending reset streams allowed before a GOAWAY will be sent.
458    ///
459    /// This will default to the default value set by the [`h2` crate](https://crates.io/crates/h2).
460    /// As of v0.4.0, it is 20.
461    ///
462    /// See <https://github.com/hyperium/hyper/issues/2877> for more information.
463    pub fn max_pending_accept_reset_streams(&mut self, max: impl Into<Option<usize>>) -> &mut Self {
464        self.h2_builder.max_pending_accept_reset_streams = max.into();
465        self
466    }
467
468    /// Enables or disables server push promises.
469    ///
470    /// This value is included in the initial SETTINGS handshake.
471    /// Setting this value to value to
472    /// false in the initial SETTINGS handshake guarantees that the remote server
473    /// will never send a push promise.
474    ///
475    /// This setting can be changed during the life of a single HTTP/2
476    /// connection by sending another settings frame updating the value.
477    ///
478    /// Default value of crate `h2`: `true`.
479    pub fn enable_push(&mut self, enabled: bool) -> &mut Self {
480        self.h2_builder.enable_push = enabled;
481        self
482    }
483
484    /// Sets the `Headers` frame pseudo order.
485    ///
486    /// The pseudo header order setting controls the order of pseudo headers in the
487    /// serialized HTTP/2 headers. The default value is `None`, which means that
488    /// we let the `miku-h2` crate decide the order.
489    pub fn headers_frame_pseudo_order(
490        &mut self,
491        order: impl Into<Option<&'static [crate::ext::PseudoType; 4]>>,
492    ) -> &mut Self {
493        self.h2_builder.headers_frame_pseudo_order = order.into();
494        self
495    }
496
497    /// Sets the `Headers` frame priority.
498    pub fn headers_frame_priority(
499        &mut self,
500        priority: impl Into<Option<crate::ext::FrameStreamDependency>>,
501    ) -> &mut Self {
502        self.h2_builder.headers_frame_priority = priority.into();
503        self
504    }
505
506    /// Sets the `Priority` frames (settings) for virtual streams.
507    pub fn virtual_streams_priorities(
508        &mut self,
509        priorities: impl Into<Option<&'static [crate::ext::FramePriority]>>,
510    ) -> &mut Self {
511        self.h2_builder.virtual_streams_priorities = priorities.into();
512        self
513    }
514
515    /// Constructs a connection with the configured options and IO.
516    /// See [`client::conn`](crate::client::conn) for more.
517    ///
518    /// Note, if [`Connection`] is not `await`-ed, [`SendRequest`] will
519    /// do nothing.
520    pub fn handshake<T, B>(
521        &self,
522        io: T,
523    ) -> impl Future<Output = crate::Result<(SendRequest<B>, Connection<T, B, Ex>)>>
524    where
525        T: Read + Write + Unpin,
526        B: Body + 'static,
527        B::Data: Send,
528        B::Error: Into<Box<dyn Error + Send + Sync>>,
529        Ex: Http2ClientConnExec<B, T> + Unpin,
530    {
531        let opts = self.clone();
532
533        async move {
534            trace!("client handshake HTTP/2");
535
536            let (tx, rx) = dispatch::channel();
537            let h2 = proto::h2::client::handshake(io, rx, &opts.h2_builder, opts.exec, opts.timer)
538                .await?;
539            Ok((
540                SendRequest {
541                    dispatch: tx.unbound(),
542                },
543                Connection {
544                    inner: (PhantomData, h2),
545                },
546            ))
547        }
548    }
549}
550
551#[cfg(test)]
552mod tests {
553
554    #[tokio::test]
555    #[ignore] // only compilation is checked
556    async fn send_sync_executor_of_non_send_futures() {
557        #[derive(Clone)]
558        struct LocalTokioExecutor;
559
560        impl<F> crate::rt::Executor<F> for LocalTokioExecutor
561        where
562            F: std::future::Future + 'static, // not requiring `Send`
563        {
564            fn execute(&self, fut: F) {
565                // This will spawn into the currently running `LocalSet`.
566                tokio::task::spawn_local(fut);
567            }
568        }
569
570        #[allow(unused)]
571        async fn run(io: impl crate::rt::Read + crate::rt::Write + Unpin + 'static) {
572            let (_sender, conn) = crate::client::conn::http2::handshake::<
573                _,
574                _,
575                http_body_util::Empty<bytes::Bytes>,
576            >(LocalTokioExecutor, io)
577            .await
578            .unwrap();
579
580            tokio::task::spawn_local(async move {
581                conn.await.unwrap();
582            });
583        }
584    }
585
586    #[tokio::test]
587    #[ignore] // only compilation is checked
588    async fn not_send_not_sync_executor_of_not_send_futures() {
589        #[derive(Clone)]
590        struct LocalTokioExecutor {
591            _x: std::marker::PhantomData<std::rc::Rc<()>>,
592        }
593
594        impl<F> crate::rt::Executor<F> for LocalTokioExecutor
595        where
596            F: std::future::Future + 'static, // not requiring `Send`
597        {
598            fn execute(&self, fut: F) {
599                // This will spawn into the currently running `LocalSet`.
600                tokio::task::spawn_local(fut);
601            }
602        }
603
604        #[allow(unused)]
605        async fn run(io: impl crate::rt::Read + crate::rt::Write + Unpin + 'static) {
606            let (_sender, conn) =
607                crate::client::conn::http2::handshake::<_, _, http_body_util::Empty<bytes::Bytes>>(
608                    LocalTokioExecutor {
609                        _x: Default::default(),
610                    },
611                    io,
612                )
613                .await
614                .unwrap();
615
616            tokio::task::spawn_local(async move {
617                conn.await.unwrap();
618            });
619        }
620    }
621
622    #[tokio::test]
623    #[ignore] // only compilation is checked
624    async fn send_not_sync_executor_of_not_send_futures() {
625        #[derive(Clone)]
626        struct LocalTokioExecutor {
627            _x: std::marker::PhantomData<std::cell::Cell<()>>,
628        }
629
630        impl<F> crate::rt::Executor<F> for LocalTokioExecutor
631        where
632            F: std::future::Future + 'static, // not requiring `Send`
633        {
634            fn execute(&self, fut: F) {
635                // This will spawn into the currently running `LocalSet`.
636                tokio::task::spawn_local(fut);
637            }
638        }
639
640        #[allow(unused)]
641        async fn run(io: impl crate::rt::Read + crate::rt::Write + Unpin + 'static) {
642            let (_sender, conn) =
643                crate::client::conn::http2::handshake::<_, _, http_body_util::Empty<bytes::Bytes>>(
644                    LocalTokioExecutor {
645                        _x: Default::default(),
646                    },
647                    io,
648                )
649                .await
650                .unwrap();
651
652            tokio::task::spawn_local(async move {
653                conn.await.unwrap();
654            });
655        }
656    }
657
658    #[tokio::test]
659    #[ignore] // only compilation is checked
660    async fn send_sync_executor_of_send_futures() {
661        #[derive(Clone)]
662        struct TokioExecutor;
663
664        impl<F> crate::rt::Executor<F> for TokioExecutor
665        where
666            F: std::future::Future + 'static + Send,
667            F::Output: Send + 'static,
668        {
669            fn execute(&self, fut: F) {
670                tokio::task::spawn(fut);
671            }
672        }
673
674        #[allow(unused)]
675        async fn run(io: impl crate::rt::Read + crate::rt::Write + Send + Unpin + 'static) {
676            let (_sender, conn) = crate::client::conn::http2::handshake::<
677                _,
678                _,
679                http_body_util::Empty<bytes::Bytes>,
680            >(TokioExecutor, io)
681            .await
682            .unwrap();
683
684            tokio::task::spawn(async move {
685                conn.await.unwrap();
686            });
687        }
688    }
689
690    #[tokio::test]
691    #[ignore] // only compilation is checked
692    async fn not_send_not_sync_executor_of_send_futures() {
693        #[derive(Clone)]
694        struct TokioExecutor {
695            // !Send, !Sync
696            _x: std::marker::PhantomData<std::rc::Rc<()>>,
697        }
698
699        impl<F> crate::rt::Executor<F> for TokioExecutor
700        where
701            F: std::future::Future + 'static + Send,
702            F::Output: Send + 'static,
703        {
704            fn execute(&self, fut: F) {
705                tokio::task::spawn(fut);
706            }
707        }
708
709        #[allow(unused)]
710        async fn run(io: impl crate::rt::Read + crate::rt::Write + Send + Unpin + 'static) {
711            let (_sender, conn) =
712                crate::client::conn::http2::handshake::<_, _, http_body_util::Empty<bytes::Bytes>>(
713                    TokioExecutor {
714                        _x: Default::default(),
715                    },
716                    io,
717                )
718                .await
719                .unwrap();
720
721            tokio::task::spawn_local(async move {
722                // can't use spawn here because when executor is !Send
723                conn.await.unwrap();
724            });
725        }
726    }
727
728    #[tokio::test]
729    #[ignore] // only compilation is checked
730    async fn send_not_sync_executor_of_send_futures() {
731        #[derive(Clone)]
732        struct TokioExecutor {
733            // !Sync
734            _x: std::marker::PhantomData<std::cell::Cell<()>>,
735        }
736
737        impl<F> crate::rt::Executor<F> for TokioExecutor
738        where
739            F: std::future::Future + 'static + Send,
740            F::Output: Send + 'static,
741        {
742            fn execute(&self, fut: F) {
743                tokio::task::spawn(fut);
744            }
745        }
746
747        #[allow(unused)]
748        async fn run(io: impl crate::rt::Read + crate::rt::Write + Send + Unpin + 'static) {
749            let (_sender, conn) =
750                crate::client::conn::http2::handshake::<_, _, http_body_util::Empty<bytes::Bytes>>(
751                    TokioExecutor {
752                        _x: Default::default(),
753                    },
754                    io,
755                )
756                .await
757                .unwrap();
758
759            tokio::task::spawn_local(async move {
760                // can't use spawn here because when executor is !Send
761                conn.await.unwrap();
762            });
763        }
764    }
765}
miku_hyper/client/conn/http2.rs

miku_hyper/client/conn/
http2.rs
