Merge pull request #1594 from bradovitt/chimney

chimney

Author: dominiqueplante

build.sbt

@@ -457,6 +457,17 @@ lazy val scala_libraries = (project in file("scala-libraries"))
     Defaults.itSettings
   )
 
+lazy val scala_libraries_2 = (project in file("scala-libraries-2"))
+  .configs(IntegrationTest)
+  .settings(
+    name := "scala-libraries-2",
+    scalaVersion := scala3Version,
+    libraryDependencies ++= scalaTestDeps
+      .map(_.withConfigurations(Some("it,test"))),
+    libraryDependencies += "io.scalaland" %% "chimney" % "1.4.0",
+    Defaults.itSettings
+  )
+
 val http4sBlaze = "0.23.16"
 val http4sVersion = "0.23.28"
 val osLibVersion = "0.11.1"

scala-libraries-2/README.md

@@ -0,0 +1,2 @@
+## Relevant Articles:
+

scala-libraries-2/src/main/scala/com/baeldung/chimney/Codec.scala

@@ -0,0 +1,10 @@
+package com.baeldung.chimney
+
+import io.scalaland.chimney.*, dsl.*, partial.*
+
+object ChimneyCodec extends App:
+
+  case class Domain(a: Int, b: String)
+  case class Dto(b: Option[String], a: Option[Int])
+
+  given Codec[Domain, Dto] = Codec.derive

scala-libraries-2/src/main/scala/com/baeldung/chimney/Iso.scala

@@ -0,0 +1,10 @@
+package com.baeldung.chimney
+
+import io.scalaland.chimney.*, dsl.*, partial.*
+
+object ChimneyIso extends App:
+
+  case class StructuredItem(uuid: java.util.UUID)
+  case class DomainItem(uuid: java.util.UUID)
+
+  given Iso[StructuredItem, DomainItem] = Iso.derive

scala-libraries-2/src/main/scala/com/baeldung/chimney/PartialTransformer.scala

@@ -0,0 +1,19 @@
+package com.baeldung.chimney
+
+import io.scalaland.chimney.*, dsl.*, partial.*
+
+object ChimneyPartialTransformer extends App:
+
+  val fn: Int => Boolean =
+    case 0 => false
+    case 1 => true
+    case i => throw Exception(s"Provided integer invalid: $i")
+
+  given PartialTransformer[Int, Boolean] =
+    PartialTransformer.fromFunction(fn)
+
+  val result: Result[Boolean] = 0.transformIntoPartial[Boolean]
+
+  result match
+    case Result.Value(bool)  => println(bool)
+    case Result.Errors(errs) => println(errs)

scala-libraries-2/src/main/scala/com/baeldung/chimney/Patcher.scala

@@ -0,0 +1,39 @@
+package com.baeldung.chimney
+
+import io.scalaland.chimney.dsl.*
+
+object ChimneyPatcher extends App:
+
+  case class Book(
+    name: Title,
+    authors: List[Author],
+    isbn: ISBN
+  )
+
+  case class Title(name: String) extends AnyVal
+  case class Author(name: String, surname: String)
+
+  type ISBN = Option[String]
+
+  case class UpdateISBN(isbn: ISBN)
+
+  val book = Book(
+    name = Title("Synergetics"),
+    authors = List(Author("Buckminster", "Fuller")),
+    isbn = None
+  )
+
+  val isbnUpdateForm = UpdateISBN(
+    isbn = Some("978-0206532048")
+  )
+
+  val hardcover: Book = book.patchUsing(isbnUpdateForm)
+
+  // Standard Library Alternative
+
+  val softcover: Book =
+    book.copy(
+      authors =
+        List(Author("Buckminster", "Fuller"), Author("Edmund", "Applewhite")),
+      isbn = Some("978-0020653202")
+    )

scala-libraries-2/src/main/scala/com/baeldung/chimney/Transformer.scala

@@ -0,0 +1,95 @@
+package com.baeldung.chimney
+
+import io.scalaland.chimney.*, dsl.*, partial.*
+
+object ChimneyTransformers extends App:
+
+  class MyType(val a: Int)
+
+  class MyOtherType(val b: String):
+    override def toString: String = s"MyOtherType($b)"
+
+  val transformer: Transformer[MyType, MyOtherType] = (src: MyType) =>
+    new MyOtherType(src.a.toString)
+
+  transformer.transform(new MyType(10)) // new MyOtherType("10")
+
+  implicit val transformerAsImplicit: Transformer[MyType, MyOtherType] =
+    transformer
+
+  (new MyType(10)).transformInto[MyOtherType]
+
+  // Transitive Given Instances
+
+  trait Serial[T]:
+    def serial(v: T): String
+
+  given Serial[MyOtherType] with
+    def serial(v: MyOtherType): String = v.toString
+
+  given [F, T](using Serial[T], Transformer[F, T]): Serial[F] with
+    def serial(v: F): String =
+      summon[Serial[T]].serial:
+        summon[Transformer[F, T]].transform(v)
+
+  // Automatic Case Class Transformation
+
+  // BookDTO
+
+  case class BookDTO(
+    name: String, // 1. primitive
+    authors: Seq[AuthorDTO], // 2. Seq collection
+    isbn: Option[String] // 3. Option type
+  )
+
+  case class AuthorDTO(name: String, surname: String)
+
+  // Book Domain Model
+
+  case class Book(
+    name: Title,
+    authors: List[Author],
+    isbn: ISBN
+  )
+
+  case class Title(name: String) extends AnyVal
+  case class Author(name: String, surname: String)
+
+  type ISBN = Option[String]
+
+  // we can do a transformation:
+
+  val book = Book(
+    name = Title("The Universal One"),
+    authors = List(Author("Walter", "Russell")),
+    isbn = None
+  )
+
+  val bookDTO: BookDTO = book.transformInto[BookDTO]
+
+  // Standard Library alternatives
+
+  // Selectable
+
+  class Record(elems: (String, Any)*) extends Selectable:
+    private val fields = elems.toMap
+    def selectDynamic(name: String): Any = fields(name)
+
+  type BookRecord = Record {
+    val name: Title
+    val authors: List[Author]
+    val isbn: ISBN
+  }
+
+  val naturesOpenSecret: BookRecord = Record(
+    "name" -> Title("Nature's Open Secret"),
+    "authors" -> List(Author("Rudolph", "Steiner")),
+    "isbn" -> Some("978-0880103930")
+  ).asInstanceOf[BookRecord]
+
+  // Tuple Generics
+
+  val bookTuple: (Title, List[Author], ISBN) = Tuple.fromProductTyped(book)
+
+  val bookAgain: Book =
+    summon[deriving.Mirror.Of[Book]].fromProduct(bookTuple)