longevity

A Persistence Framework for Scala and NoSQL

View project on GitHub

repo crud spec

The RepoCrudSpec iterates over all of the repositories in your LongevityContext, and tests basic CRUD operations for each of them. This includes testing Repo.retrieve method against every key defined in your persistent types.

Two RepoCrudSpecs are provided for you in the LongevityContext: repoCrudSpec, and inMemRepoCrudSpec. The latter uses an in-memory database. The former executes tests using a test database. The database connection details are specified in the longevity config. The database back end is specified by the longevity context’s configuration.

The repo crud specs are ScalaTest suites:

val spec: org.scalatest.Suite = longevityContext.repoCrudSpec

In a typical evocation of ScalaTest, for instance from within SBT, a classpath scan is performed, and only top-level Suites - non-abstract classes that are defined directly within a package - are found. So to get one of these repo crud specs to run, you have to nest it in a top-level class. For example, to run both in-memory and against a real database:

import org.scalatest.Suites
import scala.concurrent.ExecutionContext.Implicits.global

class BlogCrudSpec extends Suites(
  longevityContext.repoCrudSpec,
  longevityContext.inMemRepoCrudSpec)

ScalaTest is an optional dependency in longevity, so you’ll need to declare a dependency on ScalaTest in your own project to use the repo crud specs. Please use ScalaTest version 3.0.1 or later.

You need to provide an execution context when calling LongevityContext.repoCrudSpec. The easiest way to do this is to include import scala.concurrent.ExecutionContext.Implicits.global at the top of your file.

The default test data generator will not work out of the box in the face of constraint violations causing exceptions to be thrown from your persistent and embeddable constructors. In this case, you need to provide custom generators for your types. This is described in the section on enforcing constraints.

prev: enforcing constraints
up: testing
next: query spec