rust-webx-host 1.2.0

rust-webx HTTP layer: Host builder, middleware pipeline, Trie-based router, hyper integration
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

//! Strict/lenient scope validation on `HostBuilder` (rust-dix 0.8+ semantics).

use std::sync::Arc;

use webx_core::mode::AppMode;
use webx_host::server::Host;

#[derive(Debug)]
struct ScopedThing(u32);

fn ready_builder() -> webx_host::server::HostBuilder {
    Host::builder().mode(AppMode::Development).no_spa()
}

#[test]
fn strict_scope_validation_is_the_default() {
    let host = ready_builder()
        .register(|svc| svc.scoped::<ScopedThing>(|_| Arc::new(ScopedThing(1))))
        .try_build()
        .expect("host must build");

    let error = host
        .provider()
        .get::<ScopedThing>()
        .expect_err("strict scope validation must reject Scoped services from the root");
    let message = error.to_string();
    assert!(
        message.contains("root provider"),
        "the error must explain the root-scope rule, got: {message}"
    );

    // The supported path: open a scope and resolve there.
    let scope = host.provider().scope();
    assert!(
        scope.get::<ScopedThing>().is_ok(),
        "resolving inside an explicit scope must work"
    );
}

#[test]
fn lenient_scope_validation_restores_root_resolution() {
    let host = ready_builder()
        .lenient_scope_validation()
        .register(|svc| svc.scoped::<ScopedThing>(|_| Arc::new(ScopedThing(7))))
        .try_build()
        .expect("host must build");

    let first = host
        .provider()
        .get::<ScopedThing>()
        .expect("lenient mode resolves Scoped services from the root");
    let second = host
        .provider()
        .get::<ScopedThing>()
        .expect("the root-local instance stays resolvable");
    assert!(
        Arc::ptr_eq(&first, &second),
        "lenient root resolution caches the instance root-locally, like rust-dix 0.7"
    );
    assert_eq!(first.0, 7);
}