kandra-test/io.kandra.test

Package-level declarations

Types

CapturedStatement

data class CapturedStatement(val cql: String, val values: List<Any?>)

A captured statement as seen by a test: the CQL text and the positional values bound to it.

FakeKandraSession

class FakeKandraSession : CqlSession

In-memory drop-in replacement for CqlSession — no ScyllaDB connection required.

FakeUnset

object FakeUnset

Sentinel marking a positional variable on a FakeBoundStatement that was explicitly left unset (via BoundStatement.unset) as opposed to bound to an actual CQL null (via setBytesUnsafe(idx, null), which FakeBoundStatement records as Kotlin null). Mirrors the real driver's "unset means don't touch this column" write semantics — see StatementBuilder.insertPrimary (uses unset) vs. StatementBuilder.insertPrimaryWithNulls (binds real null, to create a tombstone) for the two call sites this distinction matters for.

KandraCloud

object KandraCloud

Live-cluster (e.g. Scylla Cloud) test harness. Env-driven, so no credentials ever live in the repo.

KandraMultiDcFixtureException

class KandraMultiDcFixtureException(message: String, cause: Throwable? = null) : RuntimeException

Thrown by KandraMultiDcTestcontainers when the multi-DC Docker Compose fixture itself fails to come up -- a dynamically-chosen port still collided (see KandraMultiDcTestcontainers.compose's doc for the small, inherent check-then-bind race), Docker isn't running, or Compose otherwise failed to start. Wraps whatever Testcontainers/Docker raised with an actionable, Kandra-authored message instead of leaving a caller to decode a raw Docker bind error (GH #108 / ISS-095).

KandraMultiDcTestcontainers

object KandraMultiDcTestcontainers

A real two-datacenter, one-node-per-DC Cassandra topology for DC-aware load-balancing/failover tests (GH #84 / ISS-076), backed by multidc-docker-compose.yml (this module's src/main/resources) via Testcontainers' ComposeContainer. Mirrors KandraTestcontainers's lazy-singleton, JVM-shared style -- one topology per JVM, reused across every test class that touches it, rather than a fresh cluster per test.

KandraRuntime

class KandraRuntime : AutoCloseable

A fully wired Kandra instance backed by a FakeKandraSession.

KandraRuntimeHandle

class KandraRuntimeHandle constructor(session: CqlSession, val runtime: KandraRuntime, scope: CoroutineScope, val keyspace: String)

A runtime handle for an isolated test keyspace. Close it in @AfterEach.

KandraTestBackend

object KandraTestBackend

Connection provider for live-cluster tests: one abstraction over the shared Testcontainers Cassandra (KandraTestcontainers) and the env-driven Scylla Cloud cluster (KandraCloud).

KandraTestcontainers

object KandraTestcontainers

Integration test utilities for running Kandra against a real ScyllaDB/Cassandra instance.

KandraTestUtils

object KandraTestUtils

Factory object for creating in-memory Kandra runtimes suitable for unit tests.