Struct TestClient 

pub struct TestClient { /* private fields */ }

An in-process test client bound to an assembled App.

TestClient drives App::process directly — no socket is bound and no runtime port is used — so tests are fast and hermetic. Build a request with get / post / put / delete (or the generic request), then call send to get a TestResponse.

use churust_core::{Churust, Call, TestClient};
let app = Churust::server()
    .routing(|r| { r.get("/", |_c: Call| async { "home" }); })
    .build();
let res = TestClient::new(app).get("/").send().await;
assert_eq!(res.status().as_u16(), 200);
assert_eq!(res.text(), "home");

Implementations

impl TestClient

pub fn new(app: App) -> Self

Create a client that drives the given assembled App.

pub fn request(&self, method: Method, uri: impl Into<String>) -> TestRequest<'_>

Begin building a request with an arbitrary method and uri. The verb helpers (get, post, etc.) call this for the common methods.

use churust_core::{Churust, Call, TestClient};
use http::Method;
let app = Churust::server()
    .routing(|r| { r.get("/", |_c: Call| async { "ok" }); })
    .build();
let res = TestClient::new(app).request(Method::GET, "/").send().await;
assert_eq!(res.text(), "ok");

pub fn get(&self, uri: impl Into<String>) -> TestRequest<'_>

Begin building a GET request to uri.

pub fn post(&self, uri: impl Into<String>) -> TestRequest<'_>

Begin building a POST request to uri.

pub fn put(&self, uri: impl Into<String>) -> TestRequest<'_>

Begin building a PUT request to uri.

pub fn delete(&self, uri: impl Into<String>) -> TestRequest<'_>

Begin building a DELETE request to uri.