yew-router-nested 0.16.1

A router implementation for the Yew framework
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use yew_router::{route::Route, switch::Permissive, Switch};

#[derive(Clone, Debug, Eq, PartialEq, Switch)]
pub enum InnerRoute {
    #[to = "/left"]
    Left,
    #[to = "/right"]
    Right,
}

#[derive(Clone, Debug, Eq, PartialEq, Switch)]
#[to = "/single/{number}"]
pub struct Single {
    number: u32,
}

#[derive(Clone, Debug, Eq, PartialEq, Switch)]
#[to = "/othersingle/{number}"]
pub struct OtherSingle(u32);
#[derive(Clone, Debug, Eq, PartialEq, Switch)]
#[to = "{*:path}#{route}"]
pub struct FragmentAdapter<W: Switch> {
    path: String,
    route: W,
}

#[derive(Clone, Debug, PartialEq, Switch)]
pub enum AppRoute {
    #[to = "/some/route"]
    SomeRoute,
    #[to = "/some/{thing}/{other}"]
    // If you have a variant with named fields, the field names should appear in the matcher string.
    Something { thing: String, other: String },
    #[to = "/another/{}"] // Tuple-enums don't need names in the capture groups.
    Another(String),
    #[to = "/doot/{}/{something}"]
    // You can still puts names in the capture groups to improve readability.
    Yeet(String, String),
    #[to = "/inner"]
    #[rest] // same as /inner{*}
    Nested(InnerRoute),
    #[rest] // Rest delegates the remaining input to the next attribute
    Single(Single),
    #[rest]
    OtherSingle(OtherSingle),
    /// Because this is permissive, the inner item doesn't have to match.
    #[to = "/option/{}"]
    Optional(Permissive<String>),
    /// Because this is permissive, a corresponding capture group doesn't need to exist
    #[to = "/missing/capture"]
    MissingCapture(Permissive<String>),
}

#[test]
fn switch() {
    let route = Route::new_no_state("/some/route");
    assert_eq!(AppRoute::switch(route), Some(AppRoute::SomeRoute));

    let route = Route::new_no_state("/some/thing/other");
    assert_eq!(
        AppRoute::switch(route),
        Some(AppRoute::Something {
            thing: "thing".to_owned(),
            other: "other".to_owned()
        })
    );

    let route = Route::new_no_state("/another/other");
    assert_eq!(
        AppRoute::switch(route),
        Some(AppRoute::Another("other".to_owned()))
    );

    let route = Route::new_no_state("/inner/left");
    assert_eq!(
        AppRoute::switch(route),
        Some(AppRoute::Nested(InnerRoute::Left))
    );

    let route = Route::new_no_state("/yeet");
    assert_eq!(AppRoute::switch(route), None);

    let route = Route::new_no_state("/single/32");
    assert_eq!(
        AppRoute::switch(route),
        Some(AppRoute::Single(Single { number: 32 }))
    );

    let route = Route::new_no_state("/othersingle/472");
    assert_eq!(
        AppRoute::switch(route),
        Some(AppRoute::OtherSingle(OtherSingle(472)))
    );

    let route = Route::new_no_state("/option/test");
    assert_eq!(
        AppRoute::switch(route),
        Some(AppRoute::Optional(Permissive(Some("test".to_owned()))))
    );
}

#[test]
fn build_route() {
    let mut buf = String::new();
    AppRoute::Another("yeet".to_string()).build_route_section::<()>(&mut buf);
    assert_eq!(buf, "/another/yeet");

    let mut buf = String::new();
    AppRoute::Something {
        thing: "yeet".to_string(),
        other: "yote".to_string(),
    }
    .build_route_section::<()>(&mut buf);
    assert_eq!(buf, "/some/yeet/yote");

    let mut buf = String::new();
    OtherSingle(23).build_route_section::<()>(&mut buf);
    assert_eq!(buf, "/othersingle/23");
}