Skip to main content

Crate kape_testkit

Crate kape_testkit 

Source
Expand description

§kape-testkit

Reusable contract checks for Kape backend adapters.

assert_adapter_contract exercises the complete public CacheBackend seam for string adapters: scalar and batch miss/hit behavior, i64 millisecond TTL boundaries, expiry, duplicate read positions, duplicate batch-write rejection, removal, and clear. Built-in adapters use the same suite while keeping service-backed Redis and PostgreSQL runs explicit. Granular generic helpers remain available for other key and value types. get_random_string supplies unique keys for examples and tests.

[dev-dependencies]
kape-testkit = "0.1.0"
tokio = { version = "1", features = ["macros", "rt-multi-thread", "time"] }
use kape::CacheBackend;
use kape_testkit::assert_adapter_contract;

async fn check_backend<B>(backend: &B)
where
    B: CacheBackend<String, String>,
{
    assert_adapter_contract(backend, 100).await;
}

assert_adapter_contract and assert_expiring_contract use tokio::time::sleep, so they must run inside a Tokio runtime, such as a #[tokio::test]. The remaining granular helpers do not perform timed waits.

Functions§

assert_adapter_contract
Checks the complete public adapter contract using canonical string fixtures.
assert_backend_contract
Checks scalar miss, immortal and zero-TTL writes, invalid TTL rejection, removal, and zero-value-safe hit semantics.
assert_batch_contract
Checks ordered batch reads, duplicate read positions, duplicate-write rejection, misses, pre-validation, and empty-batch behavior.
assert_clear_contract
Checks that clear removes all entries visible to this backend.
assert_expiring_contract
Checks positive millisecond TTL reporting and expiration.
get_random_string
Returns a 16-character alphanumeric string from OS-seeded hasher state.