Struct MockHttpRequest 

pub struct MockHttpRequest {
    pub method: Method,
    pub uri: Uri,
    pub headers: HeaderMap,
    pub body: Bytes,
    pub cookies: HashMap<String, String>,
    pub query_params: HashMap<String, String>,
}

Mock HTTP request for testing server functions.

This provides a fluent API for building HTTP requests without an actual HTTP layer, useful for testing server functions directly.

Fields

method: Method

The HTTP method.

uri: Uri

The request URI.

headers: HeaderMap

Request headers.

body: Bytes

Request body as bytes.

cookies: HashMap<String, String>

Cookies extracted from headers.

query_params: HashMap<String, String>

Query parameters.

Implementations

impl MockHttpRequest

pub fn new(method: Method, uri: &str) -> Self

Create a new mock request with the given method and URI.

pub fn get(uri: &str) -> Self

Create a GET request.

pub fn post(uri: &str) -> Self

Create a POST request.

pub fn put(uri: &str) -> Self

Create a PUT request.

pub fn patch(uri: &str) -> Self

Create a PATCH request.

pub fn delete(uri: &str) -> Self

Create a DELETE request.

pub fn with_json<T: Serialize>(self, body: &T) -> Self

Set the request body as JSON.

This serializes the value to JSON and sets the appropriate Content-Type header.

Panics

Panics if the value cannot be serialized to JSON. Since this is a test utility, invalid input indicates a test setup error that should be caught immediately.

pub fn with_form<T: Serialize>(self, body: &T) -> Self

Set the request body as form data.

This serializes the value as URL-encoded form data.

Panics

Panics if the value cannot be serialized as form data. Since this is a test utility, invalid input indicates a test setup error that should be caught immediately.

pub fn with_body(self, body: impl Into<Bytes>) -> Self

Set the request body as raw bytes.

pub fn with_text(self, body: impl Into<String>) -> Self

Set the request body as a string.

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

Add a request header.

pub fn with_headers<'a>( self, headers: impl IntoIterator<Item = (&'a str, &'a str)>, ) -> Self

Add multiple headers.

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

Add a cookie.

pub fn with_cookies<'a>( self, cookies: impl IntoIterator<Item = (&'a str, &'a str)>, ) -> Self

Add multiple cookies.

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

Add a query parameter.

pub fn with_query_params<'a>( self, params: impl IntoIterator<Item = (&'a str, &'a str)>, ) -> Self

Add multiple query parameters.

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

Set the Authorization header with a Bearer token.

pub fn with_basic_auth(self, username: &str, password: &str) -> Self

Set the Authorization header with Basic auth.

pub fn with_content_type(self, content_type: &str) -> Self

Set the Content-Type header.

pub fn with_accept(self, accept: &str) -> Self

Set the Accept header.

pub fn path(&self) -> &str

Get the request path (without query string).

pub fn uri_string(&self) -> String

Get the full URI as a string.

pub fn get_header(&self, name: &str) -> Option<&str>

Get a header value.

pub fn get_cookie(&self, name: &str) -> Option<&str>

Get a cookie value.

pub fn get_query(&self, name: &str) -> Option<&str>

Get a query parameter value.

pub fn json<T: for<'de> Deserialize<'de>>(&self) -> Result<T, Error>

Parse the body as JSON.

pub fn form<T: for<'de> Deserialize<'de>>(&self) -> Result<T, Error>

Parse the body as form data.

pub fn text(&self) -> Result<String, FromUtf8Error>

Get the body as a string.

Trait Implementations

impl Clone for MockHttpRequest

fn clone(&self) -> MockHttpRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MockHttpRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MockHttpRequest

fn default() -> Self

Returns the “default value” for a type.