Struct axum_test::TestServerConfig

pub struct TestServerConfig {
    pub ip: Option<IpAddr>,
    pub port: Option<u16>,
    pub save_cookies: bool,
    pub expect_success_by_default: bool,
    pub restrict_requests_with_http_schema: bool,
    pub default_content_type: Option<String>,
}

This is for customising the TestServer on construction.

It implements Default to ease building configurations:

use ::axum_test::TestServerConfig;

let config = TestServerConfig {
    save_cookies: true,
    ..TestServerConfig::default()
};

These can be passed to TestServer::new_with_config:

use ::axum::Router;
use ::axum_test::TestServer;
use ::axum_test::TestServerConfig;

let my_app = Router::new()
    .into_make_service();

let config = TestServerConfig {
    save_cookies: true,
    ..TestServerConfig::default()
};

// Build the Test Server
let server = TestServer::new_with_config(my_app, config)?;

Fields

ip: Option<IpAddr>

Set the IP to use for the server.

Defaults to 127.0.0.1.

port: Option<u16>

Set the port number to use for the server.

Defaults to a random port.

save_cookies: bool

Set for the server to save cookies that are returned, for use in future requests.

This is useful for automatically saving session cookies (and similar) like a browser would do.

Defaults to false (being turned off).

expect_success_by_default: bool

Sets requests made by the server to always expect a status code returned in the 2xx range, and to panic if that is missing.

This is useful when making multiple requests at a start of test which you presume should always work. It also helps to make tests more explicit.

Defaults to false (being turned off).

restrict_requests_with_http_schema: bool

If you make a request with a ‘http://’ schema, then it will ignore the Test Server’s address.

For example if the test server is running at http://localhost:1234, and you make a request to http://google.com. Then the request will go to http://google.com. Ignoring the localhost:1234 part.

Turning this setting on will change this behaviour.

After turning this on, the same request will go to http://localhost:1234/http://google.com.

Defaults to false (being turned off).

default_content_type: Option<String>

Set the default content type for all requests created by the TestServer.

This overrides the default ‘best efforts’ approach of requests.

Trait Implementations

impl Clone for TestServerConfig

fn clone(&self) -> TestServerConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TestServerConfig

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

Formats the value using the given formatter.

impl Default for TestServerConfig

fn default() -> Self

Returns the “default value” for a type.