feagi-structures 0.0.10

The most core library, defines the basic data types used by FEAGI, as well as some processors to modify them
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

/// Generate a platform-specific async main entry point.
///
/// This macro creates the appropriate `main` function with the correct
/// async runtime attribute for the enabled platform feature.
///
/// # Usage
///
/// ```ignore
/// use feagi_structures::async::FeagiAsyncRuntime;
///
/// // Your application logic - platform agnostic
/// async fn run_application<R: FeagiAsyncRuntime>(runtime: &R) {
///     let handle = runtime.spawn(async { 42 });
///     println!("Result: {}", handle.await);
/// }
///
/// // Generate the main entry point
/// feagi_structures::feagi_main!(run_application);
/// ```
#[cfg(feature = "async")]
#[macro_export]
macro_rules! feagi_main {
    ($app_func:expr) => {
        // Check for conflicting features
        #[cfg(all(feature = "async-tokio", feature = "async-wasm"))]
        compile_error!("Do not enable both async-tokio and async-wasm features!");

        #[cfg(all(feature = "async-tokio", feature = "async-wasi"))]
        compile_error!("Do not enable both async-tokio and async-wasi features!");

        #[cfg(all(feature = "async-wasm", feature = "async-wasi"))]
        compile_error!("Do not enable both async-wasm and async-wasi features!");

        #[cfg(not(any(feature = "async-tokio", feature = "async-wasm", feature = "async-wasi")))]
        compile_error!(
            "No async runtime feature enabled! Enable one of: async-tokio, async-wasm, async-wasi"
        );

        // Tokio entry point
        #[cfg(feature = "async-tokio")]
        #[tokio::main]
        async fn main() {
            $crate::async::run_async!($app_func);
        }

        // WASM entry point - must be sync, spawns async work
        #[cfg(feature = "async-wasm")]
        #[wasm_bindgen::prelude::wasm_bindgen(start)]
        pub fn main() {
            // Spawn the async application on the WASM event loop
            wasm_bindgen_futures::spawn_local(async {
                $crate::run_async!($app_func);
            });
        }

        // WASI entry point (if/when implemented)
        #[cfg(feature = "async-wasi")]
        fn main() {
            // WASI may need different handling - placeholder for now
            compile_error!("WASI main entry not yet implemented");
        }
    };
}