cranpose 0.1.97

Cranpose runtime and UI facade
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
89
90
91
92
93
94
95
96

//! The composition-scoped effects an application uses to reach the host.
//!
//! Each of these takes a platform allowance — the screen staying awake, the
//! back gesture, the frame clock, the lifecycle stream — and ties it to the
//! composition that asked, so leaving the screen gives it back. That tie is
//! the whole contract, and it only exists if the effect actually composes.

use cranpose_ui::run_test_composition;
use std::cell::Cell;
use std::rc::Rc;

#[test]
fn keeping_the_screen_on_composes_enabled_and_disabled() {
    // Disabled is not the same as absent: an effect that is composed while
    // disabled must not take the allowance, and must still be there to take it
    // when the flag flips.
    for enabled in [false, true] {
        run_test_composition(move || cranpose::KeepScreenOn(enabled));
    }
    // Composing and dropping an enabled effect must give the allowance back,
    // or the screen stays awake for the rest of the process. With no host
    // controller registered the flag is the only observable half.
    cranpose_services::set_keep_screen_on(false);
}

#[test]
fn a_back_handler_composes_and_releases_its_interception() {
    let pressed = Rc::new(Cell::new(0usize));
    let counter = Rc::clone(&pressed);
    run_test_composition(move || {
        let counter = Rc::clone(&counter);
        cranpose::BackHandler(true, move || counter.set(counter.get() + 1));
    });
    assert_eq!(pressed.get(), 0, "nothing pressed back, yet it fired");
    assert!(
        !cranpose_services::back_interception_enabled(),
        "back interception outlived the composition that asked for it"
    );
}

#[test]
fn a_lifecycle_effect_composes_and_sees_nothing_until_the_host_says_so() {
    let events = Rc::new(Cell::new(0usize));
    let counter = Rc::clone(&events);
    run_test_composition(move || {
        let counter = Rc::clone(&counter);
        cranpose::LifecycleEffect((), move |_event| counter.set(counter.get() + 1));
    });
    assert_eq!(
        events.get(),
        0,
        "a lifecycle event arrived with no host to send one"
    );
}

#[test]
fn a_frame_effect_composes_running_and_stopped() {
    let frames = Rc::new(Cell::new(0usize));
    for running in [false, true] {
        let counter = Rc::clone(&frames);
        run_test_composition(move || {
            let counter = Rc::clone(&counter);
            cranpose::FrameEffect((), running, move |_nanos| counter.set(counter.get() + 1));
        });
    }
    assert_eq!(
        frames.get(),
        0,
        "a frame was delivered without one being dispatched"
    );
}

#[test]
fn the_update_state_is_readable_from_composition_and_starts_unknown() {
    run_test_composition(|| {
        let status = cranpose::rememberAppUpdateState();
        // With no platform update backend registered there is nothing to
        // report, and the state has to say so rather than claim an update.
        assert_eq!(
            status.get(),
            cranpose_services::AppUpdateStatus::default(),
            "an update was reported with no backend to report one"
        );
    });
}

#[test]
fn a_window_state_reports_the_size_it_was_created_with() {
    run_test_composition(|| {
        let state = cranpose::rememberWindowState(320.0, 240.0);
        assert_eq!(
            state.size_non_reactive(),
            cranpose_ui::Size::new(320.0, 240.0)
        );
    });
}