allure-cargotest

allure-cargotest is the main user-facing crate in this workspace. It wires Allure test lifecycle handling into cargo test, writes result files, and re-exports the #[allure_test] and #[step] macros.

Add the crate

cargo add allure-cargotest --dev

Basic usage

Annotate your tests with #[allure_test] and optional helper functions with #[step]. During execution, results are written to target/allure-results by default.

use allure_cargotest::{allure_test, step};

#[step]
fn open_login_page() {
    // your step implementation
}

#[allure_test]
#[test]
fn login_works() {
    allure.epic("Web interface");
    allure.feature("Authentication");
    allure.story("Login with username and password");
    allure.parameter("browser", "firefox");

    open_login_page();
    allure.attachment("page.html", "text/html", "<html>...</html>");
}

Configure the output directory

Override the default results directory with ALLURE_RESULTS_DIR:

ALLURE_RESULTS_DIR=./allure-results cargo test

Generate an Allure report

After the test run, generate and open a report with the Allure CLI:

allure generate ./target/allure-results --output ./target/allure-report --clean
allure open ./target/allure-report

What this crate provides