dtact 0.1.5

Dtact: A non-preemptive, stackful coroutine runtime featuring a lock-free context arena, P2P mesh scheduling, and architecture-specific assembly switchers. Designed for hardware-level control and non-blocking heterogeneous orchestration.
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

/// Generates a structured error enum with cold-path optimization.
///
/// This macro generates the error enumeration and a set of "cold" helper
/// functions that wrap the error variants in `Err`. These helpers are
/// marked with `#[cold]` and `#[inline(never)]` to ensure that error
/// generation does not pollute the instruction cache of the hot path.
#[doc(hidden)]
#[macro_export]
macro_rules! dtact_error {
    (
        $(#[$meta:meta])*
        $vis:vis enum $name:ident {
            $(
                $(#[$variant_meta:meta])*
                $variant:ident $( { $( $(#[$field_meta:meta])* $field:ident : $ftype:ty ),* $(,)? } )? $( ( $( $(#[$tuple_meta:meta])* $tname:ident : $ttype:ty ),* $(,)? ) )?
            ),* $(,)?
        }
    ) => {
        $(#[$meta])*
        $vis enum $name {
            $(
                $(#[$variant_meta])*
                $variant $( { $( $(#[$field_meta])* $field : $ftype ),* } )? $( ( $( $(#[$tuple_meta])* $ttype ),* ) )?,
            )*
        }

        pastey::paste! {
            $(
                $(#[$variant_meta])*
                #[doc(hidden)]
                #[cold]
                #[track_caller]
                #[inline(never)]
                pub const fn [<cold_ $name:snake _ $variant:snake>]<T>(
                    $($($field : $ftype),*)?
                    $($($tname : $ttype),*)?
                ) -> core::result::Result<T, $name> {
                    core::result::Result::Err($name::$variant $( { $($field),* } )? $( ( $( $tname ),* ) )?)
                }
            )*
        }
    };
}

dtact_error! {
    /// Errors encountered during Dtact Runtime operation.
    #[derive(Debug, PartialEq, Eq, Clone, Copy)]
    pub enum DtactError {
        /// OS-level memory mapping failed (Linux).
        MmapFailed,
        /// OS-level memory allocation failed (Windows).
        VirtualAllocFailed,
        /// OS-level memory protection change failed (Linux).
        MprotectFailed,
        /// OS-level memory protection change failed (Windows).
        VirtualProtectFailed,
        /// An API function was called from a thread not managed as a fiber.
        OutsideFiberContext,
    }
}