fuchsia_async/
lib.rs

1// Copyright 2018 The Fuchsia Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5//! A futures-rs executor designed specifically for Fuchsia.
6//!
7//! # Example:
8//! A simple, singlethreaded print server:
9//!
10//! ```no_run
11//! #[fuchsia_async::run_singlethreaded]
12//! async fn main() {
13//!     let op = say_world();
14//!
15//!     // This println! will happen first
16//!     println!("Hello...");
17//!
18//!     // Calling `.await` on `op` starts executing `say_world`.
19//!     op.await;
20//! }
21//!
22//!
23//! async fn say_world() {
24//!     println!("...world");
25//! }
26//! ```
27
28#![warn(missing_docs)]
29#![warn(clippy::all)]
30#![deny(clippy::await_holding_lock)]
31#![deny(clippy::await_holding_refcell_ref)]
32
33mod runtime;
34pub use self::runtime::*;
35
36mod handle;
37#[cfg(target_os = "fuchsia")]
38pub use self::handle::channel::{Channel, RecvMsg};
39#[cfg(target_os = "fuchsia")]
40pub use self::handle::on_signals::OnSignalsRef;
41#[cfg(target_os = "fuchsia")]
42pub use self::handle::socket::Socket;
43
44/// Asynchronous networking abstractions.
45pub mod net;
46
47#[cfg(target_os = "fuchsia")]
48pub use self::handle::{
49    fifo::{Fifo, FifoEntry},
50    on_interrupt::OnInterrupt,
51    on_signals::OnSignals,
52    rwhandle::{
53        DefaultRWHandleSpec, RWHandle, RWHandleSpec, ReadableHandle, ReadableState, WritableHandle,
54        WritableState,
55    },
56};
57
58#[cfg(target_os = "fuchsia")]
59pub use runtime::instrument;
60
61pub use fuchsia_async_macro::{run, run_singlethreaded, run_until_stalled};
62
63pub mod condition;
64/// Testing support for repeated runs
65pub mod test_support;
fuchsia_async/lib.rs

fuchsia_async/
lib.rs
