async_unsync/
lib.rs

1//! **async-unsync** - Asynchronous channels for single-threaded use.
2//!
3//! This crate provides asynchronous but unsynchronized (`!Sync`) alternatives
4//! to [`tokio::sync::mpsc`][1] channel types with almost identical APIs.
5//!
6//! Using synchronized data-structures in context that are statically known to
7//! always execute on a single thread has non-trivial overhead.
8//! The specialized (and much simpler) implementations in this library are
9//! primarily intended for use in high-performance async code utilizing thread
10//! local tasks and `!Send` futures.
11//!
12//! [1]: https://docs.rs/tokio/latest/tokio/sync/mpsc/index.html
13
14#![cfg_attr(all(not(test), not(feature = "std")), no_std)]
15#![warn(clippy::inconsistent_struct_constructor)]
16#![warn(clippy::match_same_arms)]
17#![warn(clippy::missing_errors_doc)]
18#![warn(clippy::missing_panics_doc)]
19#![warn(clippy::missing_safety_doc)]
20#![warn(clippy::undocumented_unsafe_blocks)]
21#![warn(missing_docs)]
22
23#[cfg(feature = "std")]
24mod alloc {
25    pub use std::collections;
26    pub use std::rc;
27}
28
29#[cfg(all(feature = "alloc", not(feature = "std")))]
30extern crate alloc;
31
32#[cfg(feature = "alloc")]
33pub mod bounded;
34#[cfg(feature = "alloc")]
35pub mod unbounded;
36
37pub mod oneshot;
38pub mod semaphore;
39
40pub use crate::error::*;
41
42mod error;
43#[cfg(feature = "alloc")]
44mod mask;
45#[cfg(feature = "alloc")]
46mod queue;