Key-value store integration tests

BaseStoreSyncTests

Bases: BaseStandardTests, Generic[V]

Test suite for checking the key-value API of a BaseStore.

This test suite verifies the basic key-value API of a BaseStore.

The test suite is designed for synchronous key-value stores.

Implementers should subclass this test suite and provide a fixture that returns an empty key-value store for each test.

METHOD	DESCRIPTION
test_no_overrides_DO_NOT_OVERRIDE	Test that no standard tests are overridden.
kv_store	Get the key-value store class to test.
three_values	Three example values that will be used in the tests.
test_three_values	Test that the fixture provides three values.
test_kv_store_is_empty	Test that the key-value store is empty.
test_set_and_get_values	Test setting and getting values in the key-value store.
test_store_still_empty	Test that the store is still empty.
test_delete_values	Test deleting values from the key-value store.
test_delete_bulk_values	Test that we can delete several values at once.
test_delete_missing_keys	Deleting missing keys should not raise an exception.
test_set_values_is_idempotent	Setting values by key should be idempotent.
test_get_can_get_same_value	Test that the same value can be retrieved multiple times.
test_overwrite_values_by_key	Test that we can overwrite values by key using mset.
test_yield_keys	Test that we can yield keys from the store.

test_no_overrides_DO_NOT_OVERRIDE

test_no_overrides_DO_NOT_OVERRIDE() -> None

Test that no standard tests are overridden.

kv_store abstractmethod

kv_store() -> BaseStore[str, V]

Get the key-value store class to test.

The returned key-value store should be EMPTY.

three_values abstractmethod

three_values() -> tuple[V, V, V]

Three example values that will be used in the tests.

test_three_values

test_three_values(three_values: tuple[V, V, V]) -> None

Test that the fixture provides three values.

test_kv_store_is_empty

test_kv_store_is_empty(kv_store: BaseStore[str, V]) -> None

Test that the key-value store is empty.

test_set_and_get_values

test_set_and_get_values(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test setting and getting values in the key-value store.

test_store_still_empty

test_store_still_empty(kv_store: BaseStore[str, V]) -> None

Test that the store is still empty.

This test should follow a test that sets values.

This just verifies that the fixture is set up properly to be empty after each test.

test_delete_values

test_delete_values(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test deleting values from the key-value store.

test_delete_bulk_values

test_delete_bulk_values(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test that we can delete several values at once.

test_delete_missing_keys

test_delete_missing_keys(kv_store: BaseStore[str, V]) -> None

Deleting missing keys should not raise an exception.

test_set_values_is_idempotent

test_set_values_is_idempotent(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Setting values by key should be idempotent.

test_get_can_get_same_value

test_get_can_get_same_value(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test that the same value can be retrieved multiple times.

test_overwrite_values_by_key

test_overwrite_values_by_key(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test that we can overwrite values by key using mset.

test_yield_keys

test_yield_keys(kv_store: BaseStore[str, V], three_values: tuple[V, V, V]) -> None

Test that we can yield keys from the store.

BaseStoreAsyncTests

Bases: BaseStandardTests, Generic[V]

Test suite for checking the key-value API of a BaseStore.

This test suite verifies the basic key-value API of a BaseStore.

The test suite is designed for synchronous key-value stores.

Implementers should subclass this test suite and provide a fixture that returns an empty key-value store for each test.

METHOD	DESCRIPTION
test_no_overrides_DO_NOT_OVERRIDE	Test that no standard tests are overridden.
kv_store	Get the key-value store class to test.
three_values	Three example values that will be used in the tests.
test_three_values	Test that the fixture provides three values.
test_kv_store_is_empty	Test that the key-value store is empty.
test_set_and_get_values	Test setting and getting values in the key-value store.
test_store_still_empty	Test that the store is still empty.
test_delete_values	Test deleting values from the key-value store.
test_delete_bulk_values	Test that we can delete several values at once.
test_delete_missing_keys	Deleting missing keys should not raise an exception.
test_set_values_is_idempotent	Setting values by key should be idempotent.
test_get_can_get_same_value	Test that the same value can be retrieved multiple times.
test_overwrite_values_by_key	Test that we can overwrite values by key using mset.
test_yield_keys	Test that we can yield keys from the store.

test_no_overrides_DO_NOT_OVERRIDE

test_no_overrides_DO_NOT_OVERRIDE() -> None

Test that no standard tests are overridden.

kv_store abstractmethod async

kv_store() -> BaseStore[str, V]

Get the key-value store class to test.

The returned key-value store should be EMPTY.

three_values abstractmethod

three_values() -> tuple[V, V, V]

Three example values that will be used in the tests.

test_three_values async

test_three_values(three_values: tuple[V, V, V]) -> None

Test that the fixture provides three values.

test_kv_store_is_empty async

test_kv_store_is_empty(kv_store: BaseStore[str, V]) -> None

Test that the key-value store is empty.

test_set_and_get_values async

test_set_and_get_values(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test setting and getting values in the key-value store.

test_store_still_empty async

test_store_still_empty(kv_store: BaseStore[str, V]) -> None

Test that the store is still empty.

This test should follow a test that sets values.

This just verifies that the fixture is set up properly to be empty after each test.

test_delete_values async

test_delete_values(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test deleting values from the key-value store.

test_delete_bulk_values async

test_delete_bulk_values(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test that we can delete several values at once.

test_delete_missing_keys async

test_delete_missing_keys(kv_store: BaseStore[str, V]) -> None

Deleting missing keys should not raise an exception.

test_set_values_is_idempotent async

test_set_values_is_idempotent(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Setting values by key should be idempotent.

test_get_can_get_same_value async

test_get_can_get_same_value(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test that the same value can be retrieved multiple times.

test_overwrite_values_by_key async

test_overwrite_values_by_key(
    kv_store: BaseStore[str, V], three_values: tuple[V, V, V]
) -> None

Test that we can overwrite values by key using mset.

test_yield_keys async

test_yield_keys(kv_store: BaseStore[str, V], three_values: tuple[V, V, V]) -> None

Test that we can yield keys from the store.