ultimo 0.4.0

Modern Rust web framework with automatic TypeScript client generation
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

//! Testing utilities for Ultimo applications.
//!
//! Enable with `ultimo = { version = "…", features = ["testing"] }` under
//! `[dev-dependencies]`. The [`TestClient`] drives your app in-process — no
//! socket, fully deterministic.
//!
//! ```
//! use ultimo::testing::TestClient;
//! use ultimo::{Context, Ultimo};
//!
//! # async fn run() {
//! let mut app = Ultimo::new_without_defaults();
//! app.get("/ping", |ctx: Context| async move { ctx.text("pong").await });
//!
//! let client = TestClient::new(app);
//! let res = client.get("/ping").send().await;
//! res.assert_ok();
//! assert_eq!(res.text(), "pong");
//! # }
//! ```

mod client;
mod fixtures;
mod middleware;
mod response;

#[cfg(feature = "sqlx")]
mod database;

pub use client::{TestClient, TestRequest};
pub use fixtures::{load_fixture, Fixture};
pub use middleware::{run_middleware, test_context, TestContextBuilder};
pub use response::TestResponse;

#[cfg(feature = "sqlx")]
pub use database::with_test_transaction;

/// Assert two values are equal as JSON, with a readable diff on failure.
///
/// ```
/// # use ultimo::assert_json_eq;
/// assert_json_eq!(serde_json::json!({ "a": 1 }), serde_json::json!({ "a": 1 }));
/// ```
#[macro_export]
macro_rules! assert_json_eq {
    ($actual:expr, $expected:expr $(,)?) => {{
        let actual = ::serde_json::to_value(&$actual).expect("actual is serializable");
        let expected = ::serde_json::to_value(&$expected).expect("expected is serializable");
        assert_eq!(
            actual, expected,
            "JSON mismatch\n  actual:   {}\n  expected: {}",
            actual, expected
        );
    }};
}

/// Assert a [`TestResponse`](crate::testing::TestResponse) has the given status.
#[macro_export]
macro_rules! assert_status {
    ($res:expr, $code:expr $(,)?) => {{
        $res.assert_status($code);
    }};
}