GithubHelp home page GithubHelp logo

ornicar / play-autoconfig Goto Github PK

View Code? Open in Web Editor NEW

This project forked from gmethvin/play-autoconfig

0.0 2.0 0.0 33 KB

ConfigLoader generator for Play Framework 2.6+

License: Apache License 2.0

Scala 100.00%

play-autoconfig's Introduction

Play AutoConfig

Travis CI Maven

AutoConfig is a utility for type-safe configuration in Play (2.6.0 and later). The library provides a convenient macro to generate ConfigLoader instances for arbitrary classes.

Usage

To add to your sbt build:

libraryDependencies += "io.methvin.play" %% "autoconfig-macros" % playAutoConfigVersion

Replace playAutoConfigVersion with the latest version: maven central version

Creating configuration classes

It's good practice to create type-safe classes representing your configuration instead of passing around raw Configuration or Config objects. This way your application components can simply access properties of your class rather than having to read and convert configuration individually. This also makes it easier to create instances for unit testing.

For example, suppose I want to read configuration for a hypothetical API I'm making calls to. Let's assume I need an API key, an API password, and I want to configure the request timeout. So I create a class like this:

import play.api._
import io.methvin.play.autoconfig._
import scala.concurrent.duration._

case class FooApiConfig(
  apiKey: String,
  apiPassword: String,
  requestTimeout: Duration
)
object FooApiConfig {
  implicit val loader: ConfigLoader[FooApiConfig] = AutoConfig.loader
  def fromConfiguration(conf: Configuration) = conf.get[FooApiConfig]("api.foo")
}

The fromConfiguration method shows how you'd use the ConfigLoader using the Configuration#get method. In this case it would read a configuration object that looks like this:

api.foo {
  apiKey = "abcdef"
  apiPassword = "secret"
  requestTimeout = 1 minute
}

The loader macro goes through each parameter of the default constructor and looks for a ConfigLoader in scope for that type, then uses the loader to load the key in the object of the same name. In this case Play already provides loaders for String and Duration. If you had a custom object type nested inside, you could generate a loader in the exact same way.

Custom naming

The macro also supports custom names, for example:

import play.api._
import io.methvin.play.autoconfig._
import scala.concurrent.duration._

case class FooApiConfig(
  @ConfigName("api-key") apiKey: String,
  @ConfigName("api-password") apiPassword: String,
  @ConfigName("request-timeout") requestTimeout: Duration
)
object FooApiConfig {
  implicit val loader: ConfigLoader[FooApiConfig] = AutoConfig.loader
  def fromConfiguration(conf: Configuration) = conf.get[FooApiConfig]("api.foo")
}

This will change the name of the properties used for each field:

api.foo {
  api-key = "abcdef"
  api-password = "secret"
  request-timeout = 1 minute
}

Using an alternate constructor

You can also use an alternate constructor:

import play.api._
import io.methvin.play.autoconfig._
import scala.concurrent.duration._

case class FooApiConfig(
  apiKey: String,
  apiPassword: String,
  requestTimeout: Duration
) {
  @ConfigConstructor def this(key: String, password: String, timeout: Int) = {
    this(key, password, duration.millis)
  } 
}

The field names will be taken from the argument names of the alternate constructor, or their associated @ConfigName annotation.

Binding configuration classes

Once you've written your config class, you'll need to make it available to the components that use it. If you're using compile-time DI, you can write something like this:

trait FooApiComponents {
  def configuration: Configuration
  lazy val fooApiConfig: FooApiConfig = configuration.get[FooApiConfig]("api.foo")
  lazy val fooApi: FooApi = new FooApi(fooApiConfig)
}

If using Guice you can add a @Provides method to your module with your config class:

class ConfigModule extends AbstractModule {
  def configure: Unit = { /* ... */ }

  @Provides def fooApiConfig(conf: Configuration): FooApiConfig =
    conf.get[FooApiConfig]("api.foo")
}

License

This library is licensed under the Apache License, version 2.0. See the LICENSE file for details.

play-autoconfig's People

Contributors

gmethvin avatar tanacasino avatar xuwei-k avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.