Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
October 29, 2021 23:34
September 19, 2019 15:02
December 26, 2019 08:36
October 27, 2022 17:19
November 7, 2017 22:57
November 2, 2022 11:15
May 24, 2019 22:29
November 1, 2019 13:40
CI Coverage Release Issues Users Chat
.github/workflows/ci.yaml Coverage Status Release Artifacts Average time to resolve an issue Scaladex dependencies badge Gitter

Scanamo is a library to make using DynamoDB with Scala simpler and less error-prone.

The main focus is on making it easier to avoid mistakes and typos by leveraging Scala's type system and some higher level abstractions.


libraryDependencies += "org.scanamo" %% "scanamo" % "1.0.0-M23"

Scanamo is published for Scala 2.13 and Scala 2.12.

Basic Usage

Note: the LocalDynamoDB object is provided by the scanamo-testkit package.

scala> import org.scanamo._
scala> import org.scanamo.syntax._
scala> import
scala> val client = LocalDynamoDB.client()
scala> import
scala> val farmersTableResult = LocalDynamoDB.createTable(client)("farmer")("name" -> S)

scala> case class Farm(animals: List[String])
scala> case class Farmer(name: String, age: Long, farm: Farm)
scala> val table = Table[Farmer]("farmer")

scala> val ops = for {
     |   _ <- table.putAll(Set(
     |       Farmer("McDonald", 156L, Farm(List("sheep", "cow"))),
     |       Farmer("Boggis", 43L, Farm(List("chicken")))
     |     ))
     |   mcdonald <- table.get("name" -> "McDonald")
     | } yield mcdonald
scala> Scanamo.exec(client)(ops)
res1: Option[Either[error.DynamoReadError, Farmer]] = Some(Right(Farmer(McDonald,156,Farm(List(sheep, cow)))))

For more details, please see the Scanamo site.


Scanamo is licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.