6 releases (3 breaking)

0.4.0 Jul 28, 2024
0.3.0 Jun 3, 2023
0.2.0 Dec 19, 2022
0.1.2 Dec 19, 2022
0.1.0 Apr 28, 2022

#219 in Testing

Download history 2527/week @ 2024-10-06 3658/week @ 2024-10-13 2635/week @ 2024-10-20 2189/week @ 2024-10-27 4103/week @ 2024-11-03 2704/week @ 2024-11-10 3157/week @ 2024-11-17 3341/week @ 2024-11-24 3628/week @ 2024-12-01 3492/week @ 2024-12-08 3371/week @ 2024-12-15 783/week @ 2024-12-22 1212/week @ 2024-12-29 2440/week @ 2025-01-05 2997/week @ 2025-01-12 3087/week @ 2025-01-19

9,760 downloads per month
Used in 4 crates

MIT license

13KB
195 lines

axum-test-helper

axum-test-helper exposes axum original TestClient, which is private to the axum crate

More information about this crate can be found in the crate documentation.

High level features

  • Provide an easy to use interface
  • Start a server in a different port for each call
  • Deal with JSON, text and files response/requests

Usage example

Add this crate as a dev-dependency:

[dev-dependencies]
axum-test-helper = "0.*" # alternatively specify the version as "0.3.0"

Use the TestClient on your own Router:

use axum::Router;
use axum::http::StatusCode;
use axum_test_helper::TestClient;

// you can replace this Router with your own app
let app = Router::new().route("/", get(|| async {}));

// initiate the TestClient with the previous declared Router
let client = TestClient::new(app);
let res = client.get("/").send().await;
assert_eq!(res.status(), StatusCode::OK);

You can find examples like this in the example directory.

See the crate documentation for way more examples.

Disable trace

By default axum-test-helper print trace like Listening on 127.0.0.1:36457. You can disable trace with axum-test-helper = { version = "0.*", default-features = false, features = ["withouttrace"] }.

Contributing

Before submitting a pull request or after pulling from the main repository, ensure all tests pass:

# Run axum-test-helper tests
cargo test

# Test the hello-world example project
(cd examples/hello-world && cargo test)

License

This project is licensed under the MIT license.

Dependencies

~8–25MB
~307K SLoC