Awesome
scalaconfig
ScalaConfig is a lightweight wrapper over Typesafe Lightbend Config library provides scala friendly access.
It is implemented with type classes pattern and use shapeless for reading case classes.
Current documentation is a actual for 0.7 version.
ScalaConfig adds additional metods:
as[A](path)
- returnEither[Seq[Throwable], A]
by path in config objectas[A]
- convert config object toEither[Seq[Throwable], A]
asUnsafe[A](path)
- return value of typeA
by path in config object. On fail a first exception will thrown.asUnsafe[A]
- convert config object to value of typeA
. On fail a first exception will thrown.
Supported types
- Primitive (
Int
,Long
,Float
,Double
,Boolean
) String
,Symbol
- Typesafe
Config
andConfigValue
FiniteDuration
Properties
- Collections (
List[A]
,Set[A]
,Map[String, A]
,Map[String, AnyRef]
,Array[A]
, etc. All types with a CanBuildFrom instance are supported) Option[A]
- Case classes
Examples
import com.github.andr83.scalaconfig._
val config: Config = ConfigFactory.load()
val host = config.asUnsafe[String]("host")
val port = config.asUnsafe[Int]("port")
val path = config.asUnsafe[Option[String]]("path")
val users = config.asUnsafe[List[String]]("access.users")
case class DbConfig(host: String, port: Int, user: Option[String] = None, passwd: Option[String] = None)
val dbConfig: Reader.Result[DbConfig] = config.as[DbConfig]("db")
val dbConfig2: Reader.Result[DbConfig] = config.as[DbConfig] // Direct `config` mapping to case class
val dbConfig3: Reader.Result[Map[String, String]] = config.as[Map[String, String]]
val dbConfig3: Reader.Result[Map[String, AnyRef]]] = config.as[Map[String, AnyRef]]
// Custom reader
class User(name: String, password: String)
implicit def userReader: Reader[User] = Reader.pure((config: Config, path: String) => {
val userConfig = config.getConfig(path)
new User(
user = userConfig.asUnsafe[String]("name"),
password = userConfig.asUnsafe[String]("password")
)
}
})
// OR
implicit def userReader: Reader[User] = Reader.pureV((config: Config, path: String) => {
val userConfig = config.getConfig(path)
val userE = userConfig.as[String]("name")
val passwordE = userConfig.as[String]("password")
// with Cats or Scalaz it can be of course more elegant!
(userE, passwordE) match {
case (Right(user), Right(password)) => Right(new User(user, password))
case ( Left(errors1), Left(errors2)) => Left(errors1 ++ errors2)
case (Left(errors), _) => Left(errors)
case (_, Left(errors)) => Left(errors)
}
}
})
Implementation details
Usage
Latest release.
// for >= Scala 2.11.x, 2.12.x, 2.13.x
libraryDependencies += "com.github.andr83" %% "scalaconfig" % "0.7"
If you want scala 2.10 support please use 0.4 version.
Develop branch.
resolvers += Resolver.sonatypeRepo("snapshots")
libraryDependencies += "com.github.andr83" %% "scalaconfig" % "0.8-SNAPSHOT"
License
MIT License
Copyright (c) 2016 Andrei Tupitcyn