shapeless-contrib
shapeless-contrib copied to clipboard
Interoperability libraries for Shapeless
shapeless-contrib
Interoperability libraries for Shapeless
Usage
This library is currently available for Scala 2.10, 2.11, and 2.12.
To use the latest version, include the following in your build.sbt
:
libraryDependencies ++= Seq(
"org.typelevel" %% "shapeless-scalacheck" % "0.6.1",
"org.typelevel" %% "shapeless-spire" % "0.6.1",
"org.typelevel" %% "shapeless-scalaz" % "0.6.1"
)
What does this library do?
shapeless-contrib
aims to provide smooth interoperability between Shapeless, and Spire. The most prominent feature is automatic derivation of type class instances for case classes, but there is more. If you've got a cool idea for more stuff, please open an issue.
Examples
Derive type classes
Consider a simple case class with an addition operation:
case class Vector3(x: Int, y: Int, z: Int) {
def +(other: Vector3) = Vector3(this.x + other.x, this.y + other.y, this.z + other.z)
}
If we want to use that in a generic setting, e.g. in an algorithm which requires a Monoid
, we can define an instance for spire.algebra.Monoid
like so:
implicit object Vector3Monoid extends Monoid[Vector3] {
def id = Vector3(0, 0, 0)
def op(x: Vector3, y: Vector3) = x + y
}
This will work nicely for that particular case. However, it requires repetition: addition on Vector3
is just pointwise addition of its elements, and the null vector consists of three zeroes. We do not want to repeat that sort of code for all our case classes, and want to derive that automatically. Luckily, this library provides exactly that:
import spire.implicits._
import shapeless.contrib.spire._
// Define the `Vector3` case class without any operations
case class Vector3(x: Int, y: Int, z: Int)
// That's it! `Vector3` is an `AdditiveMonoid` now.
Vector3(1, 2, 3) + Vector3(-1, 3, 0)