Cagette

Cagette is a quick and dirty data store for prototyping. It allows to focus on designing your domain model, business rules, screens, user interactions, batch, reports, ... without bothering about how your data will eventually be persisted.

Setting up with sbt

Configure a new resolver:

resolvers += "Guillaume Bort" at "http://guillaume.bort.fr/repository"

Add the library dependency:

libraryDependencies += "guillaume.bort" %% "cagette" % "0.1"

Using – as easy as 1,2,3

1. Create your domain class with an id field:

Let's try with a User class:

case class User(id: Long, email: String, groups: Seq[String])

2. Create a Cageot[DomainType,IdType]:

We usually name the Cageot with the same name as the domain class:

object User extends cagette.Cageot[User,Long]

3. Query the cageot using Scala functions

The Cageot type provide some convenient higher order query functions you can use directly:

findAll()

val allusers: Seq[User] = User.findAll()

findById(id: IdType)

val maybeUser: Option[User] = User.findById(100)

findOneBy(predicate: DomainType => Boolean)

val maybeUser: Option[User] = User.findOneBy(_.email == "coco@gmail.com")

findBy(predicate: DomainType => Boolean)

val adminUsers: Seq[User] = User.findBy(_.groups.contains("admin"))

Setting up initial data set

While defining your Cageot you can define the initial data set it will contain:

object User extends cagette.Cageot[User,Long] {
	
	override def initialData = Seq(
		User(1, "bob@gmail.com", groups = Seq("admin", "user")),
		User(2, "kiki@gmail.com", groups = Seq("user")),
		User(3, "toto@gmail.com", groups = Nil),
	)

}

Updating data

save will insert a new instance

If you want to store a new instance into your Cageot, just use the save operation as:

User.save( 
  User(99, "coco@gmail.com", groups = Seq("user")) 
)

but save will also update an existing instance

If the store already contains an instance with the same id, this instance will just be udpated:

User.findById(theIdRetrievedFromTheRequest).map { user =>
	User.save(user.copy(groups = (user.groups :+ "admin").distinct ))
}

then you can delete them later

You can either delete by using the id of the instances you want to remove as:

User.delete(theIdRetrievedFromTheRequest)

or batch delete using a predicate as:

User.delete(_.groups.contains("archived"))

Using with Play framework

You can directly use this for prototyping any http://www.playframework.org. Just add the resolver and library dependency to your Build.scala file, and start defining your model. The initialData set will be applied automatically at startup and each time your code change.

Bonus

Check the source code and find secret features like pagination and autoincrement for domain class identifiers.

Enjoy!