Struct charted_testkit::TestContext

pub struct TestContext { /* private fields */ }

Implementations

impl TestContext

pub fn allow_http1(self, yes: bool) -> Self

Allows HTTP/1 connections to be used. By disabling this, the ephermeral TCP listener won’t know what to do unless HTTP/2 connections are allowed.

pub fn allows_both(&self) -> bool

Checks whenever if the ephermeral TCP listener should allow both HTTP/1 and HTTP/2 connections.

pub fn server_addr(&self) -> Option<&SocketAddr>

Returns a optional reference to a socket address if TestContext::serve was called after this call.

Example

let mut ctx = TestContext::default();
assert!(ctx.server_addr().is_none());

ctx.serve(axum::Router::new()).await;
assert!(ctx.server_addr().is_some());

pub fn request<U: AsRef<str> + 'static, B: Into<Bytes>, F: Fn(&mut Request<Full<Bytes>>)>( &self, uri: U, method: Method, body: Option<B>, build: F, ) -> ResponseFuture

Sends a request to the ephemeral server and returns a ResponseFuture.

Example

async fn handler() -> &'static str {
    "Hello, world!"
}

let mut ctx = TestContext::default();
ctx.serve(axum::Router::new().route("/", routing::get(handler))).await;

let res = ctx
    .request::<_, Bytes, _>("/", Method::GET, None, |_| {})
    .await
    .expect("was unable to send request to ephermeral server");

charted_testkit::assert_successful!(res);
assert_eq!(charted_testkit::consume_body!(res), Bytes::from_static(b"Hello, world!"));

pub async fn serve(&mut self, router: Router)

Serves the ephermeral server.

Trait Implementations

impl Debug for TestContext

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

Formats the value using the given formatter.

impl Default for TestContext

fn default() -> Self

Returns the “default value” for a type.