tideway 0.7.17

A batteries-included Rust web framework built on Axum for building SaaS applications quickly
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
120

use axum::Router;
use axum::http::Method;

use crate::App;
use crate::testing::Scenario;

/// Alba-style test harness for Tideway `App` instances.
pub struct TestApp {
    router: Router,
}

pub struct AuthTestApp {
    router: Router,
    token: String,
}

impl TestApp {
    /// Build a test app from a Tideway `App`, including middleware.
    pub fn new(app: App) -> Self {
        Self::from_router(app.into_router_with_middleware())
    }

    /// Build a test app from a Tideway `App` without middleware.
    pub fn without_middleware(app: App) -> Self {
        Self::from_router(app.into_router())
    }

    /// Build a test app from an Axum router.
    pub fn from_router(router: Router) -> Self {
        Self { router }
    }

    /// Consume the test app and return the underlying router.
    pub fn into_router(self) -> Router {
        self.router
    }

    /// Create an authenticated test app that applies a bearer token to requests.
    pub fn auth(&self, token: &str) -> AuthTestApp {
        AuthTestApp {
            router: self.router.clone(),
            token: token.to_string(),
        }
    }

    pub fn get(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::GET)
            .uri(uri)
    }

    pub fn post(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::POST)
            .uri(uri)
    }

    pub fn post_json<T: serde::Serialize>(&self, uri: &str, body: &T) -> Scenario {
        self.post(uri).json(body)
    }

    pub fn put(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::PUT)
            .uri(uri)
    }

    pub fn delete(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::DELETE)
            .uri(uri)
    }

    pub fn patch(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::PATCH)
            .uri(uri)
    }
}

impl AuthTestApp {
    pub fn get(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::GET)
            .uri(uri)
            .with_auth(&self.token)
    }

    pub fn post(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::POST)
            .uri(uri)
            .with_auth(&self.token)
    }

    pub fn post_json<T: serde::Serialize>(&self, uri: &str, body: &T) -> Scenario {
        self.post(uri).json(body)
    }

    pub fn put(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::PUT)
            .uri(uri)
            .with_auth(&self.token)
    }

    pub fn delete(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::DELETE)
            .uri(uri)
            .with_auth(&self.token)
    }

    pub fn patch(&self, uri: &str) -> Scenario {
        Scenario::new(self.router.clone())
            .method(Method::PATCH)
            .uri(uri)
            .with_auth(&self.token)
    }
}