oxide_core 0.4.0

Rust engine primitives for Oxide (store, snapshot streams, error model, optional persistence).
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
86
87
88

use oxide_core::{CoreResult, InitContext, OxideError, Reducer, ReducerEngine, StateChange};

#[derive(Debug, Clone, PartialEq, Eq)]
struct State {
    value: u64,
}

enum Action {
    Increment,
    Fail,
}

enum SideEffect {}

#[derive(Default)]
struct ReducerImpl;

impl Reducer for ReducerImpl {
    type State = State;
    type Action = Action;
    type SideEffect = SideEffect;

    async fn init(&mut self, _ctx: InitContext<Self::SideEffect>) {}

    fn reduce(
        &mut self,
        state: &mut Self::State,
        ctx: oxide_core::Context<'_, Self::Action, Self::State, ()>,
    ) -> CoreResult<StateChange> {
        match ctx.input {
            Action::Increment => {
                state.value = state.value.saturating_add(1);
                Ok(StateChange::Full)
            }
            Action::Fail => Err(OxideError::Internal {
                message: "expected failure".to_string(),
            }),
        }
    }

    fn effect(
        &mut self,
        _state: &mut Self::State,
        _ctx: oxide_core::Context<'_, Self::SideEffect, Self::State, ()>,
    ) -> CoreResult<StateChange> {
        Ok(StateChange::None)
    }
}

fn init_test_runtime() {
    fn thread_pool() -> &'static flutter_rust_bridge::SimpleThreadPool {
        static POOL: std::sync::OnceLock<flutter_rust_bridge::SimpleThreadPool> =
            std::sync::OnceLock::new();
        POOL.get_or_init(flutter_rust_bridge::SimpleThreadPool::default)
    }
    let _ = oxide_core::runtime::init(thread_pool);
    #[cfg(feature = "navigation-binding")]
    {
        let _ = oxide_core::init_navigation();
    }
}

#[tokio::test]
async fn reducer_engine_round_trip() {
    init_test_runtime();

    let engine = ReducerEngine::<ReducerImpl>::new(ReducerImpl::default(), State { value: 0 })
        .await
        .unwrap();
    let snapshot = engine.dispatch(Action::Increment).await.unwrap();
    assert_eq!(snapshot.revision, 1);
    assert_eq!(snapshot.state, State { value: 1 });
}

#[tokio::test]
async fn reducer_engine_dispatch_returns_error() {
    init_test_runtime();

    let engine = ReducerEngine::<ReducerImpl>::new(ReducerImpl::default(), State { value: 0 })
        .await
        .unwrap();
    let err = engine.dispatch(Action::Fail).await.unwrap_err();
    assert!(matches!(err, OxideError::Internal { .. }));

    let snapshot = engine.current().await;
    assert_eq!(snapshot.revision, 0);
    assert_eq!(snapshot.state, State { value: 0 });
}