Crate charted_testkit

📦🦋 charted TestKit

charted TestKit is a testing library for Axum, which extends libtest with its own test macro. The library can also be used for only Testcontainers as well.

TestKit was built to make integration testing easier for Axum services with Testcontainers support and additional macros to help build assertions based off Responses.

Example

use charted_testkit::{test, TestContext, assert_successful, consume_body};
use axum::{body::Bytes, routing, Router};
use hyper::Method;

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

fn router() -> Router {
    Router::new().route("/", routing::get(hello))
}

#[test(router)]
async fn mytest(ctx: TestContext) {
    let res = ctx
        .request("/", Method::GET, None::<axum::body::Bytes>, |_| {})
        .await
        .expect("unable to send request");

    assert_successful!(res);

    let body = consume_body!(res);
    assert_eq!(body, Bytes::from_static(b"Hello, world!"));
}

License

TestKit is released under the MIT License with love and care by Noelware, LLC.! 🐻‍❄️🦋

Please read the LICENSE file in the canonical repository for more information on what you can do with the source code.

Macros

• assert_doesnt_have_header
  Assertion macro to indicate that a Response doesn’t have the header it needs.
• assert_has_header
  Assertion macro to indicate that a Response has the header it needs.
• assert_status_code
  Macro to easily assert if a given response’s status code is the same as one you provide.
• assert_successful
  Checks whenever if a Response is successful or not.
• consume_body
  Macro to consume the full body of a response and returns a Bytes container.

Structs

• TestContext

Attribute Macros

• test
  Represents a procedural attribute macro that does the heavy lifting of charted_testkit for you. This macro also manages: