kithara-test-utils

Cross-crate test-runtime support: #[kithara::test] macro re-exports, USDT probe helpers, hang-watchdog, and unimock glue. This crate is test-only (publish = false) and does not contain the integration-test fixtures themselves — those live in kithara-integration-tests (tests/) since the Phase 5 refactor.

Modules

Usage

use kithara_test_utils::kithara;

#[kithara::test(tokio, timeout(std::time::Duration::from_secs(10)))]
async fn smoke() {
    // test body — protected by the hang watchdog (default-on)
}

For trait mocks:

use kithara_test_utils::kithara;

#[kithara::mock]
trait Service {
    fn get(&self) -> u64;
}

Features

Consumer crates typically enable mock and probe in their [dev-dependencies] while keeping the default hang feature on.

Integration tests live elsewhere

The integration-test domain (synthetic HLS servers, signal generators, TestHttpServer, TestServerHelper, HlsFixtureBuilder, PackagedTestServer, …) lives in kithara-integration-tests (tests/). To use it from another crate's tests, depend on kithara-integration-tests (it is publish = false) rather than re-implementing fixtures here.

See tests/README.md for the integration-test suite layout, the standalone test_server binary, the WASM flow, and the available fixture builders.

Integration