rkt 0.6.0

Web framework with a focus on usability, security, extensibility, and speed. (Community Fork)
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

extern crate rkt;

use rkt::error::ErrorKind;
use rkt::fairing::{self, Fairing, Info, Kind};
use rkt::{Build, Config, Rocket};

struct Singleton(Kind, Kind, bool);

#[rkt::async_trait]
impl Fairing for Singleton {
    fn info(&self) -> Info {
        Info {
            name: "Singleton",
            kind: self.0,
        }
    }

    async fn on_ignite(&self, rocket: Rocket<Build>) -> fairing::Result {
        if self.2 {
            Ok(rocket.attach(Singleton(self.1, self.1, false)))
        } else {
            Ok(rocket)
        }
    }
}

// Have => two `Singleton`s. This is okay; we keep the latter.
#[rkt::async_test]
async fn recursive_singleton_ok() {
    let result = rkt::custom(Config::debug_default())
        .attach(Singleton(
            Kind::Ignite | Kind::Singleton,
            Kind::Singleton,
            false,
        ))
        .attach(Singleton(
            Kind::Ignite | Kind::Singleton,
            Kind::Singleton,
            false,
        ))
        .ignite()
        .await;

    assert!(result.is_ok(), "{:?}", result);

    let result = rkt::custom(Config::debug_default())
        .attach(Singleton(
            Kind::Ignite | Kind::Singleton,
            Kind::Singleton,
            false,
        ))
        .attach(Singleton(
            Kind::Ignite | Kind::Singleton,
            Kind::Singleton,
            false,
        ))
        .attach(Singleton(
            Kind::Ignite | Kind::Singleton,
            Kind::Singleton,
            false,
        ))
        .attach(Singleton(
            Kind::Ignite | Kind::Singleton,
            Kind::Singleton,
            false,
        ))
        .ignite()
        .await;

    assert!(result.is_ok(), "{:?}", result);
}

// Have a `Singleton` add itself `on_ignite()`. Since it already ran, the one it
// adds can't be unique, so ensure we error in this case.
#[rkt::async_test]
async fn recursive_singleton_bad() {
    #[track_caller]
    fn assert_err(error: rkt::Error) {
        if let ErrorKind::FailedFairings(v) = error.kind() {
            assert_eq!(v.len(), 1);
            assert_eq!(v[0].name, "Singleton");
        } else {
            panic!("unexpected error: {:?}", error);
        }
    }

    let result = rkt::custom(Config::debug_default())
        .attach(Singleton(
            Kind::Ignite | Kind::Singleton,
            Kind::Ignite | Kind::Singleton,
            true,
        ))
        .ignite()
        .await;

    assert_err(result.unwrap_err());

    let result = rkt::custom(Config::debug_default())
        .attach(Singleton(
            Kind::Ignite | Kind::Singleton,
            Kind::Singleton,
            true,
        ))
        .ignite()
        .await;

    assert_err(result.unwrap_err());

    let result = rkt::custom(Config::debug_default())
        .attach(Singleton(Kind::Ignite, Kind::Singleton, true))
        .ignite()
        .await;

    assert_err(result.unwrap_err());
}