Struct TestClient 

pub struct TestClient<'a> { /* private fields */ }

Sends requests carrying cookies and tenant.

Implementations

impl<'a> TestClient<'a>

pub fn new(router: &'a Router) -> Self

pub fn cookie(&self, name: &str, value: &str) -> Self

Attaches a cookie to every request; a later value for the same name replaces the earlier one.

pub fn cookies(&self, cookies: &[(String, String)]) -> Self

Attaches every (name, value) pair, replacing earlier values for the same name.

pub fn csrf(&self, token: &str) -> Self

Attach the CSRF cookie the form’s csrf_token field must match.

pub async fn sign_in(&self, db: &Db, panel: &str, user: &impl PanelUser) -> Self

Signs user in to the panel Panel::new(panel) mounts, as a successful login does, and attaches the session cookie; no password is hashed or checked.

The session row goes into db, the router’s database, keyed to PanelUser::user_id: each request loads the user back through the panel’s Authenticator::find_by_id, so a custom authenticator works as the shipped one does.

let admin = tablo_core::auth::create_admin(&mut db, "admin@example.com", "secret", "Admin")
    .await
    .expect("seed the admin");
let client = TestClient::new(router).sign_in(&db, "admin", &admin).await;

Panics

When the session row cannot be written, e.g. the database does not register AuthSession.

pub async fn log_in( &self, panel: &str, email: &str, password: &str, next: &str, ) -> (Self, Response<Body>)

Signs in through the login form of the panel Panel::new(panel) mounts, as a browser does: loads the page, posts email and password with the page’s CSRF token, and keeps the cookies both responses set. Returns the client and the login response, which redirects on success and re-renders the form on a refusal.

next is the page to land on after signing in, "" for the panel’s home. Prefer sign_in unless the test is about the login itself.

Panics

When the login page renders no csrf_token input: the panel’s authentication is off.

pub fn tenant(&self, tenant: Uuid) -> Self

Scopes the request to another tenant, taking precedence over the logged-in user’s tenant.

pub async fn get(&self, uri: &str) -> Response<Body>

pub async fn post_form(&self, uri: &str, body: String) -> Response<Body>

pub async fn submit(&self, uri: &str, body: &str) -> Response<Body>

Posts the urlencoded body as a panel form does: with a fresh CSRF token in both the cookie and the csrf_token field.

pub async fn submit_multipart( &self, uri: &str, parts: &[(&str, Option<&str>, &str)], ) -> Response<Body>

Posts multipart_body’s parts as a panel form with a file input does: with a fresh CSRF token in both the cookie and a csrf_token part.

pub async fn post_multipart( &self, uri: &str, boundary: &str, body: String, ) -> Response<Body>

Trait Implementations

impl<'a> Clone for TestClient<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.