fluxion-stream 0.8.0

Stream combinators with ordering guarantees for async Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

// Copyright 2025 Umberto Gotti <umberto.gotti@umbertogotti.dev>
// Licensed under the Apache License, Version 2.0
// http://www.apache.org/licenses/LICENSE-2.0

//! Extension trait to convert futures channels into fluxion streams.
//!
//! This module provides [`IntoFluxionStream`] which wraps a futures `UnboundedReceiver`
//! (from `async-channel`) into a stream that emits [`StreamItem::Value`](fluxion_core::StreamItem::Value) for each received item.
//!
//! # Basic Usage
//!
//! ```rust
//! use fluxion_stream::IntoFluxionStream;
//! use async_channel::unbounded;
//!
//! # #[tokio::main]
//! # async fn main() {
//! let (tx, rx) = unbounded::<i32>();
//! let stream = rx.into_fluxion_stream();
//! # }
//! ```
//!
//! # Mapping
//!
//! You can also map values directly during conversion:
//!
//! ```rust
//! use fluxion_stream::IntoFluxionStream;
//! use fluxion_test_utils::Sequenced;
//! use async_channel::unbounded;
//!
//! # #[tokio::main]
//! # async fn main() {
//! let (tx, rx) = unbounded::<i32>();
//! // Convert i32 items to Sequenced<i32>
//! let stream = rx.into_fluxion_stream_map(|val| Sequenced::new(val));
//! # }
//! ```

#[macro_use]
mod implementation;

#[cfg(any(
    all(feature = "runtime-tokio", not(target_arch = "wasm32")),
    feature = "runtime-smol",
    feature = "runtime-async-std"
))]
mod multi_threaded;

#[cfg(any(
    all(feature = "runtime-tokio", not(target_arch = "wasm32")),
    feature = "runtime-smol",
    feature = "runtime-async-std"
))]
pub use multi_threaded::IntoFluxionStream;

#[cfg(all(
    not(any(
        all(feature = "runtime-tokio", not(target_arch = "wasm32")),
        feature = "runtime-smol",
        feature = "runtime-async-std"
    )),
    any(
        feature = "runtime-wasm",
        feature = "runtime-embassy",
        target_arch = "wasm32",
        feature = "alloc"
    )
))]
mod single_threaded;

#[cfg(all(
    not(any(
        all(feature = "runtime-tokio", not(target_arch = "wasm32")),
        feature = "runtime-smol",
        feature = "runtime-async-std"
    )),
    any(
        feature = "runtime-wasm",
        feature = "runtime-embassy",
        target_arch = "wasm32",
        feature = "alloc"
    )
))]
pub use single_threaded::IntoFluxionStream;