charted-dev / testkit

📦🦋 TestKit is a Rust-based testing framework for HTTP-based services with Testcontainers support

📦🦋 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.