fidl_test_fidl_connector/
fidl_test_fidl_connector.rs

Help
1// WARNING: This file is machine generated by fidlgen.
2
3#![warn(clippy::all)]
4#![allow(unused_parens, unused_mut, unused_imports, nonstandard_style)]
5
6use bitflags::bitflags;
7use fidl::client::QueryResponseFut;
8use fidl::encoding::{MessageBufFor, ProxyChannelBox, ResourceDialect};
9use fidl::endpoints::{ControlHandle as _, Responder as _};
10pub use fidl_test_fidl_connector_common::*;
11use futures::future::{self, MaybeDone, TryFutureExt};
12use zx_status;
13
14#[derive(Debug, Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash)]
15pub struct TestMarker;
16
17impl fidl::endpoints::ProtocolMarker for TestMarker {
18    type Proxy = TestProxy;
19    type RequestStream = TestRequestStream;
20    #[cfg(target_os = "fuchsia")]
21    type SynchronousProxy = TestSynchronousProxy;
22
23    const DEBUG_NAME: &'static str = "test.fidl.connector.Test";
24}
25impl fidl::endpoints::DiscoverableProtocolMarker for TestMarker {}
26
27pub trait TestProxyInterface: Send + Sync {
28    type PingResponseFut: std::future::Future<Output = Result<u32, fidl::Error>> + Send;
29    fn r#ping(&self) -> Self::PingResponseFut;
30    type DisconnectResponseFut: std::future::Future<Output = Result<(), fidl::Error>> + Send;
31    fn r#disconnect(&self) -> Self::DisconnectResponseFut;
32}
33#[derive(Debug)]
34#[cfg(target_os = "fuchsia")]
35pub struct TestSynchronousProxy {
36    client: fidl::client::sync::Client,
37}
38
39#[cfg(target_os = "fuchsia")]
40impl fidl::endpoints::SynchronousProxy for TestSynchronousProxy {
41    type Proxy = TestProxy;
42    type Protocol = TestMarker;
43
44    fn from_channel(inner: fidl::Channel) -> Self {
45        Self::new(inner)
46    }
47
48    fn into_channel(self) -> fidl::Channel {
49        self.client.into_channel()
50    }
51
52    fn as_channel(&self) -> &fidl::Channel {
53        self.client.as_channel()
54    }
55}
56
57#[cfg(target_os = "fuchsia")]
58impl TestSynchronousProxy {
59    pub fn new(channel: fidl::Channel) -> Self {
60        let protocol_name = <TestMarker as fidl::endpoints::ProtocolMarker>::DEBUG_NAME;
61        Self { client: fidl::client::sync::Client::new(channel, protocol_name) }
62    }
63
64    pub fn into_channel(self) -> fidl::Channel {
65        self.client.into_channel()
66    }
67
68    /// Waits until an event arrives and returns it. It is safe for other
69    /// threads to make concurrent requests while waiting for an event.
70    pub fn wait_for_event(&self, deadline: zx::MonotonicInstant) -> Result<TestEvent, fidl::Error> {
71        TestEvent::decode(self.client.wait_for_event(deadline)?)
72    }
73
74    pub fn r#ping(&self, ___deadline: zx::MonotonicInstant) -> Result<u32, fidl::Error> {
75        let _response = self.client.send_query::<fidl::encoding::EmptyPayload, TestPingResponse>(
76            (),
77            0x23aa1eb7d24346cf,
78            fidl::encoding::DynamicFlags::empty(),
79            ___deadline,
80        )?;
81        Ok(_response.gen)
82    }
83
84    pub fn r#disconnect(&self, ___deadline: zx::MonotonicInstant) -> Result<(), fidl::Error> {
85        let _response =
86            self.client.send_query::<fidl::encoding::EmptyPayload, fidl::encoding::EmptyPayload>(
87                (),
88                0x5a1b547382bf672e,
89                fidl::encoding::DynamicFlags::empty(),
90                ___deadline,
91            )?;
92        Ok(_response)
93    }
94}
95
96#[cfg(target_os = "fuchsia")]
97impl From<TestSynchronousProxy> for zx::Handle {
98    fn from(value: TestSynchronousProxy) -> Self {
99        value.into_channel().into()
100    }
101}
102
103#[cfg(target_os = "fuchsia")]
104impl From<fidl::Channel> for TestSynchronousProxy {
105    fn from(value: fidl::Channel) -> Self {
106        Self::new(value)
107    }
108}
109
110#[derive(Debug, Clone)]
111pub struct TestProxy {
112    client: fidl::client::Client<fidl::encoding::DefaultFuchsiaResourceDialect>,
113}
114
115impl fidl::endpoints::Proxy for TestProxy {
116    type Protocol = TestMarker;
117
118    fn from_channel(inner: ::fidl::AsyncChannel) -> Self {
119        Self::new(inner)
120    }
121
122    fn into_channel(self) -> Result<::fidl::AsyncChannel, Self> {
123        self.client.into_channel().map_err(|client| Self { client })
124    }
125
126    fn as_channel(&self) -> &::fidl::AsyncChannel {
127        self.client.as_channel()
128    }
129}
130
131impl TestProxy {
132    /// Create a new Proxy for test.fidl.connector/Test.
133    pub fn new(channel: ::fidl::AsyncChannel) -> Self {
134        let protocol_name = <TestMarker as fidl::endpoints::ProtocolMarker>::DEBUG_NAME;
135        Self { client: fidl::client::Client::new(channel, protocol_name) }
136    }
137
138    /// Get a Stream of events from the remote end of the protocol.
139    ///
140    /// # Panics
141    ///
142    /// Panics if the event stream was already taken.
143    pub fn take_event_stream(&self) -> TestEventStream {
144        TestEventStream { event_receiver: self.client.take_event_receiver() }
145    }
146
147    pub fn r#ping(
148        &self,
149    ) -> fidl::client::QueryResponseFut<u32, fidl::encoding::DefaultFuchsiaResourceDialect> {
150        TestProxyInterface::r#ping(self)
151    }
152
153    pub fn r#disconnect(
154        &self,
155    ) -> fidl::client::QueryResponseFut<(), fidl::encoding::DefaultFuchsiaResourceDialect> {
156        TestProxyInterface::r#disconnect(self)
157    }
158}
159
160impl TestProxyInterface for TestProxy {
161    type PingResponseFut =
162        fidl::client::QueryResponseFut<u32, fidl::encoding::DefaultFuchsiaResourceDialect>;
163    fn r#ping(&self) -> Self::PingResponseFut {
164        fn _decode(
165            mut _buf: Result<<fidl::encoding::DefaultFuchsiaResourceDialect as fidl::encoding::ResourceDialect>::MessageBufEtc, fidl::Error>,
166        ) -> Result<u32, fidl::Error> {
167            let _response = fidl::client::decode_transaction_body::<
168                TestPingResponse,
169                fidl::encoding::DefaultFuchsiaResourceDialect,
170                0x23aa1eb7d24346cf,
171            >(_buf?)?;
172            Ok(_response.gen)
173        }
174        self.client.send_query_and_decode::<fidl::encoding::EmptyPayload, u32>(
175            (),
176            0x23aa1eb7d24346cf,
177            fidl::encoding::DynamicFlags::empty(),
178            _decode,
179        )
180    }
181
182    type DisconnectResponseFut =
183        fidl::client::QueryResponseFut<(), fidl::encoding::DefaultFuchsiaResourceDialect>;
184    fn r#disconnect(&self) -> Self::DisconnectResponseFut {
185        fn _decode(
186            mut _buf: Result<<fidl::encoding::DefaultFuchsiaResourceDialect as fidl::encoding::ResourceDialect>::MessageBufEtc, fidl::Error>,
187        ) -> Result<(), fidl::Error> {
188            let _response = fidl::client::decode_transaction_body::<
189                fidl::encoding::EmptyPayload,
190                fidl::encoding::DefaultFuchsiaResourceDialect,
191                0x5a1b547382bf672e,
192            >(_buf?)?;
193            Ok(_response)
194        }
195        self.client.send_query_and_decode::<fidl::encoding::EmptyPayload, ()>(
196            (),
197            0x5a1b547382bf672e,
198            fidl::encoding::DynamicFlags::empty(),
199            _decode,
200        )
201    }
202}
203
204pub struct TestEventStream {
205    event_receiver: fidl::client::EventReceiver<fidl::encoding::DefaultFuchsiaResourceDialect>,
206}
207
208impl std::marker::Unpin for TestEventStream {}
209
210impl futures::stream::FusedStream for TestEventStream {
211    fn is_terminated(&self) -> bool {
212        self.event_receiver.is_terminated()
213    }
214}
215
216impl futures::Stream for TestEventStream {
217    type Item = Result<TestEvent, fidl::Error>;
218
219    fn poll_next(
220        mut self: std::pin::Pin<&mut Self>,
221        cx: &mut std::task::Context<'_>,
222    ) -> std::task::Poll<Option<Self::Item>> {
223        match futures::ready!(futures::stream::StreamExt::poll_next_unpin(
224            &mut self.event_receiver,
225            cx
226        )?) {
227            Some(buf) => std::task::Poll::Ready(Some(TestEvent::decode(buf))),
228            None => std::task::Poll::Ready(None),
229        }
230    }
231}
232
233#[derive(Debug)]
234pub enum TestEvent {}
235
236impl TestEvent {
237    /// Decodes a message buffer as a [`TestEvent`].
238    fn decode(
239        mut buf: <fidl::encoding::DefaultFuchsiaResourceDialect as fidl::encoding::ResourceDialect>::MessageBufEtc,
240    ) -> Result<TestEvent, fidl::Error> {
241        let (bytes, _handles) = buf.split_mut();
242        let (tx_header, _body_bytes) = fidl::encoding::decode_transaction_header(bytes)?;
243        debug_assert_eq!(tx_header.tx_id, 0);
244        match tx_header.ordinal {
245            _ => Err(fidl::Error::UnknownOrdinal {
246                ordinal: tx_header.ordinal,
247                protocol_name: <TestMarker as fidl::endpoints::ProtocolMarker>::DEBUG_NAME,
248            }),
249        }
250    }
251}
252
253/// A Stream of incoming requests for test.fidl.connector/Test.
254pub struct TestRequestStream {
255    inner: std::sync::Arc<fidl::ServeInner<fidl::encoding::DefaultFuchsiaResourceDialect>>,
256    is_terminated: bool,
257}
258
259impl std::marker::Unpin for TestRequestStream {}
260
261impl futures::stream::FusedStream for TestRequestStream {
262    fn is_terminated(&self) -> bool {
263        self.is_terminated
264    }
265}
266
267impl fidl::endpoints::RequestStream for TestRequestStream {
268    type Protocol = TestMarker;
269    type ControlHandle = TestControlHandle;
270
271    fn from_channel(channel: ::fidl::AsyncChannel) -> Self {
272        Self { inner: std::sync::Arc::new(fidl::ServeInner::new(channel)), is_terminated: false }
273    }
274
275    fn control_handle(&self) -> Self::ControlHandle {
276        TestControlHandle { inner: self.inner.clone() }
277    }
278
279    fn into_inner(
280        self,
281    ) -> (::std::sync::Arc<fidl::ServeInner<fidl::encoding::DefaultFuchsiaResourceDialect>>, bool)
282    {
283        (self.inner, self.is_terminated)
284    }
285
286    fn from_inner(
287        inner: std::sync::Arc<fidl::ServeInner<fidl::encoding::DefaultFuchsiaResourceDialect>>,
288        is_terminated: bool,
289    ) -> Self {
290        Self { inner, is_terminated }
291    }
292}
293
294impl futures::Stream for TestRequestStream {
295    type Item = Result<TestRequest, fidl::Error>;
296
297    fn poll_next(
298        mut self: std::pin::Pin<&mut Self>,
299        cx: &mut std::task::Context<'_>,
300    ) -> std::task::Poll<Option<Self::Item>> {
301        let this = &mut *self;
302        if this.inner.check_shutdown(cx) {
303            this.is_terminated = true;
304            return std::task::Poll::Ready(None);
305        }
306        if this.is_terminated {
307            panic!("polled TestRequestStream after completion");
308        }
309        fidl::encoding::with_tls_decode_buf::<_, fidl::encoding::DefaultFuchsiaResourceDialect>(
310            |bytes, handles| {
311                match this.inner.channel().read_etc(cx, bytes, handles) {
312                    std::task::Poll::Ready(Ok(())) => {}
313                    std::task::Poll::Pending => return std::task::Poll::Pending,
314                    std::task::Poll::Ready(Err(zx_status::Status::PEER_CLOSED)) => {
315                        this.is_terminated = true;
316                        return std::task::Poll::Ready(None);
317                    }
318                    std::task::Poll::Ready(Err(e)) => {
319                        return std::task::Poll::Ready(Some(Err(fidl::Error::ServerRequestRead(
320                            e.into(),
321                        ))))
322                    }
323                }
324
325                // A message has been received from the channel
326                let (header, _body_bytes) = fidl::encoding::decode_transaction_header(bytes)?;
327
328                std::task::Poll::Ready(Some(match header.ordinal {
329                    0x23aa1eb7d24346cf => {
330                        header.validate_request_tx_id(fidl::MethodType::TwoWay)?;
331                        let mut req = fidl::new_empty!(
332                            fidl::encoding::EmptyPayload,
333                            fidl::encoding::DefaultFuchsiaResourceDialect
334                        );
335                        fidl::encoding::Decoder::<fidl::encoding::DefaultFuchsiaResourceDialect>::decode_into::<fidl::encoding::EmptyPayload>(&header, _body_bytes, handles, &mut req)?;
336                        let control_handle = TestControlHandle { inner: this.inner.clone() };
337                        Ok(TestRequest::Ping {
338                            responder: TestPingResponder {
339                                control_handle: std::mem::ManuallyDrop::new(control_handle),
340                                tx_id: header.tx_id,
341                            },
342                        })
343                    }
344                    0x5a1b547382bf672e => {
345                        header.validate_request_tx_id(fidl::MethodType::TwoWay)?;
346                        let mut req = fidl::new_empty!(
347                            fidl::encoding::EmptyPayload,
348                            fidl::encoding::DefaultFuchsiaResourceDialect
349                        );
350                        fidl::encoding::Decoder::<fidl::encoding::DefaultFuchsiaResourceDialect>::decode_into::<fidl::encoding::EmptyPayload>(&header, _body_bytes, handles, &mut req)?;
351                        let control_handle = TestControlHandle { inner: this.inner.clone() };
352                        Ok(TestRequest::Disconnect {
353                            responder: TestDisconnectResponder {
354                                control_handle: std::mem::ManuallyDrop::new(control_handle),
355                                tx_id: header.tx_id,
356                            },
357                        })
358                    }
359                    _ => Err(fidl::Error::UnknownOrdinal {
360                        ordinal: header.ordinal,
361                        protocol_name: <TestMarker as fidl::endpoints::ProtocolMarker>::DEBUG_NAME,
362                    }),
363                }))
364            },
365        )
366    }
367}
368
369#[derive(Debug)]
370pub enum TestRequest {
371    Ping { responder: TestPingResponder },
372    Disconnect { responder: TestDisconnectResponder },
373}
374
375impl TestRequest {
376    #[allow(irrefutable_let_patterns)]
377    pub fn into_ping(self) -> Option<(TestPingResponder)> {
378        if let TestRequest::Ping { responder } = self {
379            Some((responder))
380        } else {
381            None
382        }
383    }
384
385    #[allow(irrefutable_let_patterns)]
386    pub fn into_disconnect(self) -> Option<(TestDisconnectResponder)> {
387        if let TestRequest::Disconnect { responder } = self {
388            Some((responder))
389        } else {
390            None
391        }
392    }
393
394    /// Name of the method defined in FIDL
395    pub fn method_name(&self) -> &'static str {
396        match *self {
397            TestRequest::Ping { .. } => "ping",
398            TestRequest::Disconnect { .. } => "disconnect",
399        }
400    }
401}
402
403#[derive(Debug, Clone)]
404pub struct TestControlHandle {
405    inner: std::sync::Arc<fidl::ServeInner<fidl::encoding::DefaultFuchsiaResourceDialect>>,
406}
407
408impl fidl::endpoints::ControlHandle for TestControlHandle {
409    fn shutdown(&self) {
410        self.inner.shutdown()
411    }
412    fn shutdown_with_epitaph(&self, status: zx_status::Status) {
413        self.inner.shutdown_with_epitaph(status)
414    }
415
416    fn is_closed(&self) -> bool {
417        self.inner.channel().is_closed()
418    }
419    fn on_closed(&self) -> fidl::OnSignalsRef<'_> {
420        self.inner.channel().on_closed()
421    }
422
423    #[cfg(target_os = "fuchsia")]
424    fn signal_peer(
425        &self,
426        clear_mask: zx::Signals,
427        set_mask: zx::Signals,
428    ) -> Result<(), zx_status::Status> {
429        use fidl::Peered;
430        self.inner.channel().signal_peer(clear_mask, set_mask)
431    }
432}
433
434impl TestControlHandle {}
435
436#[must_use = "FIDL methods require a response to be sent"]
437#[derive(Debug)]
438pub struct TestPingResponder {
439    control_handle: std::mem::ManuallyDrop<TestControlHandle>,
440    tx_id: u32,
441}
442
443/// Set the the channel to be shutdown (see [`TestControlHandle::shutdown`])
444/// if the responder is dropped without sending a response, so that the client
445/// doesn't hang. To prevent this behavior, call `drop_without_shutdown`.
446impl std::ops::Drop for TestPingResponder {
447    fn drop(&mut self) {
448        self.control_handle.shutdown();
449        // Safety: drops once, never accessed again
450        unsafe { std::mem::ManuallyDrop::drop(&mut self.control_handle) };
451    }
452}
453
454impl fidl::endpoints::Responder for TestPingResponder {
455    type ControlHandle = TestControlHandle;
456
457    fn control_handle(&self) -> &TestControlHandle {
458        &self.control_handle
459    }
460
461    fn drop_without_shutdown(mut self) {
462        // Safety: drops once, never accessed again due to mem::forget
463        unsafe { std::mem::ManuallyDrop::drop(&mut self.control_handle) };
464        // Prevent Drop from running (which would shut down the channel)
465        std::mem::forget(self);
466    }
467}
468
469impl TestPingResponder {
470    /// Sends a response to the FIDL transaction.
471    ///
472    /// Sets the channel to shutdown if an error occurs.
473    pub fn send(self, mut gen: u32) -> Result<(), fidl::Error> {
474        let _result = self.send_raw(gen);
475        if _result.is_err() {
476            self.control_handle.shutdown();
477        }
478        self.drop_without_shutdown();
479        _result
480    }
481
482    /// Similar to "send" but does not shutdown the channel if an error occurs.
483    pub fn send_no_shutdown_on_err(self, mut gen: u32) -> Result<(), fidl::Error> {
484        let _result = self.send_raw(gen);
485        self.drop_without_shutdown();
486        _result
487    }
488
489    fn send_raw(&self, mut gen: u32) -> Result<(), fidl::Error> {
490        self.control_handle.inner.send::<TestPingResponse>(
491            (gen,),
492            self.tx_id,
493            0x23aa1eb7d24346cf,
494            fidl::encoding::DynamicFlags::empty(),
495        )
496    }
497}
498
499#[must_use = "FIDL methods require a response to be sent"]
500#[derive(Debug)]
501pub struct TestDisconnectResponder {
502    control_handle: std::mem::ManuallyDrop<TestControlHandle>,
503    tx_id: u32,
504}
505
506/// Set the the channel to be shutdown (see [`TestControlHandle::shutdown`])
507/// if the responder is dropped without sending a response, so that the client
508/// doesn't hang. To prevent this behavior, call `drop_without_shutdown`.
509impl std::ops::Drop for TestDisconnectResponder {
510    fn drop(&mut self) {
511        self.control_handle.shutdown();
512        // Safety: drops once, never accessed again
513        unsafe { std::mem::ManuallyDrop::drop(&mut self.control_handle) };
514    }
515}
516
517impl fidl::endpoints::Responder for TestDisconnectResponder {
518    type ControlHandle = TestControlHandle;
519
520    fn control_handle(&self) -> &TestControlHandle {
521        &self.control_handle
522    }
523
524    fn drop_without_shutdown(mut self) {
525        // Safety: drops once, never accessed again due to mem::forget
526        unsafe { std::mem::ManuallyDrop::drop(&mut self.control_handle) };
527        // Prevent Drop from running (which would shut down the channel)
528        std::mem::forget(self);
529    }
530}
531
532impl TestDisconnectResponder {
533    /// Sends a response to the FIDL transaction.
534    ///
535    /// Sets the channel to shutdown if an error occurs.
536    pub fn send(self) -> Result<(), fidl::Error> {
537        let _result = self.send_raw();
538        if _result.is_err() {
539            self.control_handle.shutdown();
540        }
541        self.drop_without_shutdown();
542        _result
543    }
544
545    /// Similar to "send" but does not shutdown the channel if an error occurs.
546    pub fn send_no_shutdown_on_err(self) -> Result<(), fidl::Error> {
547        let _result = self.send_raw();
548        self.drop_without_shutdown();
549        _result
550    }
551
552    fn send_raw(&self) -> Result<(), fidl::Error> {
553        self.control_handle.inner.send::<fidl::encoding::EmptyPayload>(
554            (),
555            self.tx_id,
556            0x5a1b547382bf672e,
557            fidl::encoding::DynamicFlags::empty(),
558        )
559    }
560}
561
562mod internal {
563    use super::*;
564}
fidl_test_fidl_connector/fidl_test_fidl_connector.rs

fidl_test_fidl_connector/
fidl_test_fidl_connector.rs
